跳到主要内容

组件库

设计器提供 23 个以上的拖放组件。你通过把组件拖到画布上并将其绑定到 Jira 数据来组装模板。本页是各组件分组的参考。

组件面板 设计器的组件面板，各组件分组已展开。

版式​

用于排布其他一切内容的结构性构件：区块、分栏、间隔、页眉页脚以及分页符。参见版式与页面设置。

字段​

将组件绑定到任意标准或自定义 Jira 字段 —— 摘要、状态、经办人、日期、数字、下拉列表等等。未知字段类型会安全回退。参见将组件绑定到 Jira 数据。

状态、优先级与事务类型还可以渲染为徽标而非纯文本，其外观与同一状态在子任务表格中的显示一致。状态的颜色取自 Jira 状态类别，因此即便状态被重命名或不是英文，配色依然正确；优先级与事务类型则会显示其 Jira 图标和一个中性色标签。对于其他所有字段，包括你自己的单选自定义字段，该选项都会灰显 —— 因为这些取值背后没有可用于着色的类别。

重复器​

将一组组件按事务重复渲染（用于批量/看板/冲刺导出），或按列表中的每一项重复渲染，并可选择分组。参见重复器与分组。

列表与表格​

针对事务内容的现成组件：

  • 评论列表 —— 可选显示作者头像（默认关闭；仅从你自己的 Jira 站点读取，否则显示姓名首字母）
  • 工作日志表格（带 Tempo 镜像模式 —— 参见 Tempo）
  • 变更历史
  • SLA 与审批列表（对 Jira Service Management 很有用）

分类图表​

分类图表是一个普通的、可复用的组件。你可以把它放在任何允许放置组件的位置，并绑定到可分组的 Jira 字段。在普通导出模板中，它的数据源始终是当前被导出的事务集合；添加图表不会额外发起 Jira 搜索。而在报表内部，它可以改为读取报表的某个具名数据源。

可选择饼图、环形图或水平条形图呈现方式。空值显示为无。当超出分类数量上限时，多出的分类要么合并为其他，要么被截断。截断以及不受支持的取值总会产生可见提示，而不会悄悄省略数据。

对于标签这类多值字段，百分比基于分类归属数总量计算，而不是事务数量。一个带三个标签的事务贡献三次归属。

同一个组件在不同格式下有各自真实的呈现方式：

  • PDF： 带文本标签与数值的矢量图表。
  • Word（DOCX）： 内嵌 SVG 并带 PNG 回退，其后附有分类表格。
  • Markdown： 分类表格；水平条形图还会使用文本条。饼图与环形图不会用虚假图片来表示。

分类名称与数值始终以文本形式提供，因此颜色绝不会是唯一的信息载体。

时间序列​

时间序列同样是一个普通的事务集合组件。可使用一到四条序列，每条分别统计创建、已解决，或某个标量的日期/日期时间自定义字段。创建与已解决对比这一面板项只是同一组件的预设：它初始包含创建与已解决两条序列，且所有设置都可继续编辑。

“已解决”仅指 Jira 的 resolutiondate。处于 Done 状态但没有解决日期的事务不会被计为一次解决事件。

可选择折线图、面积图或分组条形图；按天、周或月分桶；以及闭区间的相对或固定时间范围。相对范围以生成时执行导出用户的本地日期为结束点。月指的是本地自然月，而非 30 天，周的起始日始终取决于显式的周一/周日设置。如果无法使用该用户的 Jira 时区，导出会回退到 UTC 并明确予以说明。

已保存过滤器的历史

已保存过滤器提供的是它当前匹配到的事务。图表可以使用这些事务上的历史日期，但它不会重建过滤器在过去的匹配范围。在把导入的“创建与已解决对比”图表与 Jira 的小工具进行比较之前，请先阅读报表组件。

格式徽标反映的是真实输出：PDF 为矢量，Word 内嵌 SVG 并带 PNG 回退且包含完整表格，Markdown 则是线性化的数据表。参见限制参考。

汇总组件​

另有三个组件汇总的是整个事务集合，而非单个事务：

  • KPI 卡片 —— 一个核心数字：事务数量、已完成数量、完成百分比，或某个数值字段的求和/平均值
  • 事务表格 —— 每个事务一行，列由你自行选择，最多 200 行
  • 二维矩阵 —— 按两个字段交叉统计事务数量的交叉表，每个轴最多 12 个分桶，可选显示合计

与分类图表一样，在普通模板中它们各自读取当前被导出的事务集合，在报表中则读取具名数据源。各格式的具体细节参见报表组件。

变更报告​

有三个组件渲染的是参照点与当前之间发生了什么变化，而不是当前状态：

  • 变更摘要 —— 计数、参照点，以及首次运行或变更历史存在缺口之类的说明
  • 增量事务列表 —— 新增列表或已不在结果中列表
  • 变更表格 —— 每个发生变化的字段一行；同一字段的多次变化会折叠为一行并附带变化次数

“已不在结果中”绝不表示已删除：事务可能因为许多无害的原因而离开过滤器，导出的文档中也始终会这样说明。

该功能在 Standard 版中可用于 JQL、看板、冲刺、发布版本与待办列表导出，在定时导出中作为每周“变化了什么”报告尤其实用。

签名区块​

为需要签署的文档放置一个签名区块。可与数字签名结合，生成防篡改的 PDF。

从默认模板起步

每个组件都以预先排布好的形式出现在内置模板中。复制一个内置模板是了解各组件作用的最快方式 —— 参见管理模板。