輸入表單

以下是關於在Adobe Campaign使用輸入表格的一些一般原則。

Forms在本區段中詳細說明。

表單結構

輸入表單的XML文檔必須包含​name​和​namespace​屬性的​<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語法的提醒：

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

XPath是一種語法，用於在XML文檔的樹中查找節點。

元素由其名稱指定，屬性由名稱指定，名稱前面加上字元「@」。

範例:

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

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

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

格式

控制項相對彼此的佈置類似於在HTML表中使用的佈置，其可能將控制項分成若干列、交錯元件或指定佔用可用空間。 但是，請記住，格式只允許分配比例；不能為對象指定固定維。

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

清單類型控制項

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

列清單

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

<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​屬性強制工具欄的水準對齊並填充清單上方的標題。

放大清單

清單資料的插入和編輯可以以單獨的編輯形式執行。

在清單中編輯表單的用途如下：

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

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

標籤清單

此清單以頁簽形式顯示集合元素的編輯。

<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>​元素下聲明，該元素是清單控制項的子項。

使用工具欄按鈕添加或刪除清單元素。

容器

容器可讓您將一組控制項分組。 它們透過​<container>​元素存在。 它們已用於格式化數列中的控制項以及用於控制標籤清單。

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

編輯表單

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

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