报告构建器
大多数 Exportelier 导出都从您正在查看的内容开始——一个问题、一个看板、一个冲刺。 报告则反过来：它是一个自行指定数据来源的已保存对象。您只需构建一次， 任何被允许导出它的人都能得到当前的数据。
一份报告恰好由两部分构成：
- 一个模板 —— 普通的设计器模板。不存在单独的 “报告模板”，也没有第二个设计器。
- 一个或多个具名数据源 —— 每一个都是 Jira 已保存过滤器。
模板内部的组件随后_按名称_绑定到某个数据源，因此单份报告 可以在同一个文档中把“支持待办事项”与“工程升级事项”并排展示。
Special Reports：Dashboard 选项卡中的已保存报告。
从 Jira 仪表板开始
您可以从零开始构建报告——选择过滤器、放置 报告组件、逐个绑定——也可以从 您已有的 Jira 仪表板开始。
**从 Jira 仪表板导入**会读取仪表板的 配置，并据此构建一份普通报告。它导入的是小工具_被配置为展示的内容_， 而不是它的图像；导入之后结果也不会与仪表板保持同步： 过滤器数据保持实时，但布局和配置只有在您明确重新导入时才会变化。
报告位于何处
报告从特殊报告中的仪表板选项卡导出。其中既包括基于已保存过滤器手动构建的报告， 也包括从 Jira 仪表板导入的报告。站点管理员在模板 → 报告下管理同一批记录； 管理列表会显示每份报告的名称、描述、数据源数量、模板、范围、最后更新时间， 以及它是否可供导出。
所有能使用 Exportelier 的人都能在仪表板选项卡中看到已启用的报告。您能_管理_什么 则取决于您的角色。
谁可以做什么
| 操作 | 站点管理员 | 任意已认证的 Jira 用户 |
|---|---|---|
| 查看报告列表 | ✅ | ✅ |
| 导出已启用的报告 | ✅ | ✅ |
| 创建、编辑、复制、删除报告 | ✅ | — |
| 打开报告设计器 | ✅ | — |
| 添加或更改数据源 | ✅ | — |
管理类操作对非管理员而言不只是被隐藏——服务器会直接拒绝它们， 因此直接调用 API 也无济于事。
站点管理员可以基于_他们自己_能看到的任何过滤器构建报告。这并不会 为其他任何人授予访问权限。每次导出都会以执行导出的人的身份重新读取 Jira——参见按用户区分的结果。
构建报告
报告编辑器包含四个部分，按使用顺序排列：
- 报告详情 —— 名称、描述、范围，以及该报告是否 已启用导出。
- 数据源 —— 添加每个已保存过滤器，并为其取一个在您的组织中 有意义的名称。参见已保存过滤器数据源。
- 设计器 —— 普通的可视化设计器。每个数据组件都会获得一个 列出您具名数据源的来源选择器。
- 预览与导出 —— 检查绑定，然后导出。
只要某个组件没有有效的数据源，报告就无法保存。编辑器会指出 有问题的组件，而不会悄悄把它们绑定到碰巧排在第一位的数据源。
允许存在没有任何组件使用的数据源——您可能想先准备好绑定—— 但编辑器会予以说明，最终导出的文档也会说明。
从内置模板开始
基于 Dashboard Report Standard 新建报告是最快捷的入口。它会 把内置的系统模板复制为一个可编辑的模板，要求至少提供一个已保存 过滤器，然后询问三个标准图表分别由哪个数据源提供数据。
如果只有一个过滤器，该问题会自动为您填好。如果有多个，则不会进行任何猜测： 在每个图表都完成分配之前无法创建报告，因为绑定错误的图表会产生 一份看起来正确、实际却不正确的报告。
内置的系统模板本身绝不会被修改。
导出报告
报告导出始终在后台运行，因为读取多个过滤器 并渲染文档无法在一次交互式请求中完成。
在作业开始之前，预检会检查每个数据源并向您展示检查结果—— 就绪、为空或不可用，并附带问题数量估计，以及当某个数据源将达到每源上限时的警 告。 随后您可以选择 PDF、**Word （DOCX）**或 Markdown 并启动导出。
运行期间您会看到真实的阶段——规划、读取 Jira 过滤器、渲染、 准备下载——并且可以随时取消。报告导出会与普通异步导出一起 显示在特殊报告 → 历史中，每条记录都带有其报告名称的标签， 因此关闭对话框后您仍可重新打开该作业。
完成的文档会如实报告它实际包含的内容：每个数据源贡献了多少问题、 在哪里因限制被截断，以及报告中定义但没有任何组件使用的数据源。
如果报告的某个已保存过滤器对您不可用，导出会失败 并指明该数据源。它不会悄悄渲染出一份内容更少的报告——一份 悄然缺少某个数据源的文档看起来与完整文档完全一样。
限制
报告有自己的上限——每份报告的数据源数量、每个数据源的问题数量、每个表格的行数 等等。其中每一项都在服务器端强制执行，并在实际发生截断时在输出中注明。参见 限制参考。