AEM Forms工作流程中的變數

工作流模型中的變數是根據其資料類型儲存值的方法。 然後，您可以在任何工作流程步驟中使用變數的名稱來擷取儲存在變數中的值。 您也可以使用變數名稱來定義用於做出路由決策的表達式。

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

• 根據 您要儲存的資訊類型，建立資料類型的變數。
• 使用「設定變數」工作 流程步驟，設定變數的值。
• 在所有AEM Forms工作流步驟中使用變數來檢索儲存值，在OR分割和轉至步驟中使用變數來定義路由表達式。

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

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

建立變數

您可使用工作流程模型側腳中的「變數」區段來建立變數。 AEM工作流程變數支援下列資料類型：

• 基本資料類型:長、雙、布爾、日期和字串
• 複雜的資料類型: 檔案、 XML、 JSON和表單資料模型例項。

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

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

1. 在AEM例項上，導覽至「工具 >工作流程>模型」。

2. 點選「建立」，並指定工作流程模型的標題和選用名稱。 選擇模型並點選​Edit。

3. 點選工作流程模型側點中可用的變數圖示，然後點選「新增變數」。

   

4. 在「新增變數」對話方塊中，指定名稱並選取變數類型。

5. 從​Type​下拉式清單中選取資料類型，並指定下列值：

   • 基本資料類型——指定變數的選用預設值。
   • JSON或XML —— 指定選用的JSON或XML結構描述路徑。 系統在將此模式中的可用屬性映射到另一個變數並將其儲存時驗證模式路徑。
   • 表單資料模型——指定表單資料模型路徑。
   • ArrayList —— 指定系列的子類型。

6. 指定變數的選用說明，並點選以儲存變更。 變數會顯示在左窗格的可用清單中。

建立變數時，請考慮下列實務：

• 建立工作流程所需的變數數量。 不過，為了節省資料庫資源，請使用所需的最少變數數，並盡可能重複使用變數。
• 變數會區分大小寫。 請確定您在工作流程中使用相同的案例來參考變數。
• 避免在變數名稱中使用特殊字元

設定變數

您可以使用「設定變數」步驟來設定變數的值，並定義值的設定順序。 變數的設定順序為變數映射在設定變數步驟中列出。

變數值的變更只會影響變更發生的程式例項。 例如，當啟動工作流且變數資料變更時，這些變更只會影響該工作流程的例項。 這些更改不會影響以前啟動或隨後啟動的工作流的其他實例。

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

• 常值： 當您知道要指定的確切值時，請使用選項。

• 運算式： 當根據運算式計算要使用的值時，請使用此選項。表達式在提供的表達式編輯器中建立。

• JSON點符號：使 用選項從JSON或FDM類型變數擷取值。

• XPATH：使 用選項從XML類型變數中檢索值。

• 相對於裝載： 當要儲存至變數的值位於相對於裝載的路徑時，請使用此選項。

• 絕對路徑： 當要儲存至變數的值在絕對路徑上可用時，請使用此選項。

您也可以使用JSON DOT符號或XPATH符號來更新JSON或XML類型變數的特定元素。

新增變數之間的映射

執行下列步驟以新增變數之間的映射：

1. 在工作流程編輯頁面上，點選工作流程模型側點中的「步驟」圖示。
2. 將​設定變數​步驟拖放至工作流程編輯器，點選該步驟並選取（設定）。
3. 在「設定變數」對話框中，選擇「映射」「映射」>「添加映射」。​
4. 在​映射變數​區段中，選取要儲存資料的變數、選取對應模式，並指定要儲存在變數中的值。 對應模式會根據變數類型而有所不同。
5. 映射更多變數，以建立有意義的運算式。 點選以儲存變更。

範例1:查詢XML變數以設定字串變數的值

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

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

範例2:使用運算式以其他變數儲存值

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

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

使用運算式編輯器

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

使用運算式編輯器可：

• 使用其他工作流程變數、數字或數學運算式來設定變數的值。
• 在數學表達式中使用工作流變數、字串、數字或表達式
• 新增條件以設定變數值。
• 在條件之間新增運算子。

它以具有下列變更的最適化表單規則編輯器為基礎。 變數中的規則編輯器：

