使用表單資料模型

AEM Forms資料整合可讓您使用分散的後端資料來源來建立表單資料模型,以便在各種調適性表單和互動式通訊工作流程中當做架構使用。 它需要設定資料來源,並根據資料來源中可用的資料模型物件和服務來建立表單資料模型。 如需詳細資訊,請參閱下列:

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

建立最適化表單和片段

您可以根據表單資料模型建立自適應表單自適應表單片段。 在建立自適應表單或自適應表單片段時,請執行以下操作以使用表單資料模型:

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

    create-af-1

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

    從資料模型中選擇。

    create-af-2

  3. 僅適應性表單片段)您可以基於表單資料模型中的一個資料模型對象建立自適應性表單片段。 展開​表單資料模型定義​下拉式清單。 它列出指定表單資料模型中的所有資料模型對象。 從清單中選擇一個資料模型對象。

    create-af-3

一旦基於表單資料模型建立了自適應表單或自適應表單片段,表單資料模型對象將以自適應表單編輯器顯示在內容瀏覽器的​資料模型對象​頁籤中。

注意

對於自適應表單片段,只有在編寫時選擇的資料模型對象及其關聯的資料模型對象才會顯示在「資料模型對象」頁籤中。

data-model-objects-tab

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

建立互動式通訊

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

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

create-ic

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

如需詳細資訊,請參閱:

建立互動式通訊

互動式通訊中的文字

互動式通訊的條件

清單片段

使用範例資料預覽

表單資料模型編輯器允許您為表單資料模型中的資料模型對象生成和編輯示例資料。 您可以使用這些資料來預覽和測試互動式通訊和調適性表單。 在預覽之前,您必須先產生範例資料,如使用表單資料模型所述。

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

  1. 在AEM作者例項上,導覽至​「表單」>「表單與檔案」
  2. 選擇互動式通訊,並點選工具列中的​預覽​以選擇​網頁頻道列印頻道​或​兩個頻道​來預覽互動式通訊。
  3. 在「預覽​[channel]」對話方塊中,確定已選取「測試表單資料模型的資料」,並點選「預覽​」。][

互動式通訊會開啟,並預先填入範例資料。

網頁預覽

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

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

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

要為自適應表單啟用表單資料模型預填充服務,請開啟「自適應表單容器」屬性,並從「基本」accordion的「預填充服務」下拉式清單中選擇「表單資料模型預填充服務」。​****​然後,儲存屬性。

預填充服務

若要在互動式通訊中設定表單資料模型預填服務,您可以在建立表單資料模型預填服務時,在「預填服務」下拉式清單中選取「表單資料模型預填服務」(Form Data Model Prefill Service),或在稍後修改屬性。

edit-ic-props

編輯互動式通訊的屬性對話方塊

將提交的自適應表單資料寫入資料源

當使用者根據表單資料模型提交表單時,您可以設定表單,將資料模型物件的提交資料寫入其資料來源。 為了達成此使用案例,AEM Forms提供表單資料模型提交動作(現成可用於根據表單資料模型的自適應表單)。 它將資料模型對象的提交資料寫入其資料源中。

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

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

資料提交

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

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

  2. 在最適化表單中,將​File Attachment​元件從元件瀏覽器拖放到最適化表單上。

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

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

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

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

使用規則調用最適化表單中的服務

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

例如,下列規則會叫用以員工ID為輸入的get服務,而傳回的值會填入表單中對應的「相依ID」、「姓」、「名字」和「性別」欄位。

調用服務

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

本頁內容