Jira Automation のトリガー

Every rule starts with a trigger. They kick off the execution of your rules. Triggers will listen for events in Jira, such as when a work item is created or when a field value is changed.

Apply conditions directly to the trigger to add criteria to the entire rule. This will filter which triggers continue your automation.

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

一般的なトリガー

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

変更されたフィールド値

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

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

You can use this trigger together with conditions to check the value of fields before performing actions. For example, send an SMS when a work item’s priority changes to greater than high.

When configuring this rule, you can select the fields to monitor for change, or use a regex to match the field names. You can narrow down the fields to monitor by specifying a change type: Value added, value deleted or any changes to the field value. You can also narrow down the work item operations that will trigger this rule – create, edit, transition or assign – or leave it blank to listen to all operations.

フォームを添付

The rule will run whenever a form is manually attached to an existing work item, but also when a form is attached using the Add form API or a form is copied to another work item using the Copy form API.

編集用にフォームを開いた時

The rule will run whenever a form is opened for customer edits on existing work items. For example, there may be times when an agent selects Open for edits on an already submitted form on a work item. This could be the trigger that sends a notification to a customer that they need to resubmit a form. This trigger will run whenever a form is manually opened for edits, but also when a form is opened using the Reopen form API.

フォームの送信時

The rule will run when forms attached to a work item are submitted. When configuring the trigger, you can select any number of forms, which will change how the trigger will act:

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

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

• If multiple forms are selected: the rule will only run when all of the selected forms on a work item are submitted.

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

受信 Webhook

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

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

A webhook is a way for a third-party to trigger an automation rule. The webhook can specify work items to act on, or even provide real-time data you can use to update a work item.

When configuring this trigger, you’ll receive a unique URL and secret that you can either add to the third-party application’s outgoing webhook configuration, or make a HTTP POST request from your custom scripts. The trigger also provides details on how to provide work item keys and other data.

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

作業項目が割り当てられました

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

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

作業項目にコメントが追加されました

