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

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

資料整合

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

表單資料模型(FDM)是JSON架構的擴充功能,可用來執行以下操作:

建立Adaptive Forms和片段 create-af

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

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

    create-af-1-1

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

    從資料模型中選取。

    create-af-2-1

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

    create-af-3

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

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

    data-model-objects-tab

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

使用範例資料預覽 preview-ic

表單資料模型編輯器可讓您為表單資料模型(FDM)中的資料模型物件產生和編輯範例資料。 您可以使用此資料來預覽和測試最適化Forms。 您必須先產生範例資料再進行預覽,如使用表單資料模型中所述。

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

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

Experience Manager Forms提供現成可用的表單資料模型預填服務,您可針對以表單資料模型(FDM)為基礎的最適化Forms 啟用此服務。 預填服務會查詢最適化表單中資料模型物件的資料來源,並在呈現表單或通訊時相應預填資料。

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

預填服務

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

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

若要設定表單資料模型提交動作:

  1. 開啟內容瀏覽器,然後選取最適化表單的「指引容器」元件。

  2. 按一下「指引容器」屬性 指引屬性 圖示。此時會開啟「最適化表單容器」對話框。

  3. 按一下「提交」標籤。

  4. 從​ 提交動作 ​下拉式清單中,選取​ 使用表單資料模型提交

    動作組態

  5. 指定要提交的​ 資料模型

  6. 按一下​ 完成

在提交表單時,會將已設定資料模型物件的資料寫入各自的資料來源。 此外,您可以使用表單資料模型(FDM)和記錄檔案(DoR)將表單附件提交至資料來源。 如需表單資料模型(FDM)的相關資訊,請參閱AEM Forms 資料整合

NOTE
AEM as a Cloud Service提供多種立即可用的提交動作,用於處理表單提交。 您可以在最適化表單提交動作文章中進一步瞭解這些選項。

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

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

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

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

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

    選取 check-button 以儲存屬性。 附件欄位現在已繫結至表單資料模型(FDM)的二進位屬性。

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

使用規則在Adaptive Forms中叫用服務 invoke-services

在基於表單資料模型(FDM)的最適化表單中,您可以建立規則以叫用表單資料模型(FDM)中設定的服務。 規則中的​ 叫用服務 ​作業會列出表單資料模型(FDM)中的所有可用服務,並讓您選取服務的輸入和輸出欄位。 您也可以使用​ 設定值 ​規則型別來叫用表單資料模型服務,並將欄位值設定為服務傳回的輸出。

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

叫用服務

此外,您可以使用guidelib.dataIntegrationUtils.executeOperation API在規則編輯器的程式碼編輯器中撰寫JavaScript。

使用自訂函式叫用表單資料模型(FDM) invoke-form-data-model-using-custom-functions

您可以使用自訂函式🔗,從規則編輯器叫用表單資料模型。 若要叫用表單資料模型(FDM),請將表單資料模型新增至允許清單。 若要將表單資料模型新增至允許清單:

  1. 前往https://server:host/system/console/configMgr的Experience ManagerWeb主控台。
  2. 尋找​ 用於服務引動的最適化表單層級白名單 — 組態處理站
  3. 按一下 加號圖示 圖示以新增組態。
  4. 新增​ 內容路徑模式 ​以指定最適化Forms的位置。 預設值為/content/forms/af/(.*),其中包含所有最適化Forms。 您也可以指定特定最適化表單的路徑。
  5. 新增​ 表單資料模型路徑模式 ​以指定表單資料模型(FDM)的位置。 預設值為/content/dams/formsanddocuments-fdm/(.*),其中包含所有表單資料模型(FDM)。 您也可以指定特定表單資料模型(FDM)的路徑。
  6. 儲存設定。

新增的組態會儲存在​ 用於服務引動的最適化表單資料模型最適化表單層級白名單中 — 組態處理站 ​選項。

NOTE
若要透過AEM原型專案使用自訂函式,從規則編輯器叫用表單資料模型(FDM):
  1. 建立組態檔
  2. 設定getContentPathPattern和getFormDataModelPathPattern的屬性。
  3. 部署專案。

相關文章

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab