以核心元件為主之最適化表單的規則編輯器中的運算子和事件類型
在AEM Forms as a Cloud中,規則編輯器包含各種運運算元型別和事件,可讓您輕鬆定義和執行複雜的條件和動作。
最適化表單的規則編輯器中可用的運運算元型別,提供完善的結構來建構精確條件。 它們可讓您以邏輯且一致的方式操控資料、執行計算以及結合多個條件。 無論您是要比較值、執行算術運算或操控字串,這些運運算元都能確保您的規則既靈活又強大。
規則編輯器中的事件會作為啟動規則的觸發器。 它們定義了在滿足某些條件時發生的特定作。 通過利用不同類型的事件,您可以自動響應各種方案,例如,用戶交互、計劃時間、數據更改和系統狀態。 通過指定這些觸發器,您可以創建滿足特定要求的動態和回應式規則。
透過瞭解並使用可用的運運算元型別和事件,您可以解鎖規則編輯器的完整潛能,這可讓您建立有效率且有效的規則,以滿足您獨特的需求並改善整體系統功能。
規則編輯器中可用的運運算元型別和事件 available-operator-types-and-events-in-rule-editor
規則編輯器提供下列邏輯運運算元和事件,您可使用它們建立規則。
- 等於
- 不等於
- 開頭為
- 結尾為
- 包含
- 不包含
- 是空的
- 不是空的
- 已選取: 當使用者選取核取方塊、下拉式清單單選按鈕的特定選項時,傳回True。
- 已初始化(事件): 當表單物件在瀏覽器中呈現時傳回True。
- 已變更(事件): 當使用者變更表單物件的輸入值或選取的選項時,傳回true。
規則編輯器中的可用規則型別 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
'物件C上的動作3;
Else, do the following:
Action 2 on Object C;
_
當您有多值元件(如單選按鈕或清單)時,為該元件建立規則時,會自動擷取選項,並讓規則建立者可以使用這些選項。 您不需要再次輸入選項值。
例如,清單有四個選項:紅色、藍色、綠色和黃色。 建立規則時,系統會自動擷取選項(選項按鈕),供規則建立者使用,如下所示:
撰寫When規則時,您可以觸發「清除值」動作。 清除值動作會清除指定物件的值。 在When陳述式中將的清除值作為選項可讓您建立具有多個欄位的複雜條件。 您可以新增Else陳述式以進一步新增條件
允許的多個字段 時間 allowed-multiple-fields
在 When 条件中,您可以選擇添加除應用規則的欄位之外的其他字段。
例如,使用 When 規則 類型,可以評估不同表單物件上的條件並執行作:
什麼時候:
(物件 A 條件 1)
和/或
(物件B條件2)
接著,執行下列動作:
物件A上的動作1
_
在When條件功能 中使用允許多個欄位時的考量事項
- 請確定核心元件設定為3.0.14版或更新版本,以便在規則編輯器中使用此功能。
- 如果規則套用至When條件內的不同欄位,即使這些欄位中只有一個已變更,規則也會觸發。
- 您只能為 AND 規則在 When 條件中新增多個欄位。 OR 規則無法執行。
如果「條件」功能中允許的多個欄位發生任何問題,請遵循下列疑難排解步驟:
- 在編輯模式下打開表單。
- 開啟「內容」瀏覽器,然後選擇 最適化表單的「引導容器 」元件。
- 按一下「指引容器」屬性
- 按兩下完成,再次儲存對話框。
隱藏 隱藏指定的物件。
顯示 顯示指定的物件。
啟用 啟用指定的物件。
停用 停用指定的物件。
啟動服務 啟動表單資料模型(FDM)中設定的服務。 選擇「啟動服務」作業時,會出現一個欄位。 點擊該欄位時,它會顯示執行個體 Experience Manager 上所有表單數據模型 (FDM) 中配置的所有服務。 選擇表單數據模型服務時,將顯示更多欄位,您可以在其中將表單物件與指定服務的輸入參數進行映射。 您可以通過指定服務的事件有效負載選項映射輸出參數。 您也可以使用規則編輯器,建立處理叫用服務作業成功和失敗回應的規則。
請參閱叫用表單資料模型(FDM)服務的規則範例。
除了「表單資料模型」服務之外,您還可以指定直接的WSDL URL來叫用Web服務。 不過,表單資料模型服務有許多優點,且建議叫用服務的方法。
如需有關在表單資料模型(FDM)中設定服務的詳細資訊,請參閱Experience Manager Forms 資料整合。
設定值 計算並設定指定物件的值。 您可以將物件值設為字串、其他物件的值、使用數學運算式或函式的計算值、物件屬性的值,或來自已設定表單資料模型服務的輸出值。 當您選擇Web服務選項時,它會顯示您Experience Manager執行個體上所有表單資料模型(FDM)中設定的所有服務。 選擇表單資料模型服務時,會出現更多欄位,您可在其中對應具有指定服務的輸入和輸出引數的表單物件。
如需有關在表單資料模型(FDM)中設定服務的詳細資訊,請參閱Experience Manager Forms 資料整合。
Set Property 規則型別可讓您根據條件動作來設定指定物件的屬性值。 您可以將屬性設為下列其中一項:
- 可見(布林值)
- label.value (字串)
- label.visible (布林值)
- 說明(字串)
- 已啟用(布林值)
- readOnly (布林值)
- 必要(布林值)
- screenReaderText (字串)
- 有效(布林值)
- errorMessage (字串)
- 預設(數字、字串、日期)
- enumNames (字串[])
- chartType (字串)
例如,這可讓您定義規則,以便在按一下按鈕時顯示文字方塊。 您可以使用自訂函式、表單物件、物件屬性或服務輸出來定義規則。
若要根據自訂函式定義規則,請從下拉式清單中選取 函式輸出,然後從 函式 索引標籤中拖放自訂函式。 如果符合條件動作,文字輸入方塊就會顯示。
若要根據表單物件定義規則,請從下拉式清單中選取 表單物件,然後從 表單物件 標籤中拖放表單物件。 如果符合條件動作,文字輸入方塊就會顯示在最適化表單中。
根據物件屬性的「設定屬性」規則可讓您根據最適化表單中包含的其他物件屬性,在最適化表單中顯示文字輸入方塊。
下圖是根據在最適化表單中隱藏或顯示文字方塊來動態啟用核取方塊的範例:
清除值 清除指定物件的值。
設定焦點 將焦點設定在指定的物件上。
提交表單 提交表單。
重設 重設表單或指定的物件。
驗證 驗證表單或指定的物件。
新增執行個體 新增指定之可重複面板或表格列的執行個體。
移除執行個體 移除指定之可重複面板或表格列的執行個體。
函式輸出 根據預先定義的函式或自訂函式定義規則。
導覽至 導覽至其他最適化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
與「顯示」規則型別類似,您可以使用 隱藏 規則型別,根據是否符合條件來顯示或隱藏表單物件。 隱藏規則類型也會在條件不滿足或返回 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;
在面板之間導覽
在面板之間導覽 規則型別可讓您在表單的不同面板之間切換焦點。 例如,您可以建立運算式,將焦點移至下一個面板。
在面板之間導覽 會將焦點移至下一個面板的規則,其結構如下:
Navigate among the panels
Shift focus to the next item Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
同樣地,您可以撰寫 在面板之間導覽 將焦點移至上一個面板的規則:
Navigate among the panels
Shift focus to the previous item Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
如需有關如何建立規則以在面板中導覽的詳細資訊,請按一下這裡。
非同步函式呼叫
這是一項預先發佈功能,可透過我們的預先發佈管道存取。
非同步函式呼叫 規則型別可讓您執行非同步函式。 它可讓您啟動獨立於主要執行緒運作的函式呼叫,讓其他處理程式繼續執行,而不需要等候非同步函式完成。
用來執行非同步函式的典型Async函式呼叫規則的結構如下:
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Async Function call
[Callback Function];
如需如何在視覺規則編輯器中使用非同步函式呼叫的詳細資訊,請參閱規則編輯器🔗中的使用非同步函式呼叫一文。
下一步
讓我們現在瞭解根據核心元件🔗的最適化表單的規則編輯器的各種範例。