SKILL.md
readonly只读
name
platform-validation-rule-generate
description
当用户需要创建、修改或验证Salesforce验证规则时,使用此技能。当用户提及验证规则、字段验证、数据质量规则、公式验证、错误消息或验证逻辑时触发。当用户遇到验证错误、需要更新公式或希望在数据层强制执行业务规则时,也使用此技能。始终将此技能用于任何验证规则工作。
何时使用此技能
当您需要以下操作时,使用此技能:
- 创建验证规则以强制数据质量
- 防止保存无效记录
- 生成带有公式的验证规则元数据
- 向对象添加业务逻辑验证
- 排查与验证规则相关的部署错误
规范
验证规则元数据规范
概述
验证规则是用于在Salesforce中强制数据质量和业务逻辑的声明性元数据组件。它们在保存记录时评估公式表达式,如果表达式返回TRUE,则阻止保存操作。
目的
- 在数据层执行业务规则
- 防止保存无效或不完整的记录
- 显示有意义的错误消息以指导用户
必需属性
核心验证规则属性
-
fullName
- 验证规则的唯一API名称
- 必须以字母开头
- 可以包含字母、数字和下划线
- 不能以下划线结尾
- 不能包含连续的下划线
- 不能超过40个字符
-
active
- 指示验证规则是否启用
true → 规则被强制执行
false → 规则处于非活动状态
- 指示验证规则是否启用
-
errorConditionFormula
-
评估记录数据的逻辑公式
-
必须返回TRUE或FALSE
-
如果为TRUE,则验证规则触发错误
-
errorMessage
- 验证失败时显示给用户的消息
-
最大长度:255个字符
特定函数指南
- TEXT - TEXT()函数不得与文本字段一起使用,要解决此问题,只需删除TEXT()函数。
- CASE - 在Salesforce的CASE()函数中,最后一个参数是默认值。管理员经常忘记提供此参数,并且CASE()函数的参数数量始终是偶数。
- VALUE - VALUE()函数只能与文本字段一起使用。如果数字被用作VALUE()函数的参数,请删除VALUE()函数。
- DAY - DAY()函数只能与日期字段一起使用。如果日期时间字段被用作DAY()函数的参数,请先将其转换为日期。
- MONTH - MONTH()函数只能与日期字段一起使用。如果日期时间字段被用作MONTH()函数的参数,请先将其转换为日期。
- DATEVALUE - DATEVALUE()函数只能与日期时间字段一起使用。如果日期被用作DATEVALUE()函数的参数,请删除DATEVALUE()函数。
- ISPICKVAL - 如果检查选择列表类型字段的相等性,则必须使用ISPICKVAL()函数。
- ISCHANGE - 使用ISCHANGE()函数来检查记录的值是否已更改。
关键规则
-
公式XML处理(最常见的错误)
- 任何包含XML标签的errorConditionFormula必须放在元数据XML中的CDATA部分内。
-
“更新”指令的解释。当收到修改公式的指令时,区分替换和添加:
- “将公式更新为[操作]”:用新要求完全替换现有公式逻辑。
- “将公式更新为也[操作]”:保留现有逻辑并附加新要求(通常通过将逻辑包装在AND()或OR()函数中)。
-
文件格式要求
- 验证规则文件必须始终使用
.validationRule-meta.xml扩展名。
- 验证规则文件必须始终使用