• 不支援函式。
• 不提供UI來檢視規則摘要
• 沒有程式碼編輯器。
• 不支援啟用和禁用對象的值。
• 不支援對象的setting屬性。
• 不支援呼叫Web服務。

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

使用變數

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

• 支援變數的工作流程步驟
• 不支援變數的工作流程步驟

支援變數的工作流程步驟

「跳至」步驟、「或分割」步驟和所有AEM Forms工作流程步驟都支援變數。

OR拆分步驟

「或分割」(OR Split)在工作流中建立一個分割，之後只有一個分支處於活動狀態。 此步驟可讓您將條件式處理路徑引入工作流程中。 您可以視需要將工作流程步驟新增至每個分支。

您可以使用規則定義、ECMA指令碼或外部指令碼為分支定義路由表達式。

可以使用變數使用表達式編輯器定義路由表達式。 有關使用OR分割步驟的路由表達式的詳細資訊，請參閱OR分割步驟。

在此示例中，在定義路由表達式之前，請使用example 2來設定​totalvalue​變數的值。 如果​totalvalue​變數的值大於50000，則分支1是活動的。 同樣地，如果​totalvalue​變數的值小於50000，您也可以定義規則，使Branch 2處於活動狀態。

同樣地，選擇外部指令碼路徑或指定路由表達式的ECMA指令碼以評估活動分支。 點選​重新命名分支​以指定分支的替代名稱。

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

移至步驟

轉至步驟​允許您指定工作流模型中要執行的下一個步驟，這取決於路由表達式的結果。

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

可以使用變數使用表達式編輯器定義路由表達式。 有關使用Goto步驟的路由表達式的詳細資訊，請參閱Goto步驟。

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

有關在Goto步驟中使用規則定義的更多示例，請參閱模擬For循環。

以表單工作流程為中心的工作流程步驟

所有AEM Forms工作流程步驟都支援變數。 如需詳細資訊，請參閱OSGi](…/…/forms/using/aem-forms-workflow-step-reference.md)上的[表單導向工作流程。

不支援變數的工作流程步驟

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

檢索變數值

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

變數資料類型	API
基元（長、雙、布爾、日期和字串）	workItem.getWorkflowData()。getMetaDataMap()。get(variableName, type)
文件	Packages.com.adobe.aemfd.docmanager.Document doc = workItem.getWorkflowData()。getMetaDataMap()。get("docVar", Packages.com.adobe.aemfd.docmanager.Document.class);
XML	Packages.org.w3c.dom.Document xmlObject = workItem.getWorkflowData()。getMetaDataMap()。get(variableName, Packages.org.w3c.dom.Document.class);
表單資料模型	Packages.com.adobe.aem.dermis.api.FormDataModelInstanceFdmObject = workItem.getWorkflowData()。getMetaDataMap()。get(variableName, Packages.com.adobe.aem.dermis.api.FormDataModelInstance.class);
JSON	Packages.com.google.gson.JsonObjectJsonObject = workItem.getWorkflowData()。getMetaDataMap()。get(variableName, Packages.com.google.gson.JsonObject.class);

您需要AEM Forms附加元件套件才能使用「檔案」和「表單資料模型」變數資料類型。

範例

使用下列API擷取字串資料類型的值：

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

更新變數值

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

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

範例

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

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

設定變數以叫用工作流程

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

workflowSession. startWorkflows使用模型、wfData和metaData作為參數。使用MetaDataMap來設定變數的值。

在此API中，variableName​變數會使用metaData.put(variableName, value)設為​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);

編輯變數

1. 在編輯工作流程頁面上，點選工作流程模型側鍵中的「變數」圖示。 左窗格中的「變數」區段會顯示所有現有變數。
2. 點選您要編輯之變數名稱旁的（編輯）圖示。
3. 編輯變數資訊並點選以儲存變更。 您無法編輯變數的​Name​和​Type​欄位。

刪除變數

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

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

1. 在編輯工作流程頁面上，點選工作流程模型側鍵中的「變數」圖示。 左窗格中的「變數」區段會顯示所有現有變數。
2. 點選您要刪除之變數名稱旁的「刪除」圖示。
3. 點選以確認並刪除變數。

引用

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