Jira Automation のトリガー

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

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

一般的なトリガー

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

変更されたフィールド値

• Related smart values: {{fieldChange}}

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

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

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

フォームの送信時

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

• If no forms are selected: the rule will run when any form is submitted.

• If one form is selected: the rule will run when that form is submitted.

• If multiple forms are selected: the rule will only run when all of the selected forms on an issue are submitted.

フォームのステータスに関する詳細をご確認ください。

受信 Webhook

• Related smart values: {{webhookData}}

このルールは、Webhook の特定の URL に HTTP POST リクエストが送信されたときに実行されます。

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

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

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

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

• Related smart values: {{assignee}}

The rule will run when the Assignee of an issue is changed. For example, when an issue is assigned to a specific user, change the issue’s status to In progress and send an email to the reporter to let them know it’s being investigated.

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

• Related smart values: {{comment}}

The rule will run when a new comment is added. For example, change the status to In progress when a new comment is added on an issue.

コメントの種類を選ぶと、コメントが単独で追加されたのか、それともトランジションの一部として追加されたのかを区別できます。たとえば、ここではクローズされた課題にコメントが追加されると再オープンしたり、コメントが追加されると課題のステータスがトランジションしたりするように自動化ルールを設定したいと仮定しましょう。この場合、利用できるコメントの種類は次のとおりです。

• すべてのコメント (初期設定): 課題に追加されるすべてのコメント

• コメントが主なアクション: 新しいコメントはコメント セクション内でメッセージとして追加されます。

• ステータスのトランジション中に追加されたコメント: 課題のステータスを変更すると、コメントが追加されます。

• 課題フィールドの編集中に追加されたコメント: 1 つ以上の課題フィールドの編集中にコメントが追加されます。

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

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

• Related smart values: {{comment}}

This rule will run when a comment is edited. Can be used with the Edit comment action.

課題が作成されました

• Related smart values: {{issue}}

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

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

課題が削除されました

• Related smart values: {{issue}}

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

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

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

• Related smart values: {{destinationIssue}}, {{linkType}}

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

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

削除された課題リンク

• Related smart values: {{destinationIssue}}, {{linkType}}

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

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

課題が移動されました

• Related smart values: {{issue}}

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

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

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

• Related smart values: {{issue}}, {{changelog}}

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

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

自動化を使った課題のトランジションに関する詳細をご確認ください。

更新された課題

• Related smart values: {{issue}}

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

Exceptions on this trigger include changes made by the Link issue, Assign issue and Log work actions.

To trigger a rule when an issue’s status is updated, please use the Issue transitioned trigger instead.

課題から手動でトリガーする

• Related smart values: {{issue}}

The rule will run when it is manually triggered by a user. This trigger is useful for automating common tasks, or testing or debugging a rule. Learn more about using the Manual trigger to test rules

You can refine which users can manually trigger a rule by selecting a permissions group in the Groups that can run trigger dropdown. Learn more about permission groups

You can also request input before a rule is run by selecting Get input from users. This allows you to set up some fields that will display to users when they trigger the rule. You can choose to make each field mandatory by selecting Required field. If a user chooses not to enter any information and selects Cancel, this won’t count as an execution towards your monthly limits.

Once a rule is created with a Manual trigger, anyone with access will be able to trigger it by going to an issue and selecting Actions.

複数の課題イベント

• Related smart values: {{issue}}

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

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

作成されたプロジェクト

• 関連するスマート値: 自動化スマート値 - プロジェクト

ルールは、プロジェクトが作成されたときに実行されます。たとえば、これはすべての Jira プロジェクトに含める必要がある既定の課題セットを作成する場合に便利です。

スケジュール済み

• Related smart values: {{issue}}

This rule runs on a specified schedule. You can run the rule at a fixed rate (for example, every 7 days), or use a Cron expression for more complex schedules.

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

Scheduled rules that reach a Failure status for 10 consecutive executions will disable automatically.

作業のログ記録

• Related smart values: {{worklog}}

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

ソフトウェア トリガー

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

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

• Related smart values: {{sprint}}

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

