表单控件

选择表单组件后，系统将打开一个向导，显示多个配置选项卡，以允许针对不同功能进行进一步自定义。 在向导的预览窗格中查看进度。

当您对组件的设计感到满意时，选择“保存” 。

下表描述了常见向导选项卡的可用设置和控件。

向导选项卡	描述	特别提及
显示	配置表单组件的显示方式。	您在“标签”必填字段中设置的名称将成为“字段键”选项卡中的“属性名称”。
数据	配置最终用户在文本字段中看到的默认值。	可以在此处定义可能包含多个项目的组件（例如，选择框、选项卡）。
验证	配置验证要求以启用其他用户界面组件。	不适用
字段键值	配置要在工作流中使用的组件的属性名称。	默认情况下，此值从“显示”选项卡的“标签”字段传递。
条件	为组件配置条件。	您可以设置高级条件，例如 Javascript 或 JSON。
逻辑	配置触发条件的逻辑。	不适用

一些表单组件具有特定的选项卡，例如：

组件	向导选项卡	描述
日期/时间	日期	配置可供选择的最小和最大日期。
	时间	将增量步骤配置为小时和分钟。
日	日	配置业务用户选择日期的方式（增量方式或从下拉列表中）。
	月	配置业务用户选择月份的方式（增量方式或从下拉列表中）。
	年	配置业务用户选择年份的方式（增量或从下拉列表中），以及可供选择的最小和最大年份。
编辑网格	模板	自定义编辑网格数据的标题和行。
数据映射	布局	将边距布局更改应用于数据映射。

显示

标签- 组件的标题。

“标签位置” - 字段的标签位置。

“说明” - 显示在输入字段下方的文本。

工具提示- 在图标的一侧添加工具提示图标。输入工具提示的文本。

“自定义 CSS 类” - 为组件添加自定义 CSS 类。您可以添加多个类别，并用空格分隔。

“隐藏” - 显示表单时隐藏组件。

备注：

该组件仍会显示在 JSON 文件中。

“隐藏标签” - 隐藏组件标签。

“已禁用” - 禁用表单中的字段。

占位符- 字段为空时显示的文本。

前缀- 在字段之前显示的文本。

后缀- 在字段后显示的文本。

“唯一” - 选中后，该字段在表单中被视为唯一字段。

“受保护” - 选中后，使字段可用于仅输入。

“持久” - 选中后，它将一个字段存储在数据库中。如果您不想将字段保存到数据库，请取消选中“持久” 。

表格视图- 选中后，将以提交的表格视图中的值显示。您可以将其用于在“编辑网格”组件中添加的子组件，以显示行中的子组件。如果取消选中， “编辑网格”的折叠行中不会显示数据。即使未显示数据，您也可以在编辑行时配置组件。

输入掩码输入掩码提供预定义的格式。例如，对于电话号码字段，默认输入掩码为[phone] 。

输入掩码元素包括：

• 9 - 数字
• a - 按字母顺序
• * - 字母数字

数据

“默认值” - 用户与字段交互之前的字段值。默认值将覆盖占位符文本。

“多个值” - 选中后，可以向字段添加多个值。这些值在 API 中显示为数组，并且该字段上会显示“添加其他按钮” 。

内容- 此部分可用于输入组件的内容。

“数据格式” - 用于保存此字段的moment.js格式。例如HH:mm:ss 。

指定时间重画- 在表单中的其他组件发生更改时重画此组件。从下拉列表中选择应重画组件的事件。要选择的默认事件为“任何更改”和“提交” 。

验证

“必填” - 选中后，此字段必须具有值。

验证时间- 确定此组件触发前端验证的时间。从下拉列表中选择事件： “更改”或“模糊” 。

最小长度- 此字段必须满足的最小长度要求。

最大长度- 此字段必须满足的最大长度要求。

最小字长- 可添加到该组件的最小字数。

最大字长 -可以添加到该字段的最大字数。

正则表达式模式- 提交表单之前，组件必须通过的正则表达式模式。

“错误标签” - 显示验证错误消息时显示的标签。

“自定义错误消息” - 发生错误时要显示的自定义错误消息。

“仅允许使用可用的值” - 选中后，系统将执行验证检查，以确保所选值为可用选项。

字段键值

属性名称-参数集合中组件的相应参数名称。

您可以使用“属性名称”在表单内部传递参数（使用“设置表单值”活动），或从表单外部获取值（使用 “获取表单值”活动）。

条件

“表单生成器”中的“条件”选项卡允许您在表单中的组件上放置条件，以隐藏或显示它们。

The Conditional tab has two sections:

• Simple
• 高级条件

简单条件

The Simple section of the Conditional tab allows you to hide or display a component, based on the value of another component.

The Simple section consists of three fields:

1. This component should Display - from this dropdown list, choose:

   • True if you want to condition when the component displays.
   • False if you want to condition when the component hides.

2. When the form component - from this dropdown list, choose a component in the form to act as a condition.

3. Has the value - type in the value that conditions the component when to display or hide.

   

高级条件

“高级条件”部分允许您使用 JavaScript 代码或 JSON 逻辑来创建条件组合。

备注：

高级逻辑将覆盖简单条件逻辑的结果。

在“JavaScript 代码” 部分中，输入自定义 JavaScript 代码。

The show variable must be given a true or false value. The data variable is used to access other components in the form, through the API key.

要了解如何使用条件组件，请查看条件组件教程页面。

逻辑

“表单生成器” 的“逻辑”选项卡允许您创建条件和高级逻辑脚本，以更改所选表单组件的状态或行为。

使用高级逻辑，您可以动态更改表单组件的控件、外观和风格。

表单逻辑由两部分组成：触发器和操作。

触发器

逻辑触发器是执行操作的条件。 例如，您可能希望仅在选中复选框选项时显示特定的表单字段。 在这种情况下，复选框选项是触发器，显示表单字段是操作。

有四种类型的逻辑触发器：

触发器类型	描述	示例
Simple	选择触发器类型和要在逻辑中使用的值。
Javascript	您为表单组件或表单数据提供 JavaScript 逻辑。使用 JavaScript 语法创建复杂逻辑，例如循环或动态行为。
JSON 逻辑	您为表单组件或表单数据提供 JSON 逻辑。建议在不允许使用 JavaScript 的情况下使用。无法支持循环或动态行为。
事件	您定义一个组件事件，该事件一旦由相应的组件发出，就会触发所需的操作。

操作

逻辑操作是应根据您设置的逻辑条件（即触发器）发生的表单组件行为。 例如，您可能想要为特定年龄的用户激活按钮。 在这种情况下，年龄范围是触发器，激活按钮是操作。

有四种类型的逻辑操作：

操作类型	描述	示例
属性	触发器会更改一个可用组件属性，例如工具提示、说明、CSS 类等。可用属性取决于触发组件的类型。
值	触发器会更改相应组件的值。该操作必须使用 JavaScript 语法定义。
合并组件架构	触发器会更改组件 JSON 中的组件架构参数。要查看可以更改的架构参数，请将鼠标指针悬停在相应的组件上，然后单击“编辑 JSON” 。您可以在一项操作中更改多个参数。
自定义操作	您可以使用 JavaScript 语法定义自定义操作，就像定义 JavaScript 触发器类型一样。	不适用