Jira Automation のアクション

Actions are the doers of your rule. They allow you to automate tasks such as editing a work item, sending a notification, or creating sub-tasks.

Assign work item

• スマート バリューの使用: あり

• Required permissions: Assign work items, Assignable user

Assigns a work item to a user.

You configure how to assign work items:

A user in a defined list – If a work item passes a restriction specified in JQL, assign it to a user from a specified list of users based on:

• Balanced workload: Each user has an equal number of work items (scope defined in JQL)

• Random: Assigns randomly from the list

• Round-robin: Assigns in sequential order of the list

Another field value or comment – Assign it to a user associated with the work item’s user field values or comments. For example,

• Assign it to a previous assignee based on the work item history

• Assign the work item to its creator

Automatic – Assign it to the space’s default assignee.

Copy from another work item – Copy the assignee from a related work item. (Or use JQL to specify work item criteria).

Smart value – Assign it based on a smart value. For example, when a work item is commented on, assign it to the comment’s author.

Specify user – Assign it to a person you select.

Unassigned – Remove existing user and set the work item as ‘Unassigned’.

User who triggered the event – Assign it to the user who triggered the event.

User in a role – Assign it to a specific role within a team.

User in a group – Assign it to someone in a specified user group.

On-call responder – Assign it to who is on-call, based on a team's Opsgenie on-call schedule. If the schedule includes multiple rotations, responders are assigned randomly.

フォームを添付する

Attach one or more forms to a work item. You can also set the visibility of the forms. Learn more about how forms work in the work item view.

値を指定したフォームを添付

Attach a form with values to an existing work item so you can populate forms with content from your chosen data source. These can either be smart values or predefined values such as choices. These forms will be attached to work items with their inputs saved, not yet submitted.

Assets and attachment form field types also aren’t supported at this time. Read more about how forms work in the work item view

フォーム ステータスを変更

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

作業項目複製

• スマート バリューの使用: あり

Creates a duplicate of a work item within the same space or a space of your choosing.

It can be used as part of a workaround for moving work items between spaces.

このアクションでは、サポートされる作業項目フィールドのリストから [添付ファイル] フィールドを選択し、添付ファイルのコピー元となるソース作業項目を選択することで、新しい作業項目を作成して、添付ファイルをコピーする機能を含む、利用可能なすべてのフィールド データをコピーします。

Its Status is then set to the first step of the corresponding workflow, and any resolutions from the original work item will be cleared. It is not a true clone and won’t be linked to the original work item.

サポートされているフィールドで、コピーされたデータを上書きする値を設定することもできます。Jira Service Management では、Jira フィールドとアセットフィールドの両方を設定します。Jira Service Management のアセットについての詳細をご確認ください。

その他のオプションを選択すると、高度なフィールド編集の追加フィールドが表示されます。

このアクションでは、作業項目のリンクまたはコメントは複製されません。

アクションで組織フィールドを設定し、報告者のメールドメインを使用を選択すると、組織のメールドメイン管理リストに明示的に追加されたドメインのみがチェックされます。報告者のドメインが 1 つの組織と完全に一致する場合、その組織が自動的に選択されます。ドメインが複数の組織と一致する場合、そのメールドメインに関連付けられたいずれかの組織が選択されます。ドメインがどこにも表示されておらず、組織が存在しない場合は作成するを選択している場合、メールドメインを名前として使用して新しい組織が作成されます。

Comment on work item

• スマート バリューの使用: あり

Adds a comment to a work item.

You can use smart values to reference work item fields to personalize the comment. You can also set the comment visibility.

フォームをコピーする

Copy one or more forms from one work item to the current work item.

ブランチを (製品名で) 作成する

ブランチを選択したツールで作成します。現在、次の 3 つの方法があります。

• ブランチを Bitbucket で作成

• ブランチを GitHub で作成

• ブランチを GitLab で作成

これには、自動化ルールと他のツールとの間の接続を設定する必要があります。自動化での接続についての詳細をご確認ください。

これらのブランチに関連する情報にアクセスするためにスマート値を使用することもできます - 作成されたブランチのスマート値についての詳細をご確認ください。

ブランチに名前を付ける際の制限

次はブランチの名前に使用できません。

• HEAD (予約語であるため)

• / で開始または終了する名前

• . で開始または終了する名前

• 末尾が .lock

• スペースを含む名前

