报告组件
有五个组件读取的是整个问题集，而不是单个问题。它们都是 普通的设计器组件——您可以像拖放其他组件一样把它们拖到画布上——但 每一个都带有数据源设置。
将组件绑定到数据
这些组件都会提出同一个问题：哪些问题？
| 您所处的位置 | 来源选择器提供的选项 |
|---|---|
| 普通的导出模板（问题、看板、冲刺、版本、待办事项列表、JQL） | 当前导出集 —— 正在被导出的问题。不发起额外的 Jira 搜索。 |
| 报告 | 该报告的具名数据源。 |
两者不可互换。具名数据源只能在报告内部解析；绑定到已不存在的数据源的 组件会在每种格式中渲染出一条可见的诊断信息，指明缺失的数据源。 它绝不会悄悄渲染为空。
当报告包含多个数据源时，系统不会做任何猜测。绑定到错误过滤器的图表 会产生一份看起来正确、实际却不正确的文档，这比直接失败更糟糕。
时间序列
将问题集中的日期事件绘制为折线图、面积图或分组柱状图。 一个组件包含一到四条序列。每条序列统计以下三种事件类型之一：
| 事件 | 统计的内容 |
|---|---|
| 创建 | 问题的创建时间戳。 |
| 已解决 | 问题的 Jira resolutiondate，仅此而已。当前处于 Done 状态绝不会被视为发生过解决事件的证据。 |
| 自定义日期 | 一个 Jira 架构为日期或日期/时间的标量自定义字段。多值日期字段会被忽略，并给出可见的警告。 |
可选择按日、周或月分桶，并使用相对范围或固定范围。两种范围都是闭区间。 相对范围以导出的明确生成时间所对应的本地日历日期结束；固定范围同时包含 起始和结束。空分桶可以保留，而对于累积序列则必须保留， 以免曲线中的平直区段消失。
日历边界使用执行导出用户的 Jira 时区。如果 Exportelier 无法读取该时区，或 Jira 返回了无效时区，图表会回退到 UTC 并 在文档中打印警告。月分桶是本地日历月，而不是经过的 30 天。 周的起始日为周一或周日，取决于组件中的明确设置； 服务器的区域设置绝不会替您做出选择。
已保存过滤器数据源返回的是当前匹配该过滤器的问题。 图表仅针对这些问题统计历史上的创建、已解决或自定义日期事件； 它不会重建在更早时期哪些问题曾匹配该过滤器。
因此，在仪表板导入之后进行比较时，Exportelier 的创建 vs. 已解决 图表可能与 Jira 自身的创建 vs. 已解决小工具不同，而这种差异并不一定是计算缺陷。
分桶限制在模板保存时强制执行：366 个日分桶、104 个周分桶 或 60 个月分桶。超出限制的配置会被拒绝，而不是悄悄缩短曲线。
类别图表
按一个可分组字段对问题集进行分组，并将分布绘制为 饼图、环形图或水平条形图。
- 最多 20 个类别；超出部分会被合并为 Other 或被截断，取决于组件的设置。
- 空值显示为 None。
- 对于标签等多值字段，百分比统计的是类别 分配次数，而不是问题数——一个带有三个标签的问题会贡献三次。
- 截断和不受支持的值始终会生成可见的提示。
KPI 卡片
一个醒目的数字加一个标签。可选择一种指标：
| 指标 | 统计的内容 |
|---|---|
| 问题数量 | 数据源中的问题数。 |
| 已完成问题数量 | 状态类别为 Done 的问题数。 |
| 完成百分比 | 已完成问题占数据源的百分比。 |
| 数值字段 | 某个数值字段的求和或平均值。 |
数值聚合只接受有限数值。为空或非数字的值会被忽略 并被显式计数，因此基于填充不完整字段构建的卡片绝不会悄悄 让您误判它自身的统计基础。
卡片还可以选择显示它所读取的数据源名称——当多张卡片 并排放置时非常有用。
问题表
每个问题一行，列由您自行选择。
- 每列可选择任意标准字段或自定义字段，并可选设置自定义表头 和宽度。
- 可选按某个字段升序或降序排序。
- 最多 200 行。 当数据源包含更多问题时，表格会显示前若干行 并说明省略了多少行。
- 可选的行数说明行（“47 行中的 12 行”）和可选的表头行。
字段值的渲染和类型转换与 Exportelier 其他表格完全一致， 因此自定义字段在任何位置看起来都一样。
二维矩阵
交叉表：一个字段沿行排列，另一个字段沿列排列，统计 每个单元格中的问题数量。
- 两个坐标轴都限制为 12 个分桶。超出部分会 归入确定性的 Other 分桶——相同的输入始终 产生相同的表格。
- 可选的行合计、列合计和总计。
- 在每种格式中都渲染为真实、可访问的表格，绝不渲染为图片。
每种格式如何渲染它们
Exportelier 将一个模板编译为三种格式。下表反映渲染器实际生成的内容—— 只有当某种格式承载了全部数值时才标记为完整，而不是仅仅看起来相似。
| 组件 | Word（DOCX） | Markdown | |
|---|---|---|---|
| 时间序列 | 矢量坐标轴、折线、面积或柱形，带文字图例和可选的数值/表格 | 内嵌 SVG 并带有确定性的 PNG 回退，其后是完整的数据表 | 线性化表格，每个分桶一行、每条序列一列；不提供伪折线图片 |
| 类别图表 | 带标签和数值的矢量图表 | 内嵌 SVG 并带有 PNG 回退，其后是类别表 | 类别表；水平条形图还会附带文字条形。饼图和环形图不会以图片形式伪造。 |
| KPI 卡片 | 完整 | 完整 | 完整 |
| 问题表 | 完整 | 完整 | 完整 |
| 矩阵 | 完整 | 完整 | 完整 |
类别名称和数值始终以文本形式提供，因此颜色绝不会 成为信息的唯一载体。
Markdown 输出会对您 Jira 数据中任何会破坏表格结构的内容进行转义， 从而让问题文本始终保持为问题文本。
限制
一份报告最多可包含 30 个数据驱动组件。结合每个数据源 和每个表格的上限，这为单次导出的开销设定了边界——参见 限制参考。