Variabelen in AEM werkstromen variables-in-aem-workflows

Een variabele in een workflowmodel is een manier om een waarde op te slaan op basis van het gegevenstype. U kunt dan de naam van de variabele in om het even welke werkschemastap gebruiken om de waarde terug te winnen die in de variabele wordt opgeslagen. U kunt veranderlijke namen ook gebruiken om uitdrukkingen te bepalen voor het nemen van verpletterende besluiten.

In AEM workflowmodellen kunt u:

In de volgende video ziet u hoe u variabelen kunt maken, instellen en gebruiken in AEM workflowmodellen:

De variabelen zijn een uitbreiding van de MetaDataMapinterface. U kunt MetaDataMapin ECMAScript gebruiken om tot meta-gegevens toegang te hebben die gebruikend variabelen worden bewaard.

Een variabele maken create-a-variable

U maakt variabelen aan de hand van de sectie Variabelen die beschikbaar is in de assistent van het workflowmodel. AEM werkstroomvariabelen ondersteunen de volgende gegevenstypen:

Voor extra complexe gegevenstypes beschikbaar in de werkschema's van AEM Forms, zie Variabelen in de werkschema's van AEM Forms. Gebruik het gegevenstype ArrayList om variabele verzamelingen te maken. U kunt een variabele ArrayList maken voor alle primitieve en complexe gegevenstypen. Maak bijvoorbeeld een variabele ArrayList en selecteer String als subtype om meerdere tekenreekswaarden op te slaan met de variabele.

Als u een variabele wilt maken,

Houd rekening met de volgende werkwijzen wanneer u variabelen maakt:

Een variabele instellen set-a-variable

Met de stap Variabele instellen kunt u de waarde van een variabele instellen en de volgorde definiëren waarin de waarden worden ingesteld. De variabele wordt geplaatst in de orde dat de veranderlijke toewijzingen in de vastgestelde veranderlijke stap vermeld zijn.

Wijzigingen in waarden van variabelen zijn alleen van invloed op de instantie van het proces waarin de wijziging plaatsvindt. Wanneer bijvoorbeeld een werkstroom wordt gestart en variabele gegevens worden gewijzigd, hebben de wijzigingen alleen invloed op dat exemplaar van de werkstroom. De wijzigingen zijn niet van invloed op andere versies van de workflow die eerder zijn gestart of later zijn gestart.

Afhankelijk van het gegevenstype van de variabele kunt u de volgende opties gebruiken om de waarde van een variabele in te stellen:

U kunt ook specifieke elementen van een variabele van het type JSON of XML bijwerken met JSON-puntnotatie of XPATH-notatie.

Toewijzing tussen variabelen toevoegen add-mapping-between-variables

Ga als volgt te werk om toewijzingen tussen variabelen toe te voegen:

Voorbeeld 1: Vraag een XML-variabele naar een waarde voor een tekenreeksvariabele example-query-an-xml-variable-to-set-value-for-a-string-variable

Selecteer een variabele van het type van XML die u een dossier van XML wilt opslaan. Vraag de variabele van XML om de waarde voor een koordvariabele voor het bezit te plaatsen beschikbaar in het dossier van XML. Het gebruik specificeert XPATH voor het veranderlijke gebied van XML om het bezit te bepalen in de koordvariabele op te slaan.

In dit voorbeeld, selecteer de variabele van a formdata XML om het {dossier op te slaan 2} cc-app.xml. Vraag de formdata variabele zodat kunt u de waarde voor de e-mailadres koordvariabele plaatsen om de waarde voor het emailAddress bezit op te slaan beschikbaar in het cc-app.xml dossier.

Voorbeeld 2: een expressie gebruiken om waarde op te slaan op basis van andere variabelen example2

Gebruik een expressie om de som van de variabelen te berekenen en sla het resultaat op in een variabele.

In dit voorbeeld, gebruik de uitdrukkingsredacteur om een uitdrukking te bepalen om de som van activaKosten en evenwieamount variabelen te berekenen en het resultaat in totalvalue variabele op te slaan.

Expressieeditor gebruiken use-expression-editor

U gebruikt ook expressies om de waarde van een variabele in de runtime te berekenen. Variabelen bieden een expressie-editor om expressies te definiëren.

Met de expressie-editor kunt u:

De editor is gebaseerd op de regel voor aangepaste formulieren. De volgende wijzigingen zijn aangebracht. Regeleditor in variabelen:

Voor meer informatie, zie de aanpassingsredacteur van de vormenregel.

Een variabele gebruiken use-a-variable

