本教學課程是建立您第一個互動式通訊系列中的步驟。 建議依序依序依序排列,以瞭解、執行和展示完整的教學課程使用案例。
AEM Forms資料整合模組可讓您從不同的後端資料來源建立表單資料模型,例如AEM使用者設定檔、REST風格的web services、SOAP架構的web services、OData服務和關聯式資料庫。 您可以在表單資料模型中配置資料模型對象和服務,並將其與自適應表單關聯。 最適化表單欄位會系結至資料模型物件屬性。 這些服務可讓您預先填寫最適化表單,並將提交的表單資料寫回資料模型物件。
如需表單資料整合與表單資料模型的詳細資訊,請參閱AEM Forms Data Integration。
本教學課程會逐步帶您準備、建立、設定表單資料模型,並將之與互動式通訊建立關聯。 在本教學課程結束時,您將能夠:
表單資料模型看起來類似下列:
A. Configured data sources B. Data sources結構 C. Available services D. D. Dobjects configured E.E.D.D.D.D.D.D.D.Services服務
開始之前,請確定您有下列項目:
建立互動式通訊時,資料庫是不可或缺的。 本教學課程使用資料庫來顯示「表單資料模型」和「互動式通訊」的永續性功能。 設定包含客戶、帳單和呼叫表的資料庫。
下圖說明客戶表格的示例資料:
使用以下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語句在資料庫中建立calls表。
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表中列出的每個移動號碼,calls表中有多個記錄。 例如,您可以參照calls表來檢索1457892541移動號碼的呼叫詳細資訊。
bills表格包含帳單詳細資訊,例如帳單日期、帳單期間、每月費用和通話費用。 customer表使用「清單計畫」欄位連結到bills表。 customer表中有與每個客戶關聯的計畫。 bills表格包含所有現有計畫的定價詳細資訊。 例如,您可以從customer表中檢索Sarah的計畫詳細資訊,並使用這些詳細資訊從bills表中檢索定價詳細資訊。
您可以設定不同類型的資料來源以建立表單資料模型。 在本教程中,您將配置已配置並填入示例資料的MySQL資料庫。 如需其他支援資料來源的詳細資訊以及如何設定這些資料來源,請參閱AEM Forms Data Integration。
執行下列操作以配置MySQL資料庫:
將MySQL資料庫的JDBC驅動程式作為OSGi包安裝:
以管理員身分登入AEM Forms Author Instance,然後前往AEM網頁主控台組合。 預設URL為https://localhost:4502/system/console/bundles。
點選安裝/更新。 出現上傳/安裝包對話框。
點選選擇檔案以瀏覽並選擇MySQL JDBC驅動程式OSGi包。 選擇啟動Bundle和刷新包,然後按一下安裝或更新。 確保Oracle Corporation的MySQL JDBC驅動程式處於活動狀態。 已安裝驅動程式。
將MySQL資料庫配置為資料源:
前往https://localhost:4502/system/console/configMgr的AEM網頁主控台。
找到Apache Sling Connection Pooled DataSource組態。 點選以在編輯模式中開啟設定。
在設定對話方塊中,指定下列詳細資訊:
資料來源名稱: 您可以指定任何名稱。例如,指定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驅動程式才能與資料庫建立連接。
借閱時測試: 啟用 Test on Borrow選項。
Test on Return: Enable the Test on Returnoption.
驗證查詢: 指定SQL SELECT查詢以驗證池中的連接。查詢至少必須返回一行。 例如,從customer選擇*。
事務隔離:將值設定為 READ_COMMITTED。
將其他屬性保留為預設值值並點選保存。
系統會建立類似下列的設定。
AEM Forms提供直覺式使用者介面,讓您從設定的資料來源建立表單資料模式l。 您可以在表單資料模型中使用多個資料來源。 在本教程中,您將使用MySQL作為資料源。
執行下列動作以建立表單資料模型:
在AEM作者例項中,導覽至Forms > Data Integrations。
點選「建立 > 表單資料模型」。
在「建立表單資料模型」嚮導中,為表單資料模型指定name。 例如,FDM_Create_First_IC。 點選Next。
選取資料來源畫面會列出所有已設定的資料來源。 選擇MySQL資料源並按一下建立。
按一下Done。 建立FDM_Create_First_IC表單資料模型。
設定表單資料模型包括:
在AEM作者例項上,導覽至Forms > Data Integrations。 預設URL為https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm。
此處列出了您先前建立的FDM_Create_First_IC表單資料模型。 選擇它,然後點選編輯。
選定的資料源MySQL顯示在資料源窗格中。
展開MySQL資料源樹。 從teleca架構中選擇以下資料模型對象和服務:
資料模型物件:
服務:
點選「新增選取的」,將選取的資料模型物件和服務新增至表單資料模型。
清單、呼叫和客戶資料模型對象顯示在Model頁籤的右窗格中。 get和update服務顯示在Services頁籤中。
計算屬性是根據規則或表達式計算其值的屬性。 使用規則,可以將計算屬性的值設定為文本字串、數字、數學表達式的結果或表單資料模型中其他屬性的值。
根據使用案例,使用以下數學表達式在bills資料模型對象中建立usagecharges子計算屬性:
執行以下步驟為清單資料模型對象建立計算子屬性:
選中bills資料模型對象頂部的複選框以選擇它,然後點選建立子屬性。
在建立子屬性窗格中:
點選編輯規則以開啟規則編輯器。
點選Create。 將開啟設定值規則窗口。
從「選擇選項」下拉式清單中,選擇「數學運算式」。
在數學表達式中,分別選擇callcharges和confcallcharges作為第一和第二對象。 選擇plus作為運算子。 在數學運算式中點選並點選「延伸運算式」以新增smscharges、internetcharges、roamingnational、roamingintnl和vas<a111/>對象。
下圖描述了規則編輯器中的數學表達式:
點選Done。 規則會在規則編輯器中建立。
點選「關閉」以關閉「規則編輯器」視窗。
定義資料模型對象後,您可以在它們之間建立關聯。 關聯可以是一對一或一對多。 例如,可以有多個與員工關聯的家屬。 它被稱為一對多關聯,在連接相關資料模型對象的線上以1:n表示。 但是,如果關聯為給定的員工ID返回唯一的員工名稱,則稱為一對一關聯。
將資料源中的關聯資料模型對象添加到表單資料模型時,它們的關聯將保留並顯示為通過箭頭線連接。
根據使用案例,在資料模型物件之間建立下列關聯:
關聯 | 資料模型物件 |
---|---|
1:n | customer:calls(每月帳單中可將多個呼叫與客戶關聯) |
1:1 | 客戶:清單(一個清單與特定月份的客戶關聯) |
執行以下步驟以建立資料模型對象之間的關聯:
選中customer資料模型對象頂部的複選框以選擇它,然後點選添加關聯。 將開啟添加關聯屬性窗格。
在添加關聯窗格中:
指定關聯的標題。 此欄位為選擇性欄位。
從Type下拉式清單中選擇一對多。
從模型對象下拉清單中選擇calls。
從Service下拉式清單中選擇get。
點選「新增」,使用屬性將customer資料模型物件連結至呼叫資料模型物件。 根據使用案例,呼叫資料模型物件必須連結至客戶資料模型物件中的行動號碼屬性。 將開啟添加參數對話框。
在添加參數對話框中:
從名稱下拉式清單中選擇mobilenum。 行動編號屬性是客戶和呼叫資料模型物件中的通用屬性。 因此,它用於建立客戶和調用資料模型對象之間的關聯。
對於客戶資料模型對象中可用的每個移動號碼,呼叫表中有多個可用呼叫記錄。
指定引數的可選標題和說明。
從綁定到下拉清單中選擇customer。
從捆綁值下拉式清單中選擇mobilenum。
點選Add。
mobilenum屬性顯示在Arguments部分。
點選Done可建立客戶與呼叫資料模型物件之間的1:n關聯。
在客戶和呼叫資料模型對象之間建立關聯後,在客戶和清單資料模型對象之間建立1:1關聯。
選中customer資料模型對象頂部的複選框以選擇它,然後點選添加關聯。 將開啟添加關聯屬性窗格。
在添加關聯窗格中:
指定關聯的標題。 此欄位為選擇性欄位。
從Type下拉式清單中選擇一對一。
從模型對象下拉清單中選擇bills。
從Service下拉式清單中選擇get。 billplan屬性是清單表的主鍵,已在Arguments部分中提供。
清單和客戶資料模型對象分別使用開單計畫(清單)和客戶計畫(客戶)屬性進行連結。 在這些屬性之間建立綁定,以檢索MySQL資料庫中任何可用客戶的計畫詳細資訊。
從綁定到下拉清單中選擇customer。
從綁定值下拉清單中選擇customerplan。
點選Done可在計費計畫和客戶計畫屬性之間建立綁定。
下圖描述了資料模型對象和用於建立它們之間關聯的屬性之間的關聯:
在建立客戶與其他資料模型物件之間的關聯後,編輯客戶屬性以定義從資料模型物件擷取資料的屬性。 根據使用案例,使用行動號碼作為屬性,從客戶資料模型物件擷取資料。
選擇customer資料模型對象頂部的複選框以選擇它,然後點選編輯屬性。 將開啟編輯屬性窗格。
將customer指定為頂層模型對象。
從讀取服務下拉式清單中選擇get。
在參數部分:
從綁定到下拉清單中選擇請求屬性。
指定mobilenum作為綁定值。
從Write Service(服務)下拉清單中選擇update。
在參數部分:
對於mobilenum屬性,從綁定到下拉式清單中選擇customer。
從捆綁值下拉式清單中選擇mobilenum。
點選「Done」以儲存屬性。
選中calls資料模型物件頂端的核取方塊以加以選取,然後點選編輯屬性。 將開啟編輯屬性窗格。
針對呼叫資料模型物件停用頂層模型物件。
點選Done。
重複步驟8 - 10以配置bills資料模型對象的屬性。
轉到服務頁籤。
選擇get服務,然後點選編輯屬性。 將開啟編輯屬性窗格。
在編輯屬性窗格中:
輸入可選標題和說明。
從輸出模型對象下拉清單中選擇customer。
點選「Done」以儲存屬性。
選擇update服務並點選編輯屬性。 將開啟編輯屬性窗格。
在編輯屬性窗格中:
輸入可選標題和說明。
從輸入模型對象下拉清單中選擇customer。
點選Done。
點選「儲存」以儲存表單資料模型。
您可以測試資料模型物件和服務,以驗證表單資料模型已正確設定。
執行下列動作以執行測試:
轉至Model標籤,選擇customer資料模型物件,並點選Test Model Object。
在測試表單資料模型窗口中,從選擇模型/服務下拉清單中選擇讀取模型對象。
在Input區段中,為mobilenum屬性指定值,該屬性存在於已配置的MySQL資料庫中,然後點選Test。
會擷取與指定mobilenum屬性相關聯的客戶詳細資料並顯示在「輸出」區段中,如下所示。 關閉對話框。
轉到服務頁籤。
選擇get服務並點選測試服務。
在Input區段中,為mobilenum屬性指定值,該屬性存在於已配置的MySQL資料庫中,然後點選Test。
會擷取與指定mobilenum屬性相關聯的客戶詳細資料並顯示在「輸出」區段中,如下所示。 關閉對話框。
表單資料模型編輯器允許您在表單資料模型中為所有資料模型對象屬性生成示例資料,包括計算屬性。 它是一組隨機值,符合為每個屬性設定的資料類型。 您也可以編輯和儲存資料,即使重新產生範例資料,也會保留這些資料。
執行下列動作以產生、編輯和儲存範例資料:
在表單資料模型頁面上,點選編輯範例資料。 它會在「編輯樣本資料」窗口中生成並顯示樣本資料。
在編輯範例資料視需要編輯資料,然後點選儲存。 關上窗戶。