This trigger will either run for every sprint on that board, or you can narrow this down using a regular expression.

You can use this trigger together with the related issues branch Issue fixed in version to loop through all issues fixed in this version.

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

• Related smart values: {{version}}

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

You can restrict which versions will trigger this rule using a regular expression.

The Version updated trigger listens for versions being created and released, as well as being amended. Use this trigger if you need to listen for all events around a version.

You can use the Version released trigger together with the related issues branch Issue fixed in version to loop through all issues fixed in this version.

DevOps トリガー

These triggers are only available for Jira Cloud when integrated with a source code management tool. Check out the list of compatible tools

セルフホスト型ツールまたはオンプレミス型ツール (例: Bitbucket Server、GitLab オンプレミス、GitHub Enterprise) はサポート対象外です。ただし、これらのツールも Jira Cloud と統合可能であり、ソフトウェア プロジェクトの他の部分において、統合によるメリットを得られます。

作成されたブランチ

• Related smart values: {{branch}}

• Connect your source code management tool to use this trigger. Learn how to integrate your development tools with Jira Cloud.

You can use conditions to refine the branches you are monitoring with this trigger. The rule will run when a branch is created. For example, when a branch is created that includes an issue key, transition that issue to In progress.

build failed

• Related smart values: Smart values - development

• Connect your source code management tool to use this trigger. Visit the marketplace to integrate your build tool with Jira Cloud.

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

ビルド ステータスの変更

• Related smart values: Smart values - development

• Connect your source code management tool to use this trigger. Visit the marketplace to integrate your build tool with Jira Cloud.

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

ビルドの成功

• Related smart values: Smart values - development

• Connect your source code management tool to use this trigger. Visit the marketplace to integrate your build tool with Jira Cloud.

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

作成されたコミット

• Related smart values: {{commit}}

• Connect your source code management tool to use this trigger. Learn how to integrate your development tools with Jira Cloud.

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

Compass で作成されたコンポーネント

• Related smart values: {{component}}

  • 開発スマート値の詳細についてはこちらをご確認ください。

The Component created in Compass trigger will cause your rule to run when a component is created in Compass.

You must already have access to a Compass site in order to use this trigger. Discover Compass

You’ll be prompted to set up a connection to Compass the first time you use this component. Read more about connections

Compass でのスコアカード ステータスの変更

• Related smart values: {{scorecard}} {{component}}

The Scorecard status change in Compass trigger will cause your rule to run when a scorecard changes status in Compass.

You must already have access to a Compass site in order to use this trigger. Discover Compass

You’ll be prompted to set up a connection to Compass the first time you use this component. Read more about connections

デプロイの失敗

• Related smart values: Smart values - development

• Connect your source code management tool to use this trigger. Visit the marketplace to integrate your deployment tool with Jira Cloud.

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

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

• Related smart values: Smart values - development

• Connect your source code management tool to use this trigger. Visit the marketplace to integrate your deployment tool with Jira Cloud.

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

デプロイの成功

• Related smart values: Smart values - development

• Connect your source code management tool to use this trigger. Visit the marketplace to integrate your deployment tool with Jira Cloud.

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

プルリクエスト作成

• Related smart values: {{pullRequest}}

• Connect your source code management tool to use this trigger. Learn how to integrate your development tools with Jira Cloud.

The rule executes when a pull request is created. You can use conditions to refine the pull requests you are monitoring with this trigger. For example, when a pull request is created that includes an issue key, transition that issue to In review.

pull request declined

• Related smart values: {{pullRequest}}

• Connect your source code management tool to use this trigger. Learn how to integrate your development tools with Jira Cloud.

プル リクエストが拒否されるとルールを実行します。条件を使用して、このトリガーで監視するプル リクエストを絞り込むことができます。

プルリクエストのマージ

• Related smart values: {{pullRequest}}

• Connect your source code management tool to use this trigger. Learn how to integrate your development tools with Jira Cloud.

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

セキュリティ トリガー

脆弱性の検出

• Related smart values: {{vulnerability}}

