表单控件

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

如果您对组件的设计感到满意，请选择“ 保存”。

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

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

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

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

显示

标签 - 组件的标题。

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

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

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

自定义 CSS 类 - 向组件添加自定义 CSS 类。 您可以添加多个类，并用空格分隔这些类。

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

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

隐藏标签 - 隐藏组件的标签。

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

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

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

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

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

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

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

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

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

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

数据

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

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

“内容 ” - 在此部分中键入组件的内容。

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

“重绘时点” - 如果表单中的另一个组件发生更改，则重绘此组件。从下拉列表中选择应重绘组件的事件。 要选择的默认事件为“ 任何更改” 和“ 提交”。

验证

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

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

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

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

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

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

“正则表达式模式 ”- 提交表单前组件必须传递的正则表达式模式。

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

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

仅允许可用值 - 选中后，将执行验证检查，以确保所选值是可用选项。

字段键值

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

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

条件

“表单生成器”中的“ 条件” 选项卡可用于对表单中的组件放置条件，以隐藏或显示组件。

“ 条件” 选项卡包含两个部分：

• Simple
• 高级条件

简单条件

“ 条件” 选项卡的“简单”部分允许您根据另一个组件的值隐藏或显示某个组件。

“ 简单 ”部分包含三个字段：

1. 此组件应显示 - 从此下拉列表中选择：

   • 如果要在组件显示时设置条件，则为True 。
   • 如果要在组件隐藏时设置条件，则为False 。
2. “表单组件” - 从此下拉列表中，选择表单中的组件作为条件。

3. 具有值 - 输入用于调节组件何时显示或隐藏的值。

   
   

   

   
   

高级条件

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

注意： “高级逻辑”会覆盖“ 简单 条件逻辑”的结果。

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

必须为 show 变量指定 true 或 false 值。 数据 变量用于通过 API 密钥访问表单中的其他组件。

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

逻辑

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

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

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

触发器

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

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

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

操作

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

有四种类型的逻辑操作：

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