跳转到内容

TBL-003 允许值

验证特定列的单元格值包含在 values 指定的允许列表中。发现列表外的值时,会报告为 error

即使团队约定 Status 列只使用 draft / review / stable 三个值,经过一段时间后仍可能出现 wipdone 等私有值。明确指定值集合可以防止表记不一致和私有用法的扩散。

字段类型必填说明
columnstring验证目标的列名
valuesstring[]允许值的数组
filesstring应用此规则的文件 glob
| ID | 内容 | Status |
| ------ | ---------------- | ------ |
| REQ-01 | 用户注册 | stable |
| REQ-02 | 重置密码 | wip |

设置 values: ["draft", "review", "stable"] 时,wip 不在允许列表中,故判定为违例。

docs/requirements.md
line 4 error Invalid value "wip" in column "Status". Allowed: draft, review, stable TBL-003
| ID | 内容 | Status |
| ------ | ---------------- | ------ |
| REQ-01 | 用户注册 | stable |
| REQ-02 | 重置密码 | review |
{
"rule": "tbl003",
"options": {
"column": "Status",
"values": ["draft", "review", "stable"]
}
}