使用文档

RowCraft 表格设置、规则和默认行

表格设置作用于整个表格。规则根据条件让列必填或只读、禁止新增或删除行，或锁定表格。它们既在编辑器中生效，也由 Jira 在服务器端强制执行，因此对 REST API、自动化和批量编辑同样有效。

表格设置

打开列设计器的 表格设置 页签。

设置	作用
最少行数	表格至少要有的行数。0 表示表格可以不填。设为 1 或以上时，保存空表格会提示“至少添加 1 行”。
最多行数	最多 200 行，默认 100。一个 Jira 字段大约能容纳 100 行常见数据（32,768 个字符）。
JQL 中 Total 对应的列	JQL 中 `Total` 表示哪一个数字或公式列的合计，例如 `issue in rowcraftField("Purchase items", "Total > 1000")`。任何列也都可以用 `SUM`、`AVG`、`MIN`、`MAX` 和 `COUNT` 搜索；保留这个设置是为了让使用 `Total` 的已保存过滤器继续有效。
查看时的样式	表格（默认）显示带表头和合计的表格，宽表格可以左右滚动。紧凑列表每行一条，适合 Jira 右侧窄栏中的字段。
固定列	无、第一列，或前 2、3……列。宽表格左右滚动时，这些列在编辑器和只读视图中保持不动。

打开规则页签。每条规则在其条件全部满足时执行一个动作，多条规则可以同时生效。一个表格最多 20 条规则。

动作	效果
必填	在满足条件的行中，所选列不能为空。
只读	所选列中已经保存的值不能修改。同一次编辑中新增的行仍可填写。
禁止新增行	已保存的表格不能再添加行。新工作项或尚无已保存行的表格不受影响。
禁止删除行	已保存的行不能删除。同一次编辑中新增的行仍可删除。
禁止新增和删除行	同时具备以上两项。值仍然可以修改。
锁定整个表格	工作项处于所选状态时，任何人都不能修改表格。只读视图显示类似已锁定 · Done 的标签。

列可以逐个选择，也可以选择 所有列。

选择 添加条件 添加条件。一条规则的所有条件都必须满足。

条件类型	示例	可用于
本行的列	类别为服务、金额 > 5000、已付款已勾选、供应商为空	必填、只读、禁止删除行
工作项状态	为以下之一：已批准、完成 / 不为以下任何一个	所有规则
当前用户	属于用户组 finance / 不属于用户组（例外），是 / 不是指定人员	除锁定外的所有规则
项目角色	拥有角色 Administrators / 没有该角色（例外）	除锁定外的所有规则
始终生效	对所有人、所有状态生效	除锁定外的所有规则

添加常用规则 会添加一条现成的规则，补全即可：

常用规则	示例
某些状态下锁定表格	申请为“已批准”或“已关闭”时锁定。
某些状态下全部列只读，指定用户组例外	已保存的值保持不变，该用户组的成员仍可修改。
某些状态下禁止新增和删除行	值仍然可以修改。
选了某个值时，其他列必填	类别为“服务”时供应商必填。
勾选某列后锁定这一行，指定项目角色例外	已付款的行不能修改，Administrators 角色除外。
勾选某列后禁止删除这一行，指定项目角色例外	已付款的行不能删除，Administrators 角色除外。

打开 默认行 页签，准备新的空表格字段预先带有的行，例如清单的检查项。用户可以修改或删除这些行。最多 50 行；已有工作项不受影响。

像编辑工作项上的表格一样在表格中编辑默认行：输入、从 Excel 粘贴或导入文件。默认行必须满足列的规则（例如必填列）才能保存。