將規則新增至最適化表單 adaptive-forms-rule-editor

Adobe 建議使用新式且可擴充的資料擷取核心元件，用來建立新的最適化表單或將最適化表單新增到 AEM Sites 頁面。這些元件代表最適化表單建立方面的重大進步，可確保令人印象深刻的使用者體驗。本文會介紹使用基礎元件編寫最適化表單的舊方法。

概觀 overview

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

規則編輯器提供直覺式且簡化的使用者介面來撰寫規則。 規則編輯器為所有使用者提供一個視覺化編輯器。 您可以使用規則對自適應表單物件執行的一些關鍵操作包括：

新增至表單超級使用者群組的使用者可以建立指令碼並編輯現有指令碼。 forms-users群組中的使用者可以使用指令碼，但不能建立或編輯指令碼。

核心元件中的規則編輯器和基礎元件中的規則編輯器之間的差異

下表示範了規則編輯器的核心元件和規則編輯器的基礎元件中可用功能之間的差異：

了解規則 understanding-a-rule

規則是動作和條件的組合。 在規則編輯器中，動作包括隱藏、顯示、啟用、停用或計算表單中物件值等活動。 條件是對表單物件的狀態、值或屬性執行檢查和作業來評估的Boolean運算式。 根據評估條件所傳回的值（ True或False）執行動作。

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

規則通常會遵循下列其中一種建構：

條件-動作 在此構造中，規則首先定義條件，後跟要觸發的操作。 該結構可與程式設計語言中的if-then語句相媲美。

在規則 編輯者中， When 規則 類型強制實施條件操作構造。

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

規則編輯器中的「顯示」、「隱藏」、「啟用」、「停用」、「設定值」和「驗證」規則型別會強制實施動作條件規則結構。 依預設，「顯示」的替代動作是「隱藏」，而「啟用」的替代動作是「停用」，反之亦然。 您無法變更預設的替代動作。

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

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

雖然您可以使用任何規則建構來實現大部分的使用案例，以下提供一些選擇建構勝過其他建構的准則。 如需規則編輯器中可用規則的詳細資訊，請參閱規則編輯器中的可用規則型別。

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

規則編輯器提供下列邏輯運運算元和事件，您可使用它們建立規則。

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

規則編輯器提供了一組預先定義的規則型別，您可以使用這些型別來撰寫規則。 讓我們來詳細瞭解一下每種規則型別。 如需有關在規則編輯器中寫入規則的詳細資訊，請參閱寫入規則。

什麼時候 whenruletype

When ​ ​規則 類型遵循條件-操作-交替操作​ 規則構造，或者有時僅 ​遵循​ 條件-操作 ​構造。在此規則類型中，首先指定評估條件，然後在滿足條件時觸發操作 （ True）。 使用 When 規則 類型時，可以使用多個 AND 和 OR 運算符來創建 嵌套表達式。

使用 When 規則 類型，您可以評估表單對象的條件並對一個或多個物件執行操作。

簡而言之，典型的 When 規則 結構如下：

When on Object A:

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

Then, do the following:

關於物件B的行動2;
和
關於物件C的行動3;

_

當您有多值元件（如單選按鈕或清單）時，為該元件建立規則時，會自動擷取選項，並讓規則建立者可以使用這些選項。 您不需要再次輸入選項值。

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

撰寫When規則時，您可以觸發「清除值」動作。 清除值動作會清除指定物件的值。 在When陳述式中將的清除值作為選項可讓您建立具有多個欄位的複雜條件。

的值

隱藏 ​隱藏指定的物件。

顯示 ​顯示指定的物件。

啟用 ​啟用指定的物件。

禁用 禁用指定的物件。

啟動服務 ​啟動表單資料模型(FDM)中設定的服務。 選擇「啟動服務」作業時，會出現一個欄位。 點選欄位時，它會顯示您Experience Manager執行個體上所有表單資料模型(FDM)中設定的所有服務。 選擇表單資料模型(FDM)服務時，會出現更多欄位，您可在其中對應具有指定服務的輸入和輸出引數的表單物件。 請參閱呼叫表單資料模型服務的規則範例。

除了表單資料模型服務之外，您還可以指定直接的WSDL URL來叫用Web服務。 不過，表單資料模型服務有許多優點，且建議叫用服務的方法。

如需有關在表單資料模型(FDM)中設定服務的詳細資訊，請參閱Experience Manager Forms 資料整合。

