输入表单入门

创建或扩展架构时，您需要创建或修改关联的输入表单，以使这些更改对最终用户可见。

通过输入表单，您可以从Adobe Campaign客户端控制台编辑与数据架构关联的实例。表单通过其名称和命名空间进行标识。

表单的标识键是由命名空间和用冒号分隔的名称组成的字符串，例如："cus:contact"。

编辑输入表单

从 Administration> Configuration >Input forms 客户端控制台的文件夹：

编辑区域允许您输入输入表单的XML内容：

预览会生成输入表单的显示：

窗体结构

表单的描述是一种结构化XML文档，用于观察表单模式的语法 xtk:form.

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

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

默认情况下，表单与具有相同名称和命名空间的数据架构相关联。要将表单与其他名称关联，请将 实体模式 属性 <form> 元素。为了说明输入表单的结构，让我们使用“cus:recipient”示例模式描述接口：

<srcSchema name="recipient" namespace="cus">
  <enumeration name="gender" basetype="byte">
    <value name="unknown" label="Not specified" value="0"/>
    <value name="male" label="Male" value="1"/>
    <value name="female" label="Female" value="2"/>
  </enumeration>

  <element name="recipient">
    <attribute name="email" type="string" length="80" label="Email" desc="E-mail address of recipient"/>
    <attribute name="birthDate" type="datetime" label="Date"/>
    <attribute name="gender" type="byte" label="Gender" enum="gender"/>
  </element>
</srcSchema>

基于示例架构的输入表单：

<form name="recipient" namespace="cus">
  <input xpath="@gender"/>
  <input xpath="@birthDate"/>
  <input xpath="@email"/>
</form>

编辑控件的描述从 <form> 根元素。在 <input> 元素 xpath 属性，其中包含其架构中字段的路径。

编辑控件会自动适应相应的数据类型，并使用架构中定义的标签。

注意

您可以通过添加标签属性 <input> 元素：
<input label="E-mail address" xpath="@name" />

默认情况下，每个字段都显示在一行中，并根据数据类型占用所有可用空间。

所有表单属性均列在 Campaign Classicv7文档。

格式化

控件的布局类似于HTML表中使用的布局，它可以将控件划分为多列、隔行元素或指定可用空间的占用。但是，请记住，格式仅允许您按比例划分区域；不能为对象指定固定维度。

要在两列中显示上述示例的控件：

<form name="recipient" namespace="cus">
  <container colcount="2">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email"/>
  </container>
</form>

的 <container> 元素 colcount 属性允许您将子控件的显示强制显示到两列上。

的 colspan 属性会按值中输入的列数来扩展控件：

<form name="recipient" namespace="cus">
  <container colcount="2">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
</form>

通过填充 type="frame" 属性时，容器会在子控件周围添加一个框架，该框架中的标签包含在标签属性：

<form name="recipient" namespace="cus">
  <container colcount="2" type="frame" label="General">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
</form>

A <static> 元素可用于设置输入表单的格式：

<form name="recipient" namespace="cus">
  <static type="separator" colspan="2" label="General"/>
  <input xpath="@gender"/>
  <input xpath="@birthDate"/>
  <input xpath="@email" colspan="2"/>
  <static type="help" label="General information about recipient with date of birth, gender, and e-mail address." colspan="2"/>
</form>

的 <static> 标记 分隔符 使用类型，可添加带有标签属性。

使用 <static> 标记。文本的内容是在标签属性。

使用容器

使用容器对一组控件进行分组。它们由 <container> 元素。上面使用它们设置多列控件的格式。

的 xpath 属性 <container> 允许您简化子控件的引用。然后，控件的引用将相对于父项 <container> 父项。

不带“xpath”的容器示例：

<container colcount="2">
  <input xpath="location/@zipCode"/>
  <input xpath="location/@city"/>
</container>

在名为“location”的元素中添加“xpath”的示例：

<container colcount="2" xpath="location">
  <input xpath="@zipCode"/>
  <input xpath="@city"/>
</container>

容器用于使用一组在页面中格式的字段来构建复杂的控件。

添加选项卡（笔记本）

使用 笔记本 容器，以在可从选项卡访问的页面中设置数据格式。

<container type="notebook">
  <container colcount="2" label="General">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
  <container colcount="2" label="Location">
    ...
  </container>
</container>

主容器由 type="notebook" 属性。在子容器中声明制表符，并从标签属性。

添加 style="down" 属性强制选项卡标签在控件下方垂直定位。此属性是可选的。默认值为 "up".

<container style="down" type="notebook"> ... </container>

添加图标（图标框）

使用此容器可显示垂直图标栏，以选择要显示的页面。

<container type="iconbox">
  <container colcount="2" label="General" img="xtk:properties.png">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
  <container colcount="2" label="Location" img="nms:msgfolder.png">
    ...
  </container>
