以下是有关在Adobe Campaign中使用输入表单的一些一般原则。
有关Forms的详情,请参阅 本节.
输入表单的XML文档必须包含 <form>
具有的根元素 name 和 命名空间 属性,分别填充表单名称及其命名空间。
<form name="form_name" namespace="name_space">
…
</form>
默认情况下,表单与具有相同名称和命名空间的数据架构关联。 要将表单与其他名称相关联,请在 entity-schema 的属性 <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文档的树中查找节点。
元素由名称指定,属性由名称指定,名称前面加有字符“@”。
示例:
<chapter>
元素编辑控件会自动适应对应的数据类型,并使用架构中定义的标签。
默认情况下,每个字段显示在一行中,并占用所有可用空间,具体取决于数据类型。
输入表单必须引用 type="contentForm" 上的属性 <form>
元素,用于自动添加输入内容所需的框架。
控制项相对于彼此的排列方式与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>
元素。 其结构与输入表单的结构相同。
A 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" 为数据架构中的收集元素填充属性。
容器允许您对一组控件进行分组。 它们通过以下方式存在 <container>
元素。 它们已用于格式化多个列中的控件以及选项卡列表的控件。
有关容器以及如何在输入表单中使用这些容器的更多信息,请参阅 本节.
通过编辑区域,您可以输入输入表单的XML内容:
此 Preview 选项卡用于查看输入表单: