Variabler i AEM Forms arbetsflöden variables-in-aem-forms-workflows

En variabel i en arbetsflödesmodell är ett sätt att lagra ett värde baserat på dess datatyp. Du kan sedan använda namnet på variabeln i vilket arbetsflödessteg som helst för att hämta värdet som lagras i variabeln. Du kan också använda variabelnamn för att definiera uttryck för att fatta beslut om routning.

I AEM arbetsflödesmodeller kan du:

I följande video visas hur du kan skapa, ange och använda variabler i AEM arbetsflödesmodeller:

Variabler är ett tillägg till det befintliga MetaDataMap -gränssnittet. Du kan använda MetaDataMap i ECMAScript för att komma åt metadata som sparats med variabler.

Skapa en variabel create-a-variable

Du skapar variabler med hjälp av avsnittet Variabler som är tillgängliga i arbetsflödesmodellens sidospak. AEM arbetsflödesvariabler har stöd för följande datatyper:

Du behöver AEM Forms-tilläggspaket för datatyperna Document och Form Data Model. Använd datatypen ArrayList för att skapa variabelsamlingar. Du kan skapa en ArrayList-variabel för alla primitiva och komplexa datatyper. Skapa till exempel en ArrayList-variabel och välj String som undertyp för att lagra flera strängvärden med variabeln.

Så här skapar du en variabel:

Tänk på följande när du skapar variabler:

Ange en variabel set-a-variable

Du kan använda steget Ange variabel för att ange värdet för en variabel och definiera i vilken ordning värdena ska anges. Variabeln ställs in i den ordning som variabelmappningarna visas i steget för att ange variabel.

Ändringar av variabelvärden påverkar bara instansen av den process i vilken ändringen sker. När ett arbetsflöde initieras och variabeldata ändras påverkar ändringarna bara den instansen av arbetsflödet. Ändringarna påverkar inte andra instanser av arbetsflödet som har initierats tidigare eller som har initierats senare.

Beroende på variabelns datatyp kan du använda följande alternativ för att ange värdet för en variabel:

Du kan också uppdatera specifika element i en JSON- eller XML-typvariabel med JSON DOT Notation eller XPATH.

Lägg till mappning mellan variabler add-mapping-between-variables

Utför följande steg för att lägga till mappning mellan variabler:

Exempel 1: Fråga en XML-variabel för att ange ett värde för en strängvariabel example-query-an-xml-variable-to-set-value-for-a-string-variable

Välj en variabel av XML-typ för att lagra en XML-fil. Fråga XML-variabeln för att ange värdet för en strängvariabel för egenskapen som är tillgänglig i XML-filen. Använd Ange XPATH för fältet XML-variabel för att definiera den egenskap som ska lagras i strängvariabeln.

I det här exemplet väljer du en formdata XML-variabel som ska lagra filen cc-app.xml. Fråga variabeln formdata om du vill ange värdet för strängvariabeln emailaddress för att lagra värdet för egenskapen emailAddress som finns i filen cc-app.xml .

Exempel 2: Använd ett uttryck för att lagra värden baserat på andra variabler example2

Använd ett uttryck för att beräkna summan av variablerna och lagra resultatet i en variabel.

I det här exemplet använder du uttrycksredigeraren för att definiera ett uttryck för att beräkna summan av variablerna assetsCost och balanceamount och lagra resultatet i variabeln totalValue .

Använda uttrycksredigeraren use-expression-editor

Du använder också uttryck för att beräkna värdet för en variabel i körningsmiljön. Variabler tillhandahåller en uttrycksredigerare för att definiera uttryck.

Använd uttrycksredigeraren för att:

Det baseras på redigering av adaptiva formulärregler med följande ändringar. Regelredigerare i variabler:

Mer information finns i Regelredigeraren för anpassade formulär.

Använda en variabel use-a-variable

Du kan använda variabler för att hämta indata och utdata eller spara resultatet av ett steg. Arbetsflödesredigeraren innehåller två typer av arbetsflödessteg:

Arbetsflödessteg med stöd för variabler workflow-steps-with-support-for-variables

Steget Gå till, eller Dela, och alla AEM Forms Workflow-steg har stöd för variabler.

ELLER Dela upp steg or-split-step

Med ELLER-delning skapas en delning i arbetsflödet, varefter endast en gren är aktiv. I det här steget kan du lägga in sökvägar för villkorlig bearbetning i arbetsflödet. Du kan lägga till arbetsflödessteg i varje gren efter behov.

Du kan definiera routningsuttryck för en gren med en regeldefinition, ett ECMA-skript eller ett externt skript.

Du kan använda variabler för att definiera routningsuttrycket med hjälp av uttrycksredigeraren. Mer information om hur du använder routningsuttryck för steget ELLER Dela finns i ELLER Dela steg.

I det här exemplet använder du example 2 för att ange värdet för variabeln totalvalue innan du definierar routningsuttrycket. Gren 1 är aktiv om värdet för variabeln totalvalue är större än 50000. På samma sätt kan du definiera en regel som gör grenen 2 aktiv om värdet för variabeln totalvalue är mindre än 50000.

