Experience League

退出搜索

Experience Cloud

Document Cloud

输入窗体

以下是关于在Adobe Campaign中使用输入表单的一些一般原则。

Forms详细介绍。

窗体结构

输入表单的XML文档必须包含 <form> 根元素，其名称和命名空间属 性，以分别填充表单名称及其命名空间。

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

默认情况下，表单与具有相同名称和模式的数据命名空间关联。要将表单与其他名称关联，请在元素的entity- 模式属性中 ，输入模式 <form> 键。

为了说明输入表单的结构，我们根据示例模式“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文档的树中找到节点。

元素由其名称指定，属性由名称前的字符“@”指定。

示例:

@date:选择名称为“date”的属性
第章/@title:选择元素下的“title”属 <chapter> 性
…/@date:从当前元素的父元素中选择日期

编辑控件自动适应相应的数据类型并使用在模式中定义的标签。

默认情况下，每个字段都显示在一行上并占用所有可用空间，具体取决于数据类型。

注意

输入表单必须引用元 素上的type ="contentForm" <form> 属性，以自动添加要输入内容所需的框架。

格式化

控件相对于彼此的排列类似于HTML表中使用的排列，可将控件分为几列、交错元素或指定可用空间的占用。但是，请记住，格式只允许分配比例；不能为对象指定固定尺寸。

如需详细信息，请参阅此部分。

列表类型控件

要编辑集合元素，必须使用列表类型控件。

列列表

此控件显示可编辑的列列表，其工具栏包含“添加”和“删除”按钮。

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

列表控件必须用type=" 列表"属性填充 ,列表的路径必须引用集合元素。

列由列表的子 <input> 元素声明。

注意

当数据模式中的集合元素完成 ordered="true "属性时，会自动添加向上和向下排序箭头。

默认情况下，工具栏按钮垂直对齐。还可以水平对齐它们：

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

工具栏 “题注”属性强制工具栏的水平对齐，并填充列表上方的标题。

注意

对于不要在控件左侧显示的集合元素标签，请添 加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> 下的元素指定。其结构与输入形式的结构相同。

在 Detail 列表定义中输 入zoom="true "属性时，会自动添加按钮。这样，您就可以在所选行上打开编辑表单。

注意

添加 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 "属性时，将自动添加左右排序箭头。