Jira Automation のトリガー

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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

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

一般的なトリガー

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

変更されたフィールド値

このルールはフィールドが変更されるたびに実行されます。システムとカスタムのすべての各フィールドがサポートされています。この優れた機能によって、課題の作成中、編集中、移行中などの変更にごく簡単に対応できます。この条件付きのトリガーをフォローアップして、実行前にフィールドの値を確認するか、そのままアクションを進められます。次の例では、課題の優先度が「高」を超えると SMS を送信します。

最初に、変更を監視するフィールドを選択します。個々のフィールドを選択するのではなく、正規表現によってフィールド名をマッチングできます。必要に応じて、このルールをトリガーする課題操作 (作成、編集、移行、割り当てなど) を絞り込む、またはすべての操作をリッスンするために空白のままにできます。

受信 Webhook

Webhook はサードパーティに自動化ルールをトリガーさせます。また、アクションを実行する特定の課題を指定、さらには課題の更新に使用できるリアルタイム データを Automation for Jira に提供できます。 

Webhook トリガーを設定する際に固有の URL を受け取ります。この URL によって、サードパーティ アプリケーションの発信用 Webhook 設定に追加するか HTTP Post リクエストをカスタム スクリプトから発行できます。また、このトリガーでは、必要に応じて課題キーとその他のデータの提供方法に関する具体的な詳細が提供されます。

{{webhookData}} スマート値によって、ルールの残りの部分で Webhook によって提供されるカスタム データを参照できます。

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

  • Server Lite で利用: 可能
  • 関連するスマート値: {{assignee}}

[担当者] フィールドが変更された際にこのルールが実行されます。

このトリガーには設定がありません。

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

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

  • Server Lite で利用: 可能
  • 関連するスマート値: {{comment}}

新しいコメントが追加された際にこのルールが実行されます。

このトリガーには設定がないため、新しいコメントが追加された際に実行されます (コメントを編集してもルールはトリガーされません)。

トリガーできるアクションは多数あります。たとえば、課題に新しいコメントが追加された際にステータスが「進行中」に変更されるようにルールを設定できます

または、コメントに特定の単語が含まれている場合にルールをトリガーできます (JQL 検索条件が必要)。たとえば、コメントに「完了」という単語が含まれている場合、このルールは課題のステータスを「完了」に変更します。

課題が作成されました

  • Server Lite で利用: 可能
  • 関連するスマート値: {{issue}}

このルールは課題が作成された際に実行されます。いずれかのアクションと併用すると、新しい課題のカスタマイズ、フィールドの入力、ユーザーへの割り当て、サブタスクの追加など、幅広いアクションを自動で行えます。

課題が削除されました

  • Server Lite で利用: 可能
  • 関連するスマート値: {{issue}}

このルールは、課題が削除された際に実行されます。

この機能によって、たとえば課題が削除されたことを通知するメールを送信できます。条件によって、監視している課題のみに絞り込めます。

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

  • Server Lite で利用: 不能
  • 関連するスマート値: {{destinationIssue}}、{{linkType}}

このルールは、課題が別の課題にリンクされた際に実行されます。課題をリンクすることであらゆる状況を効率的に整理できて、重複、関連する課題、課題ブロッカーなどを追跡できます。

トリガーは任意のリンク タイプに基づいて設定できます。たとえば、重複としてリンクされている課題を自動でクローズできます。

削除された課題リンク

  • Server Lite で利用: 不能
  • 関連するスマート値: {{destinationIssue}}、{{linkType}}

このルールは、課題が別の課題からリンクを解除された際 (課題リンクが削除されるなど) に実行されます。

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

課題が異動されました

  • Server Lite で利用: 不能
  • 関連するスマート値: {{issue}}

課題があるプロジェクトから別のプロジェクトに移動した際に、このトリガーは反応します。条件とアクションによって、すべての設定 (値、フィールドなど) が新しいプロジェクト全体に確実にコピーされます。

課題プロパティ更新済み

  • Server Lite で利用: 可能
  • 関連するスマート値: {{issueProperty}}

このトリガーによって、Jira Server の課題のプロパティに加えられた変更に対応します。特定のプロパティまたはすべてのプロパティの変更をリッスンできます。

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

  • Server Lite で利用: 可能

