快捷键:Ctrl/Cmd + K

Commitlane 使用文档

自定义指标

使用自定义公式计算指标,并手动运行报告模板。

这项功能能做什么

从可用变量定义公式,搭配图表、表格和文字。预览使用示例数据;实际运行会按团队和筛选条件查询真实数据。

适用场景

  • 计算团队已在使用的自定义指标。
  • 用相同公式和结构重复生成报告。

开始步骤

  1. 1选择变量、公式、数据类型和单位。
  2. 2检查预览,再用熟悉的期间运行。
  3. 3将指标加入模板,检查保存的结果后再导出。

设置项

设置项用途如何使用常见错误
公式和单位定义计算方法和展示格式。确认变量含义,并检查分母可能为零的情况。把缺失数据或计算错误当成零值。
筛选条件和期间限定运行时查询的真实数据。检查团队、日期,以及适用时的仓库和用户。把示例结果当作团队实绩。
日程和收件人将这些字段保存在模板中。报告仍需手动生成和分享。认为保存日程会自动运行或发送邮件。

使用示例

情况: 你想在报告中复用 PR 合并率。

  1. 1用可用变量定义公式,并检查没有 PR 时的情况。
  2. 2运行一个已知期间,确认百分比结果。
  3. 3保存模板供之后使用。

能确认什么: 可以用明确的筛选条件重复计算,并查看每次保存的结果。

常见问题

修改公式会改变旧报告吗?

已完成的运行会保存公式和值的副本。若旧运行缺少副本,请重新运行以获得可导出的结果。

支持哪些导出格式?

JSON、CSV,以及可另存为 PDF 的打印视图。图表导出为数值表格。

为什么计算失败?

检查变量、语法、数据是否存在以及分母。错误或缺失数据不会自动变成零。

使用建议

  • 记录公式含义,定义改变时告知使用者,以便正确比较历史结果。

相关指南