新しい課題(トリガー)
このピースでできることJira Cloud の接続方法ステップ 1:Atlassian API トークンを作成するステップ 2:workrun に接続を追加するピースの設定項目1. JQL(任意)2. JQL サニタイズ(任意)取得できる情報出力例(抜粋)
このピースでできること
- Jira Cloudで新しい課題(Issue)が作成されたことを検知して、ワークフローを起動します。
Jira Cloud の接続方法
workrun と Jira Cloud を接続するには、Instance URL、メールアドレス、API トークン の 3 つが必要です。
ステップ 1:Atlassian API トークンを作成する
- Atlassian アカウント設定 にアクセスします。
- 「Create API token」 をクリックします。
- トークン名を入力し(例:)、「Create」 をクリックします。
- 表示されたトークンをコピーします。
⚠️ トークンはこの画面でしか表示されません。必ずコピーして保管してください。
ステップ 2:workrun に接続を追加する
- workrun で Jira Cloud のアクション/トリガーをフローに追加します。
- 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
- 以下をそれぞれ入力します:
- Instance URL: の形式で入力
- Email: Jira のログイン用メールアドレス
- API Token: ステップ 1 でコピーしたトークン
- 「保存」 をクリックして接続を完了します。
ピースの設定項目
1. JQL(任意)
- 監視対象の課題を絞り込みたい場合に、JQLを指定します。
- 未指定の場合は、作成された課題を広く検知します。
2. JQL サニタイズ(任意)
- JQLをサニタイズするかどうかを指定します。
取得できる情報
検知したJira Cloudの課題を1件ずつ出力します。JQLに一致し、接続ユーザーが参照できる課題が対象です。
| 実際のキー | 内容・条件 |
|---|---|
| 課題ID・課題キー。APIの応答に含まれる場合に利用できます。 | |
| 課題の作成日時。新規課題の判定にも使用します。 | |
| 課題の件名・状態。取得できる場合に利用できます。 | |
| プロジェクト・課題タイプの情報。取得できる場合に利用できます。 | |
| その他の参照可能なフィールド。カスタムフィールドなどは接続先によって異なります。 |
- 利用例: を通知へ表示し、 を課題の取得・更新に使えます。
- 課題フィールドはJira側の権限・設定によって異なります。取得されるフィールドは参照可能なものが対象で、サンプルが空でも実行時の出力が空とは限りません。実際の項目はテストトリガーで確認してください。
出力例(抜粋)
以下は形を示す架空の例です。