[也適用於v8]{class="badge positive" title="亦適用於Campaign v8"}

輸入表單 input-forms

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

在本節中詳細說明Forms。

表單結構 form-structure

輸入表單的XML檔案必須包含具有​ 名稱 ​和​ 名稱空間 ​屬性的​ <form> ​根專案，才能分別填入表單名稱及其名稱空間。

<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語法的提醒：

XPath語言在Adobe Campaign中用於參照屬於資料結構的元素或屬性。

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

元素是以其名稱來指定，而屬性是以字元「@」開頭的名稱來指定。

範例：

編輯控制項會自動適應對應的資料型別，並使用結構描述中定義的標籤。

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

格式 formatting

控制項相對於彼此的排列方式看起來類似於HTML表格中使用的排列方式，可能會將控制項分割為數個欄、交錯元素或指定可用空間的佔用。 但是請記住，格式僅授權比例分配；您不能為物件指定固定尺寸。

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

清單型別控制項 list-type-controls

若要編輯收集要素，您必須使用清單型態控制項。

欄清單 column-list

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

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

清單控制項必須填入​ type="list" ​屬性，而且清單的路徑必須參考集合專案。

資料行是由清單的子​ <input> ​專案宣告。

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

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

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

放大清單 zoom-in-a-list

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

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

<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 ​按鈕。 這可讓您在選取的行上開啟編輯表單。

索引標籤清單 tab-list

此清單會以索引標籤的形式顯示集合元素的編輯。

<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> ​元素下宣告。

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

容器 containers

容器可讓您將一組控制項分組。 它們透過​ <container> ​元素存在。 它們已用來格式化數個欄中的控制項，並用來控制索引標籤清單。

如需有關容器，以及如何在輸入表單中使用容器的詳細資訊，請參閱本節。

編輯表單 editing-forms

編輯區域可讓您輸入輸入表單的XML內容：

Preview ​索引標籤可讓您檢視輸入表單：

深入瞭解編輯表單和表單結構。