BlueGrove Labs
帮助中心RowCraft – Table Fields for JiraJira Cloud
联系支持
EN

设计 RowCraft 表格的列

列设计器决定表格的样子和行为。表格字段和面板表格使用同一个设计器,需要“管理 Jira”权限。

打开列设计器

  • 表格字段: 应用 → RowCraft → 表格字段 → 在字段的上下文上选择 配置。一个表格字段可以有多个上下文(例如每个项目一个),每个上下文有自己的列和规则。
  • 面板表格: 应用 → RowCraft → 面板表格 → 配置。
  • 从 Jira 字段设置进入: Jira 设置 → 工作项 → 字段 → RowCraft 字段 → 上下文 → 编辑上下文的配置。这会在 Jira 页面中打开同一个设计器。
Purchase items 字段的列设计器,有“列”“表格设置”“规则”“条件格式”“默认行”“预览”六个页签,六列及其类型和“必填”复选框,以及“保存配置”按钮
英文界面示例:列设计器。页签上的数字表示表格有多少列、规则、颜色规则和默认行。

设计器有六个页签:

页签 设置内容
列 列、列类型和每列的设置(列设置与公式)
表格设置 最少和最多行数、JQL 中的 Total 列、查看样式和固定列(表格设置与规则)
规则 必填、只读、禁止新增或删除行,以及按状态锁定(规则)
条件格式 为满足条件的单元格或行上色(颜色)
默认行 每个新的空表格预先带有的行(默认行)
预览 表格在新工作项上的初始样子,以及该表格的 JQL 示例

选择 保存配置 之前,工作项上的表格不会有任何变化。有问题的页签会标出 有问题需要处理,保存时会列出需要修正的内容。

从模板开始

选择 从模板开始,选择七个模板之一,然后选择 使用此模板。如果表格已经有列,模板会替换它们;工作项上已保存的数据会保留。

“从模板开始”对话框,选中了 Purchase request 并预览其六列
英文界面示例:模板自带合适的类型、必填列、合计;验收清单还带有五个默认行。

模板包括采购申请、报价单、费用报销、设备申领、测试步骤、验收清单和空白表格。列名和选项按应用模板的管理员的语言生成。各模板的列见模板列表。

复制其他字段的表格

从其他字段复制 会列出站点上所有 RowCraft 表格字段的上下文,以及各自的列数和规则数。选择字段和上下文后选择 复制。列、规则、表格设置和默认行会作为新列复制过来,因此旧字段中保存的值永远不会出现在副本中。保存之前不会有任何变化。

添加、重命名、排序和删除列

  • 添加列 会在末尾添加一个文本列。输入列名并选择类型。一个表格最多 20 列。
  • 列名:同一表格中的列名不能重复,也不能包含 { 或 }(公式中用它们引用列)。
  • 必填:每一行都必须填写这一列。计算列(公式、行号)不能设为必填。按条件必填请使用规则。
  • 排序:拖动列左侧的拖动手柄,或在“预览”中拖动列标题。使用键盘时,选中手柄后选择“移到最前”“上移”“下移”或“移到最后”。
  • 删除(垃圾桶图标)会删除该列。保存后,RowCraft 会在后台清除工作项上这一列的值,不会在工作项历史中留下记录。
  • 清空所有列 会从设计器中删除所有列及其规则,方便从头开始。

底部的进度条显示配置的占用情况(例如 配置已用 4%)。选项、选项颜色、规则和条件格式都会占用 Jira 配置的存储空间。

列类型

在 列类型 列表中选择类型。每种类型有自己的编辑器、校验、合计方式和 JQL 运算符。

新列的“列类型”菜单已展开,列出 Text、Long text、Number、Date、Select list、Multi select、Checkbox、User、Work item 和 Formula
英文界面示例:列类型列表,行号在列表末尾。
类型 内容 说明
文本 一行文字,最多 1,000 个字符 可设置长度限制和格式规则(正则表达式)
长文本 可换行显示的文字,最多 1,000 个字符 适合说明和测试步骤
数字 数字 小数位、前缀和后缀(例如 ¥ 或 %)、允许范围和合计
日期 日期(存为 YYYY-MM-DD) 日期选择器;可用 startOfMonth() 和相对日期搜索
下拉单选 列表中的一个选项 最多 200 个选项,每个选项可设颜色
下拉多选 同一列表中的多个选项 显示为彩色标签
复选框 勾选或未勾选 按空格键切换;合计可统计勾选的行数
用户 一个 Jira 用户 人员选择器;可用 currentUser() 搜索
工作项 指向另一个 Jira 工作项的链接 可用 JQL 限定可选的工作项;每个表格最多 5 个
公式 由同一行的数字、公式和复选框列计算出的值 见公式
行号 行的位置(1、2、3……) 仅用于显示,不保存、不搜索

保存配置

选择 保存配置。出现 已保存 表示工作项从现在起使用新的列和规则。RowCraft 同时刷新它的 JQL 函数,已保存的过滤器立即使用新的列。

  • 如果配置在此期间已在其他页面或被其他人保存,RowCraft 会拒绝这次保存,以免旧页面把已删除的列带回来。请重新加载页面,再做一次修改。
  • 修改公式或 Total 列后,RowCraft 会在后台重新计算已有工作项的搜索数据,通常几秒到几分钟完成。
  • 保存前请留意 会在列和规则过于复杂、Jira 在最大行数下可能无法完成检查时发出提醒,并建议更低的最大行数。

截图预览