对象记录验证规则可以确保用户输入有意义的正确数据,从而帮助贵组织提高数据质量。验证规则包含用于评估字段中的用户输入数据的公式或表达式,它们返回的值“True”表示数据有效,“False”表示数据无效。
一些有用的验证规则示例包括:
- 批准日期必须在提交日期之后。
- 撤回日期必须在注册日期之后。
- 产品折扣不能超过 40%。
Vault 支持您在对象级别或对象类型级别为特定对象字段配置验证规则。使用对象类型粒度,您可以准确地反映各对象类型之间存在差异的业务规则。
如何创建验证规则
要创建验证规则:
- 导航到管理 > 配置 > 对象,并打开对象。
- 要在对象级别定义规则,请打开验证规则标签页。在对象级别定义的规则将应用于所有记录,而无论对象类型如何。
- 要在对象类型级别定义规则,请打开对象类型标签页,单击对象类型,然后向下滚动至类型验证规则节段。在单个对象类型中定义的规则将仅应用于该对象类型的记录。
- 单击创建。
- 输入验证规则的基本详细信息:标签和名称。名称不会向最终用户显示,仅通过 API 可见。
- 输入错误消息。输入无效值的用户将看到此警告消息。
- 在错误位置中选择一个或多个字段。这些是规则将验证的字段。
- 在验证表达式节段中,定义验证规则。了解有关编写表达式的更多信息,请参阅验证表达式。
- 单击验证,以提示 Vault 检查表达式中是否有错误。如果未发现错误,请单击保存。
Vault 将立即开始为新记录应用验证规则。对于现有记录,如果用户编辑并尝试重新保存记录,Vault 将应用验证规则。
验证表达式
验证表达式使用与公式字段和字段默认值相同的表达式语法,但必须返回一个是/否(又称 True/False)值。
支持的字段类型
验证表达式只能包含具有以下数据类型的字段:
- 日期
- 日期时间
- 数字
- 是/否
- 选项列表
- 文本
支持的字段
验证表达式可以使用您正在配置的对象中的字段,也可以使用来自相关对象的字段(仅通过出站关系)。
可用函数和运算符
有关使用 Vault 表达式语言的一般信息,请参阅在 Vault 中创建公式。有关可用函数和运算符的详细信息,请参阅 Vault 公式引用指南。
执行验证规则
如果字段值不符合为这些字段定义的验证规则,用户将无法创建新记录或保存编辑。在大多数情况下,配置的验证错误将内嵌显示,但在字段被隐藏或字段编辑发生在生命周期状态入口操作中的情况下,用户将看到一个带有验证错误的弹出对话框。
Vault 会在创建或编辑记录的任何时候执行记录验证规则,包括:
- 在批量编辑记录或批量创建记录的过程中
- 当由 Vault 加载程序启动记录创建或编辑时
- 当由用户操作启动记录创建或编辑时
- 当由入口操作启动记录创建或编辑时
- 当创建或编辑非活动对象记录时
- 当通过“创建和关联”创建记录时,包括来自文档的“创建和关联”
- 字段默认值
- 在页面布局中不可见的字段
- 由于字段级安全配置而被隐藏或只读的字段
验证失败
在某些情况下,验证表达式将自动解析为“False”,因此验证将失败:
- 验证表达式中的一个或多个字段为空
- 验证表达式中的一个或多个字段不适用于记录的对象类型
限制
对象记录验证规则存在以下限制:
- 一些应用程序可能会阻止您为某些系统、标准和应用程序标准对象创建规则。
- 规则表达式的长度不能超过 3900 个字符。
- 错误消息的长度不能超过 255 个字符。
- 规则表达式不能包含公式字段。
- 规则表达式不能包含系统管理的名称。
- 在迁移模式下创建记录时,Vault 不会评估验证规则。
相关权限
您可以使用标准系统管理员或 Vault 所有者安全配置文件完成本文章中的所有步骤。如果 Vault 使用自定义安全配置文件,则您的配置文件必须授予以下权限:
- 管理员:配置:对象:编辑
- 能够编辑 Vault 对象配置以便创建记录验证规则。