Välj på liknande sätt en extern skriptsökväg eller ange ECMA-skriptet för routningsuttryck för att utvärdera den aktiva grenen. Välj Rename Branch om du vill ange ett alternativt namn för grenen.

Mer exempel finns i Skapa en arbetsflödesmodell.

Gå till steg go-to-step

Med Gå till steg kan du ange nästa steg i arbetsflödesmodellen som ska köras, beroende på resultatet av ett routningsuttryck.

Ungefär som i steget ELLER Dela kan du definiera routningsuttryck för Gå till med hjälp av en regeldefinition, ett ECMA-skript eller ett externt skript.

Du kan använda variabler för att definiera routningsuttrycket med hjälp av uttrycksredigeraren. Mer information om hur du använder routningsuttryck för steget Gå till finns i Gå till steg.

I det här exemplet anger Gå till-steget Granska kreditkortsansökan som nästa steg om värdet för variabeln actiontaken är lika med Behöver mer information.

Mer exempel på hur du använder regeldefinitionen i steget Gå till finns i Simulera en For-slinga.

Centrala arbetsflödessteg för Forms forms-workflow-centric-workflow-steps

Alla AEM Forms Workflow-steg har stöd för variabler. Mer information finns i Forms-centrerat arbetsflöde i OSGi.

Arbetsflödessteg utan stöd för variabler workflow-steps-without-support-for-variables

Du kan använda gränssnittet MetaDataMap för att komma åt variabler i arbetsflödessteg som inte stöder variabler.

Hämta variabelvärdet retrieve-the-variable-value

Använd följande API:er i ECMA-skriptet för att hämta värden för befintliga variabler baserat på datatypen:

Du behöver AEM Forms-tilläggspaket för datatyperna Document och Form Data Model.

Exempel

Hämta värdet för strängdatatypen med följande API:

workItem.getWorkflowData().getMetaDataMap().get(accname, Packages.java.lang.String)

Uppdatera variabelvärdet update-the-variable-value

Använd följande API i ECMA-skriptet för att uppdatera värdet för en variabel:

workItem.getWorkflowData().getMetaDataMap().put(variableName, value)

Exempel

workItem.getWorkflowData().getMetaDataMap().put(salary, 50000)

uppdaterar värdet för variabeln Använd på 50000.

Ange variabler för att starta arbetsflöden apiinvokeworkflow

Du kan använda ett API för att ange variabler och skicka dem för att anropa arbetsflödesinstanser.

workflowSession.startWorkflow använder modell, wfData och metaData som argument. Använd MetaDataMap för att ange värdet för variabeln.

I detta API är variabeln variableName inställd på value med metaData.put(variableName, value);

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);

Exempel

Initiera dokumentobjektet doc till en sökväg ("a/b/c") och ange värdet för variabeln docVar till sökvägen som lagras i dokumentobjektet.

import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.WorkflowData;
import com.adobe.granite.workflow.model.WorkflowModel;
import com.adobe.granite.workflow.metadata.MetaDataMap;
import com.adobe.aemfd.docmanager.Document;

/*This example assumes that you already have a workflowSession and modelId along with the payloadType and payload */
WorkflowData wfData = workflowSession.newWorkflowData(payloadType, payload);
MetaDataMap metaData = wfData.getMetaDataMap();
Document doc = new Document("/a/b/c");// initialize a document object
metaData.put("docVar",doc); //Assuming that you have created a variable "docVar" of type Document in your workflow model
WorkflowModel model = workflowSession.getModel(modelId);
workflowSession.startWorkflow(model, wfData, metaData);

Lagra känsliga användardata utanför JCR med arbetsflödesvariabler jcr-independent-persistance

Data som behandlas med Forms Workflow kan innehålla känsliga användardata, t.ex. personligt identifierbar information och känslig personlig information. Företag kan välja att lagra data, som bearbetas i olika arbetsflödessteg (och skickas med arbetsflödesvariabler), utanför JCR-lagring i ett externt datalager som ägs och hanteras av dem. Mer information om beständiga arbetsflödesdata i ett externt lagringsutrymme finns i Använda arbetsflödesvariabler för kundägda datalager.
Adobe Experience Manager innehåller arbetsflödes-API:t UserMetaDataPersistenceProvider för lagring av arbetsflödesvariabler i externa Azure-blobblagringsplatser. Mer information om hur du använder API finns i Använda arbetsflödesvariabler för att parametrisera känsliga data och lagra i externa datalager.

Redigera en variabel edit-a-variable

Ta bort en variabel delete-a-variable

Ta bort alla referenser till variabeln från arbetsflödet innan du tar bort variabeln. Kontrollera att variabeln inte används i arbetsflödet.

Så här tar du bort en variabel:

Referenser references

Mer exempel på hur du använder variabler i AEM Forms Workflow steps finns i Variabler i AEM.