WorkflowBusiness Klasse

Die WorkflowBusiness-Klasse dient zur Verwaltung von WinLine CRM Workflows. Sie bietet Methoden zum Erstellen, Exportieren und Verwalten von CRM-Fällen und deren Anhängen.

Konstruktoren

public WorkflowBusiness(SystemUnitOfWork mesoSystemSession, ILogger<WorkflowBusiness>? logger = null) public WorkflowBusiness(IDataLayer mesoSystemDataLayer, ILogger<WorkflowBusiness>? logger = null) public WorkflowBusiness(string serverName, int port, string databaseName, string userName, string password, bool threadsafe, ILogger<WorkflowBusiness>? logger = null)

Öffentliche Methoden

FaelleAlsQueryable

Erstellt eine Abfrage für CRM-Fälle und projiziert sie auf den FallDto-Typ. Damit können Fälle gefiltert und abgefragt werden.

public IQueryable<FallDto> FaelleAlsQueryable(string mesocomp)

Parameter:

mesocomp: Der Name des Mandanten, für den die Fälle abgefragt werden sollen.

Rückgabe: Eine IQueryable-Sammlung von FallDto-Objekten.

ErzeugeFall (ErzeugeFallAnhandFeldliste)

Erzeugt einen neuen CRM-Fall mittels Mesonic WebService anhand einer Liste von Feldwerten.

public ErzeugterFall ErzeugeFall(ErzeugeFallAnhandFeldliste fallAnhandFelder, WebServiceParameter parameter)

Parameter:

fallAnhandFelder: Enthält die Feldwerte für den neuen Fall, Workflownummer und optional Anhänge.
parameter: Parameter für den WebService-Zugriff.

Rückgabe: Ein ErzeugterFall-Objekt mit Informationen zum erstellten Fall.

Exceptions:

ValidationException: Bei ungültigen Parametern.
InvalidOperationException: Bei ungültiger Operation.

ExportiereFaelleMitVorlage

public XmlDocument? ExportiereFaelleMitVorlage(ExportiereFaelleMitVorlageParameter parameterFallExport, WebServiceParameter parameter)

Exportiert die angegebenen Fälle mittels Mesonic WebService als XML-Dokument.

Parameter:

parameterFallExport: Parameter zur Filterung der zu exportierenden Fälle.
parameter: Parameter für den WebService-Zugriff.

Rückgabe: Ein XML-Dokument mit den exportierten Fällen oder null.

Exceptions:

ValidationException: Bei ungültigen Parametern.
InvalidOperationException: Bei ungültiger Operation.

ExportiereFaelleAlsJson

Exportiert die angegebenen Fälle mittels Mesonic WebService als JSON-String.

public string? ExportiereFaelleAlsJson(ExportiereFaelleMitVorlageParameter parameterFallExport, WebServiceParameter parameter)

Parameter:

parameterFallExport: Parameter zur Filterung der zu exportierenden Fälle.
parameter: Parameter für den WebService-Zugriff.

Rückgabe: Ein JSON-String mit den exportierten Fällen oder null.

Exceptions:

ValidationException: Bei ungültigen Parametern.
InvalidOperationException: Bei ungültiger Operation.

ErstelleCrmIncidencesUndSchritteQuery

Erstellt eine Datenbankabfrage für CRM-Fälle und -Schritte anhand der angegebenen Exportparameter.

public IQueryable<CrmIncidencesUndSchritte>
 ErstelleCrmIncidencesUndSchritteQuery(
     ExportiereFaelleMitVorlageParameter parameterFallExport)

Parameter:

parameterFallExport: Parameter zur Filterung der Fälle.

Rückgabe: Eine IQueryable-Sammlung von CrmIncidencesUndSchritte-Objekten.

ErzeugeFall (ErzeugeFallVonJson)

Erzeugt einen neuen CRM-Fall mittels Mesonic WebService aus einem JSON-String.

public ErzeugterFall ErzeugeFall(ErzeugeFallVonJson neuerFall, 
    WebServiceParameter parameter)

Parameter:

neuerFall: Enthält den JSON-String mit Feldwerten, Workflownummer, Vorlagennummer und optional Anhänge.
parameter: Parameter für den WebService-Zugriff.

Rückgabe: Ein ErzeugterFall-Objekt mit Informationen zum erstellten Fall.

Exceptions:

