AEM工作流程中的變數 variables-in-aem-workflows
工作流程模型中的變數是根據其資料型別儲存值的方式。 然後，您就可以在任何工作流程步驟中使用變數的名稱，來擷取儲存在變數中的值。 您也可以使用變數名稱來定義用於進行路由決定的運算式。
在AEM工作流程模型中，您可以：
- 根據您要儲存於其中的資訊型別，建立資料型別的變數。
- 使用「設定變數」工作流程步驟，設定變數的值。
- 在OR Split和Goto AEM工作流程步驟中使用變數，以便定義用於進行路由決定的運算式。 您也可以在所有AEM Forms工作流程步驟中使用變數。
以下影片示範如何在AEM工作流程模型中建立、設定和使用變數：
變數是MetaDataMap介面的延伸。 您可以在ECMAScript中使用MetaDataMap來存取使用變數儲存的中繼資料。
建立變數 create-a-variable
您可以使用工作流程模型Sidekick中可用的變數區段來建立變數。 AEM工作流程變數支援下列資料型別：
如需AEM Forms工作流程中可用的其他複雜資料型別，請參閱AEM Forms工作流程中的變數。 使用ArrayList資料型別建立變數集合。 您可以為所有基本和複雜資料型別建立ArrayList變數。 例如，建立ArrayList變數並選取String作為子型別，以使用變數儲存多個字串值。
若要建立變數，
-
在AEM執行個體上，導覽至「工具>工作流程>模型」 。
-
選取「建立」，並指定工作流程模型的標題和選用名稱。 選取模型並選取 編輯。
-
選取工作流程模型Sidekick中可用的變數圖示，並選取 新增變數。
-
在新增變數對話方塊中，指定名稱，並選取變數的型別。
-
從 型別 下拉式清單中選取資料型別，並指定下列值：
- 基本資料型別 — 指定變數的選擇性預設值。
- JSON或XML — 指定選用的JSON或XML結構描述路徑。 將這個結構描述中可用的屬性對應並儲存到另一個變數時，系統會驗證結構描述路徑。
- 表單資料模型 — 指定表單資料模型路徑。
- ArrayList — 指定集合的子型別。
-
指定變數的選擇性說明，並選取方塊核心取記號所指示的
以儲存變更。 變數會顯示在左窗格中可用的清單中。
建立變數時，請考量下列作法：
- 建立工作流程所需數量的變數。 不過，為了節省資料庫資源，請使用最少量的必要變數，並儘可能重複使用變數。
- 變數會區分大小寫。 請務必在工作流程中使用相同大小寫參考變數。
- 避免在變數的名稱中使用特殊字元
設定變數 set-a-variable
您可以使用「設定變數」步驟來設定變數的值，並定義設定值的順序。 變數會依照變數對應在設定變數步驟中列出的順序來設定。
變數值的變更只會影響變更發生的程式例項。 例如，啟動工作流程並變更變數資料時，變更只會影響該工作流程例項。 變更不會影響先前已起始或稍後起始之工作流程的其他執行個體。
視變數的資料型別而定，您可以使用下列選項來設定變數的值：
- 常值： 當您知道要指定的確切值時，請使用選項。
- 運算式： 根據運算式計算所要使用的值時，請使用選項。 運算式是在提供的運算式編輯器中建立。
- JSON點標籤法： 使用選項從JSON或FDM型別變數擷取值。
- XPATH： 使用選項從XML型別變數擷取值。
- 相對於承載： 當要儲存至變數的值可在相對於承載的路徑取得時，請使用選項。
- 絕對路徑： 當要儲存至變數的值在絕對路徑可用時，請使用選項。
您也可以使用JSON DOT Notation或XPATH標籤法更新JSON或XML型別變數的特定元素。
新增變數之間的對應 add-mapping-between-variables
若要在變數之間新增對應，請執行下列動作：
- 在工作流程編輯頁面上，選取工作流程模型Sidekick中可用的步驟圖示。
- 將 設定變數 步驟拖放到工作流程編輯器中，選取該步驟，然後選取扳手所指示的
- 在[設定變數]對話方塊中，選取 對應 > 新增對應。
- 在 對應變數 區段中，選取要儲存資料的變數、選取對應模式，然後指定要在變數中儲存的值。 對應模式會因變數型別而異。
- 對應更多變數，以便做出有意義的運算式。 選取方塊內勾選記號所指示的
範例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
您也可以使用運算式，在執行階段計算變數的值。 變數提供運算式編輯器以定義運算式。
使用運算式編輯器可以：
- 使用其他工作流程變數、數字或數學運算式設定變數值。
- 在數學運算式中使用工作流程變數、字串、數字或運算式
- 新增條件，讓您可以設定變數的值。
- 在條件之間新增運運算元。
這會根據調適型表單規則編輯器，且有下列變更。 變數中的規則編輯器：
- 不支援函式。
- 不提供可檢視規則摘要的UI
- 沒有程式碼編輯器。
- 不支援啟用和停用物件的值。
- 不支援設定物件的屬性。
- 不支援呼叫網站服務。
如需詳細資訊，請參閱適用性表單規則編輯器。
使用變數 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相關資訊，請參閱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);
編輯變數 edit-a-variable
- 在編輯工作流程頁面上，選取工作流程模型Sidekick中可用的「變數」圖示。 左窗格中的變數區段會顯示所有現有的變數。
- 選取鉛筆符號所指示的
- 編輯變數資訊，並選取核取記號所指示的
刪除變數 delete-a-variable
在刪除變數之前，請從工作流程中移除變數的所有參考。 請確定此變數並未用於工作流程中。
若要刪除變數，
- 在編輯工作流程頁面上，選取工作流程模型Sidekick中可用的「變數」圖示。 左窗格中的變數區段會顯示所有現有的變數。
- 選取您要刪除之變數名稱旁的刪除圖示。
- 選取核取記號符號所指示的