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

建立互動式通訊的表單資料模型

04-create-form-data-model-main

本教學課程是建立第一個互動式通訊系列中的步驟。 建議您依序依序依序執行系列,以了解、執行和示範完整的教學課程使用案例。

關於教學課程

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

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

本教學課程會逐步引導您完成準備、建立、設定表單資料模型,以及將其與互動式通訊建立關聯的步驟。 在本教學課程結束時,您將能夠:

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

form_data_model_callouts

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

必備條件

開始之前,請確定您有下列項目:

步驟1:設定資料庫

資料庫是建立互動式通信的必要條件。 本教學課程使用資料庫來顯示「表單資料模型」和「互動式通訊」的持續性功能。 設定包含客戶、帳單和呼叫表的資料庫。
下圖說明客戶表格的範例資料:

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

calls​表包括呼叫日期、呼叫時間、呼叫號碼、呼叫持續時間和呼叫費用等呼叫詳細資訊。 customer​表格使用行動號碼(mobilenum)欄位連結至呼叫表格。 對於​customer​表格中列出的每個行動號碼,呼叫​表格中有多個記錄。 例如,您可以參考​呼叫​表格,擷取​1457892541​行動號碼的呼叫詳細資料。

bills​表包括帳單詳細資訊,如帳單日期、帳單期間、每月費用和呼叫費用。 customer​表使用「清單計畫」欄位連結到​bills​表。 customer​表中有與每個客戶關聯的計畫。 bills​表包含所有現有計畫的定價詳細資訊。 例如,您可以從​customer​表中檢索​Sarah​的計畫詳細資訊,並使用這些詳細資訊從​bills​表中檢索定價詳細資訊。

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

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

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

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

    1. 以管理員身分登入AEM Forms Author Instance,並前往AEM Web主控台套件組合。 預設URL為http://localhost:4502/system/console/bundles
    2. 點選​安裝/更新。 此時將顯示​上載/安裝套件組合​對話框。
    3. 點選​選擇檔案​以瀏覽並選擇MySQL JDBC驅動程式OSGi包。 選擇「啟動套件組合」和「刷新套件」,然後點選「安裝」或「更新」。 確保Oracle公司的MySQL JDBC驅動程式處於活動狀態。 已安裝驅動程式。
  2. 將MySQL資料庫配置為資料源:

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

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

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

      • 資料來源名稱: 您可以指定任何名稱。例如,指定​MySQL
      • 資料源服務屬性名稱:指定包含DataSource名稱的服務屬性的名稱。在將資料源實例註冊為OSGi服務時指定。 例如, 資料源.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查詢以驗證池中的連接。查詢必須至少返回一行。 例如, 選擇*來自customer
      • 事務隔離:將值設定為 READ_COMMITTED

    保留其他屬性,其預設值為values,然後點選​Save

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

    apache_configuration

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

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

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

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

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

  3. 在建立表單資料模型精靈中,為表單資料模型指定​名稱。 例如, FDM_Create_First_IC。 點選​Next

  4. 選擇資料源螢幕列出所有配置的資料源。 選擇​MySQL​資料源並點選​Create

    fdm_mysql_data_source

  5. 按一下​Done。 建立​FDM_Create_First_IC​表單資料模型。

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

配置表單資料模型包括:

添加資料模型對象和服務

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

  2. 此處列出了您先前建立的​FDM_Create_First_IC​表單資料模型。 選取它,然後點選​Edit

    所選資料源​MySQL​顯示在​資料源​窗格中。

    mysql_fdm

  3. 展開​MySQL​資料源樹。 從​teleca​架構中選擇以下資料模型對象和服務:

    • 資料模型物件:

      • 票據
      • 呼叫
      • 客戶
    • 服務:

      • get
      • 更新

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

    select_data_model_objs_services

    清單、調用和客戶資料模型對象顯示在​Model​頁簽的右窗格中。 get和更新服務顯示在​Services​頁簽中。

    data_model_objects

為資料模型對象建立計算子屬性

計算屬性是根據規則或表達式計算其值的屬性。 使用規則,可以將計算屬性的值設定為文本字串、數字、數學表達式的結果或窗體資料模型中其他屬性的值。

