文件AEM 6.4Forms 指南

使用表單資料模型 work-with-form-data-model

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • User
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.

資料整合提供表單資料模型編輯器，可設定及使用表單資料模型。

表單資料模型編輯器提供直覺式使用者介面和工具，可用於編輯和設定表單資料模型。 使用編輯器，可以在表單資料模型中，從關聯的資料源添加和配置資料模型對象、屬性和服務。 此外，它還允許您建立資料模型對象和屬性，而不使用資料源，並以後將它們與相應的資料模型對象和屬性綁定。 您也可以為資料模型物件屬性產生和編輯範例資料，以便在預覽時預填最適化表單和互動式通訊。 您可以測試在表單資料模型中設定的資料模型物件和服務，以確保其與資料來源正確整合。

如果您是初次使用Forms資料整合，且尚未設定資料來源或建立表單資料模型，請參閱下列主題：

請閱讀，了解使用表單資料模型編輯器可執行的各種任務和設定的詳細資訊。

NOTE
您必須同時是 fdm-author 和 forms-user 群組，以便建立及使用表單資料模型。 請連絡您的AEM管理員以成為群組的成員。

添加資料模型對象和服務 add-data-model-objects-and-services

如果您使用資料源建立了表單資料模型，則可以使用表單資料模型編輯器來添加資料模型對象和服務、配置其屬性、在資料模型對象之間建立關聯，以及測試表單資料模型和服務。

您可以在表單資料模型中，從可用的資料來源新增資料模型物件和服務。 新增的資料模型物件顯示在「模型」標籤中時，新增的服務會顯示在「服務」標籤中。

要添加資料模型對象和服務，請執行以下操作：

  1. 登入AEM製作例項，導覽至 Forms >資料整合，並開啟要在其中添加資料模型對象的表單資料模型。

  2. 在「資料來源」窗格中，展開資料來源以檢視可用的資料模型物件和服務。

  3. 選取要新增至表單資料模型的資料模型物件和服務，然後點選 添加選定內容.

    所選對象

    「模型」(Model)頁簽顯示所有資料模型對象及其屬性的圖形表示，這些對象及其屬性添加到表單資料模型中。 每個資料模型物件由表單資料模型中的方塊表示。

    模型標籤

    note note
    NOTE
    您可以按住並拖曳資料模型物件方塊四周，以在內容區域中組織這些物件。 在表單資料模型中新增的所有資料模型物件在「資料來源」窗格中會呈現灰色。

    「服務」索引標籤會列出新增的服務。

    services-tab

    note note
    NOTE
    除了資料模型對象和服務之外，OData服務元資料文檔還包括定義兩個資料模型對象之間關聯的導航屬性。 如需詳細資訊，請參閱 使用OData服務的導航屬性.

  4. 點選 儲存 保存窗體模型對象。

    note note
    NOTE
    您可以使用最適化表單規則，叫用表單資料模型的「服務」索引標籤中設定的服務。 規則編輯器的「調用服務」操作中提供了已配置的服務。有關在適用性表單規則中使用這些服務的詳細資訊，請參閱 規則編輯器.

建立資料模型對象和子屬性 create-data-model-objects-and-child-properties

建立資料模型對象 create-data-model-objects

雖然可以從配置的資料源添加資料模型對象，但也可以建立沒有資料源的資料模型對象或實體。 如果您尚未在表單資料模型中設定資料來源，則此功能特別實用。

要建立不使用資料源的資料模型對象，請執行以下操作：

  1. 登入AEM製作例項，導覽至 Forms >資料整合，並開啟要在其中建立資料模型對象或實體的表單資料模型。

  2. 點選 建立實體.

  3. 在「建立資料模型」(Create data Model)對話框中，指定資料模型對象的名稱並點選 新增. 資料模型物件會新增至表單資料模型。 請注意，新新增的資料模型物件未系結至資料來源，且沒有任何屬性，如下圖所示。

    新實體

接下來，可以在未綁定的資料模型對象中添加子屬性。

添加子屬性 child-properties

表單資料模型編輯器可讓您在資料模型物件中建立子屬性。 建立時的屬性不會綁定到資料源中的任何屬性。 您稍後可以將子屬性與包含資料模型物件中的其他屬性捆綁。