</container>

主容器由 type="iconbox" 属性。与图标关联的页面在子容器中声明。图标的标签将从标签属性。

页面的图标将从 img="<image>" 属性，其中 <image> 是与其由名称和命名空间组成的键值对应的图像名称（例如，“xtk:properties.png”）。

图像可从 Administration > Configuration > Images 节点。

隐藏容器(visibleGroup)

您可以通过动态条件隐藏一组控件。

此示例说明了“性别”字段值控件的可见性：

<container type="visibleGroup" visibleIf="@gender=1">
  ...
</container>
<container type="visibleGroup" visibleIf="@gender=2">
  ...
</container>

可见性容器由属性定义 type="visibleGroup". 的 visibleIf 属性包含可见性条件。

条件语法的示例：

visibleIf="@email='peter.martinezATneeolane.net'":测试字符串类型数据上的等同性。比较值必须用引号括起来。
visibleIf="@gender >= 1和@gender != 2”:条件。
visibleIf="@boolean1=true或@boolean2=false":测试布尔字段。

条件显示(enabledGroup)

利用此容器，可启用或禁用动态条件中的一组数据。禁用控件会阻止对其进行编辑。以下示例说明如何启用“Gender”字段值中的控件：

<container type="enabledGroup" enabledIf="@gender=1">
  ...
</container>
<container type="enabledGroup" enabledIf="@gender=2">
  ...
</container>

启用容器由 type="enabledGroup" 属性。的 enabledIf 属性包含激活条件。

编辑链接

请记住，链接在数据架构中声明如下：

<element label="Company" name="company" target="cus:company" type="link"/>

链接在其输入表单中的编辑控制如下：

<input xpath="company"/>

可通过编辑字段访问目标选择。输入由提前键入辅助，以便能够从输入的前几个字符中轻松找到目标元素。然后，搜索将基于 计算字符串 在目标架构中定义。如果在控件中进行验证后架构不存在，则会显示即时创建目标的确认消息。确认后，将在目标表中创建新记录，并将其与链接关联。

下拉列表用于从已创建的记录列表中选择目标元素。

的 Modify the link （文件夹）图标可启动一个选择表单，其中包含目标元素列表和过滤器区域。

的 Edit link （放大镜）图标可启动链接元素的编辑表单。默认情况下，目标模式的键上会推导使用的形式。的表单属性允许您强制编辑表单的名称(例如，“cus:company2”)。

您可以通过添加 <sysfilter> 元素：

<input xpath="company">
  <sysFilter>
    <condition expr="[location/@city] =  'Newton"/>
  </sysFilter>
</input>

您还可以使用 <orderby> 元素：

<input xpath="company">
  <orderBy>
    <node expr="[location/@zipCode]"/>
  </orderBy>
</input>

控制属性

noAutoComplete:禁用“提前键入”（值为“true”）
createMode:如果链接不存在，则即时创建该链接。可能的值包括：
- 无:禁用创建。如果链接不存在，则会显示错误消息
- 内嵌:创建与编辑字段中的内容的链接
- 版本:在链接上显示编辑表单。验证表单后，将保存数据（默认模式）
noZoom:链接上没有编辑窗体（值为“true”）
表单:覆盖目标元素的编辑表单

添加链接列表（未绑定）

在数据架构中作为收集元素输入的链接(unbound="true")必须经过列表才能查看与其关联的所有元素。

其原理是显示具有优化数据加载的链接元素列表（通过数据批量下载，仅当列表可见时才执行）。

架构中的集合链接示例：

<element label="Events" name="rcpEvent" target="cus:event" type="link" unbound="true">
...
</element>

其输入形式的列表：

 <input xpath="rcpEvent" type="linklist">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

列表控件由 type="linklist" 属性。列表路径必须引用集合链接。

通过 <input> 列表的元素。的 xpath 属性是指目标架构中字段的路径。

带有标签的工具栏（在架构的链接上定义）会自动置于列表上方。

该列表可通过 Filters 按钮，并配置为添加和排序列。

的 Add 和 Delete 通过按钮，您可以在链接上添加和删除收藏集元素。默认情况下，添加元素会启动目标架构的编辑表单。

的 Detail 按钮 zoom="true" 属性已在 <input> 列表的标记：它允许您启动选定行的编辑表单。

在加载列表时，可以应用过滤和排序：

 <input xpath="rcpEvent" type="linklist">
  <input xpath="@label"/>
  <input xpath="@date"/>
  <sysFilter>
    <condition expr="@type = 1"/>
  </sysFilter>
  <orderBy>
    <node expr="@date" sortDesc="true"/>
  </orderBy>
</input>

定义关系表

使用关系表可以将两个表与N-N基数链接。关系表仅包含两个表的链接。

因此，向列表添加元素应允许您从关系表中的两个链接之一完成列表。

