Einen Workflow ausführen
Sie können eine vollständige Workflow-Ausführung starten, indem Sie in der Hierarchie Workflows auf das Symbol „Ausführen“ klicken oder im Menü Aktionen eines bestimmten Workflows Run All wählen.
Sie können auch oben in der Workflow-Tabelle auf die Schaltfläche Toggle Start/Stop klicken. Mit dieser Umschalttaste beenden Sie einen laufenden Workflow oder starten einen Workflow.
Wenn Sie bei einem Workflow, der bereits läuft, auf Ausführen klicken, weist PlaidCloud Sie darauf hin, anstatt eine zweite Ausführung zu starten.
Einen Buchungsmodus wählen
Abschnitt betitelt „Einen Buchungsmodus wählen“Jede Ausführung hat einen ERP-Buchungsmodus. Um in PlaidCloud einen Modus zu wählen, verwenden Sie Mit Buchungsmodus ausführen im Kontextmenü eines Workflows oder die Schaltfläche für den Ausführungsmodus auf der Arbeitsfläche des Workflows; Workflow starten oder Workflow ausführen ohne Moduswahl fordert Live an, weiterhin begrenzt durch die unten beschriebene Obergrenze des Projekts. Sie können den Modus auch wählen, wenn Sie eine Ausführung über die Run-API oder den Assistenten starten.
| Modus | Was geschieht |
|---|---|
| Live | Buchungsschritte buchen genau so, wie sie es immer getan haben. Dies ist der Standard. |
| Simulate | Jeder ERP-Buchungsschritt erstellt und validiert genau das, was er buchen würde, schreibt dann aber nichts fest und kontaktiert das ERP nie. Die Buchungen, die gebucht würden, werden erfasst, sodass Sie sie prüfen können, bevor Sie live ausführen: die eines Schritts Belege buchen im Buchungsregister als Würde gebucht (siehe Belege in ERP-Systemen buchen), die des eigenen Buchungsschritts eines Systems in der ERP-Buchungshistorie, als simuliert gekennzeichnet. |
| Off | Buchungsschritte werden vollständig übersprungen. |
Ein Projekt hat außerdem eine eigene Obergrenze für den Buchungsmodus. Sie wird über die Projekt-API oder den Assistenten von jedem Mitglied mit Schreibzugriff auf ein entsperrtes Projekt festgelegt. Die Obergrenze macht eine Ausführung immer nur sicherer, nie freizügiger: Der wirksame Modus einer Ausführung ist der restriktivere aus dem von Ihnen gewählten Modus und der Obergrenze des Projekts. Ein Projekt mit der Obergrenze Simulate bleibt also simuliert, auch wenn Sie die Ausführung als Live starten.
Ein geplantes Ereignis behält seinen eigenen Buchungsmodus. Ein Zeitplan, der auf Simulate gesetzt ist, läuft daher bei jeder Auslösung simuliert.
Der Modus gilt für alles, was die Ausführung berührt. Ein Unter-Workflow, ein Makro sowie ein Run Model-, Conditional Run Model- oder Loop Model-Schritt übernehmen alle den Modus der übergeordneten Ausführung, ebenso eine Ausführung, die Sie nach einem Beenden fortsetzen — eine simulierte Ausführung kann an keiner Stelle in sich selbst real buchen.
Das Projekt zum Buchen autorisieren
Abschnitt betitelt „Das Projekt zum Buchen autorisieren“Ein Workflow bucht in einem ERP als das Projekt, nicht als die Person, die ihn gestartet hat. Bevor eine Ausführung buchen kann, benötigt das Projekt eine Autorisierung für jede ERP-Verbindung und jede Umgebung, die seine Buchungsschritte verwenden. Ohne sie schlägt der Schritt mit der Meldung „This project isn’t authorized to post to connection …“ fehl und nennt die Verbindung und die Umgebung. Die Schritte Call SAP Financial Document Attachment, Call SAP Master Data Table RFC und Call SAP RFC benötigen keine Autorisierung.
Um ein Projekt zu autorisieren, öffnen Sie seine Startseite und wählen unter ERP-Buchung den Eintrag ERP-Schreibautorisierungen. Jede Zeile steht für eine Verbindung in einer Umgebung. Aktivieren Sie Autorisiert, damit das Projekt dort buchen darf, oder deaktivieren Sie das Kontrollkästchen, um dies zu beenden. Autorisiert von und Autorisiert am zeigen, wer die Autorisierung zuletzt erteilt hat und wann.
- Die Schaltfläche wird den Architects des Projekts und den Workspace-Administratoren angezeigt, aber nur ein Architect kann eine Autorisierung ändern, und nur solange das Projekt entsperrt ist. Ein Workspace-Administrator, der kein Architect ist, kann sich zuvor selbst als Architect hinzufügen.
- Wenn Sie eine Zeile auswählen, um sie zu autorisieren oder die Autorisierung zu entziehen, wird die Liste nicht neu geladen: Die Bildlaufposition und eine von Ihnen gewählte Spaltensortierung bleiben erhalten. Die Größe des Fensters kann geändert werden, und der Hinweis zu öffentlichen Projekten wird vollständig umbrochen.
- Um eine Verbindung zu autorisieren, benötigen Sie auch selbst Schreibzugriff darauf: Sie sind ihr Eigentümer, oder sie wird namentlich oder über eine Ihrer Sicherheitsgruppen für Sie freigegeben. Eine Verbindung, die auf Alle Arbeitsbereichsmitglieder gesetzt ist, zählt nicht.
- Ein Projekt, das auf Alle Arbeitsbereichsmitglieder gesetzt ist, wird wie jedes andere autorisiert. Jedes Mitglied ist Architect des Projekts, sodass jedes Mitglied mit Schreibzugriff auf eine Verbindung das Projekt dafür autorisieren kann. Sobald es autorisiert ist, kann jedes Mitglied aus den Workflows des Projekts in diese Verbindung buchen, und das Fenster weist oberhalb des Rasters darauf hin.
- Eine neue Kopie, die nur für Sie privat ist und mit Tabellendaten oder Dimensionselementen erstellt wurde, übernimmt die Autorisierungen der Quelle, die Sie selbst erteilen könnten, und startet in Simulate, wenn die Quelle Live war — siehe ERP-Schreibautorisierungen in der Kopie. Jede andere Kopie und jedes aus einem Projektarchiv erstellte Projekt startet ohne Autorisierungen. Autorisieren Sie es, bevor es bucht.
Den Status eines Schritts verfolgen
Abschnitt betitelt „Den Status eines Schritts verfolgen“Während ein Workflow läuft, zeigt jeder Schritt ein Statussymbol, das anzeigt, wo er steht, zusammen mit seiner bisherigen Laufzeit. Bewegen Sie den Mauszeiger über das Symbol, um die zugehörige Meldung zu sehen.
| Status | Bedeutung |
|---|---|
| Waiting | Der Schritt steht in der Warteschlange und hat noch nicht begonnen. |
| Running | Der Schritt arbeitet, und seine Dauer läuft hoch. |
| Completed | Der Schritt wurde erfolgreich abgeschlossen. |
| Warning | Der Schritt wurde abgeschlossen, hat aber etwas gemeldet, das im Workflow-Protokoll lesenswert ist. |
| Error | Der Schritt ist fehlgeschlagen. Siehe Schrittfehler verwalten. |
| Skipped | Der Schritt wurde übergangen — er ist deaktiviert, oder seine Ausführungsbedingungen waren nicht erfüllt. Siehe Schritte in einem Workflow überspringen. |
| Continued | Der Schritt ist fehlgeschlagen, ist aber so eingestellt, dass er bei einem Fehler fortfährt, sodass der Workflow weitergelaufen ist. Siehe Bei Fehler fortfahren. |
| Stopped | Die Ausführung wurde beendet, bevor der Schritt abgeschlossen werden konnte. |
| Abandoned | Die Ausführung des Schritts wurde unterbrochen, sodass er nie abgeschlossen wird. Setzen Sie die Ausführung fort, oder führen Sie den Workflow erneut aus. |
Eine geöffnete Workflow-Ansicht aktualisiert sich im Verlauf einer Ausführung von selbst, sodass die Status, die Sie sehen, aktuell bleiben, ohne dass Sie die Seite neu laden müssen.
Abgebrochene Schritte
Abschnitt betitelt „Abgebrochene Schritte“Ein Schritt wird als abandoned (abgebrochen) markiert, wenn das, was ihn ausgeführt hat, mitten in der Ausführung weggefallen ist — meist weil jemand auf Beenden gedrückt hat oder weil eine Plattformwartung die Ausführung unterbrochen hat. Die Dauer des Schritts läuft nicht mehr weiter, und der QuickInfo-Text des Status erklärt, was geschehen ist.
Ein abgebrochener Schritt wurde nicht abgeschlossen und hat keine Ausgabe erzeugt. Er ist kein langsamer Schritt und auch kein Problem mit Ihren Daten oder Ihrer Konfiguration.
Um die Arbeit wieder aufzunehmen, setzen Sie die Ausführung fort — der abgebrochene Schritt wird erneut ausgeführt — oder führen Sie den gesamten Workflow erneut aus. Beides ist unbedenklich.
Unterbrochene Schritte
Abschnitt betitelt „Unterbrochene Schritte“Geht der Server, auf dem ein Schritt läuft, mitten in der Ausführung verloren, führt PlaidCloud den Schritt automatisch erneut aus, wenn eine Wiederholung sicher ist: Ein Schritt, der seine Ausgabe ersetzt, liefert dasselbe Ergebnis wie eine einzelne saubere Ausführung, sodass Sie nichts prüfen müssen. Das Protokoll des Schritts zeigt an der Stelle, an der der zweite Versuch beginnt, eine Warnung: „Restarted: the server running this step stopped before it finished (e.g. out of memory or a restart); running it again from the start.“
Ein Schritt, der nicht sicher wiederholt werden kann, wird nicht erneut ausgeführt. Er schlägt einmalig mit der Meldung interrupted (unterbrochen) fehl, weil eine zweite Ausführung das duplizieren könnte, was der erste Versuch bereits geschrieben hat. Schritte, die Ausgaben mit {date} oder {date_iso} im Namen oder Pfad schreiben, gelten als nicht sicher wiederholbar, da eine erneute Ausführung auf einem anderen Datum landen könnte. Zur Wiederherstellung prüfen Sie das Ziel des Schritts auf das, was der erste Versuch geschrieben hat, bereinigen es bei Bedarf und führen den Schritt dann erneut aus oder wählen für die Ausführung Fortsetzen.
Schritte, die nie starten
Abschnitt betitelt „Schritte, die nie starten“Solange ein Schritt auf einen Worker wartet, lautet seine Statusmeldung „Waiting for a worker… N min. No import worker has picked this step up yet.“ (die Art des Workers entspricht dem Schritt, etwa Import oder Export). Die Meldung verschwindet, sobald die Arbeit beginnt.
Wenn der Job eines Schritts nie starten kann, schlägt der Schritt mit der Angabe des Grunds fehl, anstatt ewig zu warten:
| Ursache | Schlägt fehl nach etwa |
|---|---|
| Kein Worker übernimmt den Job eines Import- oder Dimensionsschritts | 40 Minuten |
| Der Pod des Schritts bleibt im Zustand Pending hängen | 20 Minuten |
| Das Image des Schritts kann nicht abgerufen werden | 5 Minuten |
| Für den Schritt wird kein Pod erstellt | 20 Minuten |
| Kein Runner übernimmt eine Connector-Synchronisierung (Singer) | 30 Minuten |
Die Meldung zur Connector-Synchronisierung nennt die Synchronisierung. Wenn ein Worker den Job gestartet hat und dann weggefallen ist, schlägt der Schritt ebenfalls fehl, mit einer Meldung, dass der Worker beendet wurde. Die Meldungen zu Import und Dimension lauten „Use Run from here to retry.“
Ausführungen, die nicht mehr reagieren
Abschnitt betitelt „Ausführungen, die nicht mehr reagieren“Eine Ausführung bleibt nie im Status Wird ausgeführt, wenn die Arbeit dahinter weggefallen ist. Geht der Server verloren, auf dem der Workflow läuft, endet die Ausführung als fehlgeschlagen. Eine Ausführung dauert höchstens 12 Stunden: Läuft sie zu diesem Zeitpunkt noch, schlägt sie mit „Run failed: still running at the 12-hour limit. Re-run the workflow.“ fehl.
Anhalten, Beenden und Fortsetzen
Abschnitt betitelt „Anhalten, Beenden und Fortsetzen“Während ein Workflow läuft, können Sie ihn anhalten, sodass laufende Schritte abgeschlossen werden und neue Schritte warten, oder beenden, wodurch die Schritte in der Warteschlange und alle noch laufenden Import- oder Export-Jobs abgebrochen werden, zusammen mit der Warehouse-Abfrage, die ein Export gerade gelesen hat. Import- und Dimensionsschritte, die noch in der Warteschlange standen, werden sauber abgebrochen, sodass sie spätere Importe und Dimensionsladevorgänge im Workspace nicht blockieren. Beenden stoppt außerdem die in der Warteschlange stehenden oder laufenden Connector-Synchronisierungen (Singer) des Workflows, sodass eine Synchronisierung nicht weiterläuft, nachdem der Workflow beendet wurde.
Ein Makro kann an mehreren Stellen gleichzeitig laufen, aufgerufen von anderen Workflows oder von einem Schritt Makro: Gleichzeitige Ausführung. Das Beenden des Makros beendet jede laufende Instanz davon. Das Beenden einer einzelnen Instanz beendet nur diese Instanz und das, was sie gestartet hat, und lässt den aufrufenden Workflow weiterlaufen; dasselbe gilt für einen Schritt Macro Concurrent, der eine nicht mehr reagierende Instanz aufgibt. Ein Makro, das nur innerhalb anderer Workflows läuft, wird in der Workflow-Liste als Wird ausgeführt angezeigt, wobei Beenden verfügbar ist, und wenn Sie es öffnen, sehen Sie für jeden Schritt den Status sowie die Start- und Endzeit aus seiner letzten Ausführung.
Fortsetzen nimmt eine angehaltene, beendete oder fehlgeschlagene Ausführung dort wieder auf, wo sie aufgehört hat, anstatt von vorn zu beginnen. Die Option steht zur Verfügung, wenn die letzte Ausführung eines Workflows im Zustand angehalten, beendet oder Fehler endete.
Was „dort, wo sie aufgehört hat“ bedeutet, hängt davon ab, wie der Workflow ausgeführt wird:
| Ausführung | Beim Fortsetzen |
|---|---|
| Serial | Startet bei dem Schritt neu, der beim Ende der Ausführung lief, und läuft von dort weiter. Liegt dieser Schritt in einer Gruppe, nimmt Fortsetzen die gesamte Gruppe der obersten Ebene auf, die ihn enthält: Schritte der Gruppe, die bereits erfolgreich abgeschlossen wurden, bleiben unberührt, die übrigen werden ausgeführt, und die Ausführung läuft nach der Gruppe weiter. |
| Parallel | Führt jeden Schritt erneut aus, der noch nicht erfolgreich abgeschlossen war, und lässt abgeschlossene Schritte unberührt. |
| Advanced (graph) | Führt den fehlgeschlagenen Knoten und alles, was noch auf ihn wartet, erneut aus und lässt abgeschlossene Knoten unberührt. |
Schritte, die einen anderen Workflow aufrufen — Run Model, Conditional Run Model und Loop Model — setzen den aufgerufenen Workflow fort, anstatt ihn neu zu starten, über beliebig viele Verschachtelungsebenen hinweg. Ein Schleifenschritt setzt die unterbrochene Iteration fort und überspringt die bereits abgeschlossenen Iterationen.
Wenn Sie einen Workflow fortsetzen, der als verschachtelter untergeordneter Workflow eines anderen lief — einen, den ein Run Model-Schritt in einem übergeordneten Workflow aufgerufen hat —, bietet PlaidCloud Von Kettenanfang fortsetzen an. Das alleinige Fortsetzen des untergeordneten Workflows kann die Orchestrierung des übergeordneten nicht weiterführen; diese Option setzt daher stattdessen den übergeordneten Workflow der obersten Ebene fort — die Wurzel der Kette — und führt die gesamte Kette dort weiter, wo sie angehalten hat. Das Fortsetzen eines Workflows der obersten Ebene bleibt unverändert. Der Kettenanfang wird innerhalb desselben Projekts ermittelt: Eine Kette, die in ein anderes Projekt hineinreicht, wird vom Anfang des Teils innerhalb des Projekts aus fortgesetzt.
Das Fortsetzen führt immer die ursprüngliche Ausführung weiter. Es führt jeden Schritt dieser Ausführung erneut aus, der nicht erfolgreich abgeschlossen wurde — ein fehlgeschlagener oder abgebrochener Schritt wird erneut ausgeführt und nicht als abgeschlossen behandelt —, und die zwischenzeitliche erneute Ausführung eines einzelnen Schritts ändert nicht, was das Fortsetzen als Nächstes aufnimmt. Das gilt auch für einen untergeordneten Workflow: Wenn Sie einen seiner Schritte einzeln erneut ausgeführt haben, führt das Fortsetzen des übergeordneten Workflows trotzdem alles aus, was im untergeordneten Workflow noch offen war, nicht nur diesen Schritt.
Eine fortgesetzte Ausführung wird als neue Ausführung im Ausführungsverlauf des Workflows erfasst und enthält nur die Schritte, die sie erneut ausgeführt hat. Die ursprüngliche Ausführung behält ihren eigenen Verlaufseintrag. Ruft eine Ausführung denselben untergeordneten Workflow mehrmals auf, erhält jeder Aufruf einen eigenen Eintrag im Ausführungsverlauf des untergeordneten Workflows. Die Iterationen eines Schleifenschritts zählen als ein Aufruf.