適用性表單規則編輯器 adaptive-forms-rule-editor

概觀 overview

Adobe Experience Manager Forms中的規則編輯器功能可讓表單業務使用者和開發人員針對最適化表單物件撰寫規則。 這些規則會根據預設條件、使用者輸入和表單上的使用者動作，定義要在表單物件上觸發的動作。 它有助於進一步簡化表單填寫體驗，確保準確性和速度。

規則編輯器提供直覺且簡化的使用者介面，可編寫規則。 規則編輯器為所有使用者提供視覺編輯器。 此外，規則編輯器僅針對表單高級用戶提供編寫規則和指令碼的代碼編輯器。 您可以使用規則對適用性表單物件執行的一些重要動作包括：

規則編輯器取代了AEM 6.1 Forms及舊版中的指令碼功能。 不過，您現有的指令碼會保留在新的規則編輯器中。 如需在規則編輯器中使用現有指令碼的詳細資訊，請參閱 規則編輯器對現有指令碼的影響

新增至Forms-power-users群組的使用者可以建立新指令碼並編輯現有的指令碼。 表單使用者群組中的使用者可以使用指令碼，但無法建立或編輯指令碼。

了解規則 understanding-a-rule

規則是動作和條件的組合。 在規則編輯器中，動作包括隱藏、顯示、啟用、停用或計算表單中物件的值等活動。 條件是布林運算式，通過對表單對象的狀態、值或屬性執行檢查和操作來評估。 動作會根據值( True 或 False)，透過評估條件傳回。

規則編輯器提供一組預先定義的規則類型，例如「時間」、「顯示」、「隱藏」、「啟用」、「停用」、「設定值」和「驗證」，以協助您編寫規則。 每個規則類型都可讓您定義規則中的條件和動作。 本檔案進一步詳細說明每種規則類型。

規則通常遵循下列其中一個結構：

條件 — 動作 在此結構中，規則會先定義條件，接著定義要觸發的動作。 此結構可與寫程式語言中的if-then陳述式比較。

在規則編輯器中， 當 規則類型可強制執行條件 — 動作結構。

動作條件 在此結構中，規則會先定義要觸發的動作，接著定義評估的條件。 此結構的另一個變數是action-condition-alternate動作，也定義了條件傳回False時要觸發的替代動作。

規則編輯器中的「顯示」、「隱藏」、「啟用」、「禁用」、「設定值」和「驗證」規則類型強制實施action-condition規則結構。 預設情況下，「顯示」的替代操作為「隱藏」，「啟用」的替代操作為「禁用」，反之亦然。 不能更改預設替代操作。

如需規則編輯器中可用規則類型的詳細資訊，請參閱 規則編輯器中可用的規則類型.

選擇規則結構的准則 guidelines-for-choosing-a-rule-construct

雖然您可以使用任何規則結構來達到大部分的使用案例，但以下提供一些准則以供您選擇一個結構而非另一個結構。 如需規則編輯器中可用規則的詳細資訊，請參閱 規則編輯器中可用的規則類型.

規則編輯器中可用的運算子類型和事件 available-operator-types-and-events-in-rule-editor

規則編輯器提供下列邏輯運算子和事件，您可使用這些運算子和事件建立規則。

規則編輯器中可用的規則類型 available-rule-types-in-rule-editor

規則編輯器提供一組預先定義的規則類型，您可用來編寫規則。 讓我們詳細查看每個規則類型。 如需在規則編輯器中撰寫規則的詳細資訊，請參閱 寫入規則.

時間 when

此 當 規則類型遵循 condition-action-alternate動作 規則構造，有時只是 condition-action 建構。 在此規則類型中，您會先指定評估的條件，然後在滿足條件時觸發動作( True)。 使用When規則類型時，您可以使用多個AND和OR運算子來建立 嵌套表達式.

使用「時間」(When)規則類型，可以評估表單對象上的條件，並對一個或多個對象執行操作。

簡單來說，典型的「當時」規則的結構如下：

When on Object A:

(Condition 1 AND Condition 2 OR Condition 3) is TRUE;

Then, do the following:

Action 2 on Object B;
AND
Action 3 on Object C;