設定值 ​計算並設定指定物件的值。 您可以將物件值設為字串、其他物件的值、使用數學運算式或函式的計算值、物件屬性的值，或來自已設定表單資料模型服務的輸出值。 當您選擇Web服務選項時，它會顯示您Experience Manager執行個體上所有表單資料模型(FDM)中設定的所有服務。 選擇表單資料模型服務時，會出現更多欄位，您可在其中對應具有指定服務的輸入和輸出引數的表單物件。

如需有關在表單資料模型(FDM)中設定服務的詳細資訊，請參閱Experience Manager Forms 資料整合。

Set Property ​規則型別可讓您根據條件動作來設定指定物件的屬性值。 您可以將屬性設定為下列其中一項：

例如，它可讓您定義規則，以動態地將核取方塊新增至最適化表單。 您可以使用自訂函式、表單物件或物件屬性來定義規則。

若要根據自訂函式定義規則，請從下拉式清單中選取​ 函式輸出，然後從​ 函式 ​索引標籤中拖放自訂函式。 如果符合條件動作，則自訂函式中定義的核取方塊數會新增至最適化表單。

若要根據表單物件定義規則，請從下拉式清單中選取​ 表單物件，然後從​ 表單物件 ​標籤中拖放表單物件。 如果符合條件動作，則表單物件中定義的核取方塊數會新增至調適型表單。

根據物件屬性的「設定屬性」規則可讓您根據最適化表單中包含的其他物件屬性，新增最適化表單中的核取方塊數目。

下圖是根據最適化表單中的下拉式清單數量，以動態方式新增核取方塊的範例：

清除值 ​清除指定物件的值。

設定焦點 ​將焦點設定在指定的物件上。

儲存表單 ​儲存表單。

提交Forms ​提交表單。

重設表單 ​重設表單。

驗證表單 ​驗證表單。

新增執行個體 ​新增指定之可重複面板或表格列的執行個體。

移除執行個體 ​移除指定之可重複面板或表格列的執行個體。

導覽至 ​導覽至其他最適化Forms、其他資產（例如影像或檔案片段）或外部URL。

設定值 set-value-of

規則型別的 ​設定值可讓您依據指定的條件是否符合，來設定表單物件的值。 值可以設定為另一個物件的值、常值字串、衍生自數學運算式或函式的值、另一個物件的屬性值，或表單資料模型服務的輸出。 同樣地，您可以檢查元件、字串、屬性或衍生自函式或數學運算式的值的條件。

“ 設置值 規則類型”並非適用於所有表單物件，例如面板和工具列按鈕。 標準的「規則集值」具有下列結構：

將物件 A 的值設定為：

（字串 ABC）或
（物件 屬性 物件 C 的 X）或
（來自函數的值）或
（值來自數學運算式）或
（數據模型服務或Web服務的輸出值）;

時間（選擇）：

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

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

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

節目 show

使用​ 顯示 ​規則型別，您可以撰寫規則來根據條件是否滿足來顯示或隱藏表單物件。 Show規則型別也會觸發Hide動作，以防條件未滿足或傳回False。

典型的Show規則結構如下：

Show Object A;

When:

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

Else:

Hide Object A;

隱藏 hide

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

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

Hide Object A;

When:

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

Else:

Show Object A;

啟用 enable

啟用 ​規則型別可讓您根據條件是否滿足來啟用或停用表單物件。 Enable規則型別也會觸發Disable動作，以防條件不滿足或傳回False。

典型的Enable規則結構如下：

Enable Object A;

When:

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

Else:

Disable Object A;

停用 disable

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

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

Disable Object A;

When:

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

Else:

Enable Object A;

驗證 validate

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

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

Validate Object A;

Using:

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

設定的選項 setoptionsof

Set Options Of ​規則型別可讓您定義規則，以動態地將核取方塊新增至最適化表單。 您可以使用表單資料模型(FDM)或自訂函式來定義規則。

若要根據自訂函式定義規則，請從下拉式清單中選取​ 函式輸出，然後從​ 函式 ​索引標籤中拖放自訂函式。 自訂函式中定義的核取方塊數會新增至最適化表單。

若要建立自訂函式，請參閱規則編輯器中的自訂函式。

若要根據表單資料模型(FDM)定義規則：

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

