输入表单

以下是关于在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”的属性
• 章节/@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​选项卡允许您查看输入表单：