如果您有多值元件（如選項按鈕或清單），則在為該元件建立規則時，系統會自動擷取選項，並供規則建立者使用。 您不需要再次輸入選項值。

例如，清單有四個選項：紅、藍、綠、黃。 建立規則時，會自動擷取選項（選項按鈕），並讓規則建立者使用，如下所示：

撰寫「時間」規則時，您可以觸發「清除值」動作。 「清除值」(Clear Value Of)操作會清除指定對象的值。 在When語句中將「清除值」(Clear Value)設定為選項，允許您使用多個欄位建立複雜條件。

隱藏 隱藏指定的對象。

顯示 顯示指定的對象。

啟用 啟用指定的對象。

停用 禁用指定的對象。

調用服務 調用在表單資料模型中配置的服務。 選擇「調用服務」操作時，將顯示一個欄位。 點選欄位時，它會顯示您AEM執行個體上所有表單資料模型中設定的所有服務。 選擇表單資料模型服務時，將顯示其他欄位，您可以在其中使用指定服務的輸入和輸出參數映射表單對象。 請參閱叫用表單資料模型服務的範例規則。

除了表單資料模型服務外，還可以指定直接WSDL URL來調用Web服務。 但是，表單資料模型服務有許多優點，並且建議使用調用服務的方法。

如需在表單資料模型中設定服務的詳細資訊，請參閱 AEM Forms資料整合.

設定值 計算並設定指定對象的值。 您可以將對象值設定為字串、另一個對象的值、使用數學表達式或函式的計算值、對象的屬性值或配置的表單資料模型服務的輸出值。 當您選擇Web服務選項時，它會顯示在AEM例項上所有表單資料模型中設定的所有服務。 選擇表單資料模型服務時，將顯示其他欄位，您可以在其中使用指定服務的輸入和輸出參數映射表單對象。

如需在表單資料模型中設定服務的詳細資訊，請參閱 AEM Forms資料整合.

設定屬性 設定指定對象的屬性的值。

清除值 清除指定對象的值。

設定焦點 將焦點設定在指定的對象上。

保存表單 保存表單。

提交Forms 提交表格。

重設表單 重設表單。

驗證表單 驗證表單。

新增例項 添加指定的可重複面板或表行的實例。

刪除實例 刪除指定的可重複面板或表行的實例。

設定下列項目的值: set-value-of

此 設定值 規則類型可讓您根據是否滿足指定條件來設定表單物件的值。 該值可以設定為另一對象的值、常值字串、從數學表達式或函式導出的值、另一對象的屬性的值或表單資料模型服務的輸出。 同樣地，您也可以檢查元件、字串、屬性，或從函式或數學運算式衍生的值上的條件。

請注意，「設定值」規則類型不適用於所有表單對象，如面板和工具欄按鈕。 規則的標準設定值具有下列結構：

將對象A的值設定為：

（字串ABC）或
（對象C的對象屬性X）OR
（來自函式的值）OR
（數學表達式中的值）OR
（資料模型服務或web服務的輸出值）;

時機（選用）:

（條件1、條件2、條件3）為TRUE;

下列範例會將值擷取至 dependentid 欄位作為輸入，並設定 Relation 欄位至 Relation 的引數 getDependent 表單資料模型服務。

使用表單資料模型服務設定值規則範例

顯示 show

使用 顯示 規則類型，您可以撰寫規則以根據是否滿足條件來顯示或隱藏表單物件。 若不滿足或傳回條件，「顯示」規則類型也會觸發「隱藏」動作 False.

典型的「顯示」規則的結構如下：

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

隱藏 hide

與「顯示」規則類型類似，您可以使用 隱藏 規則類型，根據是否滿足條件來顯示或隱藏表單物件。 隱藏規則類型也會在條件不滿足或傳回時觸發顯示動作 False.

典型的隱藏規則結構如下：

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

啟用 enable

此 啟用 規則類型可讓您根據是否滿足條件來啟用或停用表單物件。 若不滿足或傳回條件，「啟用」規則類型也會觸發「停用」動作 False.

一般的「啟用」規則的結構如下：

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

停用 disable

與「啟用」規則類型類似， 停用 規則類型可讓您根據是否滿足條件來啟用或停用表單物件。 若不滿足或傳回條件，「停用」規則類型也會觸發「啟用」動作 False.

