了解如何在 Tulip 中使用小部件、按钮和触发器来验证数据。
对操作员输入数据进行验证可减少质量问题,并规范流程中使用的表单。如果用户输入的数据值不符合验证要求,系统将显示错误信息。此外,您还可以使用触发器逻辑,在输入数据不符合要求时阻止操作员继续使用应用程序。
数据验证使应用程序构建更加顺畅,并具有以下优势:
- 简化触发器管理:减少触发器的数量和复杂性,从而简化应用程序的开发和维护。节省应用程序开发时间。
- 创建动态步骤:通过按钮的启用/禁用功能为应用程序添加动态控制,从而实现更强的交互性和灵活性。
- 减少应用程序维护工作:减少审查和理解应用程序所需的时间。复制并粘贴控件时,无需担心触发器的影响。
您还可以通过动态启用和禁用按钮,提供直观的应用程序体验。
各输入控件可用的验证规则
虽然您可以使用所有输入控件进行数据验证,但某些输入控件具有用于设置数据参数的验证规则。下表概述了每个 Input Widget 可用的验证规则。
| 输入控件 | 验证规则 |
|---|---|
| 复选框 | 不适用 |
| 文本 | 包含、不包含、以…开头、以…结尾、最大字符限制、最小字符限制、是电子邮件、是URL(根据此处) |
| 多行 | 包含、以…开头、以…结尾、最大字符限制、最小字符限制、不包含 |
| 文件 | 不适用 |
| 数字 | 等于、不等于、大于、大于等于、小于、小于等于、在范围内(包含边界)、在范围外(不包含边界)、精确小数位数 |
| 单选 | 不适用 |
| 多选 | 所选最小值、所选最大值 |
| 日期选择器 | 是、之前、之后、在范围内(含边界)、在范围外(不含边界)、在……或之前、在……或之后 |
| 图片 | 不适用 |
| 电子签名 | 不适用 |
创建验证规则
- 选择一个具有可用验证规则的输入控件(参见上表)。
- 在“上下文窗格”中,单击**“验证规则**”旁边的**“+**”图标。
- 选择要添加到该输入控件的规则。

- 为该规则选择一个数据源以进行验证。该数据源可以是静态值,也可以是变量。

- 单击**“+”**按钮以添加更多规则。
重新排列验证规则
验证规则的顺序决定了当输入的数据值不通过验证时,系统首先显示的错误信息。
在下面的示例中,输入的数据同时违反了两条验证规则。但是,显示的错误消息与配置的第一条规则相关。
示例 1:“包含Tulip”是第一个未通过验证的规则,因此相应地显示该错误消息。

示例 2:“以 Hello开头”是第一个失败的规则,因此相应地显示该错误信息。

这使应用构建者能够指定向操作员显示的错误消息的优先级。要重新排列验证规则的顺序,请点击六点图标,然后将其拖动到某条规则的前面或后面。

要求输入数据
将验证规则标记为“必填”后,系统会添加一条规则:操作员必须填写该输入项,该输入才被视为有效。 您可以对所有输入控件类型使用此功能。当输入控件被标记为必填时,应用中的该输入控件旁边会显示一个红色星号。要设置此功能,请切换侧边栏**“验证规则”部分标题下方的“标记为必填**”滑块。

输入验证错误提示
侧边栏**“验证规则**”部分内的**“错误格式**”下拉菜单提供了多种选项,用于设置应用在播放器中运行时,输入数据出现错误时向操作员显示的提示样式。

向操作员显示错误的三种选项:1.显示验证规则错误消息 * 用红色边框标出输入字段,并向操作员显示错误消息2.仅标出输入字段 * 用红色边框标出输入字段3.隐藏错误 * 不提供任何视觉提示
动态启用和禁用按钮
通过动态控件决定操作员何时可以点击按钮。当按钮被禁用时,它将以淡色显示,且操作员无法点击该按钮。

您甚至可以在电子签名控件上使用此控件。

通过在侧边栏中为所选按钮的**“交互”部分设置“启用”状态**,可以动态启用或禁用按钮。默认情况下,按钮的“启用”状态设置为**“是”**。

有几种方法可以添加动态控制来确定按钮的启用状态:1. 指定一个布尔变量2. 在包含验证规则的“带输入控件的步骤”中检查用户输入的有效性3.**使用“所有控件”**选项,该选项会检查所有输入内容是否符合验证规则

- 使用表达式
使用表达式启用/禁用按钮
如果您希望根据一组控件来启用或禁用按钮,请选择**“使用表达式**”来编写自定义条件。
您必须编写一个评估结果为布尔条件(true 或 false)的表达式。如果正确构建了有效的表达式,表达式编辑器将在左下角显示提示。
**示例 1:**下面的示例使用取模运算来判断输入到数字输入控件中的值是奇数还是偶数。如果该值为奇数,则按钮将被启用;如果该值为偶数,则按钮将被禁用。

示例 2:使用表达式还可以将多个条件组合在一起。在下面的示例中,按钮要处于启用状态,该值必须是奇数,并且必须满足数字输入控件上设置的验证条件。

下方的输入值会导致按钮处于禁用状态。尽管输入的值是奇数,但它不符合输入控件的验证规则。

下方的输入值会导致按钮处于启用状态,因为该值既是奇数,又符合输入控件的验证规则。

触发器中的输入控件验证
您可以在触发器中的**“如果”**条件中使用输入控件验证。这使应用构建者能够快速创建逻辑,该逻辑不依赖于操作员输入的具体值,而是基于这些值的有效性。

还可以通过触发器将控件有效性信息存储到变量和表记录中。

您找到想要的内容了吗?
您还可以访问community.tulip.co发布问题,或查看其他人是否遇到过类似问题!