模式中的关系表示例：

<srcSchema name="subscription" namespace="cus">
  <element name="recipient" type="link" target="cus:recipient" label="Recipient"/>
  <element name="service" type="link" target="cus:service" label="Subscription service"/>
</srcSchema>

例如，我们首先从“cus:recipient”架构的输入形式开始。该列表必须显示与服务订阅的关联，并且必须允许您通过选择现有服务来添加订阅。

<input type="linklist" xpath="subscription" xpathChoiceTarget="service" xpathEditTarget="service" zoom="true">
  <input xpath="recipient"/>
  <input xpath="service"/>
</input>

的 xpathChoiceTarget 属性允许您从输入的链接中启动选择表单。创建关系表记录将自动更新指向当前收件人和选定服务的链接。

注意

的 xpathEditTarget 属性允许您对输入的链接上的选定行进行强制编辑。

列表属性

noToolbar:隐藏工具栏（其值为“true”）
toolbarCaption:过载工具栏标签
工具栏对齐:修改工具栏的垂直或水平几何(可能值："vertical"|"horizontal")
img:显示与列表关联的图像
表单:覆盖目标元素的编辑表单
缩放:添加 Zoom 按钮以编辑目标元素
xpathEditTarget:设置对输入的链接的编辑
xpathChoiceTarget:此外，在输入的链接上启动选择表单

添加内存列表控件

内存列表允许您使用列表数据预加载功能编辑收集元素。此列表无法过滤或配置。

这些列表用于XML映射的集合元素或低容量链接。

添加列列表

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

<input xpath="rcpEvent" type="list">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

必须使用 type="list" 属性，且列表路径必须引用收集元素。

列在子项中声明 <input> 列表的标记。列标签和大小可以强制使用标签和 colSize 属性。

注意

排序箭头在 ordered="true" 属性会添加到数据架构的收集元素中。

工具栏按钮可水平对齐：

<input nolabel="true" toolbarCaption="List of events" type="list" xpath="rcpEvent" zoom="true">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

的 toolbarCaption 属性会强制工具栏的水平对齐方式并在列表上方输入标题。

允许放大列表

可以在单独的编辑表单中输入列表中数据的插入和编辑。

<input nolabel="true" toolbarCaption="List of events" type="list" xpath="rcpEvent" zoom="true" zoomOnAdd="true">
  <input xpath="@label"/>
  <input xpath="@date"/>

  <form colcount="2" label="Event">
    <input xpath="@label"/>
    <input xpath="@date"/>
  </form>
</input>

编辑表单已从 <form> 元素。其结构与输入形式的结构相同。的 Detail 按钮 zoom="true" 属性已在 <input> 标记。此属性允许您启动选定行的编辑表单。

注意

添加 zoomOnAdd="true" 属性强制在插入列表元素时调用编辑表单。

列表属性

noToolbar:隐藏工具栏（其值为“true”）
toolbarCaption:过载工具栏标签
工具栏对齐:修改工具栏的位置(可能值："vertical"|"horizontal")
img:显示与列表关联的图像
表单:覆盖目标元素的编辑表单
缩放:添加 Zoom 按钮以编辑目标元素
zoomOnAdd:在添加的
xpathChoiceTarget:此外，在输入的链接上启动选择表单

添加不可编辑的字段

要显示字段并阻止对其进行编辑，请使用 <value> 标记或完成 readOnly="true" 属性 <input> 标记。

“性别”字段示例：

<value value="@gender"/>
<input xpath="@gender" readOnly="true"/>

“添加”单选按钮

单选按钮允许您从多个选项中进行选择。的 <input> 标记用于列出可能的选项， checkedValue 属性指定与选项关联的值。

“性别”字段示例：

<input type="RadioButton" xpath="@gender" checkedValue="0" label="Choice 1"/>
<input type="RadioButton" xpath="@gender" checkedValue="1" label="Choice 2"/>
<input type="RadioButton" xpath="@gender" checkedValue="2" label="Choice 3"/>

添加复选框

复选框反映布尔状态（选中或未选中）。默认情况下，此控件由“Boolean”(true/false)字段使用。默认值为0或1的变量可与此按钮关联。此值可通过 checkValue 属性。

<input xpath="@boolean1"/>
<input xpath="@field1" type="checkbox" checkedValue="Y"/>

此控件在要编辑的一组字段上构建树。

要编辑的控件将分组为 <container> 在 <input> 标记：

<input nolabel="true" type="treeEdit">
  <container label="Text fields">
    <input xpath="@text1"/>
    <input xpath="@text2"/>
  </container>
  <container label="Boolean fields">
    <input xpath="@boolean1"/>
    <input xpath="@boolean2"/>
  </container>
</input>

添加表达式字段

