この機能でできること
利用可能な変数で数式を作り、グラフ・表・テキストと組み合わせます。プレビューはサンプルデータを使い、実際の実行では選択したチームとフィルターのデータを取得します。
利用する場面
- チームで使っている独自指標を計算するとき。
- 同じ数式と構成でレポートを繰り返し作るとき。
最初の手順
- 1変数、数式、データ型、単位を選びます。
- 2プレビューを確認し、次に内容の分かる期間で実行します。
- 3指標をテンプレートに追加し、保存された結果を確認してから出力します。
設定項目
| 設定項目 | 役割 | 設定のポイント | よくある間違い |
|---|---|---|---|
| 数式と単位 | 計算方法と表示形式を決めます。 | 変数の意味と、分母が 0 になる場合を確認します。 | データ欠損や計算エラーを値 0 と解釈すること。 |
| フィルターと期間 | 実行時に取得するデータを決めます。 | チーム、日付、必要に応じてリポジトリやユーザーを確認します。 | サンプルの計算結果をチームの実績と混同すること。 |
| スケジュールと宛先 | これらの項目をテンプレートに保存します。 | 生成と共有は手動で行います。 | 保存したスケジュールで自動生成やメール送信が始まると考えること。 |
利用例
状況: PR のマージ率を毎回同じ定義でレポートに載せます。
- 1利用可能な変数で数式を作り、PR が 0 件の場合を確認します。
- 2既知の期間で計算し、パーセント表示を確認します。
- 3次回のためにテンプレートを保存します。
分かること: 条件を明示して計算を繰り返し、保存された各結果を参照できます。
よくある質問
数式を変えると過去のレポートも変わりますか？
完了した実行は数式と値のコピーを保持します。古い実行にコピーがない場合は、再実行して出力可能な結果を作ってください。
どの形式で出力できますか？
JSON、CSV、PDF 保存用の印刷画面を使えます。グラフは値の表として出力されます。
計算が失敗する場合は？
変数、構文、データの有無、分母を確認してください。エラーや欠損値は自動的に 0 にはなりません。
使い方のヒント
- 数式の意味を記録し、定義を変更した場合は利用者に知らせてください。