Excel（XLSX）出力
Excel 出力は PDF と同じテンプレートを、ページではなくシートに射影したものです。受け取る人が読むのではなく、並べ替え・絞り込み・ピボット・集計をし たいときに使います。Free と Standard の両方で利用できます。
ブックに入るのは、テンプレートのうち行の形を持つ部分だけです。それ以外は省略され、Report info シートに列挙されるので、何が除かれたのかを推測する必要はありません。
インストール前に試す
サンプルブックをダウンロード — 1 つのテンプレートから 5 枚のシートが生成されます。Report info、KPI カードの Summary、課題テーブル、カテゴリ件数、そして小計付きの作業ログです。開いて日付列を並べ替えてみてください。それがこの形式のすべてです。
このファイルは実際のエクスポートとまったく同じコードパスで、合成した課題から生成され、ビルドのたびに作り直されます。つまりダウンロードされるものは、モックアップではなく Exportelier が今書き出すものそのものです。
すでにインストール済みですか？ デザイナーのライブプレビューの Excel タブは、テンプレートが生成するシート（名前・列数・行数、および省略されるものとその理由）を一覧表示します。ファイルは生成されず、月間エクスポート枠も消費しません。
セルは文字列ではなく型付き
これがこの形式のすべてです。日付は日付、数値は数値なので、日付列は時系列に並び、数値列は合計できます。
- 日付は Excel の短い日付形式、日時は
yyyy-mm-dd hh:mmを使います。どちらもロケール設定に関係なく曖昧になりません。 - 時間（作業時間、当初見積、残余見積） は小数第 2 位までの小数時間です。単位は
Time Spent (h)のように列見出しに明記します。単位のない7.5が並ぶ列は、サポート問い合わせのもとになるからです。 - カテゴリシートの割合は分数ではなく、0〜100 の通常の数値です。
- 複数値のフィールド（ラベル、コンポーネント、バージョン）は 1 つのテキストセルにまとめられ、リッチテキストは折り返しを有効にしたプレーンテキストになります。
各シートには固定された見出し行とフィルターが付きます。表に合計がある場合は小計として書き出されるため、フィルターを無視せず、絞り込みに追随します。
どのコンポーネントがシートになるか
次のコンポーネントは、 テンプレート内に現れる順に 1 つずつシートになります。
| コンポーネント | シートの内容 |
|---|---|
| 課題テーブル | 課題ごとに 1 行、設定した列ごとに 1 列 |
| マトリクス | 行バケット × 列バケット、設定に応じて合計付き |
| カテゴリチャート | Category、Count、Percent |
| 時系列チャート | バケットの日付と、系列ごとに 1 列 |
| 作業ログテーブル | 作業ログの行。作業時間は小数時間 |
| 変更履歴 | 日時・実行者・フィールド・変更前・変更後 |
| サブタスク、SLA、承認 | 既存の列構成のまま |
| 変更レポートの一覧 | 追加された課題、外れた課題、変化したフィールド |
行の形を持ちながら、独自のシートにならないコンポーネントが 2 つあります。KPI カードはそれぞれ共有の Summary シートの 1 行（Metric、Value、Source、Issues）になり、このシートはテンプレートに KPI カードが 1 つ以上ある場合にだけ現れます。レポート通知 — レポートが自分のデータについて書く完全性の警告 — は Report info シートにそのまま再現されます。「何を除いたか」を伝える警告そのものを落としてしまうことこそ、この通知が防ごうとしている失敗だからです。
リピーターの中でのみ機能するコンポーネント
作業ログ、変更履歴、サブタスク、SLA、承認は単一の課題を記述します。したがって課題集合を繰り返すリピーターの中でのみシートになります。単独では読み取る対象の課題が存在しないため、その理由とともに省略されます。
単独のフィールドも同じです。課題リピーターの中では 1 つの列になり、そのリピーター内のすべてのフィールドが、全課題を対象とする 1 枚の Fields シートにまとまります。リピーターの外では行を持たない単一の値なので、省略されます。
何が省略され、それはなぜか
- レイアウトとページの要素 — 見出し、テキスト、画像、区切り線、改ページ、段組み、コンテナー、署名ブロック。シートにはページがないため、セルとしての表現がありません。
- 行の形を持たない課題コンテンツ — コメント、添付ファイル、リンク、進捗バー。
- コンテキストブロック — スプリント・リリース・バックログの見出しと統計。これらは行ではなく、エクスポートに関する単一の事実を述べるものです。
- 透かし、ヘッダー、フッター 。 透かしはバナー行では代用しません。見出しの上に印を置けば、この形式が存在する理由である数式・フィルター・並べ替えのすべてが壊れるからです。
テンプレートに表形式のものが 1 つもない場合、Exportelier は空のブックを作りません。エクスポートダイアログは選択肢を隠すのではなく、このテンプレートにはシートに入れられる表・グラフ・リストがありません という理由とともに Excel をグレー表示します。
「Report info」シート
常に最初のシートで、常に存在します。列は Section、Item、Detail の 3 つ、セクションは最大 6 つです。
- Export — ブックの生成日時、生成に使ったテンプレート、どのエクスポートコンテキストから来たか。
- Sources — 各データソースの名前と課題数。上限に達した場合は
Source limited to N of M issue(s).。解決できなかったソースも、その理由とともにここに記載されます。 - Not exported — 省略された各コンポーネントと上記の理由。同じ省略が複数回あった場合はその件数も。
- Content — 黙って失われるのではなく短縮されたもの。
Rows omitted by a table limit、Rows omitted by this edition's row limit、Shortened cells（Excel の 32,767 文字上限を超えたセル）、Cells with control characters removed。 - Report notice — レポート自身の完全性の警告を、そのまま。
- Sheets — エクスポートするものが一切なかった場合のみ。
まずこのシートを読んでください。シートが思ったより短いときは、その理由がここに書かれています。
行数の上限
1 つの表が出力する行数は Free で最大 200 行、Standard で 500 行です。この上限は形式ではなくエディションに属し、PDF・Word・Markdown にも同じように適用されます。したがって同じテンプレートを同じ利用者がエクスポートすれば、ブックと PDF は同じ数値を報告します。
500 は単一のデータソースが供給できる最大数でもあるため、Standard ではこの上限が実際に効くことはありません。出会う制限は、表に自分で設定した行数だけです。上限が実際に適用された場合、取り除かれた行数は Report info に記録されます。
Excel を使える場所
複数課題のエクスポートすべて — JQL 検索、ボード、スプリント、リリース、バックログ、特別レポート、保存済みレポート、そして Exportelier Automation のスケジュールエクスポートです。大きなエクスポートは他の形式と同じくバックグラウンドジョブとして実行されます。
次の 3 つでは提供されません。
- 単一課題のエクスポート（Jira Automation アクションを含む）。1 行のブックはスプレッドシートではないため、Exportelier は生成せずに拒否します：Excel export needs a set of issues. Export from a board, sprint, release, backlog, filter or report instead.
- 課題ごとに 1 ファイル（ZIP）。同じ理由が積み重なるだけで、Excel エクスポートは常に 1 つのブックを生成します。
- Word Template Mode。こちらは DOCX 入力・DOCX 出力の専用モードです。
取り込んだダッシュボードは複数シートのブックになる
ダッシュボードの取り込みでは、各ガジェットの保存済みフィルターが名前付きデータソースになり、それに紐づく各コンポーネントが両方の名前を持つ独立したシートになります（Issues — 未解決のエスカレーション、Categories — スプリントの不具合）。Sources セクションは各フィルターを課題数とともに 1 回ずつ挙げるので、シートが課題を並べ、1 行がその出所を示します。
ガジェットのタイトルは見出しとして取り込まれ、見出しにはセルとしての表現がありません。そのため Not exported に件数として現れます。フィルター名はシート名の側が引き継ぎます。
Excel はシート名を 31 文字に制限し、: \ / ? * [ ] を禁止しているため、長いソース名は自動的に短縮され、重複しないようにされます。電子署名は PDF のみが対象で、ブックには署名されません。