Variablen in AEM-Workflows variables-in-aem-workflows
Eine Variable in einem Workflow-Modell bietet die Möglichkeit, einen Wert basierend auf seinem Datentyp zu speichern. Sie können den Namen der Variablen in jedem Workflow-Schritt verwenden, um den in der Variablen gespeicherten Wert abzurufen. Sie können auch Variablennamen verwenden, um Ausdrücke für Routing-Entscheidungen zu definieren.
In AEM-Workflow-Modellen haben Sie folgende Möglichkeiten:
- Erstellen Sie eine Variable eines Datentyps basierend auf dem Typ von Information, die Sie darin speichern möchten.
- Legen Sie einen Wert für die Variable fest, indem Sie den Workflow-Schritt „Variable festlegen“ verwenden.
- Verwenden Sie die Variable in den Workflow-Schritten „ODER-Aufspaltung“ und „Goto“ von AEM zum Definieren eines Ausdrucks für Routing-Entscheidungen. In allen AEM Forms-Workflow-Schritten können Sie auch Variablen verwenden.
Das folgende Video zeigt, wie Sie Variablen in AEM-Workflow-Modellen erstellen, festlegen und verwenden können:
Variablen sind eine Erweiterung der MetaDataMap-Schnittstelle. Sie können MetaDataMap in ECMAScript verwenden, um auf Metadaten zuzugreifen, die mithilfe von Variablen gespeichert wurden.
Erstellen einer Variablen create-a-variable
Variablen erstellen Sie mithilfe des Abschnitts „Variablen“ im Sidekick des Workflow-Modells. AEM-Workflow-Variablen unterstützen die folgenden Datentypen:
Weitere komplexe Datentypen, die in AEM Forms-Workflows verfügbar sind, finden Sie unter Variablen in AEM Forms-Workflows. Verwenden Sie den Datentyp „ArrayList“, um Variablenauflistungen zu erstellen. Sie können eine ArrayList-Variable für alle primitiven und komplexen Datentypen erstellen. Beispiel: Erstellen Sie eine ArrayList-Variable und wählen Sie als Untertyp „String“ aus, um mehrere Zeichenfolgenwerte in der Variablen zu speichern.
Um eine Variable zu erstellen:
-
Navigieren Sie in einer AEM-Instanz zu „Tools“ > „Workflows“ > „Modelle“.
-
Wählen Sie Erstellen aus und geben Sie den Titel und einen optionalen Namen für das Workflow-Modell an. Wählen Sie das Modell und dann Bearbeiten aus.
-
Wählen Sie das Variablensymbol im Sidekick des Workflow-Modells und dann Variable hinzufügen aus.
-
Geben Sie im Dialogfeld „Variable hinzufügen“ den Namen an und wählen Sie den Typ der Variable aus.
-
Wählen Sie in der Dropdown-Liste Typ den Datentyp aus und geben Sie die folgenden Werte an:
- Primitiver Datentyp: Geben Sie einen optionalen Standardwert für die Variable an.
- JSON oder XML – Geben Sie einen optionalen JSON- oder XML-Schema-Pfad an. Das System überprüft den Schemapfad, während es die in diesem Schema verfügbaren Eigenschaften einer anderen Variablen zuordnet und speichert.
- Formulardatenmodell – Geben Sie einen Pfad für ein Formulardatenmodell an.
- ArrayList – Geben Sie einen Untertyp für die Auflistung an.
-
Geben Sie eine optionale Beschreibung für die Variable an und wählen Sie das
, um die Änderungen zu speichern. Die Variable wird in der im linken Bereich verfügbaren Liste angezeigt.
Berücksichtigen Sie beim Erstellen von Variablen die folgenden Punkte:
- Erstellen Sie so viele Variablen, wie ein Workflow erfordert. Allerdings sollten Sie, um Datenbankressourcen zu sparen, die Anzahl der Variablen auf das erforderliche Minimum beschränken und Variablen nach Möglichkeit wiederverwenden.
- Bei Variablen wird zwischen Groß- und Kleinbuchstaben unterschieden. Stellen Sie sicher, dass Sie in Ihrem Workflow immer mit identischer Groß- und Kleinschreibung auf Variablen verweisen.
- Verwenden Sie im Namen der Variablen keine Sonderzeichen.
Festlegen einer Variablen set-a-variable
Mit dem Schritt „Variable festlegen“ können Sie den Wert einer Variablen festlegen und die Reihenfolge definieren, in der die Werte festgelegt werden. Die Variable wird in der Reihenfolge festgelegt, in der die Variablenzuordnungen im Schritt „Variable festlegen“ aufgeführt sind.
Änderungen an Variablenwerten betreffen nur die Instanz des Prozesses, in dem die Änderung erfolgt. Wenn beispielsweise ein Prozess initiiert wird und Variablendaten geändert werden, betreffen die Änderungen nur diese Instanz des Prozesses. Die Änderungen wirken sich nicht auf andere Instanzen des Prozesses aus, die davor oder danach initiiert werden.
Je nach Datentyp der Variablen können Sie die folgenden Optionen verwenden, um den Wert einer Variablen festzulegen:
- Literal: Verwenden Sie die Option, wenn Sie den genauen Wert kennen, der angegeben werden soll.
- Ausdruck: Verwenden Sie die Option, wenn der zu verwendende Wert in einem Ausdruck berechnet wird. Der Ausdruck wird im bereitgestellten Ausdruckseditor erstellt.
- JSON-Punktnotation: Verwenden Sie die Option, um einen Wert aus einer Variablen vom Typ JSON oder FDM abzurufen.
- XPATH: Verwenden Sie die Option, um einen Wert aus einer Variablen vom Typ XML abzurufen.
- Relativ zur Payload: Verwenden Sie die Option, wenn der Wert, der in einer Variablen gespeichert werden soll, unter einem Pfad relativ zur Payload verfügbar ist.
- Absoluter Pfad: Verwenden Sie die Option, wenn der Wert, der in einer Variablen gespeichert werden soll, unter einem absoluten Pfad verfügbar ist.
Sie können bestimmte Elemente einer JSON- oder XML-Typvariablen auch mittels JSON-Punktnotation oder XPATH-Notation aktualisieren.
Hinzufügen einer Zuordnung zwischen Variablen add-mapping-between-variables
Gehen Sie wie folgt vor, um eine Zuordnung zwischen Variablen hinzuzufügen:
- Wählen Sie auf der Seite für das Bearbeiten des Workflows das Symbol „Schritte“ aus, das im Sidekick des Workflow-Modells verfügbar ist.
- Ziehen Sie den Schritt Variable festlegen per Drag-and-Drop in den Workflow-Editor, wählen Sie den Schritt und das
- Wählen Sie im Dialogfeld „Variable festlegen“ die Option Zuordnung > Zuordnung hinzufügen aus.
- Wählen Sie im Abschnitt Variable zuordnen die Variable aus, in der Daten gespeichert werden sollen, wählen Sie den Zuordnungsmodus aus und geben Sie einen Wert an, der in der Variablen gespeichert werden soll. Die Zuordnungsmodi variieren je nach Variablentyp.
- Ordnen Sie weitere Variablen zu, damit Sie einen aussagekräftigen Ausdruck bilden können. Wählen Sie das
Beispiel 1: Abfragen einer XML-Variablen, um den Wert für eine Zeichenfolgenvariable festzulegen example-query-an-xml-variable-to-set-value-for-a-string-variable
Wählen Sie eine Variable vom Typ XML aus, in der Sie eine XML-Datei speichern möchten. Fragen Sie die XML-Variable ab, um den Wert für eine Zeichenfolgenvariable für die in der XML-Datei verfügbare Eigenschaft festzulegen. Verwenden Sie das Feld XPATH für die XML-Variable angeben, um die Eigenschaft zu definieren, die in der Zeichenfolgenvariablen gespeichert werden soll.
In diesem Beispiel wählen Sie eine XML-Variable formdata aus, um die Datei cc-app.xml zu speichern. Fragen Sie die Variable formdata ab, damit Sie den Wert für die String-Variable emailaddress setzen können, um den Wert für die Eigenschaft emailAddress zu speichern, die in der Datei cc-app.xml verfügbar ist.
Beispiel 2: Verwenden eines Ausdrucks, um einen Wert basierend auf anderen Variablen zu speichern example2
Verwenden Sie einen Ausdruck, um die Summe der Variablen zu berechnen und das Ergebnis in einer Variablen zu speichern.
In diesem Beispiel verwenden Sie den Ausdruckseditor, um einen Ausdruck zu definieren, mit dem die Summe der Variablen assetscost und balanceamount zu berechnet und das Ergebnis in der Variablen totalvalue gespeichert wird.
Verwenden des Ausdruckseditors use-expression-editor
Sie können Ausdrücke auch dazu verwenden, den Wert einer Variablen zur Laufzeit zu berechnen. Variablen verfügen über einen Ausdruckseditor für das Definieren von Ausdrücken.
Den Ausdruckseditor verwenden Sie, um:
- den Wert von Variablen mithilfe anderer Workflow-Variablen, Zahlen oder mathematischer Ausdrücke festzulegen.
- Workflow-Variablen, Zeichenfolgen, Zahlen oder einen Ausdruck in einem mathematischen Ausdruck zu verwenden.
- Fügen Sie Bedingungen hinzu, damit Sie Werte von Variablen festlegen können.
- Operatoren zwischen Bedingungen hinzuzufügen.
Sie basiert auf dem Regeleditor für adaptive Formulare, mit den folgenden Änderungen. Regeleditor in Variablen:
- Unterstützt Funktionen nicht.
- Stellt keine Benutzeroberfläche zum Anzeigen einer Regelzusammenfassung bereit.
- Verfügt über keinen Code-Editor.
- Unterstützt nicht das Aktivieren und Deaktivieren des Wertes eines Objekts.
- Unterstützt nicht das Festlegen einer Eigenschaft eines Objekts.
- Unterstützt nicht das Aufrufen eines Webservice.
Weitere Informationen finden Sie unter Regeleditor für adaptive Formulare.
Verwenden einer Variablen use-a-variable
Sie können Variablen verwenden, um Eingaben und Ausgaben abzurufen oder um das Ergebnis eines Schritts zu speichern. Der Workflow-Editor bietet zwei Arten von Workflow-Schritten:
- Workflow-Schritte mit Unterstützung für Variablen
- Workflow-Schritte ohne Unterstützung für Variablen
Workflow-Schritte mit Unterstützung für Variablen workflow-steps-with-support-for-variables
Die Schritte „Goto“ und „ODER-Teilung“ sowie alle AEM Forms Workflow-Schritte unterstützen Variablen.
ODER-Teilungs-Schritt or-split-step
Die ODER-Teilung erstellt eine Verzweigung im Workflow, nach der nur einer der beiden Zweige aktiv bleibt. Mit diesem Schritt können Sie bedingte Verarbeitungspfade in einem Workflow einrichten. Sie fügen jeder Verzweigung nach Bedarf Workflow-Schritte hinzu.
Sie können Routing-Ausdrücke für eine Verzweigung mithilfe einer Regeldefinition, eines ECMA-Skripts oder eines externen Skripts definieren.
Sie können Variablen verwenden, um den Routing-Ausdruck mit dem Ausdruckseditor zu definieren. Weitere Informationen zur Verwendung von Routing-Ausdrücken für den Schritt „ODER-Teilung“ finden Sie unter ODER-Teilungs-Schritt.
In diesem Beispiel verwenden Sie vor dem Definieren des Routing-Ausdrucks das Beispiel 2, um den Wert für die Variable totalvalue festzulegen. Zweig 1 ist aktiv, wenn der Wert der Variablen totalvalue größer als 50000 ist. Auf ähnliche Weise können Sie eine Regel definieren, die den Zweig 2 aktivieren soll, wenn der Wert der Variablen totalvalue kleiner als 50000 ist.
Wählen Sie auf ähnliche Weise einen externen Skriptpfad aus oder geben Sie das ECMA-Skript an, damit Routing-Ausdrücke die aktive Verzweigung auswerten können. Wählen Sie Verzweigung umbenennen aus, um einen alternativen Namen für die Verzweigung anzugeben.
Weitere Beispiele finden Sie unter Erstellen eines Workflow-Modells.
GOTO-Schritt (Wechseln zu Schritt) go-to-step
Mit der Option Goto-Schritt können Sie den nächsten auszuführenden Schritt im Workflow-Modell angeben, abhängig vom Ergebnis eines Routing-Ausdrucks.
Ähnlich wie beim ODER-Teilungs-Schritt können Sie Routing-Ausdrücke für einen GOTO-Schritt (Wechseln zu Schritt) mithilfe einer Regeldefinition, eines ECMA-Skripts oder eines externen Skripts definieren.
Sie können Variablen verwenden, um den Routing-Ausdruck mit dem Ausdruckseditor zu definieren. Weitere Informationen zur Verwendung von Routing-Ausdrücken für den GOTO-Schritt finden Sie unter GOTO-Schritt (Wechseln zu Schritt).
In diesem Beispiel gibt der GOTO-Schritt (Wechseln zu Schritt) als nächsten Schritt den Schritt „Kreditkartenantrag prüfen“ an, wenn der Wert für die Variable actiontaken gleich Need more info (Weitere Informationen erforderlich) ist.
Weitere Beispiele zur Verwendung der Regeldefinition im GOTO-Schritt (Wechseln zu Schritt) finden Sie unter Simulieren einer For-Schleife.
Forms-Workflow-zentrierte Arbeitsschritte forms-workflow-centric-workflow-steps
Alle AEM Forms-Workflow-Schritte unterstützen Variablen. Weitere Informationen finden Sie unter Formularzentrierte Workflows in OSGi.
Workflow-Schritte ohne Unterstützung für Variablen workflow-steps-without-support-for-variables
Sie können die Schnittstelle MetaDataMap verwenden, um auf Variablen in Workflow-Schritten zuzugreifen, die keine Variablen unterstützen.
Abrufen des Variablenwerts retrieve-the-variable-value
Um Werte für vorhandene Variablen basierend auf dem Datentyp abzurufen, verwenden Sie die folgenden APIs im ECMA-Skript.
Informationen zu APIs für zusätzliche komplexe Variablendatentypen, die in AEM Forms-Workflows verfügbar sind, finden Sie unter Variablen in AEM Forms-Workflows.
Beispiel
Rufen Sie den Wert vom Datentyp „String“ (Zeichenfolge) über die folgende API ab:
workItem.getWorkflowData().getMetaDataMap().get(accname, Packages.java.lang.String)
Aktualisieren des Variablenwertes update-the-variable-value
Um den Wert einer Variablen zu aktualisieren, verwenden Sie die folgende API im ECMA-Skript.
workItem.getWorkflowData().getMetaDataMap().put(variableName, value)
Beispiel
workItem.getWorkflowData().getMetaDataMap().put(salary, 50000)
Aktualisiert den Wert der Variablen salary (Gehalt) auf 50000.
Festlegen von Variablen zum Aufrufen von Workflows apiinvokeworkflow
Sie können eine API verwenden, um Variablen festzulegen und sie dann zu übergeben, um Workflow-Instanzen aufzurufen.
workflowSession.startWorkflow verwendet „model“, „wfData“ und „metaData“ als Argumente. Verwenden Sie MetaDataMap, um einen Wert für die Variable festzulegen.
In dieser API wird die Variable variableName mithilfe von metaData.put(variableName, value) auf value festgelegt.
import com.adobe.granite.workflow.model.WorkflowModel;
import com.adobe.granite.workflow.metadata.MetaDataMap;
import com.adobe.aemfd.docmanager.Document;
/*Assume that you already have a workflowSession and modelId along with the payloadType and payload*/
WorkflowData wfData = workflowSession.newWorkflowData(payloadType, payload);
MetaDataMap metaData = wfData.getMetaDataMap();
metaData.put(variableName, value); //Create a variable "variableName" in your workflow model
WorkflowModel model = workflowSession.getModel(modelId);
workflowSession.startWorkflow(model, wfData, metaData);
Bearbeiten einer Variablen edit-a-variable
- Wählen Sie auf der Seite „Workflow bearbeiten“ das Symbol „Variablen“ im Sidekick des Workflow-Modells aus. Im Abschnitt „Variablen“ im linken Bereich werden alle vorhandenen Variablen angezeigt.
- Wählen Sie das Symbol
- Bearbeiten Sie die Variableninformationen und wählen Sie das Symbol
Löschen einer Variablen delete-a-variable
Bevor Sie eine Variable löschen, müssen Sie alle Verweise der Variablen aus dem Workflow entfernen. Stellen Sie sicher, dass die Variable im Workflow nicht verwendet wird.
So löschen Sie eine Variable,
- Wählen Sie auf der Seite „Workflow bearbeiten“ das Symbol „Variablen“ im Sidekick des Workflow-Modells aus. Im Abschnitt „Variablen“ im linken Bereich werden alle vorhandenen Variablen angezeigt.
- Wählen Sie das Symbol „Löschen“ neben dem Namen der Variablen aus, die Sie löschen möchten.
- Wählen Sie das Symbol