根據使用案例,使用以下數學表達式在​bills​資料模型對象中建立​usagecharges​子計算屬性:

  • 使用費=呼叫費+電話會議費+簡訊費+移動網際網路費+漫遊國家+漫遊國際+ VAS(所有這些屬性均存在於清單資料模型對象中)

    有關​usagecharges​子計算屬性的詳細資訊,請參閱規劃互動式通信

執行以下步驟為清單資料模型對象建立計算子屬性:

  1. 選中​bills​資料模型對象頂部的複選框以選擇它,然後點選​建立子屬性

  2. 在​建立子屬性​窗格中:

    1. 輸入​usagecharges​作為子屬性的名稱。
    2. 啟用​Computed
    3. 選擇​Float​作為類型,然後點選​Done​以將子屬性添加到​bills​資料模型對象。

    create_child_property_float

  3. 點選​編輯規則​以開啟規則編輯器。

  4. 點選​建立。 將開啟「設定值」規則窗口。

  5. 從「選擇選項」下拉清單中,選擇​數學表達式

    usage_charges_rule_editor

  6. 在數學表達式中,分別選擇​callcharges​和​confcallcharges​作為第一和第二對象。 選擇​plus​作為運算子。 在數學運算式中點選,然後點選​Extend Expression​以將​smschargesinternetchargesroamingnationalroamingintnl​和​vas​物件新增至運算式。

    下圖描述規則編輯器中的數學表達式:

    usage_charges_rule_all

  7. 點選​Done。 規則會在規則編輯器中建立。

  8. 點選​關閉​以關閉「規則編輯器」視窗。

添加資料模型對象之間的關聯

定義資料模型對象後,可以在它們之間建立關聯。 關聯可以是一對一或一對多。 例如,可以有多個與員工相關聯的家屬。 它稱為一對多關聯,在連接相關資料模型對象的線上以1:n表示。 但是,如果關聯為指定的員工ID返回唯一的員工名稱,則稱為一對一關聯。

將資料源中的關聯資料模型對象添加到表單資料模型時,它們的關聯將被保留並顯示為通過箭頭線連接。

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

關聯 資料模型物件
1:n customer:calls(可以在每月帳單中與客戶關聯多個呼叫)
1:1 客戶:帳單(某個特定月的一個帳單與客戶關聯)

執行以下步驟以建立資料模型對象之間的關聯:

  1. 選取​customer​資料模型物件頂端的核取方塊以選取該物件,然後點選​新增關聯。 將開啟​添加關聯​屬性窗格。

  2. 在​添加關聯​窗格中:

    • 指定關聯的標題。 此為選用欄位。
    • 從​Type​下拉清單中選擇​一對多
    • 從​模型物件​下拉式清單中選取​呼叫
    • 從​Service​下拉清單中選擇​get
    • 點選​新增​以使用屬性將​customer​資料模型物件連結至​呼叫​資料模型物件。 根據使用案例,呼叫資料模型物件必須連結至客戶資料模型物件中的行動電話號碼屬性。 將開啟​添加參數​對話框。

    add_association

  3. 在​添加參數​對話框中:

    • 從​Name​下拉清單中選擇​mobilenum。 行動編號屬性是客戶和呼叫資料模型物件中可用的通用屬性。 因此,它可用來建立客戶與呼叫資料模型物件之間的關聯。

      對於客戶資料模型物件中可用的每個行動電話號碼,呼叫表格中有多個可用的呼叫記錄。

    • 指定引數的選用標題和說明。

    • 從​綁定到​下拉清單中選擇​customer

    • 從​綁定值​下拉清單中選擇​mobilenum

    • 點選​新增

    add_association_argument

    mobilenum屬性顯示在​Arguments​區段中。

    add_argument_association

  4. 點選​Done​以建立客戶與呼叫資料模型物件之間的1:n關聯。

    在建立客戶和調用資料模型對象之間的關聯後,在客戶和清單資料模型對象之間建立1:1的關聯。

  5. 選取​customer​資料模型物件頂端的核取方塊以選取該物件,然後點選​新增關聯。 將開啟​添加關聯​屬性窗格。

  6. 在​添加關聯​窗格中:

    • 指定關聯的標題。 此為選用欄位。

    • 從​Type​下拉清單中選擇​One to One

    • 從​模型對象​下拉清單中選擇​清單

    • 從​Service​下拉清單中選擇​getbillplan​屬性是清單表的主鍵,在​Arguments​部分中已可用。

      清單和客戶資料模型對象分別使用開單計畫(清單)和客戶計畫(客戶)屬性進行連結。 在這些屬性之間建立綁定,以檢索MySQL資料庫中任何可用客戶的計畫詳細資訊。

    • 從​綁定到​下拉清單中選擇​customer

    • 從​綁定值​下拉清單中選擇​customerplan

    • 點選​Done​在計費計畫和客戶計畫屬性之間建立綁定。

    add_association_customer_bills

    下圖描述了資料模型對象與用於建立它們之間關聯的屬性之間的關聯:

    fdm_associations

