Jira コネクターはJira REST API v3を使用してJiraプロジェクトから課題を同期します。
認証
OAuth — スコープ:
read:jira-workoffline_access
設定
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
| Jiraドメイン | 入力 | はい | 例: yoursite.atlassian.net |
| プロジェクト | セレクター/入力 | はい | プロジェクトキー |
| JQLフィルター | 入力 | いいえ | 課題をフィルターするカスタムJQL |
| 最大課題数 | 入力 | いいえ | 同期課題数の制限 |
動作の仕組み
- クラウドID解決 — ドメインからAtlassianクラウドIDを解決
- JQL構築 —
project = "KEY" ORDER BY updated DESCをオプションのカスタムJQLフィルター付きで構築 - 課題検索 — Jira REST API v3検索エンドポイントを使用
- ADF抽出 — 説明とコメントのAtlassian Document Formatをプレーンテキストに変換
- ページネーション —
startAt/maxResultsオフセットページネーション
文書フォーマット
KEY-123: 課題サマリー
説明テキスト...
コメントテキスト 1...
コメントテキスト 2...メタデータタグ
| タグ | タイプ | 説明 |
|---|---|---|
| 課題タイプ | テキスト | バグ、ストーリー、タスクなど |
| ステータス | テキスト | 現在のワークフローステータス |
| 優先度 | テキスト | 課題の優先度レベル |
| ラベル | テキスト | カンマ区切りラベル |
| 担当者 | テキスト | 割り当てられた人 |
| 最終更新日 | 日付 | 課題の最終更新日 |
JQL検証
カスタムJQLフィルターはセットアップ時に検証されます。無効なJQLは即座にエラーを返します。