• 次の記号セットを含む名前: ..、~、^、:、?、*、[、/、\\、@{

Confluence ページを作成する

• スマート バリューの使用: あり

選択した Atlassian Cloud サイトに Confluence ページ (またはブログ) を作成します。これにより Confluence ページは作成されますが、コンテンツは入力されないことに注意してください。つまり、スマート値を使用してページ タイトルを定義することはできますが、自動化ルールではどのページ コンテンツも定義できません。

Requires a connection between your Jira space and Confluence. Learn more about using Jira automation with Confluence.

作業項目を作成

• スマート バリューの使用: あり

• Required permissions: Browse spaces, Create work items

Creates a work item of any type in a space. You can select fields to configure and set their values. You can copy attachments by selecting the Attachment field from the list of supported work item fields and then choosing the source work item from which attachments need to be copied.

その他のオプションを選択すると、高度なフィールド編集の追加フィールドが表示されます。

Jira Service Management では、Jira フィールドとアセットフィールドの両方を設定できます。Jira Service Management では、ルールがオブジェクトによってトリガーされる場合、オブジェクトを挿入を選択して、AQL 経由でトリガーされたオブジェクトを自動的に追加できます。Jira Service Management のアセットについての詳細をご確認ください。

Take care when using Space > Same space as trigger on global rules. As the space type is unknown until the rule runs, all work item types are available to configure. This means that you can select a work item type that will not exist in the space.

アクションで組織フィールドを設定し、報告者のメールドメインを使用を選択すると、組織のメールドメイン管理リストに明示的に追加されたドメインのみがチェックされます。報告者のドメインが 1 つの組織と完全に一致する場合、その組織が自動的に選択されます。ドメインが複数の組織と一致する場合、そのメールドメインに関連付けられたいずれかの組織が選択されます。ドメインがどこにも表示されておらず、組織が存在しない場合は作成するを選択している場合、メールドメインを名前として使用して新しい組織が作成されます。

ルックアップ テーブルを作成する

キーと値のマッピングのテーブルを作成して、それをスマート値に割り当てます。スマート値は、ルール内のその他のアクションや条件で使用できます。次に例を示します。

スマート値 {{departments.get("HR")}} は人事を返します。

キーと値のマップは、同じルール内でのみ呼び出せます。アクションがブランチで使用される場合、スマート値は同じブランチ内でのみ使用できます。キー/値のマッピングは、その他のルールやブランチには引き継がれません。

ユース ケースの例

たとえば、優先度に基づいてバグに期限を割り当てる自動化ルールを作成したいとします。優先度の高いバグは、その週内に完了する必要があります。一方、優先度の低いバグは、翌 6 か月内に完了すれば構いません。

次の値でキー/値のマップを作成できます。

And then, using the Edit work item action and the {{dueDates.get(issue.Priority.name)}} smart value, you can automatically assign due dates based on how urgent the bug is:

この方法でスマート値をネストする場合、ネストされたスマート値によって返される値は文字列でなければならないことに注意してください。この例では、代わりに issue.Priority.id を使用した場合、.format(“#”) を追加して出力を文字列 (つまり {{dueDates.get(issue.Priority.id.format("#"))}}) に変換しない限り機能しません

動的なルックアップ テーブルを作成する

既存のスマート値からキーと値のマッピングのテーブルを作成して、それを新しいスマート値に割り当てます。スマート値は、ルール内のその他のアクションや条件で使用できます。動的ソースは、値のコレクション、リスト、または配列を生成するスマート値です。

キー入力フィールドと値入力フィールドの両方でスマート値のドット表記を使用して、使用したい値までドリルダウンできます。

注: キーと値のマップは、同じルール内でのみ呼び出せます。アクションがブランチで使用される場合、スマート値は同じブランチ内でのみ使用できます。キー/値のマッピングは、その他のルールやブランチには引き継がれません。

アセットを使用したユースケースの例

例えば、ある情報を保存するために使うアセット スキーマがあるとします。

In this example we have the Slack channel and Confluence space key for a few teams. We can then create a lookup table from this:

The key will be the space name and the value will be the space key. When the log action asks for Development then it should be presented with the Space Key for that space, which we can see above is DEVELOP:

「Web リクエストを送信」の使用例

Web リクエストの送信結果はルックアップ テーブルに変換することもできます。jokes API を呼び出す次のルールの例を考えてみましょう。

Assuming then that you had joke IDs stored in your work items, you’d be able to get the joke from a work item.

サブタスクの作成

• スマート バリューの使用: あり

Creates sub-tasks on a work item.

このアクションは、サブタスクの要約の設定のみをサポートします。

Selecting Add fields will convert the Create sub-tasks action into a Create work item (work item type: sub-task) action, allowing you to set additional fields.

スプリントの作成

• スマート バリューの使用: あり

• Jira 専用です。 

選択したソフトウェア スペース ボードにスプリントを作成します。

• For company-managed spaces, the board must be a Scrum board.

• For team-managed spaces, the board must have the Sprints feature enabled. .

開始日、終了日、ゴールに特定の値を入力するオプションもあります。開始日と終了日については、日付と時刻のスマート値を使用すると便利です。たとえば、{{now}} を開始日として設定し、{{now.plusweeks(2)}} を終了日として設定できます。日付と時刻のスマート値の詳細をご確認ください。

注意事項:

• 開始日を設定する場合は、終了日も設定する必要があります。

• スプリント名は 30 文字を超えることができないため、手動で入力するスプリント名や、長すぎるテキストを返すスマート バリューに注意する必要があります。

変数の作成

• スマート バリューの使用: あり

独自のスマート バリューを定義します。この値は、同一ルールの他のアクションや条件で使用できます。定義したスマート バリューには、他のスマート バリューや数学関数を含めることができます。

Note that this will always return a string. For example, if you created variable called Stakeholders with the smart value {{issue.watchers.distinct}}, your variable would return the list of watchers but the list would be rendered as a string.

コメントの削除

• スマート バリューの使用: あり

Can be used to delete a comment on a work item. There are two different ways to use this action:

• Deleting a trigger comment: If the rule uses a trigger that involves adding a comment, such as Work item commented, Work item transitioned, or Work item updated, {{comment.id}} will delete that comment.

• Deleting other comments: Delete a comment on an active work item by using a comment smart value, such as {{issue.comment.first.id}}.

Delete work item

• スマート バリューの使用: なし

Deletes the current work item that is in context.

This action allows you to remove unwanted work items from Jira, such as when automating moving work items between spaces.

Delete work item links

• ここでのスマート値の使用: なし

This action allows you to remove any work item links currently on a work item. You can remove all work item links of a certain type (for example, remove all "blocked by" work items), or select specific work items to unlink.

コメントを編集する

• スマートの使用: あり

このアクションによって、コメントの表示やコメントの内容を編集できるようになります。利用可能なオプションは次のとおりです。

• First comment: Edit the oldest comment on a work item.

• Last comment: Edit the most recent comment on a work item.

• Trigger comment: Edit the comment that triggered the rule. Used with triggers such as Work item commented or Work item comment edited. Learn more about automation triggers.

• スマート値: コメント スマート値を指定して、編集するコメントを選択します。

オプションを選択したら、次のフィールドを空白のままにしてコメントを変更せずに残せます。これは、コメントの表示のみを編集して他の部分には手を付けない際に役立ちます。スマート値 {{currentComment}} を入力すると、コメントの現在のコンテンツが返されます。これは、現在のコメントを保持してその前後にコンテンツを追加する際に役立ちます。

[アセット] フィールドの属性を編集する

• スマート バリューの使用: あり

Jira Service Management でのみ利用できます。このアクションは、[アセット] フィールドの属性値を編集します。スマート値、文字列値、またはアセット オブジェクトの ID/キーのいずれかを入力できます。ここでフィールドを空のままにすると、オブジェクトの値がクリアされます。

アセット属性はさまざまなタイプの値 (文字列、整数、ユーザー、日付、参照オブジェクトなど) を持てるため、ここでは適切に入力する必要があります。このアクションの値が属性タイプと一致しない場合は、このルールでエラーが発生します。

作業項目を編集する

• スマート バリューの使用: あり

現在の作業項目を編集するには、設定するフィールドと追加する値を選択してください。Jira Service Management では、Jira フィールドとアセットフィールドの両方を編集できます。Jira Service Management のアセットについての詳細をご確認ください。

一部の値を動的に設定できます。添付ファイルをコピーすることもできます。サポートされている作業項目フィールドのリストから添付ファイルフィールドを選択し、添付ファイルのコピー元となるソース作業項目を選択してください。その他のオプションを選択すると、高度なフィールド編集の追加フィールドが表示されます。

アクションで組織フィールドを設定し、報告者のメールドメインを使用を選択すると、組織のメールドメイン管理リストに明示的に追加されたドメインのみがチェックされます。報告者のドメインが 1 つの組織と完全に一致する場合、その組織が自動的に選択されます。ドメインが複数の組織と一致する場合、そのメールドメインに関連付けられたいずれかの組織が選択されます。ドメインがどこにも表示されておらず、組織が存在しない場合は作成するを選択している場合、メールドメインを名前として使用して新しい組織が作成されます。

オブジェクトを編集する

• スマート バリューの使用: あり

• Jira Service Management にのみ適用されます。 

オブジェクトの属性値を更新します。スマート値、文字列値、またはアセット オブジェクトの ID/キーのいずれかを入力できます。ここでフィールドを空のままにすると、オブジェクトの値がクリアされます。

アセット属性はさまざまなタイプの値 (文字列、整数、ユーザー、日付、参照オブジェクトなど) を持てるため、ここでは適切に入力する必要があります。このアクションの値が属性タイプと一致しない場合は、このルールでエラーが発生します。Jira Service Management のアセットについての詳細をご確認ください。

リクエスト タイプの編集

• スマート バリューの使用: あり

• Jira Service Management にのみ適用されます。 

Updates the request type for a work item. Note that request types are based on work item types; any number of request types can correspond to one work item type. However, this means that when your automation rule acts on a work item, the chosen request type must correspond to that work item type. If it doesn't, the action will result in an error in the audit log.

Link work items

• スマート バリューの使用: あり

Links a work item to another by selecting the link type and the work item to link.

You can link to the work item that triggers the rule, the current work item on a Related work items branch, a smart value, or a work item key.

Link work item to focus area

Required permissions: User role in Focus with Add work Jira permissions

Links work items that meet the conditions to a focus area.

脆弱性を作業項目にリンクする

• スマート バリューの使用: なし

• Can only be used with Vulnerability found trigger.

Links the trigger vulnerability to a work item.

To create and link a new work item for every trigger vulnerability:

1. Create an automation with the Vulnerability found trigger and the Create work item action.

2. In the drop-down menu in the Link work item to vulnerability action, choose the most recently created work item.

To link all trigger vulnerabilities to one work item:

1. Create an automation with the Vulnerability found trigger.

2. In the drop-down menu in the Link work item to vulnerability action, enter the work item key.

If you enter a work item key in this action, the automation will fail if the work item doesn’t exist when the rule is run.

ログ

• スマート バリューの使用: あり

Logs time against a work item.

日時のスマート値を使用して開始日を動的に設定し、テキストのスマート値を使用して説明をカスタマイズできます。

作業項目を検索する

• スマート バリューの使用: あり

Search for up to 100 work items using a JQL query. Include the results list in other actions by using the {{lookupIssues}} smart value. Learn more about using smart values with work item lists.

All fields and custom fields can be accessed from the lookupIssues list. For example, to print the work item key for each work item in bullet point form:

And the following example sums all story points in the work item list:

オブジェクトのルックアップ

• スマート バリューの使用: あり

• Jira Service Management にのみ適用されます。

AQL を使用して最大 100 件のアセット オブジェクトを検索します。AQL クエリを入力するか、[ベーシック] フィルターを使用して、スマート値でカスタマイズできるクエリを生成します。[ベーシック] フィルターはスマート値をサポートしており、アセット属性だけでなく動的なクエリにも対応しています。[ベーシック] フィルターでアセット属性を使用する場合は、AQL クエリを動的にするために、属性の代わりに関連するスマート値を使用してください。添付のリンクをクリックすると、選択したアセット スキーマに簡単に移動できます。

このクエリの結果は、{{lookupObjects}} スマート値により、その他の自動化アクションで使用できます。これはオブジェクトのリストにアクセスして表示するために使用できますが、他のルールのトリガーには使用できません。アセットでスマート値を使う方法の詳細をご確認ください。

ウォッチャーの管理

• スマート バリューの使用: あり

Add or remove watchers on a work item.

フィールドで直接スマート バリューを使って、ユーザーを指定して追加または削除できます。

メールを送信

カスタマイズしたメールを送信

• スマート バリューの使用: あり

組織の外部ユーザーのセキュリティ ポリシーに準拠しながら、カスタム メール アドレスからブランド メールを送信します。このアクションは、オンボーディングワークフローの一環として新入社員に送信される一連のメールを自動化するようなシナリオで役立ちます。

プレーン テキスト、リッチ テキスト、HTML コンテンツ形式から選択でき、ロゴ、画像、リンクを追加して目的に合わせてメールをカスタマイズできます。独自のカスタム フィールドをすべて参照するスマート値を使用することもできます。

まず [カスタマイズしたメールを送信] アクションを選択し、次に [設定] タブにメールの詳細を入力します。

• [受信者] フィールド:

  • ドロップダウン リストから、ユーザー フィールドやグループを選択できます。スマート値や、組織内外の受信者のメール アドレスを入力することもできます。受信者には個別のメールが送信され、他の受信者アドレスは表示されません。

  • このフィールドで関係するすべての顧客を選択すると、報告者、リクエスト参加者、作業項目に組織が追加された顧客、作業項目通知をサブスクライブしている顧客にメールが送信されます。Jira Service Management の顧客と組織について読む。

  • 組織にフィルターコンテンツや外部ユーザーセキュリティなどのポリシーがある場合、一部のメールがブロックされ、一部の受信者に送信されない可能性があることにご注意ください。

• [差出人] フィールド:

  • ご利用のサイトから送信される既定のメール ドメインのメール プリフィックスをカスタマイズするオプションが利用できます。

  • また、組織管理者によって admin.atlassian.com に追加された任意のカスタム メール アドレスからメールを送信することもできます。カスタム メール アドレスのセットアップ方法をご確認ください。

[コンテンツ] タブで、次の操作を行います。

• メールで使いたいコンテンツ形式を選択します。次の選択肢を利用できます。

  • プレーン テキスト – コンテンツのフォーマットはありませんがスマート値を含めることができます。

  • リッチ テキスト – エディターのツールバーを使用したコンテンツ フォーマット (リンクや画像を含む) です。スマート値を含めることもできます。画像は、ホスト画像ファイルの公開 URL を入力することで追加するか、スマート値を使用して動的にレンダリングできます。サイズと配置は、[コンテンツ] フィールドのコンテキスト ドラッグ ハンドルとツールバーを使用して管理できます。

  • HTML – HTML によるコンテンツ フォーマット。スマート値を含めることができます。

• コンテンツを [コンテンツ] フィールドに入力します。メールの内容は、ルールが有効化、保存、または更新された後にのみ保存されます。コンテンツの書式設定を切り替えると、[コンテンツ] フィールドから既存のコンテンツが削除されます。

• [添付ファイル] フィールドから、メールに添付したいファイルを 10 個まで参照またはドロップできます (ほとんどのファイル形式で、合計サイズ 4MB 以内のファイルを添付できます)。メール アクションに添付ファイルを追加するには、ルールが保存または有効化されている必要がある点にご注意ください。

このアクションは、HIPAA 準拠のお客様にはご利用いただけません。

Microsoft Teams のメッセージを送信する

• スマート バリューの使用: あり

Microsoft Teams のメッセージを送信して、ルール実行時にチームに通知します。プライベート チャンネルにメッセージを送信できません。

このアクションでメッセージをパーソナライズできます。Microsoft Teams での自動化の使用についての詳細をご確認ください。

グローバル管理者は、アクションで使用できるドメインに制限を設定することもできます。自動化コンポーネントへの制限の追加に関する詳細をご確認ください。

Slack のメッセージを送信する

• スマート バリューの使用: あり

ルールの実行時にチームや個人に通知するために Slack のメッセージを送信します

このアクションでメッセージをパーソナライズできます。Slack での自動化の使用についての詳細をご確認ください。

グローバル管理者は、アクションで使用できるドメインに制限を設定することもできます。自動化コンポーネントへの制限の追加に関する詳細をご確認ください。

Twilio (SMS) メッセージを送信する

• スマート バリューの使用: あり

Twilio サービスを使用して通知を送信します。

このアクションは、オンコール シナリオで SMS を利用するサービス チームで役立ちます。

グローバル管理者は、アクションで使用できるドメインに制限を設定することもできます。自動化コンポーネントへの制限の追加に関する詳細をご確認ください。

Web リクエストを送信

• スマート バリューの使用: あり

発信 Web リクエストを送信して、ルール実行時に別のシステムに通知します。 後続のアクションで使える応答データを返すようにこのアクションを設定できます。

グローバル管理者は、アクションで使用できるドメインに制限を設定することもできます。自動化コンポーネントへの制限の追加に関する詳細をご確認ください。

データ形式

以下の 3 つの形式から選択できます。

• Work item data (Jira format) - The format used throughout most of Jira Cloud, including Jira Cloud’s Legacy Automation feature. Learn more about the Jira format.

• Work item data (Automation format) - The format used by Jira Cloud automation components. Learn more about the automation format.

• カスタム形式 - 独自のデータ形式を入力するには、このオプションを選択します。

非表示の値

When configuring your web request, you can also Hide certain values, making them more secure. If a value is marked as hidden and the rule is saved, the value will be replaced by asterisks (i.e., *****). It will no longer be visible, and you won’t be able to inspect any payload. This can’t be reversed (i.e. the Hidden checkbox can’t be unselected), though the value itself can still be changed when editing your rule.

セキュリティ上の理由から、ルール全体が複製されたり、エクスポート/インポートされたり、Web リクエストの送信コンポーネント自体が重複したりすると、非表示の値は失われます。このような場合は、コンポーネントを再設定して、それらの値を再入力する必要があります。

その他の注意点

• 許可されるポート: 「Web リクエストを送信」アクションからの URL に使用できるポートは、80、8080、443、6017、8443、8444、7990、8090、8085、8060、8900、9900 だけであることに注意してください。

• データの機密性: 「Web リクエストを送信」アクションを使用して、機密データをサードパーティに送信するように設定できます。これはルールを保存した後でも同じです。なぜなら、ルールを編集する権限のある人は、送信してはいけないデータを送信するように「Web リクエストを送信」アクションを再設定できるからです。このため、このアクションを使用する前に、信頼できる人だけが自動化ルールを編集できることを確認するようお勧めします。

作業項目をトランジションする

• スマート バリューの使用: あり

ワークフロー内で、作業項目をあるステータスから別のステータスにトランジションします。

課題のトランジションと同時に更新するフィールドを選択できます。たとえば、以下を更新できます。

• 作業項目からコピー: 関連する作業項目やブランチ ルールの作業項目からステータスをコピーします。

• 親からコピー: サブタスクと併用するために、親課題からステータスをコピーします。

• エピックからコピー: 作業項目に関連するエピックからステータスをコピーします。

• トリガー作業項目からコピー: ルールをトリガーした作業項目からステータスをコピーします。

• 同一ステータス (ループ): トランジションした課題が現在のステータスに戻ってくる際に使用します。画面と一緒に使用すると、ユーザーから詳細データを収集できます。たとえば、エスカレーションへのトランジションなどです。

サポートされる作業項目フィールドのリストから [添付ファイル] フィールドを選択して、添付ファイルのコピー元となるソース作業項目を選択することで、添付ファイルをコピーできます。その他のオプションを選択すると、高度なフィールド編集の追加フィールドが表示されます。

Jira Service Management では、Jira フィールドとアセットフィールドの両方を編集できます。Jira Service Management のアセットについての詳細をご確認ください。

When you set the Organizations field and choose Use reporter’s email domain, it checks only the domains explicitly added to an organization’s Manage email domains list. If the reporter’s domain:

• Matches exactly one organization – that organization is automatically selected

• Matches more than one organization – any one of the organizations associated with that email domain will be selected

• Isn’t listed anywhere and you’ve selected Create organization if it doesn’t exist – a new organization will be created using the email domain as its name

Rovo エージェントを使用する

• スマート バリューの使用: あり

Prompts an agent of your choosing on your behalf to generate a response. It must be coupled with a secondary action with text-based output, like Add comment, to direct the response to.

When setting up this action, you provide a prompt describing what the agent should analyze. For example:

Read and review the quality of the description field for this work item.

Add service space customer

• スマート バリューの使用: あり

Adds new customers to your Jira Service Management space.

スマート バリューはすべてのフィールドで使用でき、既存組織に顧客を追加できます。

このアクションを短い間隔で複数回連続して呼び出した場合、カスタマーが存在するものの、ユーザーの検索結果にはまだ表示されないため、最初の呼び出しは成功し、後続の呼び出しは失敗します。検索結果に新しいユーザーが表示されてこの問題が解決されるまで、最大で15 秒かかります。

{{customer}} のスマート バリューでは、検索結果に表示できない既存のユーザーは返されないため、エラーが発生します。

If this work item is affecting your rule, you can introduce a delay into your rule by adding the Delay action right before the Add service space customer action.

リクエストを承認/却下する

• スマート バリューの使用: なし

Jira Service Management のリクエストを承認または却下します。ワークフローを進めるために必要な承認者の数は問いません。

You can use this action on Jira Service Management work items that are pending approval on the current workflow status. Approvals are managed through the workflow. Learn more about approvals in Jira Service Management.

インシデントを作成

• スマート バリューの使用: あり

• Required permissions: Browse spaces, Create work items

When this action is executed, an incident of selected request type will be created in the selected service space on Jira Service Management. For example, you can use this action to create a new incident when a work item is created and meets certain criteria.

You'll also have the option to avoid creating a new incident if the action has already created an open incident of the same type in the space.

You need to have a service space and a request type for incidents to use this action.

バージョンの作成

• スマート バリューの使用: あり

Creates a new version that you can assign work items.

同じ名前のバージョンがすでに存在する場合は、新しいバージョンは作成されません。

Create work item with a request type

• スマート バリューの使用: あり

Creates a new issue in a Jira Service Management space using the selected request type.

All request types you’ve added to the service space can be used with this action. Learn how to organize your request types into portal groups

Similar to the Create work item action, this action allows you to configure any field available using smart values.

使用可能なフィールドには、非表示ではなく、リクエスト タイプに追加されているすべてのフィールドが含まれます。非表示のフィールドはサポートされていません。ただし、Premium プランまたは Enterprise プランで利用できるメジャー インシデントは例外です。

バージョンをリリースする

• スマート バリューの使用: あり

バージョンをリリースします。

By default, this action will release the next unreleased version of a space with the existing release date. This is determined by the order the versions are set in Releases.

リリースする特定のバージョンを選択し、スマート バリューを使って動的な名前を設定できます。

添付ファイルを削除する

• スマート バリューの使用: あり

添付ファイルのファイル名に基づいて、正規表現の一致を使って添付ファイルを削除します。

ログ アクション

• スマート バリューの使用: あり

監査ログに値を記録します。

このアクションはスマート値のテストやルールのデバッグに役立ちます。

「作業項目データを再取得する」

• スマート バリューの使用: なし

最新のフィールド値でスマート バリューを更新します。

デフォルトでは、{{issue}} 参照値はルールの実行中には更新されず、ルールが最初にトリガーされたときと同じ値が含まれます。

エンティティのプロパティを設定する

• スマート バリューの使用: あり

Sets entity properties on work items, spaces, and users related to the trigger work item of the rule execution.

These hidden properties can be used by apps for certain functions. Entity properties allow plugins to add key/value stores to work items and spaces. These values can be indexed and queried via REST API or JQL.

バージョンのリリースを元に戻す

• スマート バリューの使用: あり

Unrelease a released version for a chosen space. By default, this will be the rule's space, but you can select More options to choose a different space.

Amazon SNS トピックにメッセージを送信する

• スマート バリューの使用: あり

このアクションを実行すると、選択した Amazon Simple Notification Service トピックに JSON メッセージが送信されます。

アクションには最大 10 個のキーと値のペアを追加できます。さらに追加する場合は、サポートにお問い合わせください。

スマート値はすべての値タイプ (文字列、リスト、数値、ブール値、カスタム) で使用できます。ただし、カスタムはスマート値のみをサポートしています。

Amazon SNS トピックでアトラシアン自動化がメッセージを公開できるように設定してください。Amazon SNS の設定についての詳細をご確認ください。

AWS SSM ドキュメントを実行する

• スマート バリューの使用: あり

このアクションを実行すると、選択した AWS Systems Manager ドキュメントが実行されます。ドキュメントの事前設定されたパラメータに値を追加できます。

IAM ロールに、アトラシアン自動化が SSM ドキュメントにアクセスして実行することを許可する権限ポリシーがあることをご確認ください。AWS IAM の設定についての詳細をご確認ください。

仮想マシンを Azure で再起動

• スマート バリューの使用: なし

このアクションを実行すると、Microsoft Azure で選択された仮想マシンがアトラシアン自動化によって再起動されます。

ルールの接続の認証のために、Microsoft Azure プロファイル情報にメールアドレスを追加していることを確認してください。Microsoft Azure でプロファイル情報を追加または変更する方法の詳細をご確認ください

Azure でランブックを開始

• スマート バリューの使用: なし

このアクションを実行すると、Microsoft Azure で選択されたランブックが Atlassian Automation によって開始され、実行されます。Microsoft Azure に送信される JSON メッセージに含めるキーと値のペアを追加することもできます。

ルールの接続の認証のために、Microsoft Azure プロファイル情報にメールアドレスを追加していることを確認してください。Microsoft Azure でプロファイル情報を追加または変更する方法の詳細をご確認ください。

インシデントに関係者を追加する

スマート バリューの使用: あり

選択したユーザー (Jira Service Management エージェントと関係者ロールを持つ) を関係者としてインシデントに追加します。これにより、タイムリーな更新情報とインシデントの進捗の可視性が確保されます。

関係者は、次のようないくつかの方法で追加できます。

• インシデント ビューから手動で追加

• 影響を受けるサービスを通じて自動で追加 (それらのサービスにユーザーが割り当てられている場合)

• このアクションを使用した自動化により、サービス構成に関係なく、主要なユーザーに常に通知が届くようになります。

このアクションの実行は、Jira Service Management インシデントに対してのみ成功します。

Jira Service Management のステークホルダーに関する詳細をご確認ください。

Create post-incident review

スマート バリューの使用: あり

Automatically creates a post-incident review (PIR) for the incident. This helps teams capture learnings and follow-up actions as part of the incident resolution process.

You can define the title and description of the PIR using smart values, or pull in fields from the original incident.

Without automation, post-incident reviews must be manually created in the incident view. This action ensures they’re generated consistently as part of your workflow.

このアクションの実行は、Jira Service Management インシデントに対してのみ成功します。

Read more about post-incident reviews.

インシデントのための Zoom ミーティングを作成する

スマート バリューの使用: あり

Starts a Zoom meeting to help responders collaborate on the incident. This uses the Zoom account connected in your Jira Service Management space’s chat and video tools settings.

スマート値を使用してミーティング名をカスタマイズできます。Zoom で利用できるようになったら、ミーティングの記録を内部メモとしてインシデントに自動的に添付することもできます。

The meeting will be created using the Zoom user token of the person who connected the Zoom account in your space settings. All meetings created through automation will use this token.

This action will run successfully only for Jira Service Management incidents.
To get started, connect your Zoom account and enable it in your space’s incident management settings.
Read more about creating Zoom meetings for incidents.

インシデント用の Slack チャンネルを作成

• スマート バリューの使用: あり

このアクションを実行すると、選択した Slack ワークスペースに新しい Slack チャンネルが作成され、インシデント担当者がそのチャンネルに自動で追加されます。利用可能なすべてのインシデントの詳細とアクションが投稿され、対応チームが迅速に状況を把握して行動を起こせるようになります。

以下をカスタマイズできます。

• プレーン テキストまたはスマート値を使用したチャンネル名と説明。

• スマート値やメール アドレスを使用してチャンネル メンバーとして追加する Slack ユーザー。

• アプリ ID またはスマート値を使用してチャンネルにインストールする Slack アプリ。

アプリ ID を見つける

このアクションを使用して Slack チャンネルに追加するには、アプリのメンバー ID が必要です。

次の方法で確認できます。

1. Slack を開き、サイドバーの [アプリ] セクションに移動します。

2. アプリの名前を選択します。

3. アプリ ビューで、上部にあるアプリ名を選択して詳細パネルを開きます。

4. [Member ID (メンバー ID)] フィールドを探します。これがアプリの ID です。

既定では、チャンネルの名前と説明には、作業項目キー、要約、インシデント URL が使用されます。

このアクションの実行は、Jira Service Management インシデントに対してのみ成功します。

To get started, connect your Slack workspace with your Jira Service Management instance and space. Read how to connect Slack with Jira Service Management.

インシデントに Microsoft Teams のチャットまたはミーティングを作成する

• 「スマート値の使用: あり

このアクションを実行すると、選択した Microsoft テナントに新しい Microsoft Teams チャットまたはミーティングが作成され、インシデント担当者がチャットまたはミーティングに自動で追加されます。利用可能で関連するすべてのインシデントの詳細とアクションが投稿され、対応チームが迅速に状況を把握して行動を起こせるようになります。

Microsoft テナント、チャットまたはミーティングの名前と説明、追加するメンバーをカスタマイズできます。既定では、チャットまたはミーティングの名前と説明には、インシデントの作業項目キー、要約、URL が使用されます。

制限と動作:

• For the chat or meeting name, only the work item key can be safely used as a smart value. Microsoft Teams doesn’t support special characters in chat names, so using the work item summary or URL may cause the rule to fail.

• チャットまたはミーティングに追加されたメンバーの場合、インシデントの対応者のみが既定で含まれます。関係者など他のユーザーを追加する場合は、自動化ルールの「メンバー」フィールドに明示的に含める必要があります。

This action will run successfully only for work items of an incident request type. Read about creating a request type.

To get started, connect your Microsoft tenant with your Jira Service Management instance and space. Read how to connect Microsoft Teams with Jira Service Management.

Slack チャンネルにアプリを追加

スマート バリューの使用: あり

選択した Slack アプリをインシデントの Slack チャンネルに追加します。監視ボット、ドキュメント アプリ、統合などのツールにより、対応ワークフローを強化することができます。

スマート値を使用するか、アプリ ID を指定して、追加するアプリをカスタマイズできます。チャンネルに追加するには、接続されたワークスペースに Slack アプリがすでにインストールされている必要があります。

アプリ ID の見つけ方

このアクションを使用して Slack チャンネルに追加するには、アプリのメンバー ID が必要です。

次の方法で確認できます。

1. Slack を開き、サイドバーの [アプリ] セクションに移動します。

2. アプリの名前を選択します。

3. アプリ ビューで、上部にあるアプリ名を選択して詳細パネルを開きます。

4. [Member ID (メンバー ID)] フィールドを探します。これがアプリの ID です。

This action will run successfully only for Jira Service Management incidents.
To get started, connect your Slack workspace with your Jira Service Management instance and space.
Read how to connect Slack with Jira Service Management.

Slack でダイレクト メッセージを送る

スマート バリューの使用: あり

インシデントが発生したときに、選択したユーザーに直接 Slack メッセージを送信します。優先度の高いイベントについて、対応者や意思決定者に非公開で通知するのに役立ちます。

スマート値を使用して、メッセージの内容と受信者をカスタマイズできます。メッセージ内でユーザーにタグ付けするには、フォーマット @{{smart_value}} を使用します。

This action will only run for Jira Service Management incidents.
To get started, connect your Slack workspace with your Jira Service Management instance and space.
Read how to connect Slack with Jira Service Management.

Slack チャンネルでメッセージを送信する

スマート バリューの使用: あり

インシデントにリンクされた Slack チャンネルにメッセージを送信します。これを使用すると、インシデントの更新、ステータスの変更、または次のステップを自動化できます。

スマート値を使用してメッセージの内容をパーソナライズし、要約、ステータス、解決までの時間などの作業項目フィールドを参照します。メッセージ内でユーザーにタグ付けするには、フォーマット @{{smart_value}} を使用します。

This action will run successfully only for Jira Service Management incidents.
To get started, connect your Slack workspace with your Jira Service Management instance and space.
Read how to connect Slack with Jira Service Management.

Slack チャンネルにメンバーを追加する

スマート バリューの使用: あり

インシデントに関連する Slack チャンネルに特定のユーザーを追加します。これを使用すると、インシデントさまざまな段階で、対象分野のエキスパートやエスカレーション担当者を自動的に取り込むことができます。

スマート値を使用して追加するユーザーを定義することも、Slack ID やメール アドレスとして手動で入力することもできます。

This action will run successfully only for Jira Service Management incidents.
To get started, connect your Slack workspace with your Jira Service Management instance and space.
Read how to connect Slack with Jira Service Management.

Slack チャンネルにブックマークを追加

スマート バリューの使用: あり

インシデント対応中に作成されたインシデント Slack チャンネルにブックマークのリストを追加します。ブックマークはダッシュボード、ランブック、Confluence ページなどの主要なリソースを指すことができ、対応者は迅速に行動を起こせるようになります。

プレーン テキストとスマート値を使用して各リンクの名前と URL を定義し、ブックマークをカスタマイズできます。ブックマークとして追加できるのは有効な URL だけです。

This action will run successfully only for Jira Service Management incidents.
To get started, connect your Slack workspace with your Jira Service Management instance and space.
Read how to connect Slack with Jira Service Management.

Jira Edge Connector を使用してスクリプトを実行する

このアクションを実行すると、オンプレミス システムで選択したアクションが Jira Edge Connector 経由で実行されます。

Microsoft Azure に送信される JSON メッセージに、含めたいキーと値のペアを追加することもできます。Jira はキーと値のペアを検証しないため、必ず確認してください。

Jira Edge Connector で Jira 自動化を使用する方法をご確認ください。

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

このアクションが実行されると、アラートのステータスはユーザーが選択した新しいステータスに変更されます。アラートのステータスを、確認済み、オープン、クローズ済み、スヌーズに変更できます。

スヌーズを選択すると、カスタムのスヌーズ期間（1 分から 7 日）を選択できます。また、日付と時刻のスマート値もサポートされます。

Ansible でジョブ テンプレートを起動

このアクションが実行されると、選択したジョブ テンプレートが Ansible で起動されます。ジョブ テンプレートを正常に起動するために追加情報が必要な場合は、アクションにその情報を JSON 形式で指定できます。

アプリケーションをアトラシアン自動化に接続するにはトークンが必要なので、必ず前もって、Ansible Automation Controller でアプリケーションを作成してください。Ansible との接続に関する詳細をご確認ください

New Relic でクエリを実行する

このアクションが実行されると、指定されたクエリが NRQL を使用して New Relic で実行されます。New Relic にはユーザーキーを使用して接続できます。

接続したら、New Relic のアカウント ID と、New Relic で実行したいクエリを入力できます。

遅延

• スマート バリューの使用: なし

このアクションを（条件または別のアクションの前に）ルールに追加すると、2 つのコンポーネント間に時間ベースの遅延が追加されます。ルールは、ルール内の次のコンポーネントが実行されるまでに X 時間遅延します。

遅延コンポーネントをブランチに追加しても、ブランチのコンポーネントの実行が遅延するだけで、ルールの他の部分には影響しません。

遅延コンポーネントでは、15 分または 900 秒を超える遅延を設定できません。また、ルール内の遅延時間の合計が 60 分を超えることはできません。このアクションは、現時点では Premium プランと Enterprise プランでのみ利用可能です。

アラート イベントが発生するまでの遅延

• スマート バリューの使用: なし

イベント ベースの遅延アクションを使用すると、関連するアラート エンティティで特定のイベントが発生するまで、ルールの実行を最大 15 分遅らせられます。アラート スマート値の再取得は遅延の開始前とイベントの受信後に行われます。この機能は、ルールの次のステップに進む前に特定の条件またはメトリックが満たされていることを検証することが極めて重要なインシデント管理シナリオで特に役立ちます。

サポートされているイベント:

• 優先度が変更されました

• ステータスが更新されました

設定:

• 管理者は、変更を監視するフィールド (優先度やステータスなど) を選択できます。ルールは、指定されたイベントがこのフィールドで発生するまで最大 15 分間一時停止します。

• イベントがルールの継続をトリガーするために満たす必要のある条件を定義します。利用可能な条件は次のとおりです。

  • 指定の値に等しい

  • 等しくない

  • 次のいずれかです

  • 次のいずれでもない

値を選択:

管理者はさらに、ルールの継続をトリガーするためにイベント フィールドが満たす必要のある値も指定する必要があります。

ルールの実行:

• ルールは、設定された遅延時間か、指定されたイベントが発生するまでのいずれか早い方で一時停止します。

• 設定された遅延時間内にイベントが発生しない場合、ルールは自動的に再開しますが、まれにわずかな遅延が発生します。

• イベントが発生しなくてもルールによって実行が中止されることはありません。遅延後も継続されます。

アラート データを再取得する

• スマート バリューの使用: なし

アラート データを最新のアクションで更新し、後続のアクションでアラートの最新の状態を使用できるようにします。

デフォルトでは、{{alert}} 参照値はルールの実行中には更新されず、ルールが最初にトリガーされたときと同じ値が含まれます。

このアクションはバックグラウンドで実行されます。