Dokumentation › Produkte › ConnectWORKFLOW › ConnectWORKFLOW - Mandantenkonfiguration › Workflow Komponente im Portal konfigurieren
Schritt-für-Schritt-Anleitung zur Einrichtung und Aktivierung der ConnectWORKFLOW-Komponente im ConnectCLOUD Portal.
Zuletzt geändert am 17.11.2026
Auf dieser Seite
Zielgruppe & Rolle
Rolle: Mandanten-Administrator / Prozessverantwortlicher / Einrichter | Voraussetzung: Voraussetzungen für ConnectWORKFLOW erfüllt
Unterstützung durch MBCOM
Auf Wunsch kann die vollständige Einrichtung von ConnectWORKFLOW durch MBCOM übernommen werden.
Die Workflow-Konfiguration im ConnectCLOUD Portal ermöglicht die mandantenspezifische Bereitstellung automatisierter Genehmigungs- und Prüfpfade für Vorgänge aus trade. In diesem Bereich verwalten Sie Ihre Workflow-Blueprints, überprüfen die technischen Voraussetzungen über den Konfigurationstest und schalten die Workflow-Engine für den Mandanten aktiv.
Richtigen Mandanten auswählen
Die Workflow-Konfiguration gilt für den aktuell ausgewählten Mandanten. Prüfen Sie vor jeder Änderung die Mandantenauswahl oben in der linken Leiste des Portals.
Vorgehen bei der Ersteinrichtung im Überblick
Die Einrichtung der Workflow-Komponente im ConnectCLOUD Portal erfolgt in folgenden Schritten:
- Voraussetzungen & Vorbereitung prüfen
- Workflow-Bereich im Portal aufrufen & Grundeinstellungen festlegen
- Workflow-Blueprints verwalten
- Blueprint im Editor konfigurieren
- Benachrichtigungen & Rückfragen einrichten
- Konfigurationstest durchführen
- Workflow-Automatisierung aktivieren & testen
1. Voraussetzungen & Vorbereitung prüfen
Bevor Sie mit der Konfiguration im Portal beginnen, müssen die folgenden Systemvoraussetzungen erfüllt sein:
- Voraussetzungen erfüllt: trade, HR und DMS stehen dem Workflow-Dienst zur Verfügung (siehe Voraussetzungen für ConnectWORKFLOW). Eine microtech-Anbindung ist für Workflows nicht nötig.
- HR-Gruppen angelegt: Die Gruppen, die Aufgaben bearbeiten sollen, existieren in HR und haben Mitglieder.
- Benachrichtigungskanäle bereitgestellt (optional): Einrichtung von Teams bzw. Einrichtung vom Postfach
2. Workflow-Bereich im Portal aufrufen & Grundeinstellungen festlegen
- Öffnen Sie das ConnectCLOUD Portal und wählen Sie in der Mandantenauswahl den gewünschten Zielmandanten aus.
- Navigieren Sie über das Menü zu Administration und öffnen Sie das Register bzw. die Kachel Workflow.
- Auf der Seite sehen Sie die Status-Karte Workflow Automatisierung.
Workflow-Automatisierung zunächst deaktiviert lassen
Lassen Sie den Schalter Workflow Automatisierung während der gesamten Ersteinrichtung auf Deaktiviert. Aktivieren Sie die Engine erst, nachdem Sie Ihre Blueprints hinterlegt und den Konfigurationstest fehlerfrei bestanden haben.
3. Workflow-Blueprints verwalten
Im Bereich Workflow Blueprints werden alle für den aktuellen Mandanten hinterlegten Geschäftsprozess-Definitionen aufgelistet.
Blueprint-Übersicht
Die Tabelle gibt Ihnen einen schnellen Überblick über die konfigurierten Prozesse:
| Spalte | Bedeutung |
|---|---|
| ID & Version | Eindeutige Kennung des Blueprints (z. B. incoming-invoice) sowie die aktuelle Versionsnummer (z. B. v3). |
| Schritte | Anzahl der im Workflow hinterlegten Prozessschritte (UserSteps und SystemSteps). |
| Status | Zeigt an, ob der jeweilige Blueprint aktiv geschaltet ist (aktiv oder inaktiv). |
| Aktionen | Schaltflächen zum Betrachten, Bearbeiten oder Löschen des Blueprints. |
Verfügbare Aktionen
- Neuer Blueprint (
+): Öffnet den Editor mit einer leeren Vorlage zur Neuanlage eines Workflows. - Anzeigen (Auge): Öffnet eine schreibgeschützte Detailansicht des Blueprints inklusive der interaktiven grafischen Vorschau.
- Bearbeiten (Stift): Öffnet den Blueprint im zweigeteilten Bearbeitungs-Editor.
- Löschen (Papierkorb): Entfernt den Blueprint. Bitte beachten Sie die Bestätigungsabfrage im Dialog.
4. Blueprint im Editor konfigurieren
Klicken Sie auf Neuer Blueprint oder bearbeiten Sie einen bestehenden Eintrag, um den Blueprint-Editor zu öffnen.
Die Arbeitsumgebung im Editor
Der Editor ist in zwei synchronisierte Bereiche aufgeteilt:
- Linke Seite – YAML-Editor:
- Hier bearbeiten Sie die Definition des Blueprints in strukturierter YAML-Form.
- Ein integrierter Validator überprüft Ihre Eingaben. Er prüft zusätzlich serverseitig (während der Bearbeitung und beim Speichern) Vorgangsarten, Feldnamen, Bedingungen und HR-Gruppen und zeigt alle Probleme mit Pfad und Hinweis an. Speichern ist nur ohne Probleme möglich.
- Eine Feldauswahl liefert die Feldnamen des Vorgangs (und der Positionen), eine Gruppenauswahl fügt die ID einer HR-Gruppe an der Cursorposition ein.
- Der Status wird oben über Badges signalisiert:
| Status | Bedeutung |
|---|---|
| Gültig | Die Syntax und das Schema sind fehlerfrei. |
| Warnung | Nicht-kritische Hinweise zur Definition. |
| Fehlerhaft | Syntax- oder Strukturfehler mit detaillierter Zeilen- und Fehlerbeschreibung. |
2. Rechte Seite – Designer-Vorschau (WorkflowCanvas): |
- Stellt die im YAML-Code definierte Prozessstruktur als interaktives Ablaufdiagramm dar.
- Jeder hinzugefügte Schritt, jede Verzweigung und jeder Übergang wird unmittelbar grafisch visualisiert.
flowchart LR
Y[YAML-Editor] -->|Echtzeit-Validierung| V[Syntax & Schema Status]
Y -->|Live-Rendering| D[Designer-Vorschau / Canvas]
D -->|Visuelle Kontrolle| A[Administrator / Einrichter]
Schrittweiser Aufbau der Blueprint-Definition
Bauen Sie Ihren Workflow im YAML-Editor nach folgendem Muster auf:
- Kopfdaten & Trigger festlegen:
id: Vergeben Sie eine eindeutige Kennung (z. B.incoming-invoice).version: Setzen Sie die Startversion (z. B.1). Bei wesentlichen Änderungen erhöhen Sie die Version.trigger: Setzen SieobjectType: transaction, die Vorgangsart(en) (transactionTypes, z. B.[INBOUND_INVOICE]), den Status (statuses, z. B.[IN_REVIEW]), optional eine Startbedingung (condition, z. B.grossTotal > 5000) und den Start-Schritt (nextStep.step). Für jeden passenden Vorgang startet automatisch ein Workflow.
- Übersichtsfelder definieren (
overviewField1,overviewField2):- Definieren Sie bis zu zwei Vorgangsfelder (z. B.
partnerCompanyunddocumentDate). - Diese Felder werden im Portal schrittübergreifend in der Aufgabenliste als separate Spalten angezeigt und erleichtern Anwendern die schnelle Orientierung.
- Definieren Sie bis zu zwei Vorgangsfelder (z. B.
- Bearbeitungsschritte (
steps) anlegen:- UserStep (Fachliche Bearbeitung):
- Vergeben Sie einen eindeutigen Schrittnamen (
name, z. B.abteilungsleiter_freigabe). - Weisen Sie die Bearbeiter über
group(die ID einer HR-Gruppe, per Gruppenauswahl einfügbar) oderuserzu. - Legen Sie in
fieldsfest, welche Vorgangsfelder der Bearbeiter im Portal sehen soll (z. B.transactionNumber,netTotal,typeData.validUntil) miteditable: false. Das Beleg-PDF wird aus dem DMS automatisch angezeigt. - Setzen Sie
allowInquiry: true, wenn Bearbeiter Rückfragen an Kollegen stellen dürfen. - Konfigurieren Sie bei Bedarf Benachrichtigungen über
notificationEmail(z. B.einkauf@firma.de) oderteamsWebhookUrl.
- Vergeben Sie einen eindeutigen Schrittnamen (
- SystemStep (Automatisierter Abschluss):
- Definieren Sie Schritte ohne Benutzerinteraktion am Ende des Pfads.
- Über
action: approvewird der Beleg als freigegeben markiert, überaction: rejectals abgelehnt.
- UserStep (Fachliche Bearbeitung):
- Übergänge & Entscheidungsbuttons (
nextSteps) definieren:- Legen Sie für jeden
UserStepdie Schaltflächen fest, die dem Anwender zur Auswahl stehen. - Vergeben Sie eine Beschriftung (
label, z. B. Freigabe), eine Farbe (color, z. B.successodererror) und ein Icon (icon, z. B.check-circleoderx-circle). - Definieren Sie den Zielschritt (
step) und bei Bedarf Verzweigungsbedingungen (condition).
- Legen Sie für jeden
- Blueprint speichern:
- Klicken Sie oben rechts auf Speichern. Der Blueprint wird persistent für den Mandanten gesichert.
Technische Spezifikation in der Technischen Referenz
Die vollständige Spezifikation aller Blueprint-Eigenschaften, Expr-Bedingungsoperatoren, Typkonvertierungen für RTF-Texte
(as:TEXT), 2-Ebenen-Feldgrenzen und ein direkt kopierbares YAML-Praxisbeispiel finden Sie in der Technischen Referenz: Technische Referenz: Workflow Blueprint
5. Benachrichtigungen & Rückfragen einrichten (optional)
Optionale Benachrichtigungskanäle
Die Einrichtung von Benachrichtigungen und Webhooks ist optional. Sämtliche Workflows und Genehmigungsprozesse funktionieren auch ohne Notifikationskanäle. Wir empfehlen jedoch die Aktivierung mindestens eines Kanals, damit Bearbeiter zeitnah über neue Aufgaben oder Rückfragen informiert werden, ohne das Portal permanent überwachen zu müssen.
ConnectWORKFLOW unterstützt zwei parallele Benachrichtigungskanäle, die direkt in den Workflow-Blueprints im YAML-Editor konfiguriert werden: E-Mail-Benachrichtigungen und Microsoft Teams (Webhooks).
E-Mail-Benachrichtigungen im Blueprint
ConnectWORKFLOW kann automatisierte E-Mails versenden, um Bearbeiter über anstehende Aufgaben zu informieren oder den Austausch bei Rückfragen zu unterstützen.
Wofür wird eine E-Mail im Blueprint hinterlegt?
-
Aufgaben-Benachrichtigung bei Schritteintritt (
UserStep): Sobald ein Beleg in einen bestimmten Bearbeitungsschritt eintritt (z. B. Freigabe Einkauf oder Freigabe Geschäftsleitung), versendet ConnectWORKFLOW automatisch eine formatierte E-Mail an die im Blueprint hinterlegte Adresse.- Die E-Mail enthält alle wesentlichen Vorgangsdaten (Belegnummer, Status, Schrittbezeichnung) sowie einen direkten Link zur Aufgabe in der Aufgabenübersicht (
taskURL). - Die zuständigen Personen müssen das Portal somit nicht manuell im Blick behalten, sondern werden proaktiv benachrichtigt, sobald eine Handlung erforderlich ist.
- Die E-Mail enthält alle wesentlichen Vorgangsdaten (Belegnummer, Status, Schrittbezeichnung) sowie einen direkten Link zur Aufgabe in der Aufgabenübersicht (
-
Rückfragen zu Belegen: Stellt ein Bearbeiter im Portal eine Rückfrage zu einem Beleg, wählt er den gewünschten Kollegen aus. ConnectWORKFLOW bietet die aktiven Mitglieder der im Blueprint genannten HR-Gruppen an und verwendet deren E-Mail-Adresse aus HR. Die Benachrichtigung inklusive Rückfragetext und Beleglink wird direkt per E-Mail zugestellt. Bei einer Antwort erhält der ursprüngliche Bearbeiter auf demselben Weg eine Benachrichtigung.
Voraussetzung: Mail-Komponente im Portal
Für den E-Mail-Versand muss die Mail-Komponente in dem Administrationsbereich eingerichtet und aktiv sein. Die technische Anbindung erfolgt über Microsoft Graph (
Mail.Send). Mail-Komponente im Portal konfigurieren | Einrichtung vom Postfach (Systemkonfiguration)
Wie wird die E-Mail im Blueprint hinterlegt?
Die E-Mail-Adresse wird im YAML-Editor direkt auf der Ebene des jeweiligen Bearbeitungsschritts (UserStep) über die Eigenschaft notificationEmail eingetragen:
steps:
- name: freigabe_einkauf
stepType: UserStep
group: 3f2b8c1e-5d7a-4b9e-8a61-2c4d9e7f1a30 # ID der HR-Gruppe
# E-Mail-Adresse für proaktive Aufgaben-Benachrichtigung:
notificationEmail: "einkauf@firma.de"
allowInquiry: true
fields:
- name: transactionNumber
visible: true
editable: false
- name: netTotal
visible: true
editable: false
nextSteps:
- label: Freigeben
color: success
step: genehmigung_abteilungsleiter
Einzelperson vs. Gruppen-/Funktionspostfach
Als
notificationEmailkann sowohl die persönliche E-Mail-Adresse einer Einzelperson (z. B.max.mustermann@firma.de) als auch eine Gruppen- bzw. Sammeladresse (z. B.einkauf@firma.deoderrechnungseingang@firma.de) angegeben werden. Für Teams und Abteilungen empfehlen wir Sammelpostfächer oder Verteilerlisten, damit alle zuständigen Bearbeiter gleichzeitig informiert werden.
Microsoft Teams (Webhooks) im Blueprint
Über Microsoft Teams können Bearbeiter in Echtzeit benachrichtigt werden. Die Zustellung erfolgt über einen Power-Automate-Flow, der Nachrichten über den Teams Flow-Bot direkt im persönlichen 1:1 Chat des Empfängers veröffentlicht.
Wofür wird ein Webhook im Blueprint hinterlegt?
-
Rückfragen per Flow-Bot (Persönlicher 1:1 Chat): Wird zu einer Aufgabe eine Rückfrage gestellt oder beantwortet, sendet ConnectWORKFLOW eine strukturierte Benachrichtigung an den zentralen Webhook. Der Power-Automate-Flow stellt die Nachricht mit Vorgangsdetails und direktem Portal-Link als Flow-Bot-Nachricht in den persönlichen 1:1 Teams-Chat des Kollegen zu.
-
Kanal-Benachrichtigung für neue Aufgaben (
teamsWebhookUrl): Optional kann an einzelnen Schritten ein Teams-Kanal-Webhook hinterlegt werden, um ein ganzes Team über neue Aufgaben in einem öffentlichen oder privaten Teams-Kanal zu informieren.
Voraussetzung: Power-Automate-Flow in Teams
Für die Teams-Anbindung muss vorab ein automatisierter Cloud-Flow mit HTTP-Trigger in Microsoft Power Automate eingerichtet worden sein. Einrichtung von Teams (Systemkonfiguration)
Wie wird der Webhook im Blueprint hinterlegt?
Die Einbindung des Teams-Webhooks erfolgt im YAML-Editor des Blueprints in zwei bzw. drei Schritten:
-
Zentrale Webhook-URL für Rückfragen hinterlegen (
inquiryWebhookUrl): Tragen Sie die aus Power Automate kopierte HTTP-POST-URL auf der obersten Ebene (Root-Ebene) des Blueprints unter der EigenschaftinquiryWebhookUrlein. Diese URL gilt für alle Rückfragen und Antworten innerhalb dieses Workflows:yamlid: ER-MBCOM version: 4 # Zentraler Teams-Webhook für alle Rückfragen dieses Workflows: inquiryWebhookUrl: "https://prod-12.westeurope.logic.azure.com/workflows/..." -
Rückfragen auf Bearbeitungsschritten aktivieren (
allowInquiry: true): Damit Bearbeiter bei einer anstehenden Aufgabe die Schaltfläche Rückfrage sehen und nutzen können, aktivieren Sie auf den gewünschten Bearbeitungsschritten (UserStep) die EigenschaftallowInquiry: true:yamlsteps: - name: freigabe_einkauf stepType: UserStep group: Einkauf allowInquiry: true # Aktiviert die Rückfrage-Option im Portal -
Optional: Teams-Kanal-Webhook pro Schritt (
teamsWebhookUrl): Möchten Sie zusätzlich beim Eintritt in einen bestimmten Schritt ein gesamtes Team in einem Teams-Kanal informieren, tragen Sie die Webhook-URL des Kanals unterteamsWebhookUrldirekt am Schritt ein:yamlsteps: - name: freigabe_einkauf stepType: UserStep group: Einkauf # Optional: E-Mail und Teams-Kanal parallel benachrichtigen notificationEmail: "einkauf@firma.de" teamsWebhookUrl: "https://outlook.office.com/webhook/..." allowInquiry: true
Technische Details & Schemas
Detaillierte Spezifikationen zu den JSON-Payloads für HTTP-Trigger und Adaptive Cards in Teams finden Sie in der Technischen Referenz: Technische Referenz: Notifikationen & Teams-Webhooks
6. Konfigurationstest durchführen
Bevor die Workflow-Komponente aktiviert wird, sollte die Konfiguration über den integrierten Konfigurationstest überprüft werden.
- Wechseln Sie im Portal zur Workflow-Übersicht (Administration > Workflow).
- Klappen Sie die Karte Konfigurationstest auf.
- Klicken Sie auf Test starten.
Was wird geprüft?
Der Konfigurationstest führt eine grundlegende Validierung der Systemumgebung durch und prüft, ob alle beteiligten Komponenten und Dienste ordnungsgemäß miteinander kommunizieren können. Die Karte listet folgende Prüfungen einzeln mit Ergebnis und Hinweis:
| Prüfung | Was geprüft wird |
|---|---|
| Datenbank | Die Workflow-Datenbank ist erreichbar. |
| Konfiguration | Die gespeicherte Workflow-Konfiguration des Mandanten ist lesbar. |
| trade-Verbindung | Der Workflow-Dienst kann trade (Vorgänge) erreichen. |
| HR-Verbindung | Der Workflow-Dienst kann HR (Gruppen) erreichen. |
| Blueprints | Alle Blueprints bestehen die Prüfung (Vorgangsarten, Feldnamen, Bedingungen, Gruppen). Sind keine Blueprints angelegt, erscheint eine Warnung. |
| Benachrichtigungsdienst | Der Benachrichtigungsdienst (comms) ist erreichbar. |
Testergebnis auswerten
- Konfiguration ist gültig (grün): Alle Prüfungen sind erfolgreich. Die Komponente kann aktiviert werden.
- Die Konfiguration enthält Fehler (rot): Mindestens ein Dienst ist nicht erreichbar oder ein Blueprint ist fehlerhaft. Prüfen Sie in diesem Fall die angezeigten Detailhinweise (bei Blueprints stehen die Einzelheiten im Workflow-Editor) sowie die Voraussetzungen.
7. Workflow-Automatisierung aktivieren & testen
Nachdem alle Blueprints konfiguriert und der Konfigurationstest erfolgreich bestanden wurde, schalten Sie die Komponente aktiv.
Aktivierung im Portal
- Scrollen Sie nach oben zur Karte Workflow Automatisierung.
- Stellen Sie den Schalter von Deaktiviert auf Aktiviert.
- Klicken Sie in der Kopfzeile auf Speichern. Die Workflow-Engine ist nun für diesen Mandanten aktiv.
End-to-End-Funktionstest durchführen
Führen Sie zur Freigabe einen realen Testdurchlauf durch:
- Vorgang bereitstellen:
- Legen Sie in trade einen Testvorgang an (z. B. eine Eingangsrechnung) oder wählen Sie einen vorhandenen, der Vorgangsart, Status und Trigger-Bedingung des Blueprints erfüllt.
- Start abwarten:
- Der Workflow startet automatisch durch Hintergrund-Polling (ca. 60 Sekunden). Der Vorgang ist danach in trade gesperrt und zeigt Im Workflow.
- Aufgabe im Portal prüfen:
- Öffnen Sie im ConnectCLOUD Portal die Aufgabenübersicht.
- Die Aufgabe muss unter Aufgaben der Gruppe für die berechtigte Gruppe sichtbar sein.
- Übernehmen Sie die Aufgabe und prüfen Sie, ob alle Vorgangsdaten und das PDF korrekt angezeigt werden.
- Betätigen Sie eine Entscheidungs-Schaltfläche (z. B. Freigabe).
- Rückschreibung in trade kontrollieren:
- Kontrollieren Sie den Vorgang in trade:
metadata.workflow.statewechselt aufAPPROVED(bzw.REJECTED), der Vorgang ist wieder bearbeitbar und das Kennzeichen Im Workflow verschwindet.- Die Entscheidung steht im Verlauf der Aufgabe im Portal.
Weiterführende Referenzen & Nächste Schritte
Weiterführende Dokumentation
- Anwenderhandbuch: ConnectWORKFLOW im Arbeitsalltag: Anleitung für Anwender zur täglichen Aufgabenübernahme, Freigabe, Rückfragen und Bearbeitungshistorie.
- Technische Referenz: Workflow Blueprint: Vollständige Spezifikation, JSON/YAML-Eigenschaften, Expr-Bedingungen und Praxisbeispiel.
- Technische Referenz: Notifikationen & Teams-Webhooks: Einrichtung von Microsoft Power Automate Flows und Teams Adaptive Cards.
- Technische Referenz: Workflowinstanz & Lebenszyklus: Polling-Mechanismen, Timeouts (Auto-Release nach 24h), Sperrungen und Fehlerbehandlung.
- Technische Referenz: trade-Integration: Vorgangsabfrage, Statusrückschreibung und Sperre des Vorgangs.
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/products/workflow/tenant-config/workflow-portal-config