跳到主要内容

将组件绑定到 Jira 数据

组件通过绑定到某个字段来显示真实的 Jira 数据。绑定就是让一个通用的“字段”组件变成“经办人”或“故事点”的方式。

选择字段来源

在画布上选中一个组件,然后在属性面板中选择它应显示的字段。标准字段与自定义字段都会出现在选择器中。

在属性面板中绑定字段 画布上选中了一个字段组件,属性面板显示着字段选择器。

标准字段与自定义字段

字段渲染器注册表知道如何渲染标准 Jira 字段类型以及许多第三方自定义字段类型。当某个字段类型未被显式支持时,会有安全回退将其取值渲染为可读文本,而不是让导出失败。参见自定义字段

格式化取值

在字段支持的前提下,你可以控制取值的呈现方式(例如日期格式,或用户的显示方式)。实时预览会立即反映格式设置的变化。

绑定分类图表

请把分类图表绑定到可安全分组的字段,例如状态、事务类型、优先级、经办人或标签。图表汇总的是当前被导出的事务集合;它不会运行已保存过滤器,也不会再发起一次 Jira 请求。

对于单值字段,每个事务贡献一次归属。对于多值字段,每个取值贡献一次归属,因此百分比的分母是归属总数。空值会归入。如果分类数量超过所配置的上限,可以选择把剩余部分合并为其他,或将其截断并给出可见提示。无法安全分组的取值会被明确指出,而不会被丢弃。

绑定时间序列

在普通导出模板中,时间序列读取的是当前被导出的事务集合。在报表中,则把它绑定到一个具名的已保存过滤器数据源。同一数据源为该组件中的所有序列供数;增加序列或更改分桶间隔并不会为每条序列或每个分桶单独执行 Jira 查询。

每条序列使用一种日期事件:创建、已解决,或某个标量的自定义日期或日期时间字段。“已解决”只读取 Jira 的 resolutiondate;Done 状态无法替代缺失的解决日期。

请记住,已保存过滤器是在导出运行时才被求值的。历史分桶使用的是当前返回的这些事务上的日期,并不会重建过去有哪些事务符合该过滤器。

基于示例数据预览

设计器会用贴近真实的示例数据预览绑定结果,因此你可以在导出真实事务之前先验证版式。

未知字段同样能渲染

如果你绑定到注册表无法识别的字段类型,其取值会通过安全回退渲染,而不会破坏文档。请把缺口反馈给我们,以便扩大覆盖范围 —— 参见字段渲染问题