レポートビルダー
Exportelier のエクスポートの多くは、いま見ているもの——課題、ボード、スプリント ——から始まります。レポートはその逆です。自分自身のデータを指定する保存済み オブジェクトであり、一度作れば、エクスポートを許可された誰もが最新の数値を得ら れます。
レポートはちょうど 2 つの要素でできています。
- 1 つのテンプレート — 通常のデザイナーテンプレート です。専用の「レポートテンプレート」も、2 つ目のデザイナーもありません。
- 1 つ以上の名前付きデータソース — それぞれが Jira の保存フィルターです。
テンプレート内のコンポーネントは、名前によってソースに紐付けられます。その ため 1 つのレポートで「サポートバックログ」と「エンジニアリングのエスカレーション」 を同じドキュメントに並べて表示できます。
Special Reports の Dashboard タブに表示される保存済みレポート。
Jira ダッシュボードから始める
レポートはゼロから構築できます。フィルターを選び、 レポートコンポーネントを配置し、それぞれを紐付けます。 あるいは、すでにある Jira ダッシュボードから始めることもできます。
**Jira ダッシュボードからインポート**は、ダッシュボードの 構成を読み取り、そこから通常のレポートを構築します。インポートされるのはガジェットが 何を表示する設定になっているかであって、その画像ではありません。またインポート後も 同期はされません。フィルターのデータはライブのままですが、レイアウトと構成が変わるのは 明示的に再インポートしたときだけです。
レポートのある場所
レポートは Export Center の中に専用ページを持ち、エクスポートビューの隣に並びま す。一覧には名前、説明、データソース数、テンプレート、スコープ、最終更新、そして エクスポート可能かどうかが表示されます。
Exportelier を使える人は全員この一覧を見られます。そこで何ができるかは役割に よって決まります。
誰が何をできるか
| 操作 | サイト管理者 | 認証済みの Jira ユーザー |
|---|---|---|
| レポート一覧を見る | ✅ | ✅ |
| 有効なレポートをエクスポートする | ✅ | ✅ |
| レポートの作成・編集・複製・削除 | ✅ | — |
| レポートデザイナーを開く | ✅ | — |
| データソースの追加・変更 | ✅ | — |
管理操作は管理者以外に対して単に非表示になっているのではありません。サーバーが 拒否するため、API を直接呼び出しても通りません。
サイト管理者は自分が見られるどのフィルターからでもレポートを構築できます。 それによって他の誰かにアクセス権が与えられることはありません。エクスポートのたび に、エクスポートした本人として Jira を読み直します——ユーザーごとの結果を参照してください。
レポートを構築する
レポートエディターは、使う順に 4 つの部分から成ります。
- レポートの詳細 — 名前、説明、スコープ、エクスポートを有効にするかどうか。
- データソース — 保存フィルターを追加し、組織内で意味の通る名前を付けます。 保存フィルターのデータソースを参照してください。
- デザイナー — いつもの visual designer です。各データコンポーネントに、 名前付きソースを一覧するソース選択が追加されます。
- プレビューとエクスポー ト — 紐付けを確認してからエクスポートします。
コンポーネントに有効なデータソースがない状態では、レポートを保存できません。 エディターは、最初のソースに黙って紐付けるのではなく、該当するコンポーネントの 名前を示します。
どのコンポーネントも使っていないソースは許容されます——紐付けを準備したい場合が あるためです——が、エディターはそれを明示し、完成したエクスポートも同様です。
同梱テンプレートから始める
Dashboard Report Standard から新しいレポートを作成が最短の入口です。同梱の システムテンプレートを編集可能なテンプレートへコピーし、少なくとも 1 つの保存 フィルターを尋ね、続いて 3 つの標準チャートそれぞれにどのデータソースを供給する かを尋ねます。
フィルターが 1 つだけなら、その答えは自動的に埋まります。複数ある場合は何も推測 しません。すべてのチャートが割り当てられるまでレポートは作成できません。紐付けを 誤ったチャートは、正しく見えて正しくないレポートを生むからです。
同梱のシステムテンプレート自体が変更されることはありません。
レポートをエクスポートする
レポートのエクスポートは常にバックグラウンドで実行されます。複数のフィルター を読み、ドキュメントをレンダリングする処理は、対話的なリクエストには収まらないた めです。
ジョブの開始前に、プリフライトが各データソースを確認し、結果を示します—— 準備完了、空、または利用不可を、課題数の見積もりと、ソースごとの上限に達する場合 の警告とともに表示します。その後、PDF、Word (DOCX)、Markdown のいず れかを選んでエクスポートを開始します。
実行中は正直なフェーズ——計画、Jira フィルターの読み取り、レンダリング、ダウン ロードの準備——が表示され、いつでもキャンセルできます。レポートのエクスポートは 通常のエクスポートと並んで実行中のエクスポートに表示され、それぞれレポート名 のラベルが付きます。最近のレポートエクスポートの一覧から、ダイアログを閉じた あとでもジョブを開き直せます。
完成したドキュメントは、実際に含んでいた内容を報告します。各ソースが提供した課題 数、上限で切り詰められた箇所、そしてレポートが定義しているのにどのコンポーネント も使っていないソースです。
レポートの保存フィルターのいずれかがあなたに利用できない場合、エクスポートは失敗 し、そのソース名を示します。黙って小さなレポートをレンダリングすることはありませ ん——データソースが欠けたドキュメントは、完全なものとまったく同じに見えるからです。
制限
レポートには固有の上限があります。レポートあたりのソース数、ソースあたりの課題数、 テーブルあたりの行数などです。いずれもサーバー側で強制され、実際に何かを切り詰め たときには出力に明記されます。制限のリファレンス を参照してください。