使用文档
RowCraft 常见问题和限制
常见问题
同一个字段能否在不同项目中使用不同的列?
可以。在 Jira 的字段设置中为表格字段的每个项目建立一个上下文,再在 表格字段 页面分别配置每个上下文。报表会对齐不同上下文中同名的列,rowcraftField() 会搜索所有包含该列的上下文。
为什么不能修改已保存列的类型?
列保存后保持类型不变,这样工作项上已保存的值永远不需要转换,搜索和报表的含义也不会改变。只有下拉单选和下拉多选可以互相切换。要使用其他类型,请新增一列并删除旧列。
为什么工作项上没有显示表格?
- 表格字段: 检查字段是否已添加到该项目和工作类型的界面,以及字段是否有适用于该项目的上下文。见把字段添加到界面。
- 面板表格: 检查表格的适用范围(项目和工作类型),以及面板是否已经设置过一次 为所有工作项显示。见在工作项上显示面板。
客户能在服务台门户中填写表格吗?
可以。在 Jira Service Management 中把表格字段添加到请求类型即可。标记为 在服务台门户中隐藏(仅客服可见) 的列不会显示给客户。面板表格不会显示在门户中。
默认行会应用到已有工作项吗?
不会。RowCraft 编辑器打开新的空表格字段时(例如在创建表单中)才会填入默认行。已有工作项保持原有的行;不经过编辑器、通过 REST API 或自动化创建的工作项也不会带有默认行。
为什么搜索会找到匹配值分布在不同行的工作项?
rowcraftField() 或 rowcraftPanel() 中的每个条件只要 任意 一行满足就算命中,不同条件可以由不同的行满足。见用 JQL 搜索。要检查同一行中的值,请使用带筛选的报表。
JQL 显示“JQL is invalid. Validation of field by customJqlFunctionExpansion failed”,是哪里错了?
对于应用 JQL 函数中的任何错误,Jira 都只显示这一条消息。请检查表格名和列名、该列类型支持的运算符和值,以及你是否有应用的访问权限。搜索助手会在输入时显示 Jira 的检查结果。
能用自动化或 REST API 编辑表格吗?
表格字段可以:它的值是一个 JSON 对象,Jira 在每次写入时都会执行表格的规则。以这种方式写入的值在下次通过 RowCraft 保存之前,不会有公式结果和搜索数据,因此批量修改建议使用 RowCraft 编辑器或导入。
能从其他表格应用迁移数据吗?
从其他应用把表格下载为 CSV 或 Excel,再逐个工作项导入到 RowCraft。大规模迁移请联系支持。
在哪里获得帮助?
请联系 BlueGrove Labs 支持,并附上工作项关键字、表格名称以及提示信息的截图。
限制
| 项目 | 限制 |
|---|---|
| 每个表格的列数 | 20 |
| 每个表格的工作项列 | 5 |
| 每个表格的行数 | 最多 200(默认最大值 100) |
| 一个表格字段的大小 | 32,768 个字符,即 Jira 单个字段的上限(约 100 行常见数据);编辑器会显示已用空间 |
| 一个面板表格的大小 | 32,768 字节;中文、日文等字符每个占 3 字节 |
| 单个单元格的文本 | 1,000 个字符 |
| 每个下拉列的选项 | 200 |
| 默认行 | 50 |
| 每个表格的规则 | 20 |
| 表格配置的大小 | 约 32,000 个字符;设计器会显示占用情况 |
| 每个站点的面板表格 | 50 |
| 每个工作项上可搜索的面板表格 | 10 |
每次 rowcraftField() 或 rowcraftPanel() 调用的条件数 |
10 |
| 每个表格可搜索的文本 | 每个文本列约 2,000 个字符,所有文本列合计约 6,000 个字符;超出部分会保存,但 JQL 搜不到 |
| 导入文件大小 | 5 MB |
| 每份报表的工作项 | 20,000 |
| 每份报表的行 | 200,000 |
| 已保存的报表视图 | 每个站点 500 个,每人 100 个 |
| 报表分组层级 | 3 |