要建立子屬性，請執行以下操作：

  1. 在表單資料模型中，選取資料模型物件並點選 建立子屬性.

  2. 在 建立子屬性 對話框中，為 名稱 和 類型 欄位。 您可以選擇指定屬性的標題和說明。

  3. 如果屬性是計算屬性，則啟用計算。 根據規則或運算式來評估計算屬性的值。 如需詳細資訊，請參閱 編輯屬性.

  4. 如果資料模型對象綁定到資料源，則添加的子屬性將自動綁定到具有相同名稱和資料類型的父資料模型對象的屬性。

    若要使用資料模型物件屬性手動系結子屬性，請點選 系結參考 欄位。 此 選擇對象 對話框列出父資料模型對象中的所有屬性。 選取要系結的屬性，並點選勾號圖示。 請注意，您只能選取與子屬性資料類型相同的屬性。

  5. 點選 完成 要保存子屬性，請點選 儲存 保存表單資料模型…… 子屬性現在已新增至資料模型物件。

建立資料模型物件和屬性後，您可以繼續根據表單資料模型建立最適化表單和互動式通訊。 稍後，當您有可用的資料來源並加以設定時，您就可以將表單資料模型與資料來源系結。 系結會自動在相關的最適化表單和互動式通訊中更新。 如需使用表單資料模型建立最適化表單和互動式通訊的詳細資訊，請參閱 使用表單資料模型.

綁定資料模型對象和屬性 bind-data-model-objects-and-properties

當您要與表單資料模型整合的資料來源可供使用時，可以將其新增至表單資料模型，如 更新資料來源. 然後，執行以下操作來綁定未綁定的資料模型對象和屬性：

  1. 在表單資料模型中，選擇要與資料源綁定的未綁定資料源。

  2. 點選 編輯屬性.

  3. 在 編輯屬性 ，點選旁邊的瀏覽表徵圖 綁定 欄位。 它會開啟 選擇對象 對話框，列出在表單資料模型中添加的資料源。

    select-object

  4. 展開資料來源樹狀結構，並選取要以系結的資料模型物件，然後點選勾號圖示。

  5. 點選 完成 若要儲存屬性，然後點選 儲存 保存表單資料模型。 資料模型物件現在與資料來源系結。 請注意，資料模型物件不再標示為「未系結」。

    綁定模型對象

配置服務 configure-services

要讀取和寫入資料模型對象的資料，請執行以下操作來配置讀取和寫入服務：

  1. 選取資料模型物件頂端的核取方塊，以選取該物件並點選 編輯屬性.

    編輯屬性

    編輯屬性以配置資料模型對象的讀寫服務

    將開啟「編輯屬性」對話框。

    edit-properties-2

    編輯屬性對話方塊

    note note
    NOTE
    除了資料模型對象和服務之外，OData服務元資料文檔還包括定義兩個資料模型對象之間關聯的導航屬性。 將OData服務資料源添加到表單資料模型時，表單資料模型中有一個服務可用於資料模型對象中的所有導航屬性。 您可以使用此服務讀取相應資料模型對象的導航屬性。
    如需使用服務的詳細資訊，請參閱 使用OData服務的導航屬性.

  2. 切換 頂級對象 指定資料模型對象是否為頂級模型對象。

    在表單資料模型中配置的資料模型對象可用於基於表單資料模型的適用性表單的「內容」瀏覽器的「資料模型對象」頁簽中。 在兩個資料模型對象之間添加關聯時，要關聯的資料模型對象在「資料模型對象」(Data Model Objects)頁簽中要關聯的資料模型對象下嵌套。 如果嵌套資料模型是頂層對象，它也將單獨顯示在「資料模型對象」頁簽中。 因此，您會看到其中兩個項目，一個在巢狀階層內，另一個在巢狀階層外，這可能會混淆表單作者。 要使關聯的資料模型對象僅顯示在嵌套層次結構中，請禁用「頂級對象」屬性。

  3. 為所選資料模型對象選擇讀和寫服務。 服務的引數隨即顯示。

    讀寫服務

    為員工資料源配置的讀寫服務

  4. 點選 aem_6_3_edit 用於將參數綁定到用戶配置檔案屬性、請求屬性或常值並指定綁定值的讀取服務參數。 它將服務參數綁定到指定的綁定屬性或常值，該值作為參數傳遞給服務，以從資料源獲取與指定值關聯的詳細資訊。

    在此範例中， id 引數會採用 empid 屬性，並將其作為引數傳遞至讀取服務。 它會從 employee 指定的資料模型對象 empid. 因此，若您在 empid 欄位中，讀取服務將讀取員工的詳細資訊(具有00250員工id)。

    此外，您可以將引數設為強制或選用。

    編輯參數

    將id引數系結至AEM使用者設定檔的empid屬性

  5. 點選 完成 為了保存引數， 完成 儲存屬性，然後 儲存 保存表單資料模型。

