值校验
在字段设计中新建值校验,填写名称、适用按钮、布尔公式、失败行为、错误落点字段和提示消息。仅可选择已启用、位于表单且适用于 新建 或 编辑 的按钮,列表按钮不适用。先读取当前按钮设计获取真实按钮 ID。
公式返回 true 时通过,返回 false 时按配置 阻止 或 警告;公式执行错误或返回非布尔值时一律阻止。错误落点必须是实际启用的字段。消息支持 {{amount}} 等字段变量以及允许的关联字段路径,保存时会根据真实表单结构校验。
编辑弹窗可预览计算结果。前端提示不能替代适用表单动作执行时的服务端校验。保存规则后,分别用通过和不通过的数据测试所选按钮。
CLI
sl system form value-validation list --form-id "$FORM_ID" --json
sl system form value-validation save --form-id "$FORM_ID" --definition-file rule.json --json
sl system form value-validation delete --form-id "$FORM_ID" --rule-id "$RULE_ID" --json
rule.json 是完整规则本身,不要额外包一层 rule:
{"id":"11111111-1111-4111-8111-111111111111","name":"金额为正","buttonIds":["preset:<真实按钮ID>"],"formulaExpression":"FIELD(\"amount\") > 0","failureAction":"block","fieldApiName":"amount","message":"金额必须大于零,当前为 {{amount}}"}
将示例 ID 与 API 名替换为真实值。同一个规则 id 表示更新,新增规则使用新的 UUID。按钮键为 preset:<id> 或 custom:<id>。保存通过领域方法检查权限、公式、消息路径及按钮范围,并返回全部规则;删除返回剩余规则。这些命令要求字段设计权限,直接写入租户数据库,不是页面未保存草稿操作。
按钮选择
仅可选择新建/编辑页启用的按钮。级联选择器一级显示适用区域,二级显示按钮名称及预设/自定义来源标签,支持多选和搜索。