Jira Automation のトリガー

すべてのルールはトリガーで開始されます。トリガーによってルールの実行が開始されます。トリガーは、課題の作成やフィールド値の変更時など、Jira のイベントを検知します。

トリガーはスケジュールに沿って実行されるように設定でき、ルールに適用される前にカスタマイズできます。

Jira Automation テンプレート ライブラリでこれらすべてのトリガーを使用する方法をご確認ください。

一般的なトリガー

これらのトリガーは、すべての Jira Cloud 製品で使用できます。

変更されたフィールド値

  • 関連するスマート バリュー: {{fieldChange}}

このルールはフィールド値が変更されたときに実行されます。システムとカスタム フィールドはすべてこのトリガーにサポートされます。

このトリガーを条件と併用して、アクションを実行する前にフィールド値を確認できます。たとえば、課題の優先度が "高" より高くなったときに SMS を送信します。

このルールを設定する際は、変更を監視するフィールドを選択したり、正規表現によってフィールド名をマッチングしたりできます。変更タイプ (追加された値、削除された値、フィールド値への変更) を指定して、監視するフィールドを絞り込めます。また、このルールをトリガーする課題操作 (課題を作成、編集、トランジション、割り当てなど) を絞り込んだり、すべての操作をリッスンするために空白のままにしたりできます。

フォームの送信時

ルールは、課題に添付したフォームが送信された際に実行されます。トリガー設定時は任意の数のフォームを選択できますが、これによってトリガーの動作が次のようになります。

  • フォーム未選択: いずれかのフォームが送信された際にルールが実行されます。

  • フォームが 1 つ選択されている: そのフォームが送信された際にルールが実行されます。

  • フォームが複数選択されている: 課題で選択したすべてのフォームが送信された際にのみルールが実行されます。

フォームの状態に関する詳細をご確認ください

受信 Webhook

  • 関連するスマート バリュー: {{webhookData}}

Webhook の特定の URL に HTTP POST が送信された際に、このルールが実行されます。

Webhook は第三者が自動化ルールをトリガーする方法であり、対応する課題を指定します。課題の更新に使用可能なリアルタイム データも提供できます。

このトリガーの設定時に、サードパーティ アプリの発信用 Webhook 設定に追加するか、カスタム スクリプトから HTTP POST リクエストを発行できる固有の URL を受け取ります。また、このトリガーでは、課題キーとその他のデータの提供方法に関する詳細が提供されます。

{{webhookData}} スマート バリューを使用して、Webhook が提供するカスタム データをルールで参照できます。

課題が割り当てられました

  • 関連するスマート バリュー: {{assignee}}

このルールは課題の担当者が変更されたときに実行されます。たとえば、課題が特定のユーザーに割り当てられた際に、課題のステータスを「進行中」に変更して、その課題が調査中であることを報告者に知らせるメールを送信します。

課題にコメントが付けられました

  • 関連するスマート バリュー: {{comment}}

このルールは、新しいコメントが追加されたときに実行されます。たとえば、新しいコメントが課題に追加されると、ステータスは「進行中」に変更されます。

コメントを編集してもこのルールはトリガーされません。

課題のコメントが編集されました

  • 関連するスマート値: {comment}

このルールはコメントが編集されたときに実行されます。[コメントの編集] アクションと併用できます。

課題が作成されました

  • 関連するスマート バリュー: {{issue}}

このルールは、課題が作成されたときに実行されます。

このトリガーは、新しい課題をカスタマイズするアクション (フィールドの自動入力、ユーザーの割り当て、サブタスクの追加など) と併用できます。

課題が削除されました

  • 関連するスマート バリュー: {{issue}}

このルールは、課題が削除されたときに実行されます。たとえば、課題が削除されたことを通知するメールを送信します。

条件を使用して、監視している課題に絞り込むことができます。

課題にリンクが付けられた

  • 関連するスマート バリュー: {{destinationIssue}}{{linkType}}

このルールは、課題が別の課題にリンクされたときに実行されます。

このトリガーはどのリンク タイプがベースでも構成できます。

  • 関連するスマート バリュー: {{destinationIssue}}{{linkType}}

このルールは、ある課題と別の課題へのリンクが解除されたときに実行されます。

このトリガーは、指定のリンク タイプのみまたはすべての課題リンクを対象に実行するように設定できます。

課題が移動されました

  • 関連するスマート バリュー: {{issue}}

このルールは課題があるプロジェクトから別のプロジェクトに移動したときに実行されます。

このトリガーは、すべての値、フィールド、設定が新しいプロジェクトに確実にコピーするための条件およびアクションと併用できます。

課題がトランジションされた

  • 関連するスマート バリュー: {{issue}}{{changelog}}

このルールは課題があるステータスから別のステータスに切り替わったときに実行されます。

このトリガーは、選択したステータス、あるいは単純にワークフローのトランジションすべてをリッスンするように構成できます。

自動化を使った課題のトランジションの詳細をご覧ください

更新された課題

  • 関連するスマート バリュー: {{issue}}

このルールは課題の詳細が更新されたときに実行されます。

このトリガーの例外には [課題をリンク]、[課題を割り当て]、[作業を記録] の各アクションによる変更が含まれます。

手動

  • 関連するスマート バリュー: {{issue}}

このルールは、ユーザーによって手動でトリガーされたときに実行されます。

ルールを手動でトリガーできるグループは調整できます。このトリガーは、一般的なタスクの自動化、ルールのテストやデバッグに役立ちます。

ルールの手動実行の詳細をご覧ください

複数の課題イベント

  • 関連するスマート バリュー: {{issue}}

このルールは、選択した課題イベントが 1 つ以上発生したときに実行されます。たとえば、課題が更新、トランジション、割り当てられたときに、Slack メッセージが送信されます。

