Experience League

退出搜尋

Experience Cloud

Document Cloud

輸入表單

以下是有關在Adobe Campaign中使用輸入表單的一些一般原則。

本節中詳細說明了表單。

表單結構

輸入表單的XML文檔必須包含<form>根元素，其中name和namespace屬性必須分別填入表單名稱及其namespace。

<form name="form_name" namespace="name_space">
...
</form>

預設情況下，表單與具有相同名稱和名稱空間的資料架構相關聯。要將表單與不同的名稱關聯，請在<form>元素的entity-schema屬性中輸入模式鍵。

為了說明輸入表單的結構，我們基於示例模式"cus:book"描述一個介面：

這是相應的輸入表單：

<form name="book" namespace="cus" type="contentForm">
  <input xpath="@name"/>
  <input xpath="@date"/>
  <input xpath="@language"/>
</form>

編輯元素的說明從<form>根元素開始。

在<input>元素中輸入編輯控制項，該元素具有xpath屬性，該屬性在其模式中包含欄位的路徑。

有關XPath語法的提醒：

Adobe Campaign使用XPath語言來參考屬於資料結構的元素或屬性。

XPath是一種語法，可讓您在XML文檔的樹狀結構中找到節點。

元素由其名稱指定，屬性由名稱前面帶有字元"@"指定。

範例:

@date:選擇名稱為"date"的屬性
chapter/@title:在元素下選取「title」屬 <chapter> 性
…/@date:從當前要素的父要素中選擇日期

編輯控制項自動適應相應的資料類型並使用模式中定義的標籤。

依預設，每個欄位會顯示在一行上，並佔用所有可用空間，視資料類型而定。

注意

輸入表單必須參考**<form>元素上的type="contentForm"**屬性，以自動新增要輸入內容所需的影格。

格式

控制項彼此相對的排列類似於HTML表格中使用的排列，可將控制項分成多列、交錯元素或指定可用空間的佔用。但請記住，格式設定僅授權比例分配；不能為對象指定固定尺寸。

如需詳細資訊，請參閱本章節。

清單類型控制項

若要編輯系列元素，您必須使用清單類型控制項。

列清單

此控制項會顯示可編輯的欄清單，其工具列包含「新增」和「刪除」按鈕。

<input xpath="chapter" type="list">
  <input xpath="@name"/>
  <input xpath="@number"/>
</input>

清單控制項必須填入type="list"屬性，且清單的路徑必須參照系列元素。

列由清單的子<input>元素聲明。

注意

當資料結構中的收集元素完成ordered="true"屬性時，會自動新增向上和向下排序箭頭。

依預設，工具列按鈕會垂直對齊。也可以水準對齊：

<input nolabel="true" toolbarCaption="List of chapters" type="list" xpath="chapter">
  <input xpath="@name"/>
  <input xpath="@number"/>
</input>

toolbarCaption屬性強制工具列的水準對齊方式，並填入清單上方的標題。

注意

對於不要顯示在控制項左側的收集元素標籤，請添加nolabel="true"屬性。

放大清單

清單資料的插入和編輯可以在單獨的編輯表單中執行。

在下列情況下，可使用清單中的編輯表單：

為方便您輸入資訊，
有多線控制，
清單中的欄僅包含主要欄位，表單會顯示系列元素的所有欄位。

<input nolabel="true" toolbarCaption="List of chapters" type="list" xpath="chapter" zoom="true" zoomOnAdd="true">
  <input xpath="@name"/>
  <input xpath="@number"/>

  <form colcount="2" label="Editing a chapter">
    <input xpath="@name"/>
    <input xpath="@number"/>
    <input colspan="2" xpath="page"/>
  </form>
</input>

編輯表單的定義是透過清單元素下方的<form>元素指定。其結構與輸入形式的結構相同。

當在清單定義中輸入zoom="true"屬性時，會自動新增Detail按鈕。這可讓您在選取的行上開啟編輯表格。

注意

新增zoomOnAdd="true"屬性會強制在插入清單的元素時呼叫編輯表單。

標籤清單

此清單以標籤的形式呈現系列元素的編輯。

<container toolbarCaption="List of chapters" type="notebooklist" xpath="chapter" xpath-label="@name">
  <container colcount="2">
    <input xpath="@name"/>
    <input xpath="@number"/>
    <input colspan="2" xpath="page"/>
  </container>
</container>

清單控制項必須填入type="notebooklist"屬性，且清單的路徑必須參照系列元素。

該頁籤的標題包含通過xpath-label屬性輸入的資料值。

編輯控制項必須在<container>元素下宣告，該元素是清單控制項的子項。

使用工具列按鈕來新增或刪除清單元素。

注意

為資料結構中的收集元素填入ordered="true"屬性時，會自動新增向左和向右排序箭頭。