典型的「停用」規則的結構如下：

Disable Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Enable Object A;

驗證 validate

此 驗證 規則類型會使用運算式來驗證欄位中的值。 例如，您可以撰寫運算式來檢查用於指定名稱的文字方塊是否不包含特殊字元或數字。

典型的驗證規則結構如下：

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

了解規則編輯器使用者介面 understanding-the-rule-editor-user-interface

規則編輯器提供完整且簡單的使用者介面，可編寫及管理規則。 您可以以製作模式從最適化表單中啟動規則編輯器使用者介面。

若要啟動規則編輯器使用者介面：

讓我們詳細查看規則編輯器UI的每個元件。

A.元件規則顯示 a-component-rule-display

顯示您用來啟動規則編輯器的適用性表單物件標題，以及目前選取的規則類型。 在上述範例中，規則編輯器是從名為Salary的適用性表單物件啟動，而選取的規則類型為When。

B.表單對象和職能 b-form-objects-and-functions-br

規則編輯器使用者介面左側的窗格包含兩個標籤： Forms物件 和 函式.

「表單對象」頁簽顯示適用性表單中包含的所有對象的分層視圖。 它顯示對象的標題和類型。 撰寫規則時，您可以將表單物件拖放至規則編輯器。 在將物件或函式拖放至預留位置時建立或編輯規則時，預留位置會自動取用適當的值類型。

已應用一個或多個有效規則的表單對象標籤為綠色圓點。 如果應用於表單對象的任何規則無效，則表單對象將標籤為黃色圓點。

「函式」索引標籤包含一組內建函式，例如「總和」、「最小值」、「最大值」、「平均值」、「數量」和「驗證表單」。 您可以使用這些函式來計算可重複面板和表格列中的值，並在撰寫規則時於動作和條件陳述式中使用這些值。 不過，您可以建立 自訂函式 也是。

在表單對象的左樹中，可以點選表單對象以顯示應用於每個對象的規則。 您不僅可以瀏覽各種表單物件的規則，還可以在表單物件之間複製貼上規則。 如需詳細資訊，請參閱 複製貼上規則.

C.表單對象和函式切換 c-form-objects-and-functions-toggle-br

切換按鈕在點選時切換表單對象和函式窗格。

D.可視化規則編輯器 d-visual-rule-editor

可視化規則編輯器是規則編輯器用戶介面的可視化編輯器模式中您在其中編寫規則的區域。 它可讓您選取規則類型，並據以定義條件和動作。 在規則中定義條件和動作時，您可以從「表單對象和函式」窗格拖放表單對象和函式。

如需使用可視化規則編輯器的詳細資訊，請參閱 寫入規則.

E.可視化代碼編輯器切換器 e-visual-code-editors-switcher

表單功能使用者群組中的使用者可以存取程式碼編輯器。 對於其他使用者，無法使用程式碼編輯器。 如果您有權限，可以使用規則編輯器上方的切換器，從視覺編輯器模式切換為規則編輯器的程式碼編輯器模式（反之亦然）。 第一次啟動規則編輯器時，它會以視覺編輯器模式開啟。 您可以在可視化編輯器模式下編寫規則，或切換到代碼編輯器模式以編寫規則指令碼。 不過，請注意，如果您修改規則或在程式碼編輯器中撰寫規則，則無法切換回該規則的視覺編輯器，除非您清除程式碼編輯器。

AEM Forms會追蹤您上次用來撰寫規則的規則編輯器模式。 下次啟動規則編輯器時，該編輯器會在該模式中開啟。 不過，您也可以設定預設模式，以在指定模式中開啟規則編輯器。 若要這麼做：

F.完成和取消按鈕 f-done-and-cancel-buttons

此 完成 按鈕來儲存規則。 您可以儲存不完整的規則。 但是，不完整無效且未執行。 下次從相同表單物件啟動規則編輯器時，會列出表單物件上儲存的規則。 您可以在該檢視中管理現有規則。 如需詳細資訊，請參閱 管理規則.

此 取消 按鈕會捨棄您對規則所做的任何變更，並關閉規則編輯器。

寫入規則 write-rules

