使用文档
RowCraft 数据、隐私和权限
RowCraft 基于 Atlassian Forge 构建,完全运行在 Atlassian 云上。它没有自己的服务器,不会把数据发送到 Atlassian 之外(无出站),也不使用外部存储。Forge 将 RowCraft 标记为符合 Runs on Atlassian 条件。
数据存储在哪里
| 数据 | 存储位置 |
|---|---|
| 表格字段的行 | 工作项上的自定义字段值,位于你的 Jira 站点 |
| 表格字段的列、规则、颜色和默认行 | Jira 的字段上下文配置 |
| 面板表格的行 | 工作项上的工作项属性,位于你的 Jira 站点 |
| 面板表格定义(名称、适用范围、列) | Atlassian 托管的 Forge 应用存储 |
| 已保存的报表视图 | Forge 应用存储 |
| 面板表格的变更记录 | Forge 应用存储 |
| 表格字段的变更记录 | Jira 自己的工作项变更历史 |
| 项目是否显示 RowCraft 面板 | 你的 Jira 站点中的项目属性 |
表格数据保存在你的 Jira 站点以及你的安装所对应的 Atlassian 托管 Forge 存储中。BlueGrove Labs 没有这些数据的副本。
始终遵循 Jira 权限
- 查看: 表格只显示在用户有权浏览的工作项上。报表、搜索助手和变更记录都 以当前用户身份 读取数据,因此用户只能看到有权浏览的工作项中的行。共享报表视图只共享设置,绝不共享数据。
- 编辑: 保存表格需要编辑该工作项的权限。面板表格以用户身份写入,由 Jira 检查编辑权限。
- 搜索: JQL 结果与其他搜索一样遵循 Jira 的浏览权限。
- 管理: 表格字段和面板表格页面,以及对表格配置的所有修改,都需要 管理 Jira 全局权限,并在服务器端对每个请求进行检查。
- 规则: 必填、只读和锁定规则由 Jira 通过字段校验强制执行,因此同样适用于 REST API 调用、批量编辑和自动化。
应用权限范围
安装 RowCraft 时,Jira 会请求以下权限范围:
| 权限范围 | 用途 |
|---|---|
read:jira-work |
为编辑器、报表、变更记录和搜索读取工作项和表格值 |
write:jira-work |
以用户身份把面板表格的行保存为工作项属性 |
read:jira-user |
在用户列和规则条件中显示人员 |
read:servicedesk-request |
在 Jira Service Management 门户请求中显示表格 |
read:custom-field-contextual-configuration:jira |
读取表格字段的列配置 |
read:field:jira |
为搜索和报表查找 RowCraft 字段及其上下文 |
read:app-data:jira、write:app-data:jira |
保持 RowCraft 的 JQL 函数为最新 |
manage:jira-configuration |
在管理页面中创建表格字段并保存配置(用户还必须是 Jira 管理员) |
storage:app |
在 Forge 存储中保存面板表格定义、报表视图和面板表格变更记录 |
write:project.property:jira、delete:project.property:jira |
标记哪些项目显示 RowCraft 面板 |
RowCraft 不申请任何外部访问权限:它不会调用 Atlassian 之外的任何服务器,人员头像也从 Atlassian 加载。
删除数据
- 清空表格并保存,会从工作项中删除它的行。
- 删除列并保存配置后,会在后台从工作项中删除该列的值。
- 删除面板表格,会删除它在所有工作项上的行、搜索数据和变更记录。
- 删除工作项,会删除它的面板表格变更记录。
- 已保存的报表视图可以由创建人或 Jira 管理员删除。