教學課程：建立表單資料模型

04-create-form-data-model-main

本教學課程是 建立第一個最適化表單 系列。 建議您依序依序依序執行系列，以了解、執行和示範完整的教學課程使用案例。

關於教學課程

AEM Forms 資料整合模組允許您從不同的後端資料源(如AEM用戶配置檔案、RESTful Web服務、基於SOAP的Web服務、OData服務和關係資料庫)建立表單資料模型。 您可以在表單資料模型中配置資料模型對象和服務，並將其與最適化表單關聯。 適用性表單欄位會系結至資料模型物件屬性。 這些服務可讓您預填最適化表單，並將提交的表單資料寫回資料模型物件。

如需表單資料整合和表單資料模型的詳細資訊，請參閱 AEM Forms資料整合.

本教學課程會逐步引導您完成準備、建立、設定表單資料模型與最適化表單的相關步驟。 在本教學課程結束時，您將能夠：

表單資料模型看起來類似下列：

form-data-model_l

答： 已設定的資料來源 B. 資料來源結構 C. 可用服務 D. 資料模型物件 E. 配置的服務

必備條件

開始之前，請確定您有下列項目：

步驟1:將MySQL資料庫配置為資料源

您可以配置不同類型的資料來源以建立表單資料模型。 在本教程中，我們將配置您配置的MySQL資料庫並填入示例資料。 如需其他支援資料來源以及如何設定的相關資訊，請參閱 AEM Forms資料整合.

請執行下列動作來設定 MySQL 資料庫：

  1. 為安裝JDBC驅動程式 MySQL 資料庫作為OSGi捆綁包：

    1. 下載 MySQL JDBC驅動程式OSGi套件.

    2. 登入AEM Forms 以管理員身分製作執行個體，並前往AEM Web主控台套件組合。 預設URL為 https://localhost:4502/system/console/bundles.

    3. 點選 安裝/更新. 安 上傳/安裝套件組合 對話框。

    4. 點選 選擇檔案 瀏覽並選取 MySQL JDBC驅動程式OSGi捆綁包。 選擇 開始套件組合 和 刷新包，然後點選 安裝或更新. 確保 Oracle Corporation’s JDBC驅動程式 MySQL 活動。 已安裝驅動程式。

  2. 設定 MySQL 資料庫作為資料源：

    1. 前往AEM Web主控台，網址為 https://localhost:4502/system/console/configMgr.

    2. 找出 Apache Sling Connection Pooled DataSource 設定。 點選以在編輯模式中開啟設定。

    3. 在設定對話方塊中，指定下列詳細資料：

      • 資料源名稱： 您可以指定任何名稱。 例如，指定 WeRetailMySQL.
      • 資料源服務屬性名稱:指定包含DataSource名稱的服務屬性的名稱。 在將資料源實例註冊為OSGi服務時指定。 例如， datasource.name.
      • JDBC驅動程式類:指定JDBC驅動程式的Java類名。 針對 MySQL 資料庫，指定 com.mysql.jdbc.driver.
      • JDBC連接URI:指定資料庫的連接URL。 針對 MySQL 在埠3306和架構weretail上運行的資料庫，URL為： jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      注意

      當 MySQL 資料庫位於防火牆後，則資料庫主機名不是公用DNS。 資料庫的IP位址需要新增至 /etc/hosts AEM主機的檔案。

      • 用戶名： 資料庫的用戶名。 需要啟用JDBC驅動程式來建立與資料庫的連接。
      • 密碼： 資料庫的密碼。 需要啟用JDBC驅動程式來建立與資料庫的連接。
      注意

      AEM Forms不支援的NT驗證 MySQL. 前往AEM Web主控台，網址為 https://localhost:4502/system/console/configMgr 和搜索「Apache Sling Connection Pooled Datasource」。對於「JDBC連接URI」屬性，將「integratedSecurity」的值設定為False，並使用建立的用戶名和密碼連接 MySQL 資料庫。

      • 借用時測試： 啟用 借閱時測試 選項。

      • 返回時測試： 啟用 返回時測試 選項。

      • 驗證查詢： 指定SQL SELECT查詢以驗證池中的連接。 查詢必須至少返回一行。 例如， 選取 * 來自customerdetails.

      • 事務隔離:將值設為 READ_COMMITTED.

        保留其他屬性為預設 值 點選 儲存.

        系統會建立類似下列的設定。

        relational-database-data-source-configuration

步驟2:建立表單資料模型

AEM Forms 提供直觀的使用者介面 建立表單資料模型 從設定的資料來源。 您可以在表單資料模型中使用多個資料來源。 針對我們的使用案例，我們將使用已設定的 MySQL 資料來源。

