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

本文包含最適化Forms核心元件的最新規則編輯器功能，包括：

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

規則編輯器提供直覺式且簡化的使用者介面來撰寫規則。 規則編輯器為所有使用者提供一個視覺化編輯器。您使用規則在最適化表單物件上執行的部分關鍵動作如下：

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

瞭解規則 understanding-a-rule

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

規則編輯器提供一組預先定義的規則型別（例如When、Show、Hide、Enable、Disable、Set Value Of和Validate）以協助您撰寫規則。 每種規則型別都可讓您定義規則中的條件和動作。 本檔案將詳細說明每種規則型別。

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

Condition-Action ​在此建構中，規則會先定義條件，然後定義要觸發的動作。 此建構在程式設計語言中可與if-then statement比較。

在規則編輯器中，When ​規則型別會強制執行condition-action結構。

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

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

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

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

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

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

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

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

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

時間 whenruletype

When ​規則型別遵循​ condition-action-alternate action ​規則建構，有時只遵循​ condition-action ​建構。 在此規則型別中，您先指定評估條件，接著指定滿足條件時觸發的動作( True)。 使用When規則型別時，您可以使用多個AND和OR運運算元來建立巢狀運算式。

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

簡單地說，典型的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；

Else, do the following:

Action 2 on Object C;
_

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

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

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

的值

When中允許多個欄位 allowed-multiple-fields

在​ When ​條件中，您可以選擇新增套用規則的欄位以外的其他欄位。

例如，使用When規則型別，您可以評估不同表單物件的條件並執行動作：

When:

(Object A Condition 1)

AND/OR

(Object B Condtion 2)

Then, do the following:

Action 1 on Object A

_

中允許多個欄位

在When條件功能中使用允許多個欄位時的注意事項

如果「條件」功能中允許的多個欄位發生任何問題，請遵循下列疑難排解步驟：

隱藏 ​隱藏指定的物件。

顯示 ​顯示指定的物件。

啟用 ​啟用指定的物件。

停用 ​停用指定的物件。

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

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

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

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

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

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

例如，這可讓您定義規則，以便在按一下按鈕時顯示文字方塊。 您可以使用自訂函式、表單物件、物件屬性或服務輸出來定義規則。

若要根據自訂函式定義規則，請從下拉式清單中選取​ 函式輸出，然後從​ 函式 ​索引標籤中拖放自訂函式。 如果符合條件動作，文字輸入方塊就會顯示。

若要根據表單物件定義規則，請從下拉式清單中選取​ 表單物件，然後從​ 表單物件 ​標籤中拖放表單物件。 如果符合條件動作，文字輸入方塊就會顯示在最適化表單中。

以物件屬性為基礎的「設定屬性」規則可讓您根據最適化表單中包含的其他物件屬性，在最適化表單中顯示文字輸入方塊。

下圖是根據最適化表單中文字方塊的隱藏或顯示來動態啟用核取方塊的範例：

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

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

提交表單 ​提交表單。

重設 ​重設表單或指定的物件。

驗證 ​驗證表單或指定的物件。

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

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

函式輸出 ​根據預先定義的函式或自訂函式定義規則。

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

分派事件 ​根據預先定義的條件或事件觸發特定動作或行為。

設定值 set-value-of

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

Set Value Of ​規則型別不適用於所有表單物件，例如面板和工具列按鈕。 標準的「設定值」規則具有以下結構：

將物件A的值設為：

（字串ABC）或
（物件C的物件屬性X）或
（函式中的值） OR
（數學運算式的值） OR
（資料模型服務的輸出值）；

當（選擇性）：

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

下面的示例選擇 as True 的值Question2並設置 as correct的值Result。

使用表單數據模型服務設定值 規則的範例。

顯示 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;

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

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

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

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

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

顯示啟動規則編輯器所使用之最適化表單物件的標題，以及目前選取的規則型別。 在上述範例中，規則編輯器是從標題為問題1的最適化表單物件啟動，而選取的規則型別是「何時」。

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

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

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

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

或者，您可以使用「設定值」規則，在您建立用來顯示 — 隱藏「配偶薪資」欄位的「時機」規則中，計算貸款資格。 當「婚姻狀況」為「單一」時，產生的合併規則會顯示在規則編輯器中，如下所示。

您可以使用Else條件，撰寫合併規則以控制「配偶薪資」欄位的可見度，並在「婚姻狀況」為「已婚」時計算貸款資格。

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

除了列在​ 函式輸出 ​下的現成函式（如​ 總和）之外，您也可以在規則編輯器中使用自訂函式。 規則編輯器支援指令碼和自訂函式的JavaScript ECMAScript 2019語法。 如需建立自訂函式的指示，請參閱文章最適化Forms中的自訂函式

管理規則 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數量的產品。 若要執行此驗證，您可以編寫驗證規則，如下所示。

視覺化編輯器中的規則