Erstellen von Workflow-Modellen creating-workflow-models
Sie erstellen ein Workflow-Modell, um die Schritte zu definieren, die beim Starten des Workflows ausgeführt werden. Sie können auch Modelleigenschaften definieren, um beispielsweise festzulegen, ob es sich um einen Übergangs-Workflow oder einen Workflow mit mehreren Ressourcen handelt.
Wenn eine Benutzerin bzw. ein Benutzer einen Workflow startet, wird eine Instanz gestartet. Dies ist das entsprechende Laufzeitmodell, das erstellt wird, wenn Sie Ihre Änderungen synchronisieren.
Erstellen eines neuen Workflows creating-a-new-workflow
Wenn Sie ein Workflow-Modell neu erstellen, enthält es zunächst:
- Die Schritte Fluss-Start und Fluss-Ende.
Diese stellen den Anfang und das Ende des Workflows dar. Diese Schritte sind erforderlich und können nicht bearbeitet bzw. entfernt werden. - Ein Teilnehmer-Beispielschritt namens Schritt 1.
Dieser Schritt ist so konfiguriert, dass er dem Workflow-Initiator ein Arbeitselement zuordnet. Sie können diesen Schritt nach Bedarf bearbeiten oder löschen und Schritte hinzufügen.
So erstellen Sie einen Workflow mit dem Editor:
- Öffnen Sie die Workflow-Modelle-Konsole über Tools > Workflow > Modelle oder beispielsweise über: https://localhost:4502/aem/workflow
- Wählen Sie Erstellen und dann Modell erstellen aus.
- Das Dialogfeld Arbeitsablaufmodell hinzufügen wird angezeigt. Geben Sie Titel und Namen (optional) ein, bevor Sie Fertig auswählen.
- Das neue Modell wird nun in der Workflow-Modelle-Konsole aufgeführt.
- Wählen Sie Ihren neuen Workflow aus und öffnen Sie ihn dann, indem Sie auf Bearbeiten klicken, um ihn zu konfigurieren:
/var/workflow/models
/var/workflow/models/prototypes
Bearbeiten eines Workflows editing-a-workflow
Sie können jedes vorhandene Workflow-Modell bearbeiten, um:
- Schritte und ihre Parameter zu definieren
- Workflow-Eigenschaften zu konfigurieren, einschließlich Phasen, ob der Workflow vorübergehend ist und/oder ob er mehrere Ressourcen verwendet
Das Bearbeiten eines (vordefinierten) Standard- bzw. Legacy-Workflows umfasst einen zusätzlichen Schritt, um sicherzustellen, dass eine sichere Kopie erstellt wird, bevor Sie Änderungen vornehmen.
Wenn Aktualisierungen Ihres Workflows abgeschlossen sind, müssen Sie Synchronisieren verwenden, um ein Laufzeitmodell zu generieren. Siehe Synchronisieren eines Workflows, um Details zu erfahren.
Workflow synchronisieren – Laufzeitmodell generieren sync-your-workflow-generate-a-runtime-model
Synchronisieren (direkt in der Editor-Symbolleiste) generiert ein Laufzeitmodell. Das Laufzeitmodell ist das Modell, das tatsächlich verwendet wird, wenn eine Benutzerin bzw. ein Benutzer einen Workflow startet. Wenn Sie Ihre Änderungen nicht durch Klicken auf Sync synchronisieren, stehen diese nicht zur Laufzeit zur Verfügung.
Wenn Sie (oder eine andere Person) Änderungen am Workflow vornehmen, müssen Sie Synchronisieren verwenden, um ein Laufzeitmodell zu generieren – selbst wenn einzelne Dialogfelder (z. B. für Schritte) eigene Speicheroptionen hatten.
Wenn die Änderungen mit dem (gespeicherten) Laufzeitmodell synchronisiert sind, wird stattdessen Synchronisiert angezeigt.
Einige Schritte verfügen über obligatorische Felder und/oder eine integrierte Validierung. Wenn diese Bedingungen nicht erfüllt sind, wird ein Fehler angezeigt, wenn Sie versuchen, das Modell zu synchronisieren. Etwa wenn für einen Teilnehmer-Schritt kein Teilnehmer definiert wurde:
Erstmalige Bearbeitung eines Standard- oder Legacy-Workflows editing-a-default-or-legacy-workflow-for-the-first-time
Wenn Sie ein Standard- bzw. Legacy-Modell zur Bearbeitung öffnen, finden Sie die folgenden Bedingungen vor:
-
Der Schritte-Browser (auf der linken Seite) ist nicht verfügbar.
-
Die Symbolleiste weist eine Option zum Bearbeiten auf (auf der rechten Seite).
-
Zunächst werden das Modell und seine Eigenschaften im schreibgeschützten Modus wie folgt dargestellt:
- Standard-Workflows befinden sich unter
/libs
. - Legacy-Workflows befinden sich unter
/etc
.
Durch Auswählen von Bearbeiten wird:
- Standard-Workflows befinden sich unter
-
eine Kopie des Workflows unter
/conf
gespeichert -
der Schritte-Browser verfügbar gemacht
-
es möglich, Änderungen vorzunehmen.
Hinzufügen eines Schritts zu einem Modell adding-a-step-to-a-model
Fügen Sie Ihrem Modell Schritte hinzu, um die auszuführende Aktivität zu repräsentieren. Jeder Schritt führt eine bestimmte Aktivität aus. Eine Auswahl von Schrittkomponenten ist in einer AEM-Standardinstanz verfügbar.
Wenn Sie ein Modell bearbeiten, werden die verfügbaren Schritte in den verschiedenen Gruppen des Schritte-Browsers angezeigt. Beispiel:
So fügen Sie Schritte zum Workflow-Modell hinzu:
-
Öffnen Sie ein vorhandenes Workflow-Modell zur Bearbeitung. Wählen Sie in der Workflow-Modelle-Konsole das gewünschte Modell aus und klicken Sie anschließend auf Bearbeiten.
-
Öffnen Sie den Schritte-Browser, indem Sie ganz links in der oberen Symbolleiste das Seitenbedienfeld umschalten. Folgende Informationen/Optionen sind verfügbar:
- Nach bestimmten Schritten filtern.
- Verwenden Sie das Dropdown-Menü, um die Auswahl auf eine bestimmte Gruppe von Schritten zu begrenzen.
- Über das Symbol zum Anzeigen von Breschreibungen können Sie weitere Informationen zum jeweiligen Schritt anzeigen.
-
Ziehen Sie die entsprechenden Schritte an die gewünschte Position im Modell.
Beispiel: ein Teilnehmer-Schritt.
Nachdem Sie ihn zum Workflow hinzugefügt haben, können Sie den Schritt konfigurieren.
-
Fügen Sie nach Bedarf beliebig viele Schritte oder andere Aktualisierungen hinzu.
Zur Laufzeit werden die Schritte in der Reihenfolge ausgeführt, in der sie im Modell angezeigt werden. Nachdem Sie Schrittkomponenten hinzugefügt haben, können Sie sie an eine andere Position im Modell ziehen.
Sie können auch vorhandene Schritte kopieren, ausschneiden, einfügen, gruppieren oder löschen, wie mit dem Seiteneditor.
Unterteilte Schritte können auch mithilfe der Symbolleistenoption ein- oder ausgeblendet werden.
-
Bestätigen Sie Ihre Änderungen, indem Sie in der Editor-Symbolleiste auf Sync klicken, um das Laufzeitmodell zu generieren.
Details finden Sie unter Synchronisieren eines Workflows.
Konfigurieren eines Workflow-Schritts configuring-a-workflow-step
Sie können das Verhalten von Workflow-Schritten über das Dialogfeld Schritt-Eigenschaften konfigurieren und anpassen.
-
So öffnen Sie das Dialogfeld Schritt-Eigenschaften für einen Schritt:
-
Klicken Sie auf den **-Schritt im Workflow-Modell und wählen Sie in der Komponenten-Symbolleiste die Option Konfigurieren aus.
-
Doppelklicken Sie auf den Schritt.
note note NOTE Informationen zu den Komponenten des primären Schritts, die mit AEM installiert werden, finden Sie in der Referenz zu Workflow-Schritten. -
-
Konfigurieren Sie die Schritt-Eigenschaften nach Bedarf, wobei die verfügbaren Eigenschaften vom Schritttyp abhängen. Es können auch mehrere Registerkarten verfügbar sein. Beispiel: der standardmäßige Teilnehmer-Schritt, der in einem neuen Workflow als
Step 1
enthalten ist: -
Bestätigen Sie die Änderungen durch Klicken auf das Häkchen-Symbol.
-
Bestätigen Sie Ihre Änderungen, indem Sie in der Editor-Symbolleiste auf Sync klicken, um das Laufzeitmodell zu generieren.
Details finden Sie unter Synchronisieren eines Workflows.
Erstellen eines Übergangs-Workflows creating-a-transient-workflow
Sie können ein Übergangs-Workflow-Modell erstellen, wenn Sie ein neues Modell erstellen, oder indem Sie ein vorhandenes Modell bearbeiten:
-
Öffnen Sie das Workflow-Modell zum Bearbeiten.
-
Wählen Sie Workflow-Modelleigenschaften aus der Symbolleiste aus.
-
Aktivieren Sie im Dialogfeld das Kontrollkästchen Verlaufs-Workflow (bzw. deaktivieren Sie es, falls nötig):
-
Bestätigen Sie die Änderung mit Speichern und schließen und klicken Sie anschließend in der Editor-Symbolleiste auf Sync, um das Laufzeitmodell zu generieren.
Details finden Sie unter Synchronisieren eines Workflows.
Workflow-Modelle in der Touch-Benutzeroberfläche verfügbar machen classic2touchui
Befolgen Sie die Konfiguration, wenn ein Workflow-Modell der klassischen Benutzeroberfläche im Auswahl-Popup-Menü der Zeitleiste in der Touch-Benutzeroberfläche fehlt und verfügbar gemacht werden muss. Die folgenden Schritte zeigen die Verwendung des Workflow-Modells namens Aktivierungsanfrage.
-
Vergewissern Sie sich, dass das Modell nicht in der Touch-Benutzeroberfläche verfügbar ist. Greifen Sie über den Pfad
/assets.html/content/dam
auf ein Asset zu. Auswählen eines Assets. Öffnen Sie Zeitleiste in der linken Leiste. Klicken Sie auf Workflow starten und bestätigen Sie, dass das Aktivierungsanfrage-Modell nicht in der Popup-Liste vorhanden ist. -
Navigieren Sie wie folgt: Tools > Allgemein > Tagging. Wählen Sie Workflow.
-
Wählen Sie Erstellen > Tag erstellen. Legen Sie den Titel als
DAM
und den Namen alsdam
fest. Klicken Sie auf Übermitteln.
-
Gehen Sie zu Tools > Workflow > Modelle. Wählen Sie Aktivierungsanfrage aus und wählen Sie dann Bearbeiten.
-
Klicken Sie auf Bearbeiten und öffnen Sie das Menü Seiteninformationen. Von dort wählen Sie Eigenschaften öffnen und gehen Sie zur Registerkarte Allgemein (falls noch nicht geöffnet).
-
Fügen Sie
Workflow : DAM
zum Feld Tags hinzu. Bestätigen Sie die Auswahl mit dem Häkchen. -
Bestätigen Sie das Hinzufügen des Tags mit Speichern und schließen.
-
Schließen Sie den Prozess mit Synchronisieren ab. Der Workflow ist jetzt in der Touch-optimierten Benutzeroberfläche verfügbar.
Konfigurieren eines Workflows für die Unterstützung mehrerer Ressourcen configuring-a-workflow-for-multi-resource-support
Sie können ein Workflow-Modell für die Unterstützung mehrerer Ressourcen konfigurieren, wenn Sie ein neues Modell erstellen oder ein vorhandenes Modell bearbeiten:
-
Öffnen Sie das Workflow-Modell zum Bearbeiten.
-
Wählen Sie Workflow-Modelleigenschaften aus der Symbolleiste aus.
-
Aktivieren Sie im Dialogfeld das Kontrollkästchen Unterstützung für mehrere Ressourcen (bzw. deaktivieren Sie es, falls nötig):
-
Bestätigen Sie die Änderung mit Speichern und schließen und klicken Sie anschließend in der Editor-Symbolleiste auf Sync, um das Laufzeitmodell zu generieren.
Details finden Sie unter Synchronisieren eines Workflows.
Konfigurieren der Workflow-Phasen (die den Workflow-Fortschritt anzeigen) configuring-workflow-stages-that-show-workflow-progress
Die Workflow-Phasen sind hilfreich, um den Fortschritt eines Workflows beim Ausführen von Aufgaben anzuzeigen.
Die verfügbaren Phasen werden in den Workflow-Modellen definiert. Bestehende Workflow-Modelle können aktualisiert werden, um Statusdefinitionen einzuschließen. Sie können eine beliebige Anzahl von Phasen für das Workflow-Modell definieren.
Phasen, die für Ihren Workflow definiert werden müssen:
-
Öffnen Sie Ihr Workflow-Modell zum Bearbeiten.
-
Wählen Sie Workflow-Modelleigenschaften aus der Symbolleiste aus. Öffnen Sie dann die Registerkarte Phasen.
-
Fügen Sie Ihre benötigten Phasen hinzu (und positionieren Sie sie). Sie können eine beliebige Anzahl von Phasen für das Workflow-Modell definieren.
Beispiel:
-
Klicken Sie auf Speichern und schließen, um die Änderungen zu speichern.
-
Weisen Sie jedem Schritt im Workflow-Modell eine Phase zu. Beispiel:
Eine Phase kann mehreren Schritten zugewiesen werden. Beispiel:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Schritt Staging Schritt 1 Erstellen Schritt 2 Erstellen Schritt 3 Überprüfung Schritt 4 Genehmigen Schritt 5 Genehmigen Schritt 6 Fertig stellen -
Bestätigen Sie Ihre Änderungen, indem Sie in der Editor-Symbolleiste auf Sync klicken, um das Laufzeitmodell zu generieren.
Details finden Sie unter Synchronisieren eines Workflows.
Exportieren eines Workflow-Modells in ein Paket exporting-a-workflow-model-in-a-package
Gehen Sie folgendermaßen vor, um ein Workflow-Modell in ein Paket zu exportieren:
-
Erstellen Sie ein neues Paket mit Package Manager:
-
Navigieren Sie zum Package Manager über Tools, Implementierung, Pakete.
-
Klicken Sie auf Paket erstellen.
-
Geben Sie den Paketnamen und ggf. weitere Details an.
-
Klicken Sie auf OK.
-
-
Klicken Sie in der Symbolleiste Ihres neuen Pakets auf Bearbeiten.
-
Öffnen Sie die Registerkarte Filter.
-
Wählen Sie Filter hinzufügen und geben Sie den Pfad zum Design Ihres Workflow-Modells ein:
/conf/global/settings/workflow/models/<*your-model-name*>
Klicken Sie auf Fertig.
-
Wählen Sie Filter hinzufügen aus und geben Sie den Pfad Ihres Laufzeit-Workflow-Modells ein:
/var/workflow/models/<*your-model-name*>
Klicken Sie auf Fertig.
-
Fügen Sie zusätzliche Filter für benutzerdefinierte Skripte hinzu, die von Ihrem Modell verwendet werden.
-
Klicken Sie auf Speichern, um Ihre Filterdefinitionen zu bestätigen.
-
Wählen Sie Build in der Symbolleiste Ihrer Paketdefinition aus.
-
Wählen Sie Herunterladen aus der Paketsymbolleiste aus.
Verwenden von Workflows zur Verarbeitung von Formularübermittlungen using-workflows-to-process-form-submissions
Sie können ein Formular konfigurieren, das vom ausgewählten Workflow verarbeitet werden soll. Wenn Benutzer das Formular übermitteln, wird eine neue Workflow-Instanz mit den Daten der Formularübermittlung als Payload erstellt.
So konfigurieren Sie den Workflow für Ihr Formular:
-
Erstellen Sie eine Seite und öffnen Sie sie zur Bearbeitung.
-
Fügen Sie eine Formularkomponente zu der Seite hinzu.
-
Konfigurieren Sie die Formular-Start-Komponente, die auf der Seite angezeigt wurde.
-
Wählen Sie mithilfe von Workflow starten den gewünschten Workflow aus den verfügbaren Optionen aus:
-
Bestätigen Sie die neue Formularkonfiguration mit dem Häkchen.
Testen von Workflows testing-workflows
Beim Testen eines Workflows ist es sinnvoll, verschiedene Payload-Typen zu verwenden, auch solche, die sich von denen unterscheiden, für die der Workflow entwickelt wurde. Wenn Sie beispielsweise möchten, dass Ihr Workflow für die Verwendung mit Assets ausgelegt ist, testen Sie ihn, indem Sie eine Seite als Payload festlegen und sicherstellen, dass keine Fehler auftreten.
Testen Sie Ihren neuen Workflow beispielsweise wie folgt:
-
Starten Sie Ihr Workflow-Modell über die Konsole.
-
Definieren Sie die Payload und bestätigen Ihre Eingaben.
-
Ergreifen Sie die erforderlichen Maßnahmen, damit der Workflow fortgesetzt wird.
-
Überwachen Sie die Protokolldateien während der Ausführung des Workflows.
Sie können auch AEM so konfigurieren, dass DEBUG-Meldungen in den Protokolldateien angezeigt werden. Weitere Informationen finden Sie unter Protokollierung. Wenn die Entwicklung abgeschlossen ist, legen Sie die Einstellung für die Protokollebene wieder auf Informationen fest.
Beispiele examples
Beispiel: Erstellen eines (einfachen) Workflows, um eine Anfrage zur Veröffentlichung zu akzeptieren oder abzulehnen example-creating-a-simple-workflow-to-accept-or-reject-a-request-for-publication
Um einige der Möglichkeiten zur Erstellung eines Workflows zu veranschaulichen, wird im folgenden Beispiel eine Variante des Workflows Publish Example
erstellt.
-
Erstellen Sie ein Workflow-Modell.
Der neue Workflow enthält:
- Flussstart
Step 1
- Prozessende
-
Löschen Sie
Step 1
(da es sich um den falschen Schritttyp für dieses Beispiel handelt):- Klicken Sie auf den Schritt und klicken Sie in der Komponenten-Symbolleiste auf Löschen. Bestätigen Sie die Aktion.
-
Ziehen Sie aus der Workflow-Auswahl des Schritte-Browsers einen Teilnehmer-Schritt auf den Workflow und positionieren Sie ihn zwischen Fluss-Start und Fluss-Ende.
-
Führen Sie zum Öffnen des Dialogfelds „Eigenschaften“ einen der folgenden Schritte durch:
- Klicken Sie auf den Teilnehmer-Schritt und klicken Sie in der Komponenten-Symbolleiste auf Konfigurieren.
- Doppelklicken Sie auf den Teilnehmer-Schritt.
-
Geben Sie auf der Registerkarte Allgemein
Validate Content
als Titel und Beschreibung ein. -
Öffnen Sie die Registerkarte Benutzer/Gruppe:
- Aktivieren Sie Benutzer per E-Mail benachrichtigen.
- Wählen Sie für das Feld Benutzer/Gruppe die Option
Administrator
(admin
) aus.
note note NOTE Damit E-Mails gesendet werden, müssen der E-Mail-Dienst und die Benutzerkontodetails konfiguriert werden. -
Bestätigen Sie die Änderungen durch Klicken auf das Häkchen-Symbol.
Daraufhin wird wieder die Übersicht über das Workflow-Modell angezeigt. Der Teilnehmer-Schritt ist nun in
Validate Content
umbenannt. -
Ziehen Sie eine ODER-Teilung auf den Workflow und positionieren Sie sie zwischen
Validate Content
und Fluss-Ende. -
Öffnen Sie die ODER-Teilung für die Konfiguration.
-
Konfigurieren:
-
Allgemein: Geben Sie den Teilungsnamen an.
-
Verzweigung 1: Wählen Sie Standardroute aus.
-
Verzweigung 2: Stellen Sie sicher, dass Standardroute nicht ausgewählt ist.
-
-
Bestätigen Sie die Änderungen an der ODER-Teilung.
-
Ziehen Sie einen Teilnehmerschritt per Drag-and-Drop auf den rechten Zweig, öffnen Sie die Eigenschaften, geben Sie die folgenden Werte an und bestätigen Sie die Änderungen:
-
Titel:
Reject Publish Request
-
Benutzer/Gruppe: z. B.
projects-administrators
-
Benachrichtigen des Benutzers per E-Mail: Aktivieren Sie dieses Kontrollkästchen, damit die Benutzer per E-Mail benachrichtigt werden.
-
-
Ziehen Sie einen Prozessschritt auf den rechten Zweig, öffnen Sie die Eigenschaften, geben Sie die folgenden Werte an und bestätigen Sie die Änderungen:
-
Titel:
Publish Page as Requested
-
Prozess: Wählen Sie
Activate Page
aus. Durch diesen Prozess wird die ausgewählte Seite in den Veröffentlichungsinstanzen veröffentlicht.
-
-
Klicken Sie auf Synchronisieren (Editor-Symbolleiste), um das Laufzeitmodell zu generieren.
Details finden Sie unter Synchronisieren eines Workflows.
Ihr neues Workflow-Modell sieht wie folgt aus:
-
Wenden Sie diesen Workflow auf Ihre Seite an, sodass Benutzer, die zur Phase Fertig stellen übergehen, den Schritt Inhalt überprüfen auswählen können, egal ob sie die Seite wie angefordert veröffentlichen oder die Anfrage zur Veröffentlichung ablehnen möchten.
Beispiel: Definieren einer Regel für eine ODER-Teilung per ECMA-Skript defineruleecmascript
Mit Schritten von ODER-Teilung können Sie bedingte Verarbeitungspfade in Ihren Workflow einführen.
Um eine ODER-Regel zu definieren, gehen Sie wie folgt vor:
-
Erstellen Sie zwei Skripte und speichern Sie sie im Repository, z. B. unter:
/apps/myapp/workflow/scripts
note note NOTE Die Skripte müssen eine Funktion check()
aufweisen, die einen booleschen Wert zurückgibt. -
Bearbeiten Sie den Workflow und fügen Sie die ODER-Teilung zum Modell hinzu.
-
Bearbeiten Sie die Eigenschaften von Verzweigung 1 der ODER-Teilung:
-
Definieren Sie dies als Standardroute, indem Sie den Wert auf
true
festlegen. -
Geben Sie für Regel den Pfad zum Skript an. Beispiel:
/apps/myapp/workflow/scripts/myscript1.ecma
note note NOTE Sie können die Reihenfolge der Verzweigungen ggf. ändern. -
-
Bearbeiten Sie die Eigenschaften von Zweig 2 der ODER-Teilung:
- Geben Sie für Regel den Pfad zum anderen Skript an. Beispiel:
/apps/myapp/workflow/scripts/myscript2.ecma
- Geben Sie für Regel den Pfad zum anderen Skript an. Beispiel:
-
Legen Sie die Eigenschaften der einzelnen Schritte in jedem Zweig fest. Stellen Sie sicher, dass die Einstellung für Benutzer/Gruppe festlegt ist.
-
Klicken Sie auf Synchronisieren (Editor-Symbolleiste), um Ihre Änderungen am Laufzeitmodell beizubehalten.
Details finden Sie unter Synchronisieren eines Workflows.
Function Check() function-check
Das folgende Beispielskript gibt true
zurück, wenn es sich bei dem Knoten um einen JCR_PATH
unter /content/we-retail/us/en
handelt:
function check() {
if (workflowData.getPayloadType() == "JCR_PATH") {
var path = workflowData.getPayload().toString();
var node = jcrSession.getItem(path);
if (node.getPath().indexOf("/content/we-retail/us/en") >= 0) {
return true;
} else {
return false;
}
} else {
return false;
}
}
Beispiel: Benutzerdefinierte Aktivierungsanfrage example-customized-request-for-activation
Sie können jeden vordefinierten Workflow anpassen. Um ein benutzerdefiniertes Verhalten zu erhalten, überlagern Sie Details des entsprechenden Workflows.
Beispiel: Aktivierungsanfrage. Dieser Workflow wird zum Veröffentlichen von Seiten in Sites verwendet und wird automatisch ausgelöst, wenn eine Inhaltsautorin oder ein Inhaltsautor nicht über die entsprechenden Replikationsrechte verfügt. Weitere Informationen finden Sie unter Anpassen der Seitenbearbeitung – Anpassen des Workflows „Aktivierungsanfrage“.