使用表單資料模型 use-form-data-model

版本
文章連結
AEM as a Cloud Service
按一下這裡
AEM 6.5
本文章

hero-image

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

表單資料模型是JSON結構描述的擴充功能,可用來執行以下操作:

建立最適化表單和片段 create-af

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

  1. 在新增屬性畫面的表單模型索引標籤中,選取 表單資料模型選取自 下拉式清單。

    create-af-1-1

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

    從資料模型中選取。

    create-af-2-1

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

    create-af-3

根據表單資料模型建立最適化表單或最適化表單片段後,表單資料模型物件會出現在 資料模型物件 最適化表單編輯器中內容瀏覽器的索引標籤。

NOTE
對於最適化表單片段,只有編寫時選取的資料模型物件及其關聯的資料模型物件會出現在資料模型物件索引標籤中。

data-model-objects-tab

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

建立互動式通訊 create-ic

您可以根據表單資料模型來建立互動式通訊,您可以使用已設定資料來源的資料來預先填入互動式通訊。 此外,互動式通訊的建置區塊(例如文字、清單和條件檔案片段)可以表單資料模型為基礎。

建立互動式通訊或檔案片段時,您可以選擇表單資料模型。 下圖顯示「建立互動式通訊」對話方塊的「一般」標籤。

create-ic

建立互動式通訊對話方塊的一般標籤

如需詳細資訊,請參閱:

建立互動式通訊

互動式通訊中的文字

互動式通訊的條件

清單片段

使用範例資料預覽 preview-ic

表單資料模型編輯器可讓您為表單資料模型中的資料模型物件產生和編輯範例資料。 您可以使用此資料來預覽和測試互動式通訊和調適型表單。 在預覽之前產生範例資料,如所述 使用表單資料模型.

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

  1. 在AEM作者執行個體上,瀏覽至 Forms > Forms與檔案.
  2. 選取互動式通訊並選取 預覽 在工具列中選取 網頁管道Print Channel,或 Both Channel 以預覽互動式通訊。
  3. 在預覽中 [頻道] 對話方塊,確認 表單資料模型的測試資料 已選取並選取 預覽.

互動式通訊隨即開啟,並預填樣本資料。

Web預覽

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

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

AEM Forms提供立即可用的表單資料模型預填服務,可讓您啟用最適化表單,以及根據表單資料模型的互動式通訊。 預填服務會在呈現表單或通訊時,查詢最適化表單和互動式通訊中資料模型物件的資料來源,並據以預填資料。

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

預填服務

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

edit-ic-props

互動式通訊的「編輯內容」對話方塊

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

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

若要設定表單資料模型提交動作,請開啟最適化表單容器屬性,然後選取「 」 使用表單資料模型提交 從「提交」摺疊式功能表下的「提交動作」下拉式清單。 然後,瀏覽並選取資料模型物件,從 要提交的資料模型物件的名稱 下拉式清單。 儲存屬性。

在提交表單時,會將已設定資料模型物件的資料寫入各自的資料來源。

資料提交

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

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

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

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

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

    選取 勾選按鈕 以儲存屬性。 附件欄位現在已繫結至表單資料模型的二進位屬性。

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

使用規則在最適化表單中叫用服務 invoke-services

在基於表單資料模型的最適化表單中,您可以 建立規則 以叫用表單資料模型中設定的服務。 此 啟動服務 operation in a rule會列出表單資料模型中的所有可用服務,並讓您選取服務的輸入和輸出欄位。 您也可以使用 設定值 規則型別,用於叫用表單資料模型服務並將欄位的值設定為服務傳回的輸出。

例如,下列規則會叫用以Employee Id作為輸入的get服務,而傳回的值會填入表單中對應的Dependent Id、Last Name、First Name和Gender欄位。

invoke-service

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2