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

04-create-form-data-model-main

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

關於教學課程

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

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

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

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

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

form-data-model_l

A. 設定的資 料來源B. 資料來源結 構C. 可用服務 D. 資料模型物件 E. 設定的服務

必備條件

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

MySQL 資料庫，如建立第一個最適化表單的「必要條件」一節中所述，含有範例資料
綁定JDBC資料庫驅動程式中所述MySQL JDBC驅動程式的OSGi綁定
如第一個教學課程建立最適化表單中所述

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

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

執行以下操作來配置MySQL資料庫：

將MySQL資料庫的JDBC驅動程式作為OSGi包安裝：
1. 以管理員身分登入AEM Forms製作執行個體，並前往AEM Web主控台套件組合。預設URL為https://localhost:4502/system/console/bundles。
2. 點選安裝/更新。此時將顯示上載/安裝套件組合對話框。
3. 點選選擇檔案以瀏覽並選擇MySQL JDBC驅動程式OSGi捆綁包。選擇「啟動套件組合」和「刷新套件」，然後點選「安裝或更新」。確保MySQL的Oracle Corporation’s JDBC驅動程式處於活動狀態。已安裝驅動程式。
將MySQL資料庫配置為資料源：
1. 前往AEM Web主控台，網址為https://localhost:4502/system/console/configMgr。
2. 找出Apache Sling Connection Pooled DataSource設定。點選以在編輯模式中開啟設定。
3. 在設定對話方塊中，指定下列詳細資料：
  - 資料來源名稱： 您可以指定任何名稱。例如，指定WeRetailMySQL。
  - 資料源服務屬性名稱:指定包含DataSource名稱的服務屬性的名稱。在將資料源實例註冊為OSGi服務時指定。例如， 資料源.name。
  - JDBC驅動程式類:指定JDBC驅動程式的Java類名。對於MySQL資料庫，請指定com.mysql.jdbc.Driver。
  - JDBC連接URI:指定資料庫的連接URL。對於在埠3306和架構weretail上運行的MySQL資料庫，URL為：jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
  - 用戶名： 資料庫的用戶名。需要啟用JDBC驅動程式來建立與資料庫的連接。
  - 密碼： 資料庫的密碼。需要啟用JDBC驅動程式來建立與資料庫的連接。
  - 借貸時測試： 啟用「借 貸時測 試」選項。
  - 傳回時測試： 啟用傳 回時測 試。
  - 驗證查詢： 指定SQL SELECT查詢以驗證池中的連接。查詢必須至少返回一行。例如， 從customerdetails中選擇*。
  - 事務隔離:將值設定為 READ_COMMITTED。
    
    保留其他屬性，其預設值為values，然後點選Save。
    
    系統會建立類似下列的設定。

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

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

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

在AEM製作例項中，導覽至Forms > 資料整合。
點選「建立 > 表單資料模型」。
在「建立表單資料模型」對話方塊中，為表單資料模型指定名稱。例如， customer-shipping-billing-details。點選Next。
選擇資料源螢幕列出所有配置的資料源。選擇WeRetailMySQL資料源並點選Create。

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

步驟3:配置表單資料模型

配置表單資料模型涉及：

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

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

在AEM製作例項上，導覽至Forms > 資料整合。預設URL為https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm。
您先前建立的customer-shipping-billing-details表單資料模型列於此處。在編輯模式中開啟它。

所選資料源WeRetailMySQL是在表單資料模型中配置的。
展開WeRailMySQL資料源樹。從weretail > customerdetails架構中選擇以下資料模型對象和服務以形成資料模型：
- 資料模型物件:
  - id
  - 名稱
  - shippingAddress
  - 城市
  - 狀態
  - 郵遞區號
- 服務:
  - get
  - 更新
點選「新增選取的 」，將選取的資料模型物件和服務新增至表單資料模型。

注意

JDBC資料源的預設獲取、更新和插入服務是隨表單資料模型提供的。
為資料模型對象配置讀寫服務。
1. 選擇customerdetails資料模型對象，然後點選Edit Properties。
2. 從「讀取服務」下拉清單中選擇get。系統會自動新增id引數，該引數是customerdetails資料模型物件中的主要索引鍵。點選並依下列方式設定引數。
3. 同樣，選擇update作為寫入服務。會自動將customerdetails物件新增為引數。引數的設定如下。
  
  新增並設定id引數，如下所示。
4. 點選Done以儲存資料模型物件屬性。然後，點選儲存以儲存表單資料模型。
  
  將get和update服務新增為資料模型物件的預設服務。
前往Services標籤，並設定get和update服務。
1. 選取get服務，然後點選編輯屬性。屬性對話框開啟。
2. 在「編輯屬性」對話方塊中指定下列項目：
  - 標題:指定服務的標題。例如：檢索發運地址。
  - 說明:指定包含服務詳細功能的說明。例如：
    
    此服務從MySQL資料庫中檢索發運地址和其他客戶詳細資訊
  - 輸出模型物件:選取包含客戶資料的結構。例如：
    
    customerdetail結構
  - 傳回陣列:停用「傳回陣列」選項。
  - 引數:選取名為 ID的引數。
  點選Done。已配置從MySQL資料庫檢索客戶詳細資訊的服務。
3. 選擇update服務，然後點選Edit Properties。屬性對話框開啟。
4. 在編輯屬性對話方塊中指定下列項目：
  - 標題:指定服務的標題。例如，更新發運地址。
  - 說明:指定包含服務詳細功能的說明。例如：
    
    此服務更新MySQL資料庫中的發運地址和相關欄位
  - 輸入模型物件:選取包含客戶資料的結構。例如：
    
    customerdetail結構
  - 輸出類型:選取 布林值。
  - 引數:選取名為ID 和customerdetails 的引數。
  點選Done。已配置update服務以更新MySQL資料庫中的客戶詳細資訊。

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

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

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

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

轉至Model頁簽，選擇customerdetails資料模型對象，然後點選Test Model Object。
在測試模型/服務窗口中，從選擇模型/服務下拉清單中選擇讀取模型對象。
在customerdetails部分中，為配置的MySQL資料庫中存在的id參數指定值，然後點選Test。

與指定ID相關聯的客戶詳細資訊會擷取並顯示在Output區段中，如下所示。
同樣，您也可以測試寫入模型物件和服務。

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

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