AEM工作流程中的變數

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

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

• 建立變數 根據您想要儲存在其中的資訊型別而建立的資料型別。
• 設定變數的值 使用「設定變數」工作流程步驟。
• 使用變數 在「OR分割」和「跳至AEM」工作流程步驟中，您可以定義用於決定路由的運算式。 您也可以在所有AEM Forms工作流程步驟中使用變數。

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

變數是 中繼資料對應 介面。 您可以使用 中繼資料對應 以存取使用變數儲存的中繼資料。

建立變數

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

• 基本資料型別：長、雙、布林值、日期和字串
• 複雜的資料型別： XML 和 JSON

如需AEM Forms工作流程中可用的其他複雜資料型別，請參閱 AEM Forms工作流程中的變數. 使用ArrayList資料型別建立變數集合。 您可以為所有基本和複雜資料型別建立ArrayList變數。 例如，建立ArrayList變數並選取String作為子型別，以使用變數儲存多個字串值。

若要建立變數，

1. 在AEM執行個體上，導覽至「工具>工作流程>模型」。

2. 點選 建立 和指定工作流程模型的標題和選用名稱。 選取模型並點選 編輯.

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

   

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

5. 從中選擇資料型別 型別 下拉式清單，並指定下列值：

   • 基本資料型別 — 指定變數的選用預設值。
   • JSON或XML — 指定選用的JSON或XML結構描述路徑。 當對應並儲存此結構描述中可用的屬性至另一個變數時，系統會驗證結構描述路徑。
   • 表單資料模型 — 指定表單資料模型路徑。
   • ArrayList — 指定集合的子型別。

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

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

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

設定變數

您可以使用「設定變數」步驟來設定變數的值，並定義設定值的順序。 變數的設定順序，是將變數對應列在設定變數步驟中。

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

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

• 常值： 知道要指定的確切值時使用選項。
• 運算式： 根據運算式計算要使用的值時，請使用選項。 運算式會在提供的運算式編輯器中建立。
• JSON點標籤法： 使用選項從JSON或FDM型別變數擷取值。
• XPATH： 使用選項從XML型別變數擷取值。
• 相對於裝載： 當要儲存至變數的值可在相對於承載的路徑取得時，請使用選項。
• 絕對路徑： 當要儲存至變數的值可在絕對路徑取得時，請使用選項。

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

新增變數之間的對應

若要新增變數之間的對應，請執行下列動作：

1. 在工作流程編輯頁面上，點選工作流程模型Sidekick中可用的「步驟」圖示。
2. 拖放 設定變數 步驟至工作流程編輯器，點選該步驟，然後選取 （設定）。
3. 在「設定變數」對話方塊中，選取 對應 > 新增對應.
4. 在 對應變數 區段，選取要儲存資料的變數、選取對應模式，然後指定要儲存在變數中的值。 對應模式會因變數型別而異。
5. 對應更多變數，以便做出有意義的運算式。 點選 以儲存變更。

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

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

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

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

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

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

使用運算式編輯器

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

使用運算式編輯器可以：

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

它以適用性表單規則編輯器為基礎，有下列變更。 變數中的規則編輯器：

• 不支援函式。
• 不提供UI來檢視規則摘要
• 沒有程式碼編輯器。
• 不支援啟用和停用物件的值。
• 不支援設定物件的屬性。
• 不支援呼叫網站服務。

如需詳細資訊，請參閱 調適型表單規則編輯器.

使用變數

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

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

支援變數的工作流程步驟

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

OR分割步驟

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

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

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

在此範例中，在定義路由運算式之前，請使用 範例2 設定 totalvalue 變數。 如果下列專案的值，則分支1處於活動狀態： totalvalue 變數大於50000。 同樣地，您可以定義一個規則，使「分支2」成為活動狀態，如果 totalvalue 變數小於50000。

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

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

前往步驟

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

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

您可以使用變數來定義使用運算式編輯器的路由運算式。 如需在「跳至」步驟中使用路由運算式的詳細資訊，請參閱 移至步驟.

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

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

以Forms工作流程為中心的工作流程步驟

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

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

您可以使用 中繼資料對應 介面以存取工作流程步驟中不支援變數的變數。

擷取變數值

若要根據資料型別擷取現有變數的值，請在ECMA指令碼中使用以下API。

如需AEM Forms工作流程中可用的其他複雜變數資料型別API的相關資訊，請參閱 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)

更新 薪資 變數50000。

設定變數以叫用工作流程

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

workflowSession.startWorkflow 使用model、wfData和metaData作為引數。 使用MetaDataMap設定變數的值。

在此API中， variablename 變數設為 值 使用metaData.put(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);

編輯變數

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

刪除變數

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

若要刪除變數，

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

Business.Adobe.com 資源

Ecommerce Integrations Auto Form Fill Targeted Content Asset Collections Content Management Content Management System