教學課程：在AEM Forms中建立表單資料模型 tutorial-create-form-data-model

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

管理員
使用者
開發人員

04-create-form-data-model-main

此教學課程是建立您的第一個互動式通訊系列中的步驟。建議您依照序列時間順序來瞭解、執行和示範完整的教學課程使用案例。

關於教學課程 about-the-tutorial

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

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

本教學課程將逐步引導您準備、建立、設定表單資料模型，並將其與互動式通訊建立關聯。在本教學課程結束時，您將能夠：

表單資料模型看起來類似以下畫面：

表單資料模型

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

先決條件 prerequisites

開始之前，請確定您具備下列條件：

含有範例資料的MySQL資料庫，如設定資料庫區段中所述。
適用於MySQL JDBC驅動程式的OSGi套件組合，如套件組合JDBC資料庫驅動程式中所述

步驟1：設定資料庫 step-set-up-the-database

建立互動式通訊時，資料庫是必不可少的。本教學課程使用資料庫來顯示表單資料模型和互動式通訊的持續性功能。設定包含客戶、帳單和呼叫表格的資料庫。
下圖說明customer表格的範例資料：

sample_data_cust

使用下列DDL陳述式在資料庫中建立 customer 資料表。

CREATE TABLE `customer` (
   `mobilenum` int(11) NOT NULL,
   `name` varchar(45) NOT NULL,
   `address` varchar(45) NOT NULL,
   `alternatemobilenumber` int(11) DEFAULT NULL,
   `relationshipnumber` int(11) DEFAULT NULL,
   `customerplan` varchar(45) DEFAULT NULL,
   PRIMARY KEY (`mobilenum`),
   UNIQUE KEY `mobilenum_UNIQUE` (`mobilenum`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

使用下列DDL陳述式在資料庫中建立 bills 資料表。

CREATE TABLE `bills` (
   `billplan` varchar(45) NOT NULL,
   `latepayment` decimal(4,2) NOT NULL,
   `monthlycharges` decimal(4,2) NOT NULL,
   `billdate` date NOT NULL,
   `billperiod` varchar(45) NOT NULL,
   `prevbal` decimal(4,2) NOT NULL,
   `callcharges` decimal(4,2) NOT NULL,
   `confcallcharges` decimal(4,2) NOT NULL,
   `smscharges` decimal(4,2) NOT NULL,
   `internetcharges` decimal(4,2) NOT NULL,
   `roamingnational` decimal(4,2) NOT NULL,
   `roamingintnl` decimal(4,2) NOT NULL,
   `vas` decimal(4,2) NOT NULL,
   `discounts` decimal(4,2) NOT NULL,
   `tax` decimal(4,2) NOT NULL,
   PRIMARY KEY (`billplan`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

使用下列DDL陳述式在資料庫中建立呼叫資料表。

CREATE TABLE `calls` (
   `mobilenum` int(11) DEFAULT NULL,
   `calldate` date DEFAULT NULL,
   `calltime` varchar(45) DEFAULT NULL,
   `callnumber` int(11) DEFAULT NULL,
   `callduration` varchar(45) DEFAULT NULL,
   `callcharges` decimal(4,2) DEFAULT NULL,
   `calltype` varchar(45) DEFAULT NULL
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

通話表格包含通話詳細資料，例如通話日期、通話時間、通話號碼、通話期間和通話費用。 customer 資料表已使用行動電話號碼(mobilenum)欄位連結至通話資料表。對於 customer 表格中列出的每個行動電話號碼，通話表格中有多個記錄。例如，您可以參照通話資料表，擷取 1457892541 行動電話號碼的通話詳細資料。

帳單表格包含帳單詳細資訊，例如帳單日期、帳單期間、每月費用及通話費用。 customer 資料表已使用[帳單計畫]欄位連結至帳單資料表。 customer 資料表中每個客戶都有一個相關聯的計畫。帳單表格包含所有現有計畫的定價詳細資料。例如，您可以從 customer 資料表中擷取 Sarah 的計畫詳細資料，並使用這些詳細資料從帳單資料表中擷取定價詳細資料。

步驟2：將MySQL資料庫設定為資料來源 step-configure-mysql-database-as-data-source

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

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

以OSGi套件形式安裝MySQL資料庫的JDBC驅動程式：
1. 以管理員身分登入AEM Forms製作執行個體，並前往AEM網頁主控台套件組合。預設URL為https://localhost:4502/system/console/bundles。
2. 選取 安裝/更新。出現 上傳/安裝組合 對話方塊。
3. 選取 選擇檔案 以瀏覽並選取MySQL JDBC驅動程式OSGi套件。選取 開始套件 和 重新整理套件，然後選取安裝或更新。請確定Oracle Corporation的MySQL JDBC驅動程式處於作用中狀態。已安裝驅動程式。
將MySQL資料庫設定為資料來源：
1. 前往AEM網頁主控台，網址為https://localhost:4502/system/console/configMgr。
2. 找到 Apache Sling Connection Pooled DataSource 設定。選取以在編輯模式中開啟設定。
3. 在設定對話方塊中，指定下列詳細資訊：
  - 資料來源名稱： 您可以指定任何名稱。例如，指定 MySQL。
  - DataSource服務屬性名稱：指定包含DataSource名稱的服務屬性名稱。它是在將資料來源執行個體註冊為OSGi服務時指定。例如，datasource.name。
  - JDBC驅動程式類別：指定JDBC驅動程式的Java類別名稱。針對MySQL資料庫，請指定 com.mysql.jdbc.Driver。
  - JDBC連線URI：指定資料庫的連線URL。對於在連線埠3306和結構描述Teleca上執行的MySQL資料庫，URL是： jdbc:mysql://'server':3306/teleca?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
  - 使用者名稱： 資料庫的使用者名稱。必須啟用JDBC驅動程式才能與資料庫建立連線。
  - 密碼： 資料庫的密碼。必須啟用JDBC驅動程式才能與資料庫建立連線。
  - 借入測試： 啟用 借入測試 選項。
  - 回訪時測試： 啟用 回訪時測試 選項。
  - 驗證查詢： 指定SQL SELECT查詢來驗證集區的連線。查詢至少必須傳回一列。例如，從客戶 選取*。
  - 交易隔離：將值設定為 READ_COMMITTED。
保留其他具有預設值的屬性，並選取儲存。

會建立類似下列的設定。

步驟3：建立表單資料模型 step-create-form-data-model

AEM Forms提供直覺式使用者介面，可讓您從已設定的資料來源建立表單資料模式l。您可以在表單資料模型中使用多個資料來源。在本教學課程的使用案例中，您將使用MySQL做為資料來源。

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

在AEM作者執行個體中，導覽至 Forms > 資料整合。
選取建立 > 表單資料模型。
在建立表單資料模型精靈中，指定表單資料模型的名稱。例如，FDM_Create_First_IC。選取 「下一步」。
選取資料來源畫面會列出所有已設定的資料來源。選取 MySQL 資料來源並選取建立。
按一下完成。已建立 FDM_Create_First_IC 表單資料模型。

步驟4：設定表單資料模型 step-configure-form-data-model

設定表單資料模型包括：

新增資料模型物件及服務
建立資料模型物件的計運算元屬性
新增資料模型物件之間的關聯
編輯資料模型物件屬性
為資料模型物件設定服務

新增資料模型物件及服務 add-data-model-objects-and-services

在AEM作者執行個體上，導覽至 Forms > 資料整合。預設URL為https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm。
此處列出您先前建立的 FDM_Create_First_IC 表單資料模型。選取它並選取編輯。

選取的資料來源 MySQL 會顯示在 資料來源 窗格中。

FDM的
展開 MySQL 資料來源樹狀結構。從 teleca 結構描述選取下列資料模型物件及服務：
- 資料模型物件：
  - 帳單
  - 呼叫
  - 客戶
- 服務：
  - get
  - 更新
選取 新增選取的 以將選取的資料模型物件和服務新增至表單資料模型。

帳單、呼叫和客戶資料模型物件會顯示在模型標籤的右窗格中。取得和更新服務會顯示在服務索引標籤中。

建立資料模型物件的計運算元屬性 create-computed-child-properties-for-data-model-object

計算屬性是根據規則或運算式計算其值的屬性。您可以使用規則將計算屬性的值設定為常值字串、數字、數學運算式的結果或表單資料模型中其他屬性的值。

根據使用案例，使用下列數學運算式在 用料表 資料模型物件中建立 usagecharges 子計算屬性：

使用費=通話費+電話會議費+ SMS費+行動網際網路費+漫遊國家+漫遊國際+ VAS （所有這些屬性都存在於帳單資料模型物件中）
如需 usagecharges 子計算屬性的詳細資訊，請參閱規劃互動式通訊。

執行以下步驟來建立用料表資料模型物件的計運算元屬性：

選取清單資料模型物件頂端的核取方塊以選取它，並選取 建立子屬性。
在 建立子屬性 窗格中：
1. 輸入 usagecharges 作為子屬性的名稱。
2. 啟用 已計算。
3. 選取 Float 作為型別，並選取 Done 將子屬性新增至 bills 資料模型物件。
選取 編輯規則 以開啟規則編輯器。
選擇建立。設定值 規則視窗隨即開啟。
從「選取選項」下拉式清單中，選取 數學運算式。
在數學運算式中，選取 callcharges 和 confcallcharges 分別做為第一和第二物件。選取加作為運運算元。在數學運算式中選取，並選取 延伸運算式 以將 smscharges、internetcharges、roamingnational、roamingintnl 和 vas 物件新增至運算式。

下圖說明規則編輯器中的數學運算式：
選取完成。規則會在規則編輯器中建立。
選取關閉以關閉[規則編輯器]視窗。

在資料模型物件之間新增關聯 add-associations-between-data-model-objects

定義資料模型物件後，您就可以建立它們之間的關聯。關聯可以是一對一或一對多。例如，可以有多個與員工相關聯的相依項。它稱為一對多關聯，在連線相關資料模型物件的線上以1：n表示。但是，如果關聯針對指定的員工ID傳回唯一員工名稱，則稱為一對一關聯。

當您將資料來源中的關聯資料模型物件新增至表單資料模型時，它們的關聯會保留並顯示為以箭頭線連線。

根據使用案例，在資料模型物件之間建立下列關聯：

關聯

資料模型物件

1：n

客戶：通話（每個月帳單中可將多個通話與客戶相關聯）

1:1

customer：bills （一個帳單與特定月份的客戶相關聯）

執行以下步驟來建立資料模型物件之間的關聯：

選取客戶資料模型物件頂端的核取方塊以選取它，並選取 新增關聯。 新增關聯 屬性窗格開啟。
在 新增關聯 窗格中：
- 指定關聯的標題。它是選用欄位。
- 從型別下拉式清單中選取 一對多。
- 從 模型物件 下拉式清單中選取呼叫。
- 從服務下拉式清單中選取 get。
- 選取「新增」以使用屬性將客戶資料模型物件連結至呼叫資料模型物件。根據使用案例，呼叫資料模型物件必須連結至客戶資料模型物件中的行動電話號碼屬性。 新增引數 對話方塊開啟。
在 新增引數 對話方塊中：
- 從名稱下拉式清單中選取 行動裝置。行動號碼屬性是客戶中提供的常見屬性，可呼叫資料模型物件。因此，它可用來建立customer與呼叫資料模型物件之間的關聯。
  對於客戶資料模型物件中可用的每個行動電話號碼，呼叫表格中有多個可用的呼叫記錄。
- 指定引數的選用標題和說明。
- 從 繫結至 下拉式清單中選取客戶。
- 從 繫結值 下拉式清單中選取 mobilenum。
- 選取「新增」。
mobilenum屬性會顯示在引數區段中。
選取完成，在客戶和呼叫資料模型物件之間建立1：n關聯。

在客戶與呼叫資料模型物件之間建立關聯後，在客戶與帳單資料模型物件之間建立1:1關聯。
選取客戶資料模型物件頂端的核取方塊以選取它，並選取 新增關聯。 新增關聯 屬性窗格開啟。
在 新增關聯 窗格中：
- 指定關聯的標題。它是選用欄位。
- 從 Type 下拉式清單中選取 One to One。
- 從 模型物件 下拉式清單中選取清單。
- 從服務下拉式清單中選取 get。 billplan 屬性是清單資料表的主索引鍵，已在引數區段中可用。
  帳單和客戶資料模型物件分別使用帳單計畫(bills)和客戶計畫(customerplan) (customer)屬性連結。在這些屬性之間建立繫結，以擷取MySQL資料庫中任何可用客戶的計畫詳細資訊。
- 從 繫結至 下拉式清單中選取客戶。
- 從 繫結值 下拉式清單中選取 customerplan。
- 選取完成以在billplan和customerplan屬性之間建立繫結。
下列影像說明資料模型物件與用來建立它們之間關聯的屬性之間的關聯：

編輯資料模型物件屬性 edit-data-model-object-properties

在客戶與其他資料模型物件之間建立關聯後，編輯客戶屬性以定義屬性，系統會根據此屬性從資料模型物件中擷取資料。根據使用案例，行動電話號碼會當作屬性使用，以從客戶資料模型物件中擷取資料。

選取 customer 資料模型物件頂端的核取方塊以選取它，並選取 編輯屬性。 編輯屬性 窗格開啟。
指定客戶為 最上層模型物件。
從 讀取服務 下拉式清單中選取 get。
在引數區段中：
- 從 繫結至 下拉式清單中選取 要求屬性。
- 指定 mobilenum 做為繫結值。
從寫入服務下拉式清單中選取更新。
在引數區段中：
- 針對 mobilenum 屬性，從 繫結至 下拉式清單中選取客戶。
- 從 繫結值 下拉式清單中選取 mobilenum。
選取完成以儲存屬性。
選取呼叫資料模型物件頂端的核取方塊以選取它，並選取 編輯屬性。 編輯屬性 窗格開啟。
停用呼叫資料模型物件的 最上層模型物件。
選取「完成」。

重複步驟8至10，設定 用料表 資料模型物件的屬性。

設定服務 configure-services

移至服務標籤。
選取 get 服務並選取 編輯屬性。 編輯屬性 窗格開啟。
在 編輯屬性 窗格中：
- 輸入選用的標題和說明。
- 從 輸出模型物件 下拉式清單中選取客戶。
- 選取完成以儲存屬性。
選取更新服務並選取 編輯屬性。 編輯屬性 窗格開啟。
在 編輯屬性 窗格中：
- 輸入選用的標題和說明。
- 從 輸入模型物件 下拉式清單中選取客戶。
- 選取「完成」。
- 選取儲存以儲存表單資料模型。

步驟5：測試表單資料模型和服務 step-test-form-data-model-and-services

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

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

移至模型標籤，選取客戶資料模型物件，然後選取 測試模型物件。
在 測試表單資料模型 視窗中，從 選取模型/服務 下拉式清單中選取 讀取模型物件。
在 Input 區段中，為已設定之MySQL資料庫中存在的 mobilenum 屬性指定值，並選取測試。

系統會擷取與指定mobilenum屬性相關聯的客戶詳細資訊，並顯示在「輸出」區段中，如下所示。關閉對話方塊。
移至服務標籤。
選取 get 服務並選取 測試服務。
在 Input 區段中，為已設定之MySQL資料庫中存在的 mobilenum 屬性指定值，並選取測試。

系統會擷取與指定mobilenum屬性相關聯的客戶詳細資訊，並顯示在「輸出」區段中，如下所示。關閉對話方塊。