新しい課題が追加されたら(トリガー)
このピースでできることBacklog の接続方法ステップ 1:ホスト名を確認するステップ 2:API キーを発行するステップ 3:workrun に接続を追加するピースの設定項目1. プロジェクト(必須)
このピースでできること
- Backlog の指定したプロジェクトに新しい課題が追加されたときに、フローを自動で起動します。
- 課題の起票を検知して、通知や他システムへの登録を自動化できます。
- 課題の「更新」や「コメント」も検知したい場合は、「課題が追加または更新されたら」を使ってください。
Webhook はフローを有効にすると Backlog 側に自動で登録され、フローを無効にすると自動で削除されます。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. プロジェクト(必須)
- 監視するプロジェクトを、一覧から選びます。
- 接続を選ぶと自動で一覧が読み込まれます。接続を設定していない場合は「認証情報を入力してください」と表示されます。
- 複数のプロジェクトを監視したい場合は、プロジェクトごとにフローを作成してください。
[設定例]