課題コメントを追加する
このピースでできることBacklog の接続方法ステップ 1:ホスト名を確認するステップ 2:API キーを発行するステップ 3:workrun に接続を追加するピースの設定項目1. 課題IDまたは課題キー(必須)2. コメント本文(必須)3. お知らせしたいユーザー(任意)
このピースでできること
- Backlog の課題にコメントを1件追加します。
- コメントと同時に、知らせたいメンバーへのお知らせも送れます。
- 外部システムの対応履歴を 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. 課題IDまたは課題キー(必須)
- コメントを追加したい課題のID(数字)または課題キーを入力します。
- 課題キーは Backlog の課題画面に表示されている「プロジェクトキー-番号」の形式です。
[設定例]
2. コメント本文(必須)
- 追加するコメントの本文を入力します。
[設定例]
3. お知らせしたいユーザー(任意)
- コメントの追加を知らせたいユーザーを選びます。複数選択できます。
- 選択肢は、上で入力した課題からプロジェクトを自動判定して読み込まれます。先に「課題IDまたは課題キー」を入力しないと選択肢は表示されません。
[設定例]