レポートコンポーネント
4 つのコンポーネントは、単一の課題ではなく課題セット全体を読み取ります。いずれも 通常のデザイナーコンポーネントで——他と同じようにキャンバスへドラッグできます—— それぞれがデータソースの設定を持ちます。
コンポーネントをデータに紐付ける
これらのコンポーネントはすべて同じ問いを立てます。どの課題か?
| 場所 | ソース選択が提示するもの |
|---|---|
| 通常のエクスポートテンプレート(課題、ボード、スプリント、リリース、バックログ、JQL) | 現在のエクスポートセット — エクスポート対象の課題。追加の Jira 検索は行いません。 |
| レポート | レポートの名前付きデータソース。 |
両者は入れ替え可能ではありません。名前付きソースはレポートの中でのみ解決されます。 存在しなくなったソースに紐付いたコンポーネントは、欠けているソース名を示す可視の 診断を、すべてのフォーマットで表示します。黙って空を描くことはありません。
レポートが複数のソースを持つとき、何も推測されません。誤ったフィルターに紐付いた チャートは、正しく見えて正しくないドキュメントを生みます。これは、はっきり失敗する ものより厄介です。
カテゴリーチャート
課題セットをグループ化可能なフィールドでまとめ、分布を円、ドーナツ、 横棒チャートとして描きます。
- カテゴリーは最大 20 件。それを超える分は、コンポーネントの設定に応じて その他にまとめられるか、切り捨てられます。
- 空の値はなしとして表示されます。
- ラベルのような複数値フィールドでは、割合は課題数ではなくカテゴリーの割り当て 数で数えます。3 つのラベルを持つ課題は 3 件分を寄与します。
- 切り捨てと未対応の値には、常に可視の注記が付きます。
KPI カード
ラベル付きの単一の数値です。メトリクスを 1 つ選びます。
| メ トリクス | 何を数えるか |
|---|---|
| 課題数 | ソース内の課題。 |
| 完了した課題数 | ステータスカテゴリーが完了の課題。 |
| 完了率 | ソースに対する完了課題の割合。 |
| 数値フィールド | 数値フィールドの合計または平均。 |
数値の集計は有限の数値のみを受け付けます。空の値や数値でない値は無視され、その 件数が可視の形で示されます。半分しか入力されていないフィールドに基づくカードが、 自らの根拠について黙って誤解を招くことはありません。
任意で、カードは読み取ったデータソース名を表示できます。複数のカードを並べるとき に便利です。
課題テーブル
課題ごとに 1 行、選んだ列で構成します。
- 列ごとに任意の標準フィールドまたはカスタムフィールドを指定でき、見出しと幅を 任意に設定できます。
- フィールドによる昇順・降順の並べ替え(任意)。
- 最大 200 行。 ソースがそれより多い場合、テーブルは先頭の行を表示し、省略した 行数を明記します。
- 行数の表示(「47 行中 12 行」)とヘッダー行は任意です。
フィールド値は Exportelier の他のテーブルとまったく同じ方法でレンダリング・変換 されるため、カスタムフィール ドはどこでも同じ見た目になります。
二次元マトリクス
クロス集計です。行に 1 つのフィールド、列にもう 1 つのフィールドを取り、各セルで 課題を数えます。
- 両方の軸とも 12 区分が上限です。それを超える値は決定的なその他区分に まとめられます——同じ入力は常に同じテーブルを生みます。
- 行合計・列合計・総計は任意です。
- すべてのフォーマットで、画像ではなく実際のアクセシブルなテーブルとして描かれます。
各フォーマットでの表現
Exportelier は 1 つのテンプレートを 4 つのフォーマットへコンパイルします。下表は レンダラーが実際に生成するものを反映しています。フォーマットが「完全」とされるの は、すべての値を保持する場合だけであり、見た目が似ているだけでは足りません。
| コンポーネント | Word (DOCX) | Markdown | Excel (XLSX) | |
|---|---|---|---|---|
| カテゴリーチャート | ラベルと値を持つベクターチャート | PNG フォールバック付きの埋め込み SVG と、続くカテゴリーテーブル | カテゴリーテーブル 。横棒にはテキストバーも付きます。円とドーナツを画像で偽装しません。 | Category、Count、Percent 列を持つデータシート |
| KPI カード | 完全 | 完全 | 完全 | 共有の Summary シートの 1 行。独自のシートにはなりません |
| 課題テーブル | 完全 | 完全 | 完全 | 完全 — 課題ごとに 1 行、設定した列ごとに 1 列 |
| マトリクス | 完全 | 完全 | 完全 | 完全 — 行バケット × 列バケット、設定に応じて合計付き |
カテゴリー名と数値は常にテキストとして利用できるため、色が唯一の情報伝達手段に なることはありません。
Markdown 出力は、Jira のデータのうちテーブル構造を壊しうるものをすべてエスケープ します。課題のテキストは課題のテキストのままです。
制限
1 つのレポートに含められるデータ駆動コンポーネントは最大 30 個です。ソース ごと・テーブルごとの上限と合わせて、1 回のエクスポートのコストを限定します—— 制限のリファレンスを参照してください。