您可以使用可視化規則編輯器或代碼編輯器來編寫規則。 第一次啟動規則編輯器時，會以視覺編輯器模式開啟規則編輯器。 您可以切換至程式碼編輯器模式並撰寫規則。 不過，請注意，如果您在程式碼編輯器中撰寫或修改規則，則無法切換至該規則的視覺編輯器，除非您清除程式碼編輯器。 下次啟動規則編輯器時，它會以您上次用來建立規則的模式開啟。

先來看看如何使用視覺編輯器撰寫規則。

使用視覺編輯器 using-visual-editor

讓我們使用下列範例表單，了解如何在視覺化編輯器中建立規則。

貸款申請表示例中的「貸款要求」部分要求申請人指定其婚姻狀況、薪金，如果已婚，其配偶的薪金。 此規則會根據用戶輸入計算貸款資格金額，並顯示在「貸款資格」欄位中。 套用下列規則以實作案例：

執行下列步驟來編寫規則：

使用程式碼編輯器 using-code-editor

新增至Forms-power-users群組的使用者可使用程式碼編輯器。 規則編輯器會自動為您使用視覺編輯器建立的任何規則產生JavaScript程式碼。 您可以從視覺編輯器切換至程式碼編輯器，以檢視產生的程式碼。 不過，如果您修改程式碼編輯器中的規則程式碼，則無法切換回視覺編輯器。 如果您偏好在程式碼編輯器中撰寫規則，而非使用視覺化編輯器，則可在程式碼編輯器中重新撰寫規則。 可視化程式碼編輯器切換器可協助您在兩種模式之間切換。

程式碼編輯器JavaScript是最適化表單的運算式語言。 所有運算式都是有效的JavaScript運算式，且會使用最適化表單指令碼模型API。 這些運算式會傳回特定類型的值。 如需適用性表單類別、事件、物件和公用API的完整清單，請參閱 適用於最適化表單的JavaScript程式庫API參考.

如需在程式碼編輯器中撰寫規則的准則詳細資訊，請參閱 適用性表單運算式.

在規則編輯器中撰寫JavaScript程式碼時，下列視覺提示可協助您處理結構和語法：

規則編輯器中的自訂函式 custom-functions

除了列在「函式輸出」下方的*Sum of、*等現成可用函式外，您還可以撰寫您經常需要的自訂函式。 請確定您所撰寫的函式與 jsdoc 在上面。

隨附 jsdoc 為必要項目：

如需詳細資訊，請參閱 usejsdoc.org.

支援 jsdoc 標籤：

新增自訂函式

例如，您想要新增自訂函式，以計算平方的面積。 側長是自訂函式的使用者輸入，在表單中使用數值方塊接受。 計算的輸出會顯示在表單中的另一個數值方塊中。 若要新增自訂函式，您必須先建立用戶端程式庫，然後將其新增至CRX存放庫。

執行下列步驟建立用戶端程式庫，並將其新增至CRX存放庫。

在CRX存放庫中新增用戶端程式庫後，請在最適化表單中使用。 它可讓您將自訂函式當成表單中的規則。 執行下列步驟，在最適化表單中新增用戶端程式庫。

支援的函式聲明類型 function-declaration-supported-types

函式語句

function area(len) {
    return len*len;
}

此函式包含時， jsdoc 意見。

函式表達式

var area;
//Some codes later
/** */
area = function(len) {
    return len*len;
};

函式表達式和語句

var b={};
/** */
b.area = function(len) {
    return len*len;
}

函式聲明為變數

/** */
var x1,
    area = function(len) {
        return len*len;
    },
    x2 =5, x3 =true;

限制：自訂函式只會從變數清單中挑選第一個函式聲明（若相加）。 您可以對每個已宣告的函式使用函式運算式。

函式聲明作為對象

var c = {
    b : {
        /** */
        area : function(len) {
            return len*len;
        }
    }
};

管理規則 manage-rules

當您點選物件並點選時，表單物件上的任何現有規則都會列出 . 您可以檢視標題並預覽規則摘要。 此外，UI可讓您展開和檢視完整的規則摘要、變更規則的順序、編輯規則和刪除規則。

您可以對規則執行下列動作：

複製貼上規則 copy-paste-rules