• Connect a security tool to your project to use this trigger. Learn more about integrating security tools

接続済みのセキュリティ コンテナーの 1 つにある脆弱性がセキュリティ ツールによって検出され、Jira に送信されると、ルールが実行されます。

選択した重大度に一致する脆弱性のみがルールを有効化します。トリガーでは 1 つ以上の重大度を選択できます。

Jira Service Management トリガー

アラートが作成されました。

• Related smart values: {{alert}}

アラートが作成されたときにルールが実行されます。このトリガーを使用して、アラートが作成されたときに Jira Service Management でアクションを実行できます。

たとえば、アラートが作成されたときに Jira Service Management でインシデントを作成したり、アラートを進行中のインシデントに関連付けたりします。

アラートからの手動トリガー

• Related smart values: {{alert}}

アラートのアクションからユーザーが手動でトリガーしたときにルールが実行されます。たとえば、ユーザーが手動でルールをトリガーしたときに、アラートの説明に特定のキーワードが含まれている場合は、SSM ドキュメントを実行します。

Users that can rule this rule: By default, your rule can be run by all logged-in users, but you can allow only specific users and members of a team to run your rule.

Filter alerts to show this rule: You can make your rule available to be run only for certain alerts by choosing alert fields to filter by.

Optionally, you can select Prompt for input when the rule is triggered if you want the user, who triggers the rule from an alert, to input any information before the rule is run.

アラートの更新

• Related smart values: {{alert}}

アラートの優先度、要約、または説明が更新されたときにルールが実行されます。たとえば、アラートの優先度が P1 に変更されたときに、サービス プロジェクトで P3 の優先度のインシデントを作成します。

アラート ステータスの変更

• Related smart values: {{alert.status}}

アラートのステータスが変化したときにルールが実行されます。たとえば、アラートのステータスが「オープン」に変化したときに、Slack チャンネルにメッセージを送信します。

アラート メモが追加

• Related smart values: {{alert.note}}

新しいメモがアラートに追加されたときにルールが実行されます。たとえば、アラートにメモが追加されたときにメールを送信します。

オブジェクト トリガー

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

Jira Service Management のアセットに関する詳細をご確認ください。

サービス上限の超過

• Related smart values: {{breachedSummary}}, {{breachedRules}}

The rule will run when the daily or hourly processing time service limit is about to be breached (note that it doesn’t monitor other types of services limits, such as the “Items queued globally” limit). Read more about automation service limits

SLA しきい値の違反

• Related smart values: {{issue}}

The rule will run when a Jira Service Management SLA has breached or is about to breach.

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

承認が必要

For Jira Service Management only. Rule is run when an issue that requires approval is created or updated, or when new approvers are added to an issue. Learn more about approvals in Jira Service Management. 

承認完了

For Jira Service Management only. Rule is run when an approval step on an issue is accepted or declined. Learn more about approvals in Jira Service Management.

Slack メッセージへの絵文字リアクション

Slack で Atlassian Assist によって作成された課題にユーザーが絵文字でリアクションすると、ルールが実行されます。

Currently, the trigger works only with issue messages created by the Atlassian Assist app in Slack channels. Learn more about chat

Since this trigger uses the Slack workspace and channels you set up in chat settings, it won’t work unless you connect this service project to a Slack workspace and channel. Learn how to set up chat in Slack

デザイン トリガー

デザインが課題にリンク

The rule will run when a new Figma design is linked to an issue. Learn how to integrate Figma with Jira

You can use this trigger to add a DESIGN-LINKED label to the issue, and notify the assignee that a design has been added.

リンクされたデザインが更新されました

ルールは、すでに課題にリンクされているデザインが更新されたときに実行されます。

このトリガーを使用して、デザインが更新されたことを担当者に通知できます。

リンクされたデザインのステータスが変更されます

ルールは、すでに課題にリンクされているデザインのステータスが変化したときに実行されます。

このトリガーを使用して、デザインのステータスが変更されたときに担当者に通知したり、ステータス ラベルを自動的に追加したり、課題を次のステータスにトランジションしたりできます。