ValidationException: Bei ungültigen Parametern.
InvalidOperationException: Bei ungültiger Operation.

ErzeugeFall (ErzeugeFall)

Erzeugt einen neuen CRM-Fall mittels Mesonic WebService und der Vorlage "MesoXPO_CRM_Import".

public ErzeugterFall ErzeugeFall(ErzeugeFall neuerFall, 
    WebServiceParameter parameter)

Parameter:

neuerFall: Enthält die Daten für den neuen Fall.
parameter: Parameter für den WebService-Zugriff.

Rückgabe: Ein ErzeugterFall-Objekt mit Informationen zum erstellten Fall.

Exceptions:

ValidationException: Bei ungültigen Parametern.
InvalidOperationException: Bei ungültiger Operation.

ErzeugeFallAnhang

Erzeugt einen Anhang für einen CRM-Fall mit automatisch zugewiesenen Schlagworten für Fallnummer, Tagesdatum und Dateiname.

public ErzeugtesDokument ErzeugeFallAnhang(int fallId, 
    int schrittnummer, ErzeugeDokument dokument, string mandant)

Parameter:

fallId: Die ID des Falls, zu dem der Anhang gehört.
schrittnummer: Die Schrittnummer des Falls.
dokument: Die Daten des zu erstellenden Dokuments.
mandant: Der Name des Mandanten.

Rückgabe: Ein ErzeugtesDokument-Objekt mit Informationen zum erstellten Anhang.

Parameter- und Datenobjekte

WebServiceParameter

Parameter für den Zugriff auf Mesonic WebServices.

public record WebServiceParameter( 
   string MesonicServerUrl, 
   string? Benutzer, 
   string? Passwort, 
   string Mandant, 
   string? VorhandeneSessionId = null)

ErzeugeFall

Daten für die Erstellung eines neuen WinLine CRM-Falls.

public record ErzeugeFall(
    int Id = 0,
    int Schrittnummer = 0,
    int Workflownummer = 0,
    string? Kontonummer = null,
    string? Kurzbeschreibung = null,
    string? LangbeschreibungIntern = null,
    string? LangbeschreibungExtern = null,
    string? Projektnummer = null,
    string? Artikelnummer = null,
    string? OpNummer = null,
    double Gesamtbetrag = 0,
    DateTime? StartDatum = null,
    DateTime? Eskalationsdatum = null,
    DateTime? EndDatum = null,
    List<ErzeugeDokument>? Anhaenge = null)
{
}

ErzeugterFall

Ergebnis einer Fallanlage mit der ID des erzeugten Falls, der Schrittnummer, einer eventuellen Fehlermeldung und einer Liste der erzeugten Dokumente.

public record ErzeugterFall(
    int? ErzeugteFallId,
    int? ErzeugteSchrittnummer,
    string? Fehlermeldung,
    List<ErzeugtesDokument>? ErzeugteDokumente = null)

FallDto

Ergebnis einer Fallanlage mit der ID des erzeugten Falls, der Schrittnummer, einer eventuellen Fehlermeldung und einer Liste der erzeugten Dokumente.

public record FallDto
{
    public string Id => $"{FallId}-{Schrittnummer}";
    public int FallId { get; init; }
    public int Schrittnummer { get; init; }
    public string Benutzer { get; init; } = default!;
    public string? DelegiertAnBenutzer { get; init; } = default!;
    public string? DelegiertAnGruppe { get; init; } = default!;
    public string AktuellZustaendig => DelegiertAnBenutzer ?? DelegiertAnGruppe ?? Benutzer;
    public string AktuellerWorkflow { get; init; } = default!;
    public int Workflownummer { get; init; }
    public bool AktuellerSchritt { get; init; }
    public string? Kurzbeschreibung { get; init; }
    public string? LangbeschreibungIntern { get; init; }
    public string? LangbeschreibungExtern { get; init; }
    public string? Kontonummer { get; init; }
    public string? Artikelnummer { get; init; }
    public string? Projektnummer { get; init; }
    public string? OpNummer { get; init; }
    public double Gesamtbetrag { get; init; }
    public DateTime? StartDatum { get; init; }
    public DateTime? EndDatum { get; init; }
    public DateTime? Eskalationsdatum { get; init; }
    public DateTime? ErstellDatum { get; init; }
}

Last modified: 03 March 2025