表达式字段会从表达式动态更新字段；the <input> 标记与 xpath 属性，以输入要更新的字段的路径以及 expr 包含更新表达式的属性。

<!-- Example: updating the boolean1 field from the value contained in the field with path /tmp/@flag -->
<input expr="Iif([/tmp/@flag]=='On', true, false)" type="expr" xpath="@boolean1"/>
<input expr="[/ignored/@action] == 'FCP'" type="expr" xpath="@launchFCP"/>

表单上下文

输入表单的执行初始化包含被编辑实体数据的XML文档。本文档表示表单的上下文，可用作工作区。

更新上下文

要修改表单的上下文，请使用 <set expr="<value>" xpath="<field>"/> 标记，其中 <field> 是目标字段， <value> 是更新表达式或值。

使用的示例 <set> 标记：

<set expr="'Test'" xpath="/tmp/@test" />:将“测试”值定位在临时位置/tmp/@test1
<set expr="'Test'" xpath="@lastName" />:使用“Test”值更新“lastName”属性上的实体
<set expr="true" xpath="@boolean1" />:将“boolean1”字段的值设置为“true”
<set expr="@lastName" xpath="/tmp/@test" />:更新了“lastName”属性的内容

通过初始化和关闭表单时，可以更新表单的上下文 <enter> 和 <leave> 标记。

<form name="recipient" namespace="cus">
  <enter>
    <set...
  </enter>
  ...
  <leave>
    <set...
  </leave>
</form>

注意

的 <enter> 和 <leave> 标记可用于 <container> 页面类型（“notebook”和“iconbox”类型）。

表达语言

可以在表单定义中使用宏语言来执行条件测试。

的 <if expr="<expression>" /> 如果验证了表达式，则标记会执行标记下指定的说明：

<if expr="([/tmp/@test] == 'Test' or @lastName != 'Doe') and @boolean2 == true">
  <set xpath="@boolean1" expr="true"/>
</if>

的 <check expr="<condition>" /> 与 <error> 标记会阻止验证表单，并在不满足条件时显示错误消息：

<leave>
  <check expr="/tmp/@test != ''">
    <error>You must populate the 'Test' field!</error>
  </check>
</leave>

助手（向导）

助手可指导您完成页面形式的一组数据输入步骤。验证表单时，将保存输入的数据。

要添加助理，请使用以下类型的结构：

<form type="wizard" name="example" namespace="cus" img="nms:rcpgroup32.png" label="Wizard example" entity-schema="nms:recipient">
  <container title="Title of page 1" desc="Long description of page 1">
    <input xpath="@lastName"/>
    <input xpath="comment"/>
  </container>
  <container title="Title of page 2" desc="Long description of page 2">
    ...
  </container>
  ...
</form>

存在 type="wizard" 属性 <form> 元素允许您在表单结构中定义向导模式。页面从 <container> 元素，即 <form> 元素。的 <container> 页面的元素会填充标题的标题属性，并且desc会在页面标题下显示描述。的 Previous 和 Next 会自动添加按钮以允许在页面之间浏览。

的 Finish 按钮保存输入的数据并关闭表单。

SOAP方法

SOAP方法可从填充的 <leave> 标记。

的 <soapcall> 标记包含对具有以下输入参数的方法的调用：

<soapCall name="<name>" service="<schema>">
  <param type="<type>" exprIn="<xpath>"/>
  ...
</soapCall>

服务的名称及其实施架构通过 name 和服务属性 <soapcall> 标记。

输入参数在 <param> 元素 <soapcall> 标记。

必须通过 type 属性。可能的类型如下：

字符串:字符串
布尔:布尔值
字节:8位整数
短:16位整数
long:32位整数
短:16位整数
多次:双精度浮点数
DOMElement:元素类型节点

的 exprIn 属性包含要作为参数传递的数据的位置。

示例:

<leave>
  <soapCall name="RegisterGroup" service="nms:recipient">
    <param type="DOMElement" exprIn="/tmp/entityList"/>
    <param type="DOMElement" exprIn="/tmp/choiceList"/>
    <param type="boolean"    exprIn="true"/>
  </soapCall>
</leave>

全新改良搜索功能

输入表单入门

编辑输入表单

窗体结构

格式化

使用容器

添加选项卡（笔记本）

添加图标（图标框）

隐藏容器(visibleGroup)

条件显示(enabledGroup)

编辑链接

控制属性

添加链接列表（未绑定）

定义关系表

列表属性

添加内存列表控件

添加列列表

允许放大列表

列表属性

添加不可编辑的字段

“添加”单选按钮

添加复选框

编辑导航层次结构

添加表达式字段

表单上下文

更新上下文

表达语言

助手（向导）

SOAP方法

Business.Adobe.com资源

在此页面上

查看下一个：

学习

文档

社区

技术支持

资源

Adobe 帐户

Adobe