您可以將規則從一個欄位複製並貼到其他類似欄位，以節省時間。

若要複製貼上規則，請執行下列動作：

巢狀運算式 nestedexpressions

規則編輯器可讓您使用多個AND和OR運算子來建立巢狀規則。 您可以在規則中混合使用多個AND和OR運算子。

以下是一個嵌套規則的示例，該規則在滿足所需條件時向用戶顯示有關子女監護資格的消息。

您也可以拖放規則內的條件來加以編輯。 點選並暫留在控點上( )。 一旦指標變成手形符號（如下所示），將條件拖放至規則內的任意位置。 規則結構會變更。

日期運算式條件 dateexpression

規則編輯器可讓您使用日期比較來建立條件。

以下是範例條件，若已取得房屋上的抵押貸款，則會顯示靜態文字物件，使用者會填寫日期欄位，以表示此條件。

當使用者填入的物業抵押日期為過去時，最適化表單會顯示收入計算的相關附註。 以下規則將用戶填寫的日期與當前日期進行比較，如果用戶填寫的日期早於當前日期，則表單將顯示文本消息（名為「收入」）。

當填充日期早於當前日期時，表單將顯示文本消息（收入），如下所示：

數字比較條件 number-comparison-conditions

規則編輯器可讓您建立比較兩個數字的條件。

如果申請者目前住址的月數少於36，以下是顯示靜態文字物件的範例條件。

當用戶表示他已經在他目前的住宅地址居住了不到36個月時，表格顯示通知，可以請求額外的居住證明。

規則編輯器對現有指令碼的影響 impact-of-rule-editor-on-existing-scripts

在AEM 6.1 Forms Feature Pack 1之前的AEM Forms版本中，表單作者和開發人員可用來在「編輯」元件對話方塊的「指令碼」索引標籤中撰寫運算式，將動態行為新增至最適化表單。 規則編輯器現在會取代「指令碼」索引標籤。

您必須在「指令碼」索引標籤中撰寫的任何指令碼或運算式，都可在規則編輯器中使用。 雖然您無法在可視化編輯器中檢視或編輯指令碼，但如果您是表單功能使用者群組的成員，則可在程式碼編輯器中編輯指令碼。

規則範例 example

調用表單資料模型服務 invoke

考慮Web服務 GetInterestRates 以貸款金額、保有期和申請人的信用評分作為輸入，並返回貸款計畫，包括EMI金額和利率。 您可以使用Web服務作為資料源建立表單資料模型。 添加資料模型對象和 get 服務至表單模型。 服務會顯示在表單資料模型的「服務」標籤中。 然後，建立包含資料模型物件欄位的最適化表單，以擷取貸款金額、保有權和信用分數的使用者輸入。 新增按鈕以觸發Web服務擷取計畫詳細資訊。 輸出會填入適當欄位。

以下規則顯示如何配置調用服務操作以完成示例方案。

使用When規則觸發多個動作 triggering-multiple-actions-using-the-when-rule

在貸款申請表中，您要獲取貸款申請人是否為現有客戶。 根據使用者提供的資訊，應顯示或隱藏客戶ID欄位。 此外，如果使用者是現有客戶，您也想將焦點設定在客戶ID欄位上。 貸款申請表包含下列部分：

在選項按鈕上撰寫「執行時間」規則以實作此行為時，規則會在視覺規則編輯器中顯示如下。

在範例規則中，When區段中的陳述式為條件，當傳回True時，會執行Then區段中指定的動作。

規則在程式碼編輯器中顯示如下。

在規則中使用函式輸出 using-a-function-output-in-a-rule

在採購訂單表單中，您有下表，用戶將在其中填寫訂單。 在下表中：

答： 列1 B. 數量 C. 總數量

現在，您想要在「產品數量」欄中新增所有產品的指定數量，並在「總數量」儲存格中顯示總和。 您可以在「總量」儲存格上撰寫「設定規則值」，如下所示。

使用運算式驗證欄位值 validating-a-field-value-using-expression

在上例中解釋的採購訂單表單中，您希望限制用戶訂購超過一個數量且定價超過10000的任何產品。 若要這麼做，您可以撰寫驗證規則，如下所示。