執行下列操作以建立表單資料模型：

  1. 在AEM製作例項中，導覽至 Forms > 資料整合.

  2. 點選 建立 > 表單資料模型.

  3. 在「建立表單資料模型」對話方塊中，指定 名稱 （表單資料模型）。 例如， customer-shipping-billing-details. 點選 下一個.

  4. 選擇資料源螢幕列出所有配置的資料源。 選擇 WeRetailMySQL 資料來源及點選 建立.

    資料源選擇

此 customer-shipping-billing-details 表單資料模型已建立。

步驟3:設定表單資料模型

配置表單資料模型涉及：

  • 添加資料模型對象和服務
  • 配置資料模型對象的讀寫服務

執行下列操作來配置表單資料模型：

  1. 在AEM製作例項上，導覽至 Forms > 資料整合. 預設URL為 https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

  2. 此 customer-shipping-billing-details 您先前建立的表單資料模型會列在此處。 在編輯模式中開啟它。

    所選資料源 WeRetailMySQL 是在表單資料模型中設定。

    default-fdm

  3. 展開WeRailMySQL資料源樹。 從中選擇以下資料模型對象和服務 weretail > customerdetails 表單資料模型的結構：

    • 資料模型物件:

      • id
      • 名稱
      • shippingAddress
      • 城市
      • 狀態
      • 郵遞區號

    • 服務:

      • get
      • 更新

    點選 添加選定內容 將所選資料模型對象和服務添加到表單資料模型。

    WeRetail結構

    注意

    JDBC資料源的預設獲取、更新和插入服務是隨表單資料模型提供的。

  4. 為資料模型對象配置讀寫服務。

    1. 選取 customerdetails 資料模型物件及點選 編輯屬性.

    2. 選擇 get 從「讀取服務」下拉式清單中。 此 id 引數，即customerdetails資料模型物件中的主要索引鍵會自動新增。 點選 aem_6_3_edit 並依下列方式設定引數。

      read-default

    3. 同樣地，請選取 更新 作為寫入服務。 此 customerdetails 物件會自動新增為引數。 引數的設定如下。

      write-default

      新增及設定 id 引數，如下所示。

      id-arg

    4. 點選 完成 保存資料模型對象屬性。 然後，點選 儲存 保存表單資料模型。

      此 get 和 更新 服務會新增為資料模型物件的預設服務。

      data-model-object

  5. 前往 服務 標籤和設定 get 和 更新 服務。

    1. 選取 get 服務與點選 編輯屬性. 屬性對話框開啟。

    2. 在「編輯屬性」對話方塊中指定下列項目：

      • 標題:指定服務的標題。 例如：檢索發運地址。

      • 說明:指定包含服務詳細功能的說明。 例如：

        此服務會從中檢索發運地址和其他客戶詳細資訊 MySQL 資料庫

      • 輸出模型對象:選取包含客戶資料的結構。 例如：

        customerdetail結構

      • 傳回陣列:停用 傳回陣列 選項。

      • 引數:選擇名為的參數 ID.

      點選 完成. 已配置從MySQL資料庫檢索客戶詳細資訊的服務。

      shiiping-address-retrieval

    3. 選取 更新 服務與點選 編輯屬性. 屬性對話框開啟。

    4. 在 編輯屬性 對話框：

      • 標題:指定服務的標題。 例如，更新發運地址。

      • 說明:指定包含服務詳細功能的說明。 例如：

        此服務更新MySQL資料庫中的發運地址和相關欄位

      • 輸入模型對象:選取包含客戶資料的結構。 例如：

        customerdetail結構

      • 輸出類型:選擇 布林值.

      • 引數:選擇名為的參數 ID 和 customerdetails.

      點選 完成. 此 更新 更新客戶詳細資訊的服務，請參閱 MySQL 資料庫已配置。

      shiiping-address-update

配置表單資料模型中的資料模型對象和服務。 您現在可以測試表單資料模型。

步驟4:測試表單資料模型

您可以測試資料模型物件和服務，以驗證表單資料模型是否已正確設定。

執行下列操作以運行測試：

  1. 前往 模型 頁簽，選擇 customerdetails 資料模型物件，並點選 測試模型對象.

  2. 在 測試模型/服務 窗口，選擇 讀取模型對象 從 選擇模型/服務 下拉式清單。

  3. 在 customerdetails 區段，指定 id 已配置的參數中存在的參數 MySQL 資料庫和點選 測試.

    系統會擷取與指定ID相關聯的客戶詳細資料，並顯示在 輸出 區段，如下所示。

    測試讀取模型

  4. 同樣，您也可以測試寫入模型物件和服務。

    在以下示例中，更新服務成功更新了資料庫中ID 7102715的地址詳細資訊。

    測試 — 寫模型

    現在，如果您再次測試id 7107215的讀取模型服務，它將擷取並顯示更新後的客戶詳細資料，如下所示。

    已更新

本頁內容