跳到主要内容

状态徽标与进度

借助状态徽标、Jira 事务类型与优先级图标、已完成项的删除线以及进度条,让子事务与关联事务更易于快速浏览。所有版本均可使用。

已有模板会保持原先的外观。只有当你新增子任务事务链接进度条组件时,这些选项才会被显式写入。

子事务与关联事务

选中子任务组件即可配置:

  • 版式 —— 表格,或独立面板。面板模式共用一行列标题,并以缩进和连接引导线显示嵌套的子事务;若不需要这些标签,可关闭显示标题
  • 状态样式 —— 纯文本或徽标。
  • 显示事务类型图标 —— 在可用时使用 Jira 图标。
  • 为已完成项添加删除线 —— 仅当 Jira 报告的稳定状态类别为 Done 时生效,因此像 Abgenommen 这类被重命名或翻译过的状态同样有效。
  • 显示子任务进度 —— 为所有显示出来的子事务(包括递归加载的)添加一条按事务数量计的进度条。
  • 配色模式 —— 彩色,或适合打印的单色配色。

事务链接组件提供同样的徽标、图标、删除线与配色控件,并额外支持可选的优先级显示。

独立进度条

从组件面板的数据分组中拖出进度条。它可以度量:

  • 子任务 —— 所有显示出来的子事务,含递归加载的。
  • 关联事务 —— 按事务键去重。
  • 导出集合 —— JQL、看板、待办列表、冲刺或发布版本导出中的事务。

计算基准可选事务数量故事点。故事点进度适用于所有数据源,并使用属性面板中选定的数值型自定义字段。缺失、非数值、零与负值一律计为零点,同一事务键的重复引用只计一次。

标签可显示百分比、分数或两者兼有 —— 例如 67% (2/3)。数据源为空时默认显示 0%;也可启用数据源为空时隐藏,直接移除该组件。

状态类别与未知数据

配色与完成度只依据 Jira 的状态类别 —— 待办、进行中或已完成。Exportelier 绝不会根据状态名称来猜测。仅带名称的历史数据会渲染为中性的未知,计入进度的分母,且永不计为已完成。

各格式之间的差异

格式状态与图标进度已完成项
PDF矢量徽标、Jira 位图图标或绘制的回退图形矢量进度条,可选标签原生文本删除线
Word(DOCX)带底色与边框的徽标文本段;Jira 图标或通用字形按比例的双单元格表格,可选标签原生删除线文本段
Markdown[DONE][IN PROGRESS][TODO][UNKNOWN];事务类型与优先级以文本表示形如 67% (2/3) 的紧凑文本~~删除线~~

Markdown 刻意不内嵌位图图标、颜色或表情符号。这既保持了输出的可移植性,也保留了紧凑模式所节省的 token。

图标处理与限制

图标只通过 Atlassian 的产品 API 从 Jira 加载。Exportelier 不引入任何额外的外部网络目标,也不会在保存的事务数据包中存储图标字节 —— 这些字节只存在于当前这次渲染过程中。

  • 每次渲染最多 32 个不同图标。
  • 单个图标最大 128 KiB,总计最大 2 MiB。
  • 最多四个并发图标请求,总时间预算五秒。
  • 接受 PNG、JPEG、GIF 与 BMP;其他格式会回退为绘制的通用图形。
  • 被阻止、缺失、超大或超时的图标绝不会导致导出失败。

无障碍且适合打印的输出

状态文本始终可见,因此颜色绝不会是唯一的信号。黑白打印时,或当模板需要避免使用语义色时,请使用单色模式;徽标边框与文字对比度依然清晰可辨。Markdown 中显式的文本标记就是与颜色无关的等效表达。