[AEM Forms]{class="badge positive" title="適用於AEM Forms)。"}

互動式通訊編輯器中未繫結的變數元件

​1. 簡介

互動式通訊(IC)編輯器中的​ 未繫結變數 ​元件可讓您放置其值未繫結至任何外部資料模型或結構描述節點的欄位。 而是透過指令碼、規則型計算或靜態預設提供值,因此每當您需要並非直接來自繫結資料來源的計算或中間顯示值時,此元件都是正確的選擇。

由於未繫結變數未連線至表單資料模型,因此它可讓您在設計階段和執行階段完整地編寫值。 您可以使用它來顯示計算總計、動態產生的參考編號、中間公式結果或規則引擎產生的任何其他值。

元件支援所有四種資料型別​文字數值日期​和​日期/時間,而且使用中的資料型別會決定套用的顯示模式語法和圖片子句符號。

​2. 顯示模式

您可以使用與文字方塊、數值欄位、日期欄位和日期/時間欄位元件相同的顯示模式控制項,從​ 屬性 ​面板將​ 顯示模式 ​指派給未繫結變數欄位。 這允許在畫布預覽和產生的輸出中格式化呈現計算或參考的值。

已設定的圖樣會立即反映在畫布預覽中,並在儲存和重新載入週期中保留。

設定顯示模式

  1. 在設計畫布上選取「未繫結變數」元件。
  2. 開啟​ 屬性 ​面板。
  3. 在​ 顯示模式 ​區段中,選擇預先定義的模式或輸入自訂圖片子句。
  4. 預覽畫布上的格式化值。

選擇正確的圖樣

由於未繫結變數可以儲存任何資料型別,因此您使用的picture子句語法必須符合欄位已設定的資料型別:

欄位資料型別
圖樣語法
範例輸出
參照
文字
text{…}
(555) 123-4567
文字方塊 — 顯示模式
數值
num{…}
$1,234.21
數值欄位 — 顯示模式
日期
date{…}
01/04/2007
日期欄位 — 顯示模式
日期/時間
date{…} time{…}
04/01/2007 14:30
日期/時間欄位 — 顯示模式
NOTE
如果欄位的資料型別是日期或日期/時間,則基礎值必須符合​ ISO 8601 ​格式(YYYY-MM-DDYYYY-MM-DDTHH:MM)。 未遵循此格式的值會依原樣顯示,不會套用顯示模式。

​3. 屬性

未繫結變數元件與其他欄位元件共用一組共同屬性,有一個主要區別:它支援任何資料來源或互動式通訊片段的外部資料繫結選項。

3.1基本欄位

  • 名稱:​變數的唯一識別碼。 用於在IC內的規則、指令碼和運算式中參考它。

  • 資料型別:​指定此變數儲存的值型別: 文字數值日期​或​日期/時間。 選取的資料型別會決定要套用哪些顯示模式語法,以及如何驗證值。

  • 標題:​畫布上欄位旁邊的標籤(例如,「計算總數」或「參考編號」)。

  • 值:​欄位中顯示的預設值或計算值。 在大多數情況下,這會使用規則編輯器或指令碼以程式設計方式設定,而不是手動輸入。

  • 保留:​當沒有可用的計算值時顯示的遞補值,對於無法接受空白欄位的唯印或唯讀輸出很有用。

  • 外觀:​欄位容器的視覺樣式預設集(無、實線方塊或底線)。

3.2印刷樣式

控制顯示值的樣式設定方式:

  • 字型變化:​選擇符合周圍內容的字型系列、粗細(一般、粗體)和樣式(斜體)。

  • 字型大小:​預設通常會設為10 pt;請調整以維持與其他通訊的視覺一致性。

3.3位置

定義元件在畫布上的位置:

  • X和Y座標:​設定精確的水平與垂直位置。

  • 寬度和高度:​指定以公厘為單位的尺寸,以對齊相鄰的元素。

3.4邊界

定義元件邊界周圍的間距:

  • 上(上)

  • 下(下)

3.5外觀

設定欄位容器的樣式:

  • 填滿:​欄位的背景顏色。

  • 筆畫:​欄位周圍框線,包含下列選項:

    • 寬度:​邊框粗細。

    • 樣式:​實線、虛線或點線。

    • Edge:​圓角或銳角。

3.6存在

控制執行階段的可見度:

  • 可見:​顯示欄位並佔用版面空間。

  • 隱藏(保留空間):​欄位不可見,但版面配置空間會保留,當使用規則編輯器動態切換可見性時很有用。

​4. 用途

當您要顯示的值為時,請使用未繫結變數:

  • 由規則或指令碼計算 — 例如,執行總計、稅捐計算或從其他欄位值衍生的折扣金額。

  • 以程式設計方式產生 — 例如,後端邏輯在執行階段指派的參考號碼或追蹤代碼。

  • 在資料模型​中無法使用 — 例如,在熒幕上有意義但不作為結構描述欄位存在的中間結果。

  • 有條件可見 — 只有在符合特定條件時,才會顯示計算訊息或值,並使用規則編輯器一起設定可見度和值。

您可以將「未繫結變數」放置在子表單、版面配置容器內,或直接放置在設計畫布上。 將其與規則編輯器結合,以撰寫運算式,根據IC中的其他繫結欄位計算其值。

​5. 最佳做法

  • 設定有意義的保留值,以便在運算值無法使用時,列印輸出和唯讀預覽絕不會顯示空白欄位。

  • 將資料型別與輸出配對 — 如果您要計算貨幣金額,請將資料型別設定為「數值」並套用數值顯示模式;如果計算日期,請將它設定為「日期」並確保ISO 8601輸入。

  • 使用清楚的註解 — 因為值已經過計算,而且無法從標籤直接辨識,所以描述性註解(例如「小計(已計算)」)可防止檢閱者和一般使用者混淆。

  • 避免對屬於模型​的資料過度使用未繫結變數 — 如果值可以合理地新增到表單資料模型,則偏好繫結標準欄位。 保留「未繫結變數」給真正為暫時或衍生的值。

  • 記錄您的運算式 — 在規則編輯器中加入註解,說明每個未繫結變數的計算內容,以便稍後編輯互動通訊時,邏輯仍可維持。

另請參閱

recommendation-more-help
experience-manager-cloud-service-help-main-toc