Variabelen in AEM Forms-workflows variables-in-aem-forms-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 bestaande 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:

U vereist toe:voegen-op pakket van AEM Formsvoor de gegevenstypes van het Model van Document en van de Gegevens van de Vorm. 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.

Voer de volgende stappen uit om een variabele te 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 ingesteld in de volgorde waarin de variabele-toewijzingen worden vermeld in de stap met de variabele-set.

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 daarna worden 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

Voer de volgende stappen uit 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 om een dossier van XML op te slaan. 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 om de waarde voor de e-mailadres koordvariabele te 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 in het werkschemamodel specificeren uit te voeren, 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:

U vereist toe:voegen-op pakket van AEM Formsvoor de veranderlijke gegevenstypes van het Model van Gegevens van het Document en van de Vorm.

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

Voorbeeld

Initialiseer het doc documentvoorwerp aan een weg ("a/b/c") en plaats de waarde van de docVar variabele aan de weg die in het documentvoorwerp wordt opgeslagen.

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

Gevoelige gebruikersgegevens opslaan buiten JCR met behulp van workflowvariabelen jcr-independent-persistance

Gegevens die met Forms Workflow worden verwerkt, kunnen gevoelige gebruikersgegevens bevatten, zoals persoonlijk identificeerbare gegevens en gevoelige persoonlijke gegevens. De ondernemingen kunnen verkiezen om de gegevens op te slaan, die door diverse werkschemastappen (en overgegaan gebruikend werkschemariabelen), uit opslag JCR in een externe gegevensopslag worden verwerkt die door hen wordt bezeten en wordt beheerd. Meer over het voortbestaan werkschemagegevens in een externe opslag weten, zie Gebruikend werkschemariabelen voor klant bezeten datastores.
Adobe Experience Manager verstrekt Werkschema API UserMetaDataPersistenceProviderom werkschemariabelen in externe Azure blob opslag op te slaan. Voor details over het gebruiken van API, zie het werkschemavariabelen van het Gebruik om gevoelige gegevens van parameters te bepalen en in externe gegevensopslag op te slaan.

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.

Voer de volgende stappen uit om een variabele te verwijderen:

Verwijzingen references

Voor meer voorbeelden bij het gebruiken van variabelen in de stappen van het Werkschema van AEM Forms, zie Variabelen in AEM werkschema's.