ERP-Integration

Die nahtlose Anbindung an microtech büro+ ist ein zentraler Bestandteil der Workflow-Engine. Die Kommunikation erfolgt über eine moderne GraphQL-Schnittstelle, die es ermöglicht, Daten präzise zu lesen und Statusänderungen in Echtzeit zurückzuschreiben.

Beteiligte Tabellen und Felder

Die Workflow-Engine interagiert primär mit der Tabelle tblTransactions (Vorgänge) innerhalb von microtech. Hierbei werden spezifische Felder genutzt, um den Prozess zu steuern und Rückmeldungen aus dem Workflow direkt im ERP sichtbar zu machen.

Steuerung des Workflow-Starts

Damit ein Vorgang in den Workflow gelangt, müssen bestimmte Felder belegt sein:

• fldSel30312 (Start-Trigger): Dieses Feld fungiert als Ampel. Steht es auf Workflow angefordert, erkennt die Engine den Datensatz als neuen Task.
• fldSel30313 (Workflow-Name): Hier wird hinterlegt, welcher spezifische Prozess (z.B. ein Freigabeverfahren) gestartet werden soll.
• fldInExtBeaInfo (Start-Notiz): Ein Textfeld für initiale Kommentare, die dem ersten Bearbeiter im Workflow angezeigt werden.
• fldDokGUID (Dokument-Referenz): Über diese GUID kann die Engine das verknüpfte Dokument (z.B. ein PDF) direkt aus dem ERP abrufen.

Rückmeldung und Status-Updates

Die Engine steuert den Prozess und den Zugriffsschutz über folgende Felder in tblTransactions:

• Status (fldSel30312): Mapping der Prozesszustände (im Workflow, Workflow erfolgreich abgeschlossen, Workflow fachlich abgelehnt).
• Historie (fldGspInfo): Export der Workflow-Kommentare als Textblock.
• Sperr-Logik:
  • Aktiv: fldInExtBeaKz = true (Technischer Lock während der Laufzeit).
  • Abschluss (Ablehnung): fldGspKz = true (Dauerhafte fachliche Sperre).
  • Abschluss (Freigabe): fldGspKz = true nur, wenn Kommentare in fldGspInfo vorhanden sind (Schutz der Historie). Ansonsten bleibt der Datensatz offen.

Technischer Datenaustausch

Zeitpunkt	Feld ERP	Richtung	Logik / Format
Start	fldInExtBeaInfo	ERP → Workflow	Import als InitialNote in die Historie.
Abschluss	fldGspInfo	Workflow → ERP	Prepend (neue Daten oben). Format: Datum Zeit, Schritt, Bearbeiter: Kommentar

Sperr-Mechanismus (Locking)

Die Synchronisation erfolgt via GraphQL unter Nutzung des microtech Sperrsystems.

1. Lock: Setzen von fldInExtBeaKz beim Workflow-Start.
2. Runtime: Datensatz ist in microtech für manuelle Änderungen gesperrt (Hinweis: "Workflow Engine").
3. Unlock: fnUnlockFromExternalProcessing wird vor dem finalen Schreibvorgang aufgerufen.
4. Final Lock: Optionale Sperre via fldGspKz basierend auf dem Ergebnis (siehe oben).