保存フィルターのデータソース
レポートのデータは Jira の保存フィルターから来ます。各フィルターを一度追加し、 名前を付け、その名前にコンポーネントを紐付けます。
このバージョンでは保存フィルターが唯一のデータソースです。自由入力の JQL、REST・ SQL・CSV のソース、サードパーティのコネクターはありません。
ソースを追加する
レポートエディターのデータソースを追加は、Jira があなたに表示している保存 フィルターを一覧します。1 つ選び、ローカルの表示名——「サポートバックログ」「エン ジニアリングのエスカレーション」——を付けます。これがデザイナーのソース選択に表示 される名前です。
数値の保存フィルター ID を直接入力することもできます。Jira に到達できない場合、 選択リストはエディターをブロックせずにその旨を伝えます。
1 つのレポートには最大 8 個のデータソースを保持できます。名前は一意である必要 があります。
Exportelier が保存するのはフィルター ID であって、クエリではありません
これがレポートについて理解すべき最も重要な点です。
保存フィルターを追加すると、Exportelier はその数値 ID とあなたの表示名を保存 します。それだけです。次のものは保存しません。
- フィルターの JQL — 読み取り、コピー、ログ記録、連結のいずれも行いません。
- フィルターの結果 — 課題のスナップショットはどこにも保持されません。
エクスポート時、Exportelier は厳密に数値のみの述語 filter = 12345 を 1 つ組み
立て、いまの答えを Jira に問い合わせます。
ここから 3 つの帰結が生じます。いずれも意図したものです。
- レポートはフィルターに追随します。 Jira で保存フィルターを編集すれば、次の エクスポートに反映されます。Exportelier 側で再同期するものはありません。
- フィルターの Jira 共有ルールが自動的に適用されます。 Exportelier がそれを 迂回する抜け道になることはありません。
- 漏れうる古いコピーが存在しません。 レポートが保持するのは参照であって、 データではありません。
参照がライブであるため、広く共有された保存フィルターを編集すると、それに紐付く すべてのレポート——他の管理者が作ったものも含めて——が変わります。
すべてのエクスポートはあなたとして実行されます
Exportelier はエクスポートを開始した本人として Jira を読み取ります。アプリと してでも、レポートを作った人としてでもありません。
そのため 2 人が同じレポートを同じ日にエクスポートして、正当に異なるドキュメントを 受け取ることがあります。それぞれが、自分の Jira 権限で許可された課題だけを——それ 以上でも以下でもなく——見ます。これはバグではなく正しい挙動です。そうでなければ、 Jira が拒否しているデータを人に見せるアプリになってしまいます。
レポートを作るサイト管理者は自分が見られるフィルターを見ています。それによって 他の人が受け取る範囲が広がることはありません。
2 つのソース、1 つのフィルター、1 回の検索
2 つのデータソースが同じ保存フィルターを指している場合、Jira への問い合わせは 1 回だけで、その結果が両方に渡されます。コンポーネントが実際に必要とする フィールドはレポート全体で収集され、まとめて要求されます。「すべて」を取得したり、 コンポーネントごとに取得したりはしません。
したがって、同じフィル ターを異なる名前で——異なるコンポーネント向けに——2 回追加 しても、コストが二重にかかることはありません。
プリフライト：エクスポートが何を見つけるか
エクスポートの開始前に、Exportelier は各ソースを確認し、次のいずれかを報告します。
| 状態 | 意味 | エクスポートをブロックするか |
|---|---|---|
| 準備完了 | フィルターを読み取り、課題が見つかりました。 | いいえ |
| 空 | 現在このフィルターに一致する課題はありません。 | いいえ——空のレポートも正直な答えです。 |
| 利用不可 | このフィルターはあなたに利用できません。 | はい |
| レート制限中 | Jira がリクエストを制限しています。少し後で再試行してください。 | 一時的に |
| エラー | フィルターを確認できませんでした。 | 一時的に |
プリフライトはソースごとの概算課題数も表示し、ソースあたりの上限で切り詰められる 場合には警告します。
「利用不可」が「削除済み」と言わない理由
Jira は、もう存在しないフィルターに対しても、存在するがあなたと共有されていない
フィルターに対しても 404 を返します。API からは両者を区別できないため、
Exportelier は推測しません。証明できない削除を主張すれば、人を誤った問題の調査へ
向かわせてしまいます。メッセージは両方の可能性を示し、サイト管理者にフィルターの
共有を依頼するよう促します。
利用できないソースはエクスポートを停止します
ソースが欠けたレポートはエクスポートされません。ジョブは失敗し、そのソース名を示 します。これは意図的な選択です。データソースの 1 つが黙って欠けたレポートは実質的 に誤りであり、完全なレポートと見分けがつきません。
ソースに適用される制限
- レポートあたり 8 データソース、異なるフ ィルター検索は最大 8 件。
- ソースあたり 500 課題、レポート全体で 2,000 の一意な課題。
- 同時に走る Jira 検索は 2 件——レポートは対話的な読み取りではなくバックグラ ウンドジョブであり、サイトの Jira レート予算を共有しています。
制限がデータを切り詰めた場合、完成したドキュメントがソースごとにそれを明記します。 制限のリファレンスを参照してください。