メインコンテンツまでスキップ

レポートコンポーネント

4 つのコンポーネントは、単一の課題ではなく課題セット全体を読み取ります。いずれも 通常のデザイナーコンポーネントで——他と同じようにキャンバスへドラッグできます—— それぞれがデータソースの設定を持ちます。

コンポーネントをデータに紐付ける

これらのコンポーネントはすべて同じ問いを立てます。どの課題か?

場所ソース選択が提示するもの
通常のエクスポートテンプレート(課題、ボード、スプリント、リリース、バックログ、JQL)現在のエクスポートセット — エクスポート対象の課題。追加の Jira 検索は行いません。
レポートレポートの名前付きデータソース

両者は入れ替え可能ではありません。名前付きソースはレポートの中でのみ解決されます。 存在しなくなったソースに紐付いたコンポーネントは、欠けているソース名を示す可視の 診断を、すべてのフォーマットで表示します。黙って空を描くことはありません。

意図的に紐付けてください

レポートが複数のソースを持つとき、何も推測されません。誤ったフィルターに紐付いた チャートは、正しく見えて正しくないドキュメントを生みます。これは、はっきり失敗する ものより厄介です。

カテゴリーチャート

課題セットをグループ化可能なフィールドでまとめ、分布をドーナツ横棒チャートとして描きます。

  • カテゴリーは最大 20 件。それを超える分は、コンポーネントの設定に応じて その他にまとめられるか、切り捨てられます。
  • 空の値はなしとして表示されます。
  • ラベルのような複数値フィールドでは、割合は課題数ではなくカテゴリーの割り当て 数で数えます。3 つのラベルを持つ課題は 3 件分を寄与します。
  • 切り捨てと未対応の値には、常に可視の注記が付きます。

KPI カード

ラベル付きの単一の数値です。メトリクスを 1 つ選びます。

メトリクス何を数えるか
課題数ソース内の課題。
完了した課題数ステータスカテゴリーが完了の課題。
完了率ソースに対する完了課題の割合。
数値フィールド数値フィールドの合計または平均

数値の集計は有限の数値のみを受け付けます。空の値や数値でない値は無視され、その 件数が可視の形で示されます。半分しか入力されていないフィールドに基づくカードが、 自らの根拠について黙って誤解を招くことはありません。

任意で、カードは読み取ったデータソース名を表示できます。複数のカードを並べるとき に便利です。

課題テーブル

課題ごとに 1 行、選んだ列で構成します。

  • 列ごとに任意の標準フィールドまたはカスタムフィールドを指定でき、見出しと幅を 任意に設定できます。
  • フィールドによる昇順・降順の並べ替え(任意)。
  • 最大 200 行。 ソースがそれより多い場合、テーブルは先頭の行を表示し、省略した 行数を明記します。
  • 行数の表示(「47 行中 12 行」)とヘッダー行は任意です。

フィールド値は Exportelier の他のテーブルとまったく同じ方法でレンダリング・変換 されるため、カスタムフィールドはどこでも同じ見た目になります。

二次元マトリクス

クロス集計です。行に 1 つのフィールド、列にもう 1 つのフィールドを取り、各セルで 課題を数えます。

  • 両方の軸とも 12 区分が上限です。それを超える値は決定的なその他区分に まとめられます——同じ入力は常に同じテーブルを生みます。
  • 行合計・列合計・総計は任意です。
  • すべてのフォーマットで、画像ではなく実際のアクセシブルなテーブルとして描かれます。

各フォーマットでの表現

Exportelier は 1 つのテンプレートを 4 つのフォーマットへコンパイルします。下表は レンダラーが実際に生成するものを反映しています。フォーマットが「完全」とされるの は、すべての値を保持する場合だけであり、見た目が似ているだけでは足りません。

コンポーネントPDFWord (DOCX)MarkdownExcel (XLSX)
カテゴリーチャートラベルと値を持つベクターチャートPNG フォールバック付きの埋め込み SVG と、続くカテゴリーテーブルカテゴリーテーブル。横棒にはテキストバーも付きます。円とドーナツを画像で偽装しませんCategoryCountPercent 列を持つデータシート
KPI カード完全完全完全共有の Summary シートの 1 行。独自のシートにはなりません
課題テーブル完全完全完全完全 — 課題ごとに 1 行、設定した列ごとに 1 列
マトリクス完全完全完全完全 — 行バケット × 列バケット、設定に応じて合計付き

カテゴリー名と数値は常にテキストとして利用できるため、色が唯一の情報伝達手段に なることはありません。

Markdown 出力は、Jira のデータのうちテーブル構造を壊しうるものをすべてエスケープ します。課題のテキストは課題のテキストのままです。

制限

1 つのレポートに含められるデータ駆動コンポーネントは最大 30 個です。ソース ごと・テーブルごとの上限と合わせて、1 回のエクスポートのコストを限定します—— 制限のリファレンスを参照してください。

関連ページ