• 関連するスマート値: {{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 a work item.

Choosing a comment type allows you to distinguish if a comment was added stand-alone, or as part of a transition. For example, you may want to set an automation rule where a comment added to a closed work item re-opens, or a comment added transitions the status of the work item. The available comment types are:

• All Comments (default): All comments that are added to a work item.

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

• Comment added during status transition: Comment is added when you change the status of a work item.

• Comment added while editing work item fields: Comment added while editing one or more work item fields.

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

作業項目のコメントが編集されました

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

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

作業項目が作成されました

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

The rule will run when an work item is created.

You can use this trigger with actions to customize the new work item, including populating fields, assigning to users, and adding sub-tasks.

作業項目が削除されました

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

The rule will run when a work item is deleted. For example, send an email notification that a work item has been deleted.

You can use conditions to refine exactly the work item you are monitoring.

Work item linked

• 関連するスマート値: {{destinationIssue}}、{{linkType}}

The rule will run when a work item is linked to another work item.

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

Work item link deleted

• 関連するスマート値: {{destinationIssue}}、{{linkType}}

The rule will run when a work item is unlinked from another work item.

You can configure the trigger to only execute for specified link types, or for all work item links.

作業項目が移動されました

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

The rule will run when a work item is moved from one space to another.

You can use this trigger together with conditions and actions to ensure all values, fields and settings are copied across to the new space.

Work item transitioned

• 関連するスマート値: {{issue}}、{{changelog}}

The rule will run when a work item transitions from one status to another.

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

Learn more about transitioning a work item with automation

作業項目が更新されました

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

The rule will run when the details on a work item are updated.

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

To trigger a rule when a work item’s status is updated, please use the Work item transitioned trigger instead.

Manual trigger from work item

• 関連するスマート値: {{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

[Get input from users (ユーザーから入力を取得)] を選択して、ルールの実行前に入力をリクエストすることもできます。これによって、ユーザーがルールをトリガーした際に、ユーザーに対して表示されるいくつかのフィールドをセットアップできます。[必須フィールド] を選択すると、各フィールドを必須にできます。ユーザーが情報を入力しないで [キャンセル] を選択した場合、これは実行として月次上限にカウントされません。

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

Multiple work item events

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

The rule will run when one or more selected work item events occur. For example, send a Slack message when a work item is updated, transitioned or assigned.

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

作成されたスペース

• Related smart values: Automation smart values – spaces

Rule will run when a space is created. For example, this could be useful if you want to create a set of default work items that should be included in all Jira spaces.

スケジュール済み

• 関連するスマート値: {{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.

You can also choose to enter a JQL query. If you do, actions in this rule will execute on the work items included in the query.

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

作業のログ記録

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

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

ソフトウェア トリガー

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

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

• 関連するスマート値: {{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 work items branch Work item fixed in version to loop through all work items fixed in this version.

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

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

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

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

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

You can use the Version released trigger together with the related work items branch Work item fixed in version to loop through all work items 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

Self-hosted or On-Premise tools (e.g. Bitbucket Server, Gitlab On-Premise, Github Enterprise) aren't supported. Though they can still be integrated with Jira Cloud and you'll still get the benefits of integrating in other parts of your software space.

作成されたブランチ

• 関連するスマート値: {{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 a work item key, transition that work item 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.

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

作成されたコミット

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

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

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

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

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

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

Compass で作成されたコンポーネント トリガーによって、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 でのスコアカード ステータスの変更

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

Compass でのスコアカード ステータスの変更トリガーにより、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.

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

プルリクエスト作成

• 関連するスマート値: {{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 a work item key, transition that work item to In review.

pull request declined

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

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

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

プルリクエストのマージ

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

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

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

セキュリティ トリガー

脆弱性の検出

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

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

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

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

Jira Service Management トリガー

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

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

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

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

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

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

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

このルールを実行できるユーザー: 既定では、ログインしているすべてのユーザーがルールを実行できますが、特定のユーザーおよびチームのメンバーにのみルールの実行を許可できます。

このルールを表示するアラートをフィルター: フィルタリングするアラート フィールドを選択することで、ルールを特定のアラートでのみ実行できるようにすることができます。

アラートからルールを起動するユーザーに、ルールが実行される前に情報を入力してもらいたい場合は、オプションで [このルールがトリガーされたときに入力を求める] を選択できます。

アラートの更新

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

The rule is run when an alert’s priority, summary, or description is updated. For example, create an incident of P3 priority in a service space when an alert’s priority changes to P1.

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

• 関連するスマート値: {{alert.status}}

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

アラート メモが追加

• 関連するスマート値: {{alert.note}}

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

オブジェクト トリガー

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

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

Attribute value changed

• 関連するスマート値:

  • {{attributeChangelog.(attribute name).from}}

  • {{attributeChangelog.(attribute name).to}}

  • {{attributeChangelog.(attribute name).changeType}} 

  • {{containerObject.(attribute name)}}

For Jira Service Management only. Rule is run when the selected attribute changes on any object of this type. This can only be used for global automation rules.

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

サービス上限の超過

• 関連するスマート値: {{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 しきい値の違反

• 関連するスマート値: {{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 a work item that requires approval is created or updated, or when new approvers are added to a work item. Learn more about approvals in Jira Service Management. 

承認完了

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

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

Rule is run when a user reacts with an emoji to the work item created by Assist in Slack.

Currently, the trigger works only with work item 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 space to a Slack workspace and channel. Learn how to set up chat in Slack

デザイン トリガー

Design linked to work item

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

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

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

The rule will run when a design already linked to a work item is updated.

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

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

The rule will run when the status of a design that’s already linked to a work item changes.

You can use this trigger to notify the assignee when a design status has changed, automatically add a status label, or transition the work item to the next status.

Atlassian Guard トリガー

Loom トリガー

Loom がフォルダーに移動された

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

このトリガーは、Loom ビデオが Loom フォルダーに移動されたときにルールを実行します。

Loom がスペースに移動された

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

このトリガーは、Loom ビデオが Loom スペースに移動されたときにルールを実行します。

Loom によってミーティングが録画された

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

このトリガーは、Loom によってミーティングが録画されたときにルールを実行します。