添加關聯 add-associations

通常，資料源中的資料模型對象之間會建立關聯。 關聯可以是一對一或一對多。 例如，可以有多個與員工相關聯的家屬。 它稱為一對多關聯，如 1:n 線上連接相關資料模型對象。 但是，如果關聯為指定的員工ID返回唯一的員工名稱，則稱為一對一關聯。

將資料源中的關聯資料模型對象添加到表單資料模型時，它們的關聯將被保留並顯示為通過箭頭線連接。 您可以在表單資料模型中，跨不同資料來源新增資料模型物件之間的關聯。

NOTE
JDBC資料源中的預定義關聯不會保留在表單資料模型中。 您必須手動建立。

添加關聯：

  1. 選取資料模型物件頂端的核取方塊，以選取該物件並點選 添加關聯. 將開啟「添加關聯」對話框。

    添加關聯

    note note
    NOTE
    除了資料模型對象和服務之外，OData服務元資料文檔還包括定義兩個資料模型對象之間關聯的導航屬性。 在表單資料模型中新增關聯時，可以使用這些導覽屬性。 如需詳細資訊，請參閱 使用OData服務的導航屬性.

    將開啟「添加關聯」對話框。

    add-association-2

    添加關聯對話框

  2. 在「添加關聯」窗格中：

    • 指定關聯的標題。
    • 選擇關聯類型 — 一對一或一對多。
    • 選擇要關聯的資料模型對象。
    • 選擇讀取服務以從所選模型對象讀取資料。 讀取服務參數隨即出現。 編輯以變更引數（如有必要），並將其系結至要關聯的資料模型物件的屬性。

    在以下示例中，Dependents資料模型對象的讀取服務的預設參數為 dependentid.

    add-association-example

    Dependents讀取服務的預設參數為dependited

    但引數必須是關聯資料模型對象之間的公用屬性，在本示例中為 Employeeid. 因此， Employeeid 引數必須與 id Employee資料模型對象的屬性，以從Dependents資料模型對象中獲取關聯的依存項詳細資訊。

    add-association-example-2

    更新引數和系結

    點選 完成 來儲存引數。

  3. 點選 完成 保存關聯，然後 儲存 保存表單資料模型。

  4. 重複步驟，視需要建立更多關聯。

NOTE
添加的關聯將顯示在資料模型對象框中，具有指定的標題和一條連接關聯資料模型對象的線。
您可以選取相關的核取方塊，然後點選，以編輯關聯 編輯關聯.

新增關聯

編輯屬性 properties

您可以編輯資料模型對象的屬性、其屬性以及在表單資料模型中添加的服務。

要編輯屬性：

  1. 選取表單資料模型中資料模型物件、屬性或服務旁的核取方塊。

  2. 點選 編輯屬性. 此 編輯屬性 將開啟所選模型對象、屬性或服務的窗格。

    • 資料模型物件:指定讀和寫服務和編輯參數。
    • 屬性:指定屬性的類型、子類型和格式。 也可以指定所選屬性是否為資料模型對象的主鍵。
    • 服務:指定服務的輸入模型對象、輸出類型和參數。 對於Get服務，可以指定它是否應返回陣列。

    edit-properties-service

    獲取服務的編輯屬性對話框

  3. 點選 完成 保存屬性，然後 儲存 保存表單資料模型。

