新しい課題(トリガー)

このピースでできること

  • Jira Cloudで新しい課題(Issue)が作成されたことを検知して、ワークフローを起動します。
 

Jira Cloud の接続方法

workrun と Jira Cloud を接続するには、Instance URL、メールアドレス、API トークン の 3 つが必要です。

ステップ 1:Atlassian API トークンを作成する

  1. Atlassian アカウント設定 にアクセスします。
  1. 「Create API token」 をクリックします。
  1. トークン名を入力し(例:)、「Create」 をクリックします。
  1. 表示されたトークンをコピーします。
⚠️ トークンはこの画面でしか表示されません。必ずコピーして保管してください。

ステップ 2:workrun に接続を追加する

  1. workrun で Jira Cloud のアクション/トリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 以下をそれぞれ入力します:
      • Instance URL: の形式で入力
      • Email: Jira のログイン用メールアドレス
      • API Token: ステップ 1 でコピーしたトークン
  1. 「保存」 をクリックして接続を完了します。
 

ピースの設定項目

1. JQL(任意)

  • 監視対象の課題を絞り込みたい場合に、JQLを指定します。
  • 未指定の場合は、作成された課題を広く検知します。

2. JQL サニタイズ(任意)

  • JQLをサニタイズするかどうかを指定します。

取得できる情報

検知したJira Cloudの課題を1件ずつ出力します。JQLに一致し、接続ユーザーが参照できる課題が対象です。
実際のキー内容・条件
課題ID・課題キー。APIの応答に含まれる場合に利用できます。
課題の作成日時。新規課題の判定にも使用します。
課題の件名・状態。取得できる場合に利用できます。
プロジェクト・課題タイプの情報。取得できる場合に利用できます。
その他の参照可能なフィールド。カスタムフィールドなどは接続先によって異なります。
  • 利用例: を通知へ表示し、 を課題の取得・更新に使えます。
  • 課題フィールドはJira側の権限・設定によって異なります。取得されるフィールドは参照可能なものが対象で、サンプルが空でも実行時の出力が空とは限りません。実際の項目はテストトリガーで確認してください。

出力例(抜粋)

以下は形を示す架空の例です。