Tutorial: Create form data model

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

關於教學課程

AEM Forms 資料整合模組可讓您從不同的後端資料來源建立表單資料模型，例如AEM使用者設定檔、REST風格的web services、SOAP架構的web services、OData服務和關聯式資料庫。 您可以在表單資料模型中配置資料模型對象和服務，並將其與自適應表單關聯。 最適化表單欄位會系結至資料模型物件屬性。 這些服務可讓您預先填寫最適化表單，並將提交的表單資料寫回資料模型物件。

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

本教學課程將逐步帶您準備、建立、設定表單資料模型，並將表單資料模型與最適化表單建立關聯。 在本教學課程結束時，您將能夠：

• 將MySQL資料庫配置為資料源
• 使用MySQL資料庫建立表單資料模型
• 設定表單資料模型
• 測試表單資料模型

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

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

必備條件

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

• MySQL 資料庫，其示例資料如建立第一個自適應表單的「必 備條件」部分中所述
• OSGi Bundle for MySQL JDBC driver，如捆綁JDBC數 據庫驅動程式中所述
• 如第一個教學課程中所述的最適化表 單建立最適化表單

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

您可以設定不同類型的資料來源以建立表單資料模型。 在本教程中，我們將配置您配置的MySQL資料庫，並用示例資料填充該資料庫。 如需其他支援資料來源的詳細資訊以及如何設定這些資料來源，請參 閱AEM Forms Data Integration。

執行下列操作以配置數 MySQL 據庫：

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

   1. 以管理員身分登入「AEM Forms Author Instance」，然後前往AEM網頁主控台組合。 預設URL為 https://localhost:4502/system/console/bundles。

   2. 點選 安裝／更新。 出現 「上載／安裝組合 」對話框。

   3. 按一下 選擇檔案 ，瀏覽並選擇 MySQL JDBC驅動程式OSGi包。 選擇「 啟動Bundle 」和「重 新整理套件」，然後點選「 安裝」或「更新」。 確保的 Oracle Corporation’s JDBC驅動程式 MySQL 處於活動狀態。 已安裝驅動程式。

2. 將數 MySQL 據庫配置為資料源：

   1. 前往https://localhost:4502/system/console/configMgr的AEM網頁主控 台。

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

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

      • 資料來源名稱： 您可以指定任何名稱。 例如，指定 WeRetailMySQL。

      • DataSource服務屬性名稱:指定包含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

      • 使用者名稱： 資料庫的用戶名。 必須啟用JDBC驅動程式才能與資料庫建立連接。

      • 密碼： 資料庫的口令。 必須啟用JDBC驅動程式才能與資料庫建立連接。

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

      • 回訪時測試： 啟用「 Test on Return 」選項。

      • 驗證查詢： 指定SQL SELECT查詢以驗證池中的連接。 查詢至少必須返回一行。 例如，從 客戶詳細資料中選擇*。

      • 事務隔離:將值設定為 READ_COMMITTED。

        將其他屬性保留為預設 值 ，然後點 選「儲存」。

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

        

Step 2: Create form data model

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

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

1. 在AEM作者例項中，導覽至「表 單 >資 料整合」。

2. Tap Create > Form Data Model.

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

4. 選取資料來源畫面會列出所有已設定的資料來源。 選擇 WeRetailMySQL 資料源並點選 建立。

   

建 立客戶運送——帳單——詳細資訊 ，表單資料模型。

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

配置表單資料模型涉及：

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

執行下列動作以設定表單資料模型：

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

2. 您 先前建立的客戶——裝運——帳單——詳細資料 -表單資料模型列於此處。 在編輯模式中開啟。

   所選資料源 WeRetailMySQL 是在表單資料模型中配置的。

   

3. 展開WeRailMySQL資料源樹。 從Weretail > customerdetails ​​schema選擇下列資料模型物件和服務，以建立資料模型：

   • 資料模型物件:

     • id
     • 名稱
     • shippingAddress
     • 城市
     • 狀態
     • zipcode

   • 服務:

     • get
     • 更新

   點選 「新增選取項 」，將選取的資料模型物件和服務新增至表單資料模型。

   

   注意

   JDBC資料來源的預設get、update和insert服務是隨附表單資料模型的現成可用功能。

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

   1. 選擇客戶詳 細資料 ，並點選「編 輯屬性」。

   2. 從「 讀取服務 」下拉式清單中選取「取得」。 自 動添加 id引數，該引數是customerdetails資料模型對象中的主鍵。 點選 ，然後依如下方式設定引數。

      

   3. 同樣地，選擇 更新 作為寫入服務。 customerdetails 對象 會自動添加為參數。 參數的配置如下。

      

      按如下方式新增 及設定 ID引數。

      

   4. 點選「 完成 」以儲存資料模型物件屬性。 然後點選「 儲存 」以儲存表單資料模型。

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

      

5. 前往「服務 」標籤 ，並設 定get and update services 。

   1. 選擇get服務 並點選 「編輯 屬性」。 屬性對話框開啟。

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

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

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

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

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

        customerdetail架構

      • 返回陣列:禁用「 Return array （返回陣列）」選項。

      • 引數:選擇名為 ID的引數。

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

      

   3. 選擇更新 服務 ，然後點選「 編輯屬性」。 屬性對話框開啟。

   4. 在「編輯屬性」對話 框中指定 :

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

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

        此服務會更新MySQL資料庫中的送貨地址和相關欄位

      • 輸入模型物件:選擇包含客戶資料的結構。 例如：

        customerdetail架構

      • 輸出類型:選擇 布爾。

      • 引數:選擇名為 ID的引數 和 客戶詳細資訊。

      點選「 完成」。 配置 了更新 ，以在資料庫中更新客戶 MySQL 詳細資訊。

      

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

Step 4: Test form data model

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

執行下列動作以執行測試：

1. 轉至「模 型 」標籤，選取 customerdetails 資料模型物件，並點選「 測試模型物件」。

2. 在「測 試模型／服務 」窗口中，從「選擇模型／服務」(Select Model/Service ​​​ )下拉式清單中選擇「讀取模型對象」(Read model object)。

3. 在customerdetails 節中，為已配置資料庫中存在的 id 參數指定一個值，然 後點選 MySQL 測試 ​。

   會擷取與指定ID相關的客戶詳細資訊，並顯示在「輸 出 」區段中，如下所示。

   

4. 同樣地，您也可以測試Write模型對象和服務。

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

   

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