使用XML結構建立最適化表單

必備條件

使用XML架構作為表單模型來製作最適化表單,需要基本了解XML架構。 此外,建議在本文之前閱讀下列內容。

使用XML架構作為表單模型

Experience Manager Forms 支援使用現有XML架構作為表單模型來建立最適化表單。此XML架構表示組織中的後端系統產生或使用資料的結構。

使用XML架構的主要功能包括:

  • XSD的結構在最適化表單的製作模式中,在「內容尋找器」索引標籤中會顯示為樹狀結構。 您可以將元素從XSD階層拖曳並新增至最適化表單。
  • 您可以使用符合相關架構的XML預先填入表單。
  • 提交時,用戶輸入的資料將以符合關聯架構的XML形式提交。

XML架構由簡單和複雜的元素類型組成。 元素具有將規則新增至元素的屬性。 將這些元素和屬性拖曳至最適化表單時,會自動對應至對應的最適化表單元件。

此XML元素與最適化表單元件的對應如下:

XML元素或屬性 最適化表單元件
xs:string 文字方塊
xs:boolean 核取方塊
  • xs:unsignedInt
  • xs:xs:int
  • xs:decimal
  • 所有數值類型
數值方塊
xs:date 日期選擇器
xs:enumeration 下拉式清單
任何複雜類型元素 面板

示例XML架構

以下是XML架構的範例。

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema targetNamespace="https://adobe.com/sample.xsd"
                    xmlns="https://adobe.com/sample.xsd"
                    xmlns:xs="https://www.w3.org/2001/XMLSchema"
                >

        <xs:element name="sample" type="SampleType"/>

        <xs:complexType name="SampleType">
            <xs:sequence>
                <xs:element name="leaderName" type="xs:string" default="Enter Name"/>
                <xs:element name="assignmentStartBirth" type="xs:date"/>
                <xs:element name="gender" type="GenderEnum"/>
                <xs:element name="noOfProjectsAssigned" type="IntType"/>
                <xs:element name="assignmentDetails" type="AssignmentDetails"
                                            minOccurs="0" maxOccurs="10"/>
            </xs:sequence>
        </xs:complexType>

        <xs:complexType name="AssignmentDetails">
            <xs:attribute name="name" type="xs:string" use="required"/>
            <xs:attribute name="durationOfAssignment" type="xs:unsignedInt" use="required"/>
            <xs:attribute name="numberOfMentees" type="xs:unsignedInt" use="required"/>
             <xs:attribute name="descriptionOfAssignment" type="xs:string" use="required"/>
             <xs:attribute name="financeRelatedProject" type="xs:boolean"/>
       </xs:complexType>
  <xs:simpleType name="IntType">
            <xs:restriction base="xs:int">
            </xs:restriction>
        </xs:simpleType>
  <xs:simpleType name="GenderEnum">
            <xs:restriction base="xs:string">
                <xs:enumeration value="Female"/>
                <xs:enumeration value="Male"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:schema>
注意

確保XML架構只有一個根元素。 不支援具有多個根元素的XML架構。

使用XML架構向欄位添加特殊屬性

您可以將下列屬性新增至XML結構元素,以將特殊屬性新增至相關適用性表單的欄位。

結構屬性 在最適化表單中使用 支援
use=required 將欄位標示為必填欄位
屬性
default="default value" 新增預設值 元素和屬性
minOccurs="3"

指定最小發生次數

(適用於可重複的子表單(複雜類型))

元素(複雜類型)
maxOccurs="10"

指定最大發生次數

(適用於可重複的子表單(複雜類型))

元素(複雜類型)
注意

將結構元素拖曳至最適化表單時,會產生預設標題:

  • 大寫元素名稱的第一個字元
  • 在駝峰大小寫邊界插入空白字元。

例如,如果新增userFirstName架構元素,適用性表單中產生的註解為User First Name

限制最適化表單元件的可接受值

您可以將下列限制新增至XML架構元素,以限制最適化表單元件可接受的值:

結構屬性

資料類型

說明

元件

totalDigits

字串

指定元件中允許的位數上限。 指定的位數必須大於零。

  • 數值方塊
  • 數值步進器

maximum

字串

指定數值和日期的上界。 預設會包含最大值。

  • 數值方塊
  • 數值步進器
  • 日期挑選器

minimum

字串

指定數值和日期的下限。 預設會包含最小值。

  • 數值方塊
  • 數值步進器
  • 日期挑選器

exclusiveMaximum

布林值 (Boolean)

如果為true,則表單元件中指定的數值或日期必須小於為maximum屬性指定的數值或日期。

如果為false,則表單元件中指定的數值或日期必須小於或等於為最大屬性指定的數值或日期。

  • 數值方塊
  • 數值步進器
  • 日期挑選器

exclusiveMinimum

布林值 (Boolean)

如果為true,則表單元件中指定的數值或日期必須大於為最小屬性指定的數值或日期。

如果為false,則表單元件中指定的數值或日期必須大於或等於為最小屬性指定的數值或日期。

  • 數值方塊
  • 數值步進器
  • 日期挑選器

minLength

字串

指定元件中允許的字元數量最小。 最小長度必須等於或大於零。

  • 文字方塊

maxLength

字串

指定元件中允許的字元數上限。 最大長度必須大於零。

  • 文字方塊

length

字串

指定元件中允許的字元數。 長度必須等於或大於零。

  • 文字方塊

fractionDigits

字串

指定元件中允許的最大小數位數。 fractionDigits必須等於或大於零。

  • 具有資料類型浮點數或小數的數值框

pattern

字串

指定字元的順序。 如果字元符合指定的模式,元件將接受字元。

模式屬性映射到相應自適應表單元件的驗證模式。

  • 對應至XSD架構的所有適用性表單元件

常見問題

如何知道樹中的哪個元素與哪個XML元素關聯?

當您連按兩下「內容尋找器」中的元素時,快顯視窗會顯示欄位名稱和名為bindRef的屬性。 此屬性會將樹元素映射到架構中的元素或屬性。

XML架構元素的bindref欄位

bindRef欄位顯示樹元素與方案中的元素或屬性之間的關聯。

注意

屬性的bindRef值中有@符號,以便與元素區分。 例如, /config/projectDetails/@duration

為什麼我無法為可重複的子表單拖曳子表單的個別元素(從任何複雜類型產生的結構)(minOccours或maxOccurs值大於1)?

在可重複的子表單中,您必須使用「完成」子表單。 如果您只想要選擇性欄位,請使用整個結構並刪除不需要的結構。

我在「內容尋找器」中有一個長而複雜的結構。如何找到特定元素?

您有兩個選項:

  • 滾動瀏覽樹結構
  • 使用「搜尋」方塊來尋找元素

什麼是bindRef?

bindRef是適用性表單元件與架構元素或屬性之間的連線。 它指定XPath ,從此元件或欄位捕獲的值在輸出XML中可用。 從預填(預填)XML預填欄位值時,也會使用bindRef

本頁內容