規則編輯器提供完整但簡單的使用者介面，用於撰寫和管理規則。 您可以在撰寫模式下，從最適化表單中啟動規則編輯器使用者介面。

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

讓我們來詳細瞭解規則編輯器UI的每個元件。

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

顯示啟動規則編輯器所使用之最適化表單物件的標題，以及目前選取的規則型別。 在上述範例中，規則編輯器是從名為Salary的最適化表單物件啟動，且選取的規則型別是When。

B.表單物件與函式 b-form-objects-and-functions-br

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

「表單物件」標籤會顯示最適化表單中包含之所有物件的階層檢視。 它會顯示物件的標題和型別。 撰寫規則時，您可以將表單物件拖放至規則編輯器上。 將物件或函式拖放至預留位置時，在建立或編輯規則時，預留位置會自動採用適當的值型別。

已套用一或多個有效規則的表單物件會以綠色圓點標示。 如果套用至表單物件的任何規則無效，則表單物件會標示為黃點。

函式索引標籤包含一組內建函式，例如Sum Of、Min Of、Max Of、Average Of、Number Of和Validate表單。 您可以使用這些函式計算可重複面板和表格列中的值，並在撰寫規則時在動作和條件陳述式中使用它們。 不過，您也可以建立自訂函式。

在表單物件的左側樹狀結構中，您可以選取表單物件，以顯示套用到每個物件的規則。 您不僅可以瀏覽各種表單物件的規則，也可以在表單物件之間複製 — 貼上規則。 如需詳細資訊，請參閱複製貼上規則。

C.表單物件與功能切換 c-form-objects-and-functions-toggle-br

點選切換按鈕時，會切換表單物件和函式窗格。

D.視覺規則編輯器 visual-rule-editor

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

如需使用視覺化規則編輯器的詳細資訊，請參閱撰寫規則。

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

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

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

寫入規則 write-rules

您可以使用視覺化規則編輯器來撰寫規則<！ — 或程式碼編輯器>。 當您第一次啟動規則編輯器時，它會在視覺化編輯器模式下開啟。 您可以切換到程式碼編輯器模式並編寫規則。 不過，如果您在程式碼編輯器中撰寫或修改規則，則必須清除程式碼編輯器，才能切換至該規則的視覺化編輯器。 當您下次啟動規則編輯器時，編輯器會以您上次使用來建立規則的模式開啟。

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

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

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

範例貸款申請表單中的「貸款需求」區段要求申請人指定其婚姻狀況、薪資，如果已婚，則指定其配偶的薪資。 規則會根據使用者輸入來計算貸款資格金額，並顯示在「貸款資格」欄位中。 套用下列規則以實施情境：

若要撰寫規則，請執行下列步驟：

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

除了列在函式輸出下的現成函式（如​ 總和）之外，您也可以撰寫您經常需要的自訂函式。 確定您撰寫的函式上方有jsdoc。

必須隨附jsdoc：

規則編輯器支援指令碼和自訂函式的JavaScript ES2015語法。
如需詳細資訊，請參閱jsdoc.app。

支援的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個月時，表單會顯示通知，要求更多居住證明。

規則範例 example

啟動表單資料模型服務 invoke

假設有一項Web服務GetInterestRates，它會將貸款金額、保有權及申請者的信用評分當作輸入，並傳回包含EMI金額和利率的貸款計畫。 您可以使用Web服務作為資料來源來建立表單資料模型(FDM)。 您新增資料模型物件和get服務至表單模型。 服務會出現在表單資料模型(FDM)的「服務」標籤中。 接著，建立包含資料模型物件欄位的最適化表單，以擷取貸款金額、使用期限和信用評分的使用者輸入。 新增觸發Web服務擷取計畫詳細資料的按鈕。 輸出會填入適當的欄位中。

下列規則顯示如何設定叫用服務動作來完成範例案例。

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

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

當您在選項按鈕上編寫實施此行為的When規則時，該規則在視覺規則編輯器中會顯示如下。

視覺化編輯器中的規則

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

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

在採購單表單中，您有下表，使用者可在其中填寫訂單。 在此表格中：

A. ​列1 B. ​數量​ C. ​總數量

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

視覺化編輯器中的規則

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

在上一個範例中說明的採購單表單中，您想要限制使用者訂購超過一10000數量的產品。 若要執行此驗證，您可以編寫驗證規則，如下所示。

視覺化編輯器中的規則