編輯資料模型對象屬性

在建立客戶與其他資料模型對象之間的關聯後,編輯客戶屬性以定義基於其從資料模型對象中檢索資料的屬性。 根據使用案例,行動電話號碼會作為屬性,用於從客戶資料模型物件擷取資料。

  1. 選取​customer​資料模型物件頂端的核取方塊以選取該物件,然後點選​編輯屬性。 將開啟​編輯屬性​窗格。

  2. 將​customer​指定為​頂級模型對象

  3. 從​讀取服務​下拉清單中選擇​get

  4. 在​引數​部分:

    • 從​綁定到​下拉清單中選擇​請求屬性
    • 指定​mobilenum​作為綁定值。
  5. 從​Write​服務下拉清單中選擇​update

  6. 在​引數​部分:

    • 對於​mobilenum​屬性,從​綁定到​下拉清單中選擇​customer
    • 從​綁定值​下拉清單中選擇​mobilenum
  7. 點選​Done​以儲存屬性。

    configure_services_customer

  8. 選取​calls​資料模型物件頂端的核取方塊以選取該物件,然後點選​Edit Properties。 將開啟​編輯屬性​窗格。

  9. 為​調用​資料模型對象禁用​頂級模型對象

  10. 點選​Done

    重複步驟8 - 10以配置​bills​資料模型對象的屬性。

配置服務

  1. 前往​服務​標籤。

  2. 選取​get​服務,然後點選​編輯屬性。 將開啟​編輯屬性​窗格。

  3. 在​編輯屬性​窗格中:

    • 輸入可選標題和說明。
    • 從​輸出模型對象​下拉清單中選擇​customer
    • 點選​Done​以儲存屬性。

    edit_properties_get_details

  4. 選擇​update​服務,然後點選​Edit Properties。 將開啟​編輯屬性​窗格。

  5. 在​編輯屬性​窗格中:

    • 輸入可選標題和說明。
    • 從​輸入模型對象​下拉清單中選擇​customer
    • 點選​Done
    • 點選​儲存​以儲存表單資料模型。

    update_service_properties

步驟5:測試表單資料模型和服務

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

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

  1. 前往​Model​標籤,選取​customer​資料模型物件,然後點選​Test Model Object

  2. 在​測試表單資料模型​窗口中,從​選擇模型/服務​下拉清單中選擇​讀取模型對象

  3. 在​Input​部分中,為​mobilenum​屬性指定值,該屬性存在於配置的MySQL資料庫中,然後點選​Test

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

    test_data_model

  4. 前往​服務​標籤。

  5. 選擇​get​服務,然後點選​測試服務。

  6. 在​Input​部分中,為​mobilenum​屬性指定值,該屬性存在於配置的MySQL資料庫中,然後點選​Test

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

    test_service

編輯和保存示例資料

表單資料模型編輯器可讓您為表單資料模型中的所有資料模型物件屬性產生範例資料,包括計算屬性。 這是一組符合為每個屬性設定的資料類型的隨機值。 您也可以編輯和儲存資料,即使重新產生範例資料,資料也會保留。

執行下列操作以生成、編輯和保存示例資料:

  1. 在表單資料模型頁面上,點選​編輯範例資料。 它會在「編輯範例資料」視窗中產生並顯示範例資料。

    edit_sample_data

  2. 在「編輯示例資料」窗口中,根據需要編輯資料,然後點選「保存」。 關窗。

本頁內容