U kunt variabelen gebruiken om input en output terug te winnen of het resultaat van een stap te bewaren. De werkstroomeditor bevat twee typen workflowstappen:

Workflowstappen met ondersteuning voor variabelen workflow-steps-with-support-for-variables

De stap Ga naar OF Splitsen en alle AEM Forms Workflowstappen ondersteunen variabelen.

OF stap Splitsen or-split-step

Met de indeling OR wordt een splitsing in de workflow gemaakt, waarna slechts één vertakking actief is. Met deze stap kunt u voorwaardelijke verwerkingspaden in uw workflow introduceren. U voegt workflowstappen naar wens toe aan elke vertakking.

U kunt het verpletteren van uitdrukking voor een tak bepalen gebruikend een regeldefinitie, manuscript ECMA, of een extern manuscript.

U kunt variabelen gebruiken om de verpletterende uitdrukking te bepalen gebruikend de uitdrukkingsredacteur. Voor meer informatie bij het gebruiken van het verpletteren van uitdrukkingen voor OF Gesplitste stap, zie OF stap Splitsen.

In dit voorbeeld, alvorens de verpletterende uitdrukking te bepalen, gebruik voorbeeld 2om de waarde voor de totalvalue variabele te plaatsen. Tak 1 is actief als de waarde van de totalvalue variabele groter is dan 50000. Op dezelfde manier kunt u een regel bepalen om Tak 2 actief te maken als de waarde van de totalvalue variabele minder dan 50000 is.

Op dezelfde manier selecteer een externe manuscriptweg of specificeer het manuscript ECMA voor het verpletteren van uitdrukkingen om de actieve tak te evalueren. Selecteer Rename Branch om een alternatieve naam voor de vertakking op te geven.

Voor meer voorbeelden, zie een werkschemamodelcreëren.

Ga naar stap go-to-step

De Goto Stap laat u de volgende stap specificeren om in het werkschemamodel in werking te stellen, afhankelijk van het resultaat van een verpletterende uitdrukking.

Gelijkaardig aan OF de Gesplitste stap, kunt u het verpletteren van uitdrukking voor stap bepalen gebruikend een regeldefinitie, manuscript ECMA, of een extern manuscript.

U kunt variabelen gebruiken om de verpletterende uitdrukking te bepalen gebruikend de uitdrukkingsredacteur. Voor meer informatie bij het gebruiken van het verpletteren van uitdrukkingen voor de stap Ga, zie Ga.

In dit voorbeeld, specificeert de stap van het Ga de Toepassing van de Kaart van het Overzicht als volgende stap als de waarde voor de genomen actie variabele gelijk is aan behoefte meer info.

Voor meer voorbeelden bij het gebruiken van regeldefinitie in de Goto stap, zie Simulerend a voor lijn.

Forms-workflowgerichte stappen forms-workflow-centric-workflow-steps

Alle AEM Forms Workflowstappen ondersteunen variabelen. Voor meer informatie, zie Forms-centric werkschema op OSGi.

Workflowstappen zonder ondersteuning voor variabelen workflow-steps-without-support-for-variables

U kunt MetaDataMapinterface gebruiken om tot variabelen in werkschemastappen toegang te hebben die geen variabelen steunen.

De waarde van de variabele ophalen retrieve-the-variable-value

Gebruik de volgende API's in het ECMA-script om waarden voor bestaande variabelen op te halen op basis van het gegevenstype.

Voor informatie over APIs voor extra complexe veranderlijke gegevenstypes beschikbaar in de werkschema's van AEM Forms, zie Variabelen in de werkschema's van AEM Forms.

Voorbeeld

Hiermee wordt de waarde van het gegevenstype String opgehaald met de volgende API:

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

De waarde van de variabele bijwerken update-the-variable-value

Gebruik de volgende API in het ECMA-script om de waarde van een variabele bij te werken.

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

Voorbeeld

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

Werkt de waarde voor de salaris variabele aan 50000 bij.

Variabelen instellen om workflows aan te roepen apiinvokeworkflow

U kunt een API gebruiken om variabelen in te stellen en deze door te geven om workflowinstanties aan te roepen.

workflowSession.startWorkflowgebruikt model, wfData, en metaData als argumenten. Gebruik MetaDataMap om de waarde voor de variabele in te stellen.

In dit API, wordt de variableName variabele geplaatst aan waarde gebruikend metaData.put (variableName, waarde);

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

Een variabele bewerken edit-a-variable

Een variabele verwijderen delete-a-variable

Voordat u de variabele verwijdert, verwijdert u alle referenties van de variabele uit de workflow. Zorg ervoor dat de variabele niet in de workflow wordt gebruikt.

Om een variabele te schrappen,