プロジェクトの課題一覧を取得する
このピースでできることBacklog の接続方法ステップ 1：ホスト名を確認するステップ 2：API キーを発行するステップ 3：workrun に接続を追加するピースの設定項目1. プロジェクト（必須）2. 状態（任意）3. 担当者（任意）4. 種別（任意）5. カテゴリー（任意）6. 発生バージョン（任意）7. マイルストーン（任意）8. 優先度（任意）9. 完了理由（任意）10. 登録者（任意）11. 親子課題の条件（任意）12. 添付ファイルあり（任意）13. 共有ファイルあり（任意）14. 検索キーワード（任意）15. 登録日（以降）（任意）16. 登録日（以前）（任意）17. 更新日（以降）（任意）18. 更新日（以前）（任意）19. 期限日（以降）（任意）20. 期限日（以前）（任意）21. 開始日（以降）（任意）22. 開始日（以前）（任意）23. 取得件数（任意）24. 取得開始位置（任意）25. 並び順の属性（任意）26. 並び順（任意）
このピースでできること
- Backlog の指定したプロジェクトから課題の一覧を取得します。
- 状態・担当者・種別・期限日など、多くの条件で絞り込めます。
- 未対応の課題や期限切れの課題を定期的に取得して、リマインドや一覧化を自動化できます。
Backlog の接続方法
workrun と Backlog を接続するには、Backlog の ホスト名 と API キー が必要です。
ステップ 1：ホスト名を確認する
- Backlog にログインし、ブラウザのアドレスバーを確認します。
- と の間の部分がホスト名です。
- 例: アドレスが の場合、ホスト名は です
- Backlog のドメインには と の2種類があります。自社のスペースのURLに合わせてください
ステップ 2：API キーを発行する
- Backlog の画面右上のプロフィールアイコンから 「個人設定」 を開きます。
- 左メニューの 「API」 を開きます。
- 登録メモに任意の名前を入力し、「登録」 をクリックして API キーを発行します。
- 発行された API キーをコピーしておきます。
API キーは発行したユーザーの権限で動作します。連携したいプロジェクトにアクセスできるユーザーで発行してください。
ステップ 3：workrun に接続を追加する
- workrun で Backlog のアクション／トリガーをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 「ホスト名」 フィールドに、ステップ 1 で確認したホスト名を入力します（ は不要です）。
- 「APIキー」 フィールドに、ステップ 2 でコピーした API キーを貼り付けます。
- 「保存」 をクリックして接続を完了します。
Backlog のトリガー（「新しい課題が追加されたら」「課題が追加または更新されたら」）を使う場合、Webhook はフローを有効にすると Backlog 側に自動で登録されます。Backlog の管理画面で手動設定する必要はありません。
ピースの設定項目
1. プロジェクト（必須）
- 課題を取得するプロジェクトを、一覧から選びます。
- ここで選んだプロジェクトに応じて、以降の絞り込み項目の選択肢が切り替わります。
[設定例]
2. 状態（任意）
- 特定の状態の課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
3. 担当者（任意）
- 特定の担当者の課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
4. 種別（任意）
- 特定の種別（タスク・バグなど）の課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
5. カテゴリー（任意）
- 特定のカテゴリーがついた課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
6. 発生バージョン（任意）
- 特定の発生バージョンの課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
7. マイルストーン（任意）
- 特定のマイルストーンの課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
8. 優先度（任意）
- 特定の優先度の課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
9. 完了理由（任意）
- 特定の完了理由の課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
10. 登録者（任意）
- 特定のユーザーが登録した課題だけを取得したい場合に選びます。複数選択できます。
[設定例]
11. 親子課題の条件（任意）
- 親課題・子課題のどちらを取得するかを選びます。
- すべて
- 子課題以外
- 子課題
- 親課題でも子課題でもない課題
- 親課題
[設定例]
12. 添付ファイルあり（任意）
- オンにすると、添付ファイルがある課題だけを取得します。初期値はオフです。
[設定例]
13. 共有ファイルあり（任意）
- オンにすると、共有ファイルがある課題だけを取得します。初期値はオフです。
[設定例]
14. 検索キーワード（任意）
- 課題をキーワードで検索します。
[設定例]
15. 登録日（以降）（任意）
- この日付以降に登録された課題に絞り込みます。
[設定例]
16. 登録日（以前）（任意）
- この日付までに登録された課題に絞り込みます。
[設定例]
17. 更新日（以降）（任意）
- この日付以降に更新された課題に絞り込みます。
[設定例]
18. 更新日（以前）（任意）
- この日付までに更新された課題に絞り込みます。
[設定例]
19. 期限日（以降）（任意）
- この日付以降が期限の課題に絞り込みます。
[設定例]
20. 期限日（以前）（任意）
- この日付までが期限の課題に絞り込みます。期限切れの抽出に使えます。
[設定例]
21. 開始日（以降）（任意）
- この日付以降が開始日の課題に絞り込みます。
[設定例]
22. 開始日（以前）（任意）
- この日付までが開始日の課題に絞り込みます。
[設定例]
23. 取得件数（任意）
- 一度に取得する件数の上限を数字で入力します（1〜100、未入力の場合は20件）。
[設定例]
24. 取得開始位置（任意）
- 何件目から取得するかを数字で入力します（未入力の場合は0）。
- 21件目以降を取得したいときに、取得件数と組み合わせて使います。
[設定例]
25. 並び順の属性（任意）
- 並び替えに使う項目を選びます（課題種別 / カテゴリー / バージョン / マイルストーン / 件名 / 状態 / 優先度 / 添付ファイル / 共有ファイル / 作成日 / 作成者 / 更新日 / 更新者 / 担当者 / 開始日 / 期限日 / 予定時間 / 実績時間 / 子課題）。
[設定例]
26. 並び順（任意）
- 「昇順」または「降順」を選びます（未入力の場合は降順）。
[設定例]