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

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Interactive Communication

04-create-form-data-model-main

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

關於教學課程 about-the-tutorial

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

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

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

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

表單資料模型

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

先決條件 prerequisites

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

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

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

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

sample_data_cust

使用下列DDL陳述式來建立客戶資料庫中的表格。

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陳述式來建立帳單資料庫中的表格。

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

此呼叫此表格包含通話詳細資訊，例如，通話日期、通話時間、通話號碼、通話期間和通話費用。此客戶表格會使用行動電話號碼（行動電話）欄位連結至通話表格。針對中列出的每個行動電話號碼客戶表格中，有多個記錄呼叫表格。例如，您可以擷取以下專案的呼叫詳細資料： 1457892541 藉由參考以下網址取得行動電話號碼：呼叫表格。

此帳單此表格包含帳單明細，例如，帳單日期、帳單期間、每月費用及通話費用。此客戶表格連結至帳單使用「用料表計畫」欄位的表格。有一個計畫與中的每個客戶相關聯，客戶表格。此帳單此表格包含所有現有計畫的訂價明細。例如，您可以擷取計畫詳細資訊 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連線集區資料來源 設定。選取以在編輯模式中開啟設定。
3. 在設定對話方塊中，指定下列詳細資訊：
  - 資料來源名稱： 您可以指定任何名稱。例如，指定 MySQL.
  - 資料來源服務屬性名稱：指定包含DataSource名稱的服務屬性名稱。它是在將資料來源執行個體註冊為OSGi服務時指定。例如， 資料來源。名稱.
  - 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 會顯示在 資料來源 窗格。
展開 MySQL 資料來源樹狀結構從以下資料模型物件和服務中選取 teleca 綱要：
- 資料模型物件：
  - 帳單
  - 呼叫
  - 客戶
- 服務：
  - get
  - 更新
選取 新增選取專案 將選取的資料模型物件和服務加入至表單資料模型。

帳單、呼叫和客戶資料模型物件會顯示在模型標籤。取得和更新服務會顯示在服務標籤。

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

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

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

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

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

選取上方的核取方塊帳單資料模型物件，以選取並選取 建立子屬性.
在 建立子屬性 窗格：
1. 輸入 使用費用 做為子屬性的名稱。
2. 啟用 已計算.
3. 選取 浮點數 作為型別並選取完成將子屬性新增至帳單資料模型物件。
選取 編輯規則 以開啟規則編輯器。
選擇建立。此 設定值 規則視窗隨即開啟。
從選取選項下拉式清單中選取 數學運算式.
在數學運算式中，選取 callcharges 和 confcallcharges 分別做為第一和第二物件。選取加作為運運算元。在數學運算式中選取，然後選取 延伸運算式 以新增 smscharges， 網際費用， roamingnational， roamingintel、和 vas 物件至運算式。

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

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

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

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

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

關聯

資料模型物件

1：n

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

1:1

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

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

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

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

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

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

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

重複步驟8 - 10來設定屬性帳單資料模型物件。

設定服務 configure-services

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

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

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

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

前往模型索引標籤中，選取客戶資料模型物件，並選取 測試模型物件.
在 測試表單資料模型 視窗，選取 讀取模型物件 從 選取模型/服務 下拉式清單。
在輸入區段，指定 mobilenum 已設定之MySQL資料庫中存在的屬性，並選取測試.

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

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