使用表單資料模型

AEM Forms資料整合可讓您使用不同的後端資料來源來建立表單資料模型,以便在各種最適化表單和互動式通訊工作流程中當作結構描述。 它需要配置資料源,並根據資料源中可用的資料模型對象和服務建立表單資料模型。 如需詳細資訊,請參閱下列內容:

表單資料模型是JSON結構描述的擴充功能,可用於:

建立最適化表單和片段

您可以根據表單資料模型建立適用性表單適用性表單片段。 建立最適化表單或最適化表單片段時,請執行下列動作以使用表單資料模型:

  1. 在「添加屬性」螢幕的「表單模型」頁簽中,從​「從​中選擇」下拉清單中選擇​「表單資料模型」

    create-af-1

  2. 點選以展開​選取表單資料模型。 會列出所有可用的表單資料模型。

    從資料模型中選取。

    create-af-2

  3. 僅適用性表單片段)您可以根據表單資料模型中的一個資料模型物件,建立最適化表單片段。 展開​表單資料模型定義​下拉式清單。 它列出指定表單資料模型中的所有資料模型對象。 從清單中選取資料模型物件。

    create-af-3

建立以表單資料模型為基礎的最適化表單或最適化表單片段後,表單資料模型物件會以最適化表單編輯器顯示在內容瀏覽器的​資料模型物件​標籤中。

注意

對於最適化表單片段,只有在創作時選取的資料模型物件及其相關的資料模型物件會顯示在「資料模型物件」索引標籤中。

data-model-objects-tab

您可以將資料模型物件拖放至最適化表單或片段,以新增表單欄位。 新增的表單欄位會保留中繼資料屬性,並與資料模型物件屬性系結。 系結可確保表單提交時欄位值會在對應的資料來源中更新,並在表單轉譯時預填。

建立互動式通信

您可以根據表單資料模型建立互動式通訊,以便使用來自已設定資料來源的資料預先填入互動式通訊。 此外,互動式通信的構建模組(如文本、清單和條件文檔片段)可以基於表單資料模型。

建立互動式通訊或檔案片段時,您可以選擇表單資料模型。 下圖顯示了「建立交互通信」對話框的「常規」頁簽。

create-ic

「建立互動式通信」對話框的「常規」頁簽

如需詳細資訊,請參閱:

建立互動式通訊

互動式通訊中的文字

互動式通訊中的條件

清單片段

預覽範例資料

表單資料模型編輯器可讓您為表單資料模型中的資料模型物件產生和編輯範例資料。 您可以使用此資料來預覽和測試互動式通訊和最適化表單。 您必須先產生範例資料,然後才能依照使用表單資料模型中所述進行預覽。

若要預覽與範例表單資料模型資料的互動式通訊:

  1. 在AEM製作例項上,導覽至​Forms > Forms與檔案
  2. 選擇互動式通信,然後點選工具欄中的​預覽​以選擇​Web通道打印通道​或​兩個通道​以預覽互動式通信。
  3. 在「預覽​[頻道]」對話方塊中,確定已選取「表單資料模型的測試資料​」,然後點選「​預覽​」。

互動式通訊隨即開啟,其中包含預填的範例資料。

網頁預覽

同樣地,若要預覽含有範例資料的最適化表單,請在製作模式中開啟最適化表單,然後點選​預覽

使用表單資料模型服務預填

AEM Forms提供現成可用的表單資料模型預填服務,讓您能夠根據表單資料模型啟用最適化表單和互動式通訊。 預填充服務以自適應形式和交互通信查詢資料模型對象的資料源,並相應地在呈現表單或通信時預填充資料。

若要為最適化表單啟用「表單資料模型預填服務」,請開啟「適用性表單容器」屬性,然後從「基本」設定追蹤器的「預填服務」下拉式清單中選取「表單資料模型預填服務」。 ​然後,儲存屬性。

預填服務

若要在互動式通訊中設定表單資料模型預填服務,您可以在建立預填服務下拉式清單中選取「表單資料模型預填服務」,或之後透過修改屬性來建立預填服務。

edit-ic-props

編輯互動式通信的屬性對話框

將提交的最適化表單資料寫入資料來源

當使用者根據表單資料模型提交表單時,您可以設定表單以將資料模型物件的已提交資料寫入其資料來源。 為了達成此使用案例,AEM Forms提供表單資料模型提交動作,且僅可立即用於根據表單資料模型的最適化表單。 它會將資料模型物件的已提交資料寫入其資料來源中。

要配置「表單資料模型提交」操作,請開啟「適用性表單容器」屬性,並在「提交」折疊式功能表下的「提交操作」下拉清單中選擇​「使用表單資料模型提交」。 然後,瀏覽並從要提交​的資料模型對象的​名稱下拉清單中選擇資料模型對象。 儲存屬性。

在表單提交時,將配置的資料模型對象的資料寫入相應的資料源。

資料提交

您也可以使用二進位資料模型物件屬性,將表單附件提交至資料來源。 執行以下操作將附件提交到JDBC資料源:

  1. 將包含二進位屬性的資料模型物件新增至表單資料模型。

  2. 在最適化表單中,從「元件」瀏覽器將​檔案附件​元件拖放至最適化表單。

  3. 點選以選取新增的元件,然後點選settings_icon以開啟元件的「屬性」瀏覽器。

  4. 在「系結參考」欄位中,點選foldersearch_18並導覽至選取您在表單資料模型中新增的二進位屬性。 視需要設定其他屬性。

    點選check-button以儲存屬性。 附件欄位現在已綁定到表單資料模型的二進位屬性。

  5. 在適用性表單容器屬性的「提交」區段中,啟用​提交表單附件。 它會在提交表單時將二進位屬性欄位中的附件提交給資料來源。

使用規則在適用性表單中叫用服務

在以表單資料模型為基礎的最適化表單中,您可以建立規則來叫用表單資料模型中設定的服務。 規則中的​調用服務​操作列出表單資料模型中的所有可用服務,並允許您為服務選擇輸入和輸出欄位。 您也可以使用​設定值​規則類型來叫用表單資料模型服務,並將欄位值設為服務傳回的輸出。

例如,以下規則調用以員工ID作為輸入的獲取服務,並且返回的值將填充到窗體中相應的「從屬ID」、「姓氏」、「名字」和「性別」欄位中。

調用服務

此外,您還可以使用guidelib.dataIntegrationUtils.executeOperation API在規則編輯器的程式碼編輯器中撰寫JavaScript。 如需API詳細資訊,請參閱叫用表單資料模型服務的API

本頁內容