課題をあるステータスから別のステータスに移行する際に、このトリガーが反応します。(選択したステータスに対する) 特定のトランジション、または単にワークフローにある任意のトランジションをリッスンするように設定できます。

課題が更新されました

  • Server Lite で利用: 可能
  • 関連するスマート値: {{issue}}

このトリガーは、次の際にルールを実行します。

  • 課題に関するいずれかの詳細が更新された時 (例外: 課題リンク、担当者、ワークフロー)
  • Jira 8.17 以前: 課題のコメントが削除された時 (追加または更新は対象外)

Jira 8.18 以降は、コメントが削除されてもルールはトリガーされません。これは、Jira のイベントにおける変更点がこのルールに影響を与えたためです。

これは広範なトリガーですが、条件によって絞り込めます。

手動

  • Server Lite で利用: 不能
  • 関連するスマート値: {{issue}}

このトリガーは、Jira の「課題を表示」ページからルールを手動でキックオフする機能を追加します。ルールを手動でトリガーできるグループを調整できます。

これは、一般的なタスクの自動化、ルールのテストやデバッグに役立ちます。

これらの実行方法については、手動トリガーの詳細な説明をご参照ください。

複数の課題イベント

  • Server Lite で利用: 可能
  • 関連するスマート値: {{issue}}

このトリガーでは、このルールを実行するトリガーとなる課題イベントを 1 つ以上選択できます。複数のルールを作成するよりも簡単 (かつ効率的) です。たとえば、課題が更新、移行、割り当てられた際に Slack メッセージを送信します。 

スケジュール済み

  • Server Lite で利用: 可能
  • 関連するスマート値: {{issue}}

これによって、ルールが指定されたスケジュールで実行されます。このルールは所定の頻度で実行できます。また、より複雑なスケジュールには Cron 表記を使用できます。JQL クエリを実行するか、スケジュールに従って課題を作成しようとしている場合は、単にルールを実行できます。

ユース ケースの 1 つは、たとえば古い問題を見つけることです。その方法を示す今週のルールをご覧ください。

Jira Service Management トリガー

次のトリガーは Jira Service Management でのみ利用できます。

サービス上限の超過

  • Server Lite で利用: 可能
  • 関連するスマート値: {{breachedSummary}}、{{breachedRules}}

このトリガーによって、Jira インスタンスで定義されている処理時間の制限に違反しそうな際に通知を受け取るためのルールをセットアップできます。 

SLA しきい値の違反

  • Server Lite で利用: 不能
  • 関連するスマート値: {{issue}}

tip/resting Created with Sketch.

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

SLA トリガーによって、自分で決定したしきい値に違反しそうな (または既に違反している) Jira Service Management SLA に対応できます。これによって、顧客へのタイミングの良いフィードバックを提供、エージェントに警告、リクエストを適切な優先付けられるようになります。Jira に既にセットアップされている SLA が必要です。そこから、監視する SLA を選択して、違反する時間に基づいてトリガーする時間を設定します。 

以下の例では、課題が 1 時間以内に SLA に違反しそうな場合は、チームに Slack で通知し続けるためにこのトリガーを使用しています。

Jira Software トリガー

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

スプリントの作成、開始、完了

  • Server Lite で利用: 不能
  • 関連するスマート値: {{sprint}}

これらのトリガーは、選択したスクラム ボードでスプリントを作成、開始、または完了した際に実行されます。これをボード上のすべてのスプリントに実行するか、正規表現によってスプリントを絞り込めます。

さらに、関連する課題のブランチである「スプリントの課題」によって、スプリントで利用可能なすべての課題をループできます。

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

  • Server Lite で利用: 不能
  • 関連するスマート値: {{version}}

これらは、バージョンを作成、更新またはリリース時にトリガーされます。正規表現によって、このルールをトリガーするバージョンを制限できます。

注: バージョン更新時のトリガーは、バージョンの作成、リリース、変更をリッスンします (このトリガーは、バージョンに関わるすべてのイベントをリッスンする必要がある場合にのみ使用されることをお勧めします)。

バージョン リリース時のトリガーと関連する課題のブランチである「バージョンで修正された課題」によって、このバージョンで修正されたすべての課題をループできます。

作業のログ記録

  • Server Lite で利用: 不能
  • 関連するスマート値: {{worklog}}

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

最終更新日 2022 年 4 月 6 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.