AEM Forms工作流程中的變數 variables-in-aem-forms-workflows

工作流程模型中的變數是根據其資料型別儲存值的方式。 然後，您就可以在任何工作流程步驟中使用變數的名稱，來擷取儲存在變數中的值。 您也可以使用變數名稱來定義用於進行路由決定的運算式。

在AEM工作流程模型中，您可以：

以下影片示範如何在AEM工作流程模型中建立、設定和使用變數：

變數是現有MetaDataMap介面的延伸。 您可以在ECMAScript中使用MetaDataMap來存取使用變數儲存的中繼資料。

建立變數 create-a-variable

您可以使用工作流程模型Sidekick中可用的變數區段來建立變數。 AEM工作流程變數支援下列資料型別：

檔案與表單資料模型資料型別需要AEM Forms附加元件套件。 使用ArrayList資料型別建立變數集合。 您可以為所有基本和複雜資料型別建立ArrayList變數。 例如，建立ArrayList變數並選取String作為子型別，以使用變數儲存多個字串值。

執行以下步驟來建立變數：

建立變數時，請考量下列作法：

設定變數 set-a-variable

您可以使用「設定變數」步驟來設定變數的值，並定義設定值的順序。 變數會依照變數對應在設定變數步驟中列出的順序進行設定。

變數值的變更只會影響變更發生的程式例項。 例如，啟動工作流程並變更變數資料時，變更只會影響該工作流程例項。 變更不會影響先前已啟動或之後已啟動之工作流程的其他執行個體。

視變數的資料型別而定，您可以使用下列選項來設定變數的值：

您也可以使用JSON DOT Notation或XPATH標籤法更新JSON或XML型別變數的特定元素。

新增變數之間的對應 add-mapping-between-variables

執行以下步驟來新增變數之間的對應：

範例1：查詢XML變數以設定字串變數的值 example-query-an-xml-variable-to-set-value-for-a-string-variable

選取XML型別的變數以儲存XML檔案。 查詢XML變數，為XML檔案中可用的屬性設定字串變數的值。 使用​ 指定XML變數的XPATH ​欄位來定義要儲存在字串變數中的屬性。

在此範例中，選取​ formdata XML變數來儲存​ cc-app.xml ​檔案。 查詢​ formdata ​變數以設定​ emailaddress ​字串變數的值，以儲存​ cc-app.xml ​檔案中可用的​ emailAddress ​屬性的值。

範例2：使用運算式根據其他變數儲存值 example2

使用運算式來計算變數的總和，並將結果儲存在變數中。

在此範例中，使用運算式編輯器來定義運算式，以計算​ assetscost ​與​ balanceamount ​變數的總和，並將結果儲存在​ totalvalue ​變數中。

使用運算式編輯器 use-expression-editor

您也可以使用運算式，在執行階段計算變數的值。 變數提供運算式編輯器以定義運算式。

使用運算式編輯器可以：

這會根據調適型表單規則編輯器，且有下列變更。 變數中的規則編輯器：

如需詳細資訊，請參閱適用性表單規則編輯器。

使用變數 use-a-variable

您可以使用變數來擷取輸入和輸出，或儲存步驟的結果。 工作流程編輯器提供兩種型別的工作流程步驟：

支援變數的工作流程步驟 workflow-steps-with-support-for-variables

前往步驟（或「分割」步驟）和所有AEM Forms工作流程步驟都支援變數。

OR拆分步驟 or-split-step

「OR分割」會在工作流程中建立分割，之後只有一個分支處於作用中狀態。 此步驟可讓您將條件式處理路徑匯入工作流程中。 您可以視需要將工作流程步驟新增到每個分支。

您可以使用規則定義、ECMA命令檔或外部命令檔來定義分支的路由表示式。

您可以使用變數來定義使用運算式編輯器的路由運算式。 如需有關使用OR分割步驟的路由運算式的詳細資訊，請參閱OR分割步驟。

在此範例中，在定義路由運算式之前，請使用範例2設定​ totalvalue ​變數的值。 如果​ totalvalue ​變數的值大於50000，則分支1為作用中。 同樣地，您可以定義一個規則，在​ totalvalue ​變數的值小於50000時，讓Branch 2生效。

同樣地，選取外部指令集路徑，或指定路由運算式的ECMA指令集以評估作用中分支。 選取​ 重新命名分支 ​以指定分支的替代名稱。

如需更多範例，請參閱建立工作流程模型。

前往步驟 go-to-step

移至步驟 ​可讓您指定工作流程模型中要執行的下一個步驟（視路由運算式的結果而定）。

與「OR分割」步驟類似，您可以使用規則定義、ECMA指令集或外部指令集來定義「轉至」步驟的路由表示式。

您可以使用變數來定義使用運算式編輯器的路由運算式。 如需有關使用跳到步驟的路由運算式的詳細資訊，請參閱跳到步驟。

在此範例中，如果​ actiontaked ​變數的值等於​ 需要更多資訊，則「轉至」步驟會將「複查信用卡應用程式」指定為下一個步驟。

如需在「跳至」步驟中使用規則定義的更多範例，請參閱模擬For回圈。

以Forms工作流程為中心的工作流程步驟 forms-workflow-centric-workflow-steps

所有AEM Forms工作流程步驟都支援變數。 如需詳細資訊，請參閱在OSGi上以Forms為中心的工作流程。

不支援變數的工作流程步驟 workflow-steps-without-support-for-variables

您可以使用MetaDataMap介面，在不支援變數的工作流程步驟中存取變數。

擷取變數值 retrieve-the-variable-value

在ECMA指令碼中使用下列API，根據資料型別擷取現有變數的值：

檔案和表單資料模型變數資料型別需要AEM Forms附加元件套件。

範例

使用以下API擷取字串資料型別的值：

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

更新變數值 update-the-variable-value

在ECMA指令碼中使用以下API來更新變數的值：

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

範例

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

將​ salary ​變數的值更新為50000。

設定變數以叫用工作流程 apiinvokeworkflow

您可以使用API來設定變數，並傳遞它們以叫用工作流程例項。

workflowSession.startWorkflow使用模型、wfData和metaData做為引數。 使用MetaDataMap設定變數的值。

在此API中，使用metaData.put(variableName， value)將​ 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);

範例

將​ doc ​檔案物件初始化為路徑("a/b/c")，並將​ docVar ​變數的值設定為儲存在檔案物件中的路徑。

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

使用工作流程變數將敏感的使用者資料儲存在JCR以外 jcr-independent-persistance

使用Forms Workflow處理的資料可能包含敏感的使用者資料，例如個人識別資訊和敏感個人資訊。 企業可以選擇將資料從JCR儲存空間儲存到由他們擁有並管理的外部資料存放區，由各種工作流程步驟處理（並使用工作流程變數傳遞）。 若要進一步瞭解如何在外部儲存空間中儲存工作流程資料，請參閱針對客戶擁有的資料存放區使用工作流程變數。
Adobe Experience Manager提供工作流程API UserMetaDataPersistenceProvider，以將工作流程變數儲存在外部Azure Blob儲存體中。 如需有關使用API的詳細資訊，請參閱使用工作流程變數將敏感資料引數化，並儲存在外部資料存放區。

編輯變數 edit-a-variable

刪除變數 delete-a-variable

在刪除變數之前，請從工作流程中移除變數的所有參考。 請確定此變數並未用於工作流程中。

執行以下步驟來刪除變數：

參考 references

如需在AEM Forms工作流程步驟中使用變數的更多範例，請參閱AEM工作流程中的變數。