このトリガーの使用は、複数のさまざまなルールを作成するよりも簡単で効率的な場合があります。

スケジュール済み

  • 関連するスマート バリュー: {{issue}}

このルールは指定したスケジュールで実行されます。このルールは所定の頻度で実行できますが (例: 7 日ごと)、cron 表現を使用してより複雑なスケジュールを指定できます。

JQL クエリを入力することを選択することもできます。この場合、このルールのアクションはクエリに含まれる課題に対して実行されます。

スケジュールされたルールは、連続して 10 回の実行で [失敗] ステータスに達すると自動で無効になります。

SLA しきい値の違反

  • 関連するスマート バリュー: {{issue}}

このトリガーは Jira Service Management プロジェクトでのみ使用できます。

このルールは、Jira Service Management の SLA 違反が発生した場合や発生する可能性がある場合に実行されます。

このトリガーを使用すると、カスタマーへのタイミングの良いフィードバックの提供、エージェントへの警告、リクエストの適切な優先付けの自動化が可能になります。監視する SLA と、違反したときにトリガーするタイミング (違反の前後) を選択できます。

作業のログ記録

  • 関連するスマート バリュー: {{worklog}}

このルールは、作業ログが作成、更新および/または削除されたときに実行されます。

 

Jira Software トリガー

次のトリガーは、Jira Software でのみ使用できます。

作成済み、開始済み、または完了済みのスプリント

  • 関連するスマート バリュー: {{sprint}}

このルールは、選択したスクラム ボードでスプリントを作成、開始、完了したときに実行されます。

このトリガーでは、ボードのスプリントをすべて、または正規表現を使用してスプリントを絞り込んで実行できます。

このトリガーを関連課題ブランチの [バージョンで修復済みの課題] と併用して、このバージョンで修復されたすべての課題をループできます。

バージョンの作成、更新、リリース

  • 関連するスマート バリュー: {{version}}

このルールはバージョンの作成、更新、リリース時に実行されます。

正規表現を使用して、このルールをトリガーするバージョンを制限できます。

[バージョンを更新] トリガーはバージョンの作成やリリース、および変更をリッスンします。このトリガーは、バージョンがかかわるすべてのイベントをリッスンする必要がある場合に使用してください。

[リリース済みバージョン] トリガーを関連課題ブランチの [バージョンで修復済みの課題] と併用して、このバージョンで修正されたすべての課題をループできます。

DevOps トリガー

これらのトリガーは、ソース コード管理ツールと統合された Jira Software Cloud でのみ使用できます。これらのトリガーでは、次のツールを使用できます。

  • Bitbucket Cloud 

  • GitLab 

  • GitHub 

  • BigBrassBrand 

次のツールはこれらのトリガーとは併用できませんが Jira Software Cloud と統合できるため、ソフトウェア プロジェクトの他の部分に統合するメリットがまだあります。

  • Bitbucket Server 

  • GitLab オンプレミス 

  • GitHub Enterprise 

作成されたブランチ

条件を使用して、このトリガーで監視するブランチを絞り込めます。このルールは、ブランチが作成された際に実行されます。たとえば、課題キーを含むブランチが作成された際に、その課題を「進行中」にトランジションします。

build failed

ビルドが失敗するとルールが実行されます。このルールを、特定のビルド名や、特定のブランチまたはタグに関連付けられたビルドに対してのみトリガーするように設定できます。

ビルド ステータスの変更

ビルドのステータスが変更されるとルールが実行されます。このルールを、特定のビルド名や、特定のブランチまたはタグに関連付けられたビルドに対してのみトリガーするように設定できます。

ビルドの成功

ビルドが成功するとルールが実行されます。このルールを、特定のビルド名や、特定のブランチまたはタグに関連付けられたビルドに対してのみトリガーするように設定できます。

作成されたコミット

条件を使用して、このトリガーで監視するコミットを絞り込めます。このルールは、コミットが作成された際に実行されます。

デプロイの失敗

デプロイメントが失敗するとルールが実行されます。

デプロイメント ステータスの変更

デプロイメントのステータスが変更されるとルールが実行されます。

デプロイの成功

デプロイメントが成功するとルールが実行されます。

プルリクエスト作成

条件を使用して、このトリガーで監視するプル リクエストを絞り込めます。このルールは、プル リクエストが作成された際に実行されます。たとえば、課題キーを含むプル リクエストが作成された際に、その課題を「レビュー中」にトランジションします。

pull request declined

条件を使用して、このトリガーで監視するプル リクエストを絞り込めます。ルールは、プル リクエストが却下された際に実行されます。

プルリクエストのマージ

条件を使用して、このトリガーで監視するプル リクエストを絞り込めます。ルールは、プル リクエストがマージされた際に実行されます。

Jira Service Management トリガー

オブジェクト トリガー

Jira Service Management 専用。特定の Insight スキーマのオブジェクトが作成、更新、または削除されると、ルールが実行されます。グローバルな自動化ルールに対してのみ使用できます。

Jira Service Management の Insight についてはこちらを参照してください。

サービス上限の超過

  • 関連するスマート バリュー: {{breachedSummary}}、{{breachedRules}}

このルールは、サービス上限に達したか、上限を超えそうな場合に実行されます。

このトリガーを使用して、サービス制限を監視して上限に近づいたときに通知できます。

承認が必要

Jira Service Management の場合のみ。承認が必要な課題が作成または更新された、または新しい承認者が課題に追加された際に、ルールは実行されます。Jira Service Management の承認に関する詳細についてご確認ください。 

承認完了

Jira Service Management 専用。課題の承認ステップで承認/却下されると、ルールが実行されます。Jira Service Management の承認に関する詳細についてご確認ください。 

 

その他のヘルプ