建立計算屬性 computed

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

例如，您可以建立計算屬性 FullName 其值是現有 名字 和 LastName 屬性。 若要這麼做：

  1. 以名稱建立新屬性 FullName 其資料類型為字串。

  2. 啟用 計算 點選 完成 來建立屬性。

    計算

    將建立FullName計算屬性。 請注意屬性旁的圖示，以描繪計算屬性。

    computed-prop

  3. 選取FullName屬性，然後點選 編輯規則. 規則編輯器視窗隨即開啟。

  4. 在規則編輯器視窗中，點選 建立. A 設定值 規則視窗開啟。

    從「選取選項」下拉式清單中，選取 數學表達式. 其他可用選項包括 表單資料模型物件 和 字串.

  5. 在數學表達式中，選擇 名字 和 LastName 分別位於第一和第二對象中。 選擇 plus 作為運算子。

    點選 完成 然後點選 關閉 以關閉規則編輯器視窗。 規則看起來類似下列。

    單項規則

  6. 在表單資料模型上，點選 儲存. 已配置計算屬性。

使用OData服務的導航屬性 work-with-navigation-properties-of-odata-services

在OData服務中，導航屬性用於定義兩個資料模型對象之間的關聯。 這些屬性是在實體類型或複雜類型上定義的。 例如，在下列範例中繼資料檔案的擷取中 TripPin OData示例服務，人員實體包含三個導航屬性：朋友、BestFriend和Trips。

如需導覽屬性的詳細資訊，請參閱 OData檔案.

<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>

在表單資料模型中配置OData服務時，實體容器中的所有導航屬性都可通過表單資料模型中的服務提供。 在TripPin OData服務的這個示例中， Person 實體容器可使用 GET LINK 服務。

以下重點說明 GET LINK of Person /People 表單資料模型中的服務，此組合服務適用於 Person TripPin OData服務的實體。

nav-prop-service

在您新增 GET LINK 服務到「表單資料模型」中的「服務」頁簽，您可以編輯屬性以選擇要在服務中使用的輸出模型對象和導航屬性。 例如，下列 GET LINK of Person /People 以下示例中的服務使用Trip作為輸出模型對象，導航屬性使用Trips。

edit-prop-nav-prop

NOTE
中可用的值 預設值 欄位 NavigationPropertyName 引數取決於 返回陣列？ 切換按鈕。 啟用後，將顯示「集合」類型的導航屬性。

在此示例中，您還可以選擇輸出模型對象作為Person，選擇導航屬性參數作為Friends或BestFriend(取決於 返回陣列？ 啟用或停用)。

edit-prop-nav-prop2

同樣地，您也可以選擇 GET LINK 在表單資料模型中新增關聯時，服務和設定其導覽屬性。 不過，若要選取導覽屬性，請確定 綁定到欄位 設為 常值.

add-association-nav-prop

產生和編輯範例資料 sample

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

執行下列操作以生成和編輯示例資料：

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

    範例資料

  2. 在 編輯範例資料 視需要，編輯資料，然後點選 儲存.

接下來，您可以使用範例資料，根據表單資料模型預先填寫及測試互動式通訊。 如需詳細資訊，請參閱 使用表單資料模型.

測試資料模型對象和服務 test-data-model-objects-and-services

您的表單資料模型已設定，但在使用前，您可能想要測試已設定的資料模型物件和服務是否如預期般運作。 要測試資料模型對象和服務，請執行以下操作：

  1. 在表單資料模型中選取資料模型物件或服務，然後點選 測試模型對象 或 測試服務，分別為。

    將開啟「測試表單資料模型」窗口。

    測試資料模型

  2. 在「測試表單資料模型」窗口中，從「輸入」窗格中選擇要測試的資料模型對象或服務。

  3. 在測試程式碼中指定引數值，然後點選 測試. 成功的測試會在「輸出」窗格中返回輸出。

    test-data-model-2

同樣地，您可以測試表單資料模型中的其他資料模型物件和服務。

後續步驟 next-steps

您有可運作的表單資料模型，現在已可在最適化表單和互動式通訊工作流程中使用。 如需詳細資訊，請參閱 使用表單資料模型.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da