Jira Automation のアクション

アクションは、ルールの実行者です。作業項目の編集、通知の送信、サブタスクの作成などのタスクを自動化できます。

作業項目を割り当てる

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

• 必要な権限: 作業項目の割り当て、割り当て可能なユーザー

作業項目をユーザーに割り当てます。

作業項目の割り当て方法を設定します:

定義されたリストのユーザー – 作業項目が JQL で指定された制限を通過した場合、以下に基づいて指定されたユーザーのリストからユーザーに割り当てます。

• バランスの取れたワークロード: 各ユーザーが同数の作業項目を持ちます (スコープは JQL で定義)

• ランダム: リストからランダムに割り当てます

• ラウンドロビン: リストの順序に従って順番に割り当てます

別のフィールド値またはコメント – 作業項目のユーザー フィールド値またはコメントに関連付けられたユーザーに割り当てます。例えば、

• 作業項目の履歴に基づいて以前の担当者に割り当てる

• 作業項目を作成者に割り当てる

自動 – スペースの既定の担当者に割り当てます。

別の作業項目からコピー – 関連する作業項目から担当者をコピーします。(または JQL を使用して作業項目の条件を指定します)。

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.

ユーザーを指定 – 選択した担当者に割り当てます。

未割り当て – 既存のユーザーを削除し、作業項目を「未割り当て」に設定します。

イベントをトリガーしたユーザー – イベントをトリガーしたユーザーに割り当てます。

ロール内のユーザー – チーム内の特定のロールに割り当てます。

グループ内のユーザー – 指定されたユーザー グループ内の誰かに割り当てます。

オンコール対応者 – チームの Opsgenie オンコール スケジュールに基づいて、オンコール中のユーザーに割り当てます。スケジュールに複数のローテーションが含まれている場合、対応者はランダムに割り当てられます。

フォームを添付する

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.

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

既存の作業項目に値を含むフォームを添付して、選択したデータソースのコンテンツでフォームに入力できます。これらは、スマート値または選択肢などの事前定義された値のいずれかです。これらのフォームは、入力内容が保存された状態で作業項目に添付されますが、まだ送信されていません。

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

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

Change a form from one status to another. Read more about form statuses

作業項目複製

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

同じスペース内または選択したスペース内で作業項目の複製を作成します。

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

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

その後、対応するワークフローの最初のステップにステータスが設定され、元の作業項目にあるすべての解決が削除されます。作業項目は純粋な複製ではないため、元の作業項目には紐づけされません。

You can also set values to override any copied data in supported fields. For Jira Service Management, you set both Jira fields and Assets fields. Learn more about Assets in Jira Service Management.

Select More options to display additional fields for advanced field editing.

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

In the action, 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. If the domain matches more than one organization, any one of the organizations associated with that email domain will be selected. If the domain 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.

Comment on work item

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

作業項目にコメントを追加します。

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

フォームをコピーする

1 つ以上のフォームを他の作業項目から現在の作業項目にコピーします。

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

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

• ブランチを Bitbucket で作成

• ブランチを GitHub で作成

• ブランチを GitLab で作成

This requires setting up a connection between your automation rule and the other tool. Learn more about connections in automation.

You can also use smart values to access information related to these branches - learn more about created branch smart values.

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

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

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

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

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

• 末尾が .lock

• スペースを含む名前

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

Confluence ページを作成する

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

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

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

作業項目を作成

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

• 必要な権限: スペースの参照、作業項目の作成

スペース内で任意のタイプの作業項目を作成します。フィールドを選択して設定し、値を設定できます。添付ファイルをコピーするには、サポートされている作業項目フィールドのリストから添付ファイルフィールドを選択し、添付ファイルのコピー元となるソース作業項目を選択します。

Select More options to display additional fields for advanced field editing.

For Jira Service Management, you can set both Jira fields and Assets fields. For Jira Service Management, if the rule is triggered by an object, you can select Insert object to automatically add the triggered object via AQL. Learn more about Assets in Jira Service Management.

スペース > トリガーと同じスペースをグローバル ルールで使用する際は注意してください。スペースタイプはルールが実行されるまで不明であるため、すべての作業項目タイプを設定できます。これは、スペースに存在しない作業項目タイプを選択できることを意味します。

In the action, 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. If the domain matches more than one organization, any one of the organizations associated with that email domain will be selected. If the domain 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.

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

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

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

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

ユース ケースの例

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

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

そして、作業項目を編集アクションと {{dueDates.get(issue.Priority.name)}} スマート値を使用して、バグの緊急度に基づいて期限付きの日付を自動的に割り当てることができます。

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

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

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

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

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

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

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

この例では、いくつかのチームの Slack チャンネルと Confluence のスペース キーがあります。この情報から参照テーブルを作成できます。

キーはスペース名になり、値はスペース キーになります。ログ アクションが Development を要求する場合、そのスペースのスペース キーが提示される必要があります。上の例では DEVELOP です。

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

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

作業項目にジョーク ID が保存されていれば、作業項目からジョークを取得できます。

サブタスクの作成

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

作業項目にサブタスクを作成します。

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

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 専用です。 

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

• 企業管理スペースの場合、ボードはスクラム ボードである必要があります。

• チーム管理対象スペースの場合、ボードでスプリント機能を有効にする必要があります。

You also have the option of entering specific values for start date, end date, and goal. For start and end dates, you may find it useful to use date and time smart values. For example, you could set {{now}} as the start date, and {{now.plusweeks(2)}} as the end date. Learn more about date and time smart values.

注意事項:

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

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

変数の作成

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

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

この場合、常に文字列が返されることに注意してください。たとえば、スマート値 {{issue.watchers.distinct}} で Stakeholders という変数を作成した場合、変数はウォッチャーのリストを返しますが、リストは文字列としてレンダリングされます。

コメントの削除

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

作業項目のコメントを削除するために使用できます。このアクションを使用する方法は 2 つあります。

• トリガー コメントの削除: ルールで作業項目にコメント、作業項目の移行、作業項目の更新など、コメントの追加を含むトリガーを使用している場合、{{comment.id}} はそのコメントを削除します。

• 他のコメントの削除: {{issue.comment.first.id}} などのコメント スマート値を使用して、アクティブな作業項目のコメントを削除します。

作業項目を削除

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

現在コンテキスト内にある作業項目を削除します。

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

Delete work item links

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

このアクションを使用すると、作業項目に現在設定されている任意の作業項目リンクを削除できます。特定のタイプの作業項目リンクをすべて削除する（例：「ブロックされた」作業項目をすべて削除する）か、特定の作業項目を選択してリンクを解除できます。

コメントを編集する

• スマートの使用: あり

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

• 最初のコメント: 作業項目の最も古いコメントを編集します。

• 最新のコメント: 作業項目の最新のコメントを編集します。

• 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/キーのいずれかを入力できます。ここでフィールドを空のままにすると、オブジェクトの値がクリアされます。

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

作業項目を編集する

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

Edit the current work item by choosing the field to set and value to add. For Jira Service Management, you can edit both Jira fields and Assets fields. Learn more about Assets in Jira Service Management.

You can set some values to be dynamic. You can also 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. Select More options to display additional fields for advanced field editing.

In the action, 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. If the domain matches more than one organization, any one of the organizations associated with that email domain will be selected. If the domain 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.

オブジェクトを編集する

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

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

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

Assets attributes can have many different types of values (string, integer, user, date, reference object, etc.), so you have to get the input right here. This rule will result in an error if the value in this action doesn't match the attribute type. Learn more about Assets in Jira Service Management.

リクエスト タイプの編集

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

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

作業項目のリクエスト タイプを更新します。リクエスト タイプは作業項目タイプに基づいていることにご注意ください。1 つの作業項目タイプに対して任意の数のリクエスト タイプを対応させることができます。ただし、これは自動化ルールが作業項目に対して動作する際に、選択したリクエスト タイプがその作業項目タイプに対応している必要があることを意味します。そうでない場合、アクションによって監査ログにエラーが発生します。

作業項目をリンクする

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

作業項目を別の作業項目にリンクするには、リンクタイプとリンクする作業項目を選択します。

ルールをトリガーする作業項目、関連する作業項目ブランチの現在の作業項目、スマート値、または作業項目キーにリンクできます。

作業項目を重点分野にリンクする

必要な権限: Focus での ユーザー ロールと 作業の追加 Jira 権限

条件を満たす作業項目を重点分野にリンクします。

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

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

• 「脆弱性の検出時」トリガーとの併用時にのみ使用できます。

トリガーとなる脆弱性を作業項目にリンクします。

トリガーとなる脆弱性ごとに新しい作業項目を作成してリンクするには、次の手順に従います。

1. 「脆弱性の検出時」トリガーと「作業項目を作成」アクションを使用して、自動化を作成します。

2. 「作業項目を脆弱性にリンクする」アクションのドロップダウン メニューで、最近作成された作業項目を選択します。

トリガーとなるすべての脆弱性を 1 つの作業項目にリンクするには、次の手順に従います。

1. 「脆弱性の検出時」トリガーで自動化を作成します。

2. [作業項目を脆弱性にリンクする] アクションのドロップダウン メニューで、作業項目キーを入力します。

このアクションで作業項目キーを入力した場合、ルールの実行時に作業項目が存在しないと自動化は失敗します。

ログ

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

Logs time against a work item.

You can use date and time smart values to dynamically set the date started, and text smart values to customize the description.

作業項目を検索する

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

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.

すべてのフィールドとカスタム フィールドは、lookupIssues リストからアクセスできます。たとえば、各作業項目の作業項目キーを箇条書き形式で表示するには、次を実行します。

次の例では、作業項目リスト内のすべてのストーリー ポイントを合計します。

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

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

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

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

The results of this query can be used in other Automation actions using the {{lookupObjects}} smart value. This can be used to access and print the list of objects, but can't be used to trigger other rules. Read more about using smart values for Assets.

ウォッチャーの管理

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

作業項目のウォッチャーを追加または削除する。

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

メールを送信

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

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

Sends a branded email from a custom email address, while complying with your organization’s external user security policy. This action can be useful in scenarios like automating an email series that gets sent to a new starter as part of an onboarding workflow.

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

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

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

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

  • Selecting All customers involved in this field will send the email to the reporter, request participants, customers whose organization has been added to the work item, and customers who have subscribed to work item notification. Read about customers and organizations in Jira Service Management.

  • Note that some emails may be blocked and not sent to some recipients if your organization has policies such as filter content or external user security.

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

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

  • You can also send emails from any custom email address added at admin.atlassian.com by your organisation admins. Read how to set up custom email addresses.

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

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

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

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

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

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

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

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

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

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

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

You can personalize the message in this action. Learn more about using automation with Microsoft Teams.

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

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

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

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

You can personalize the message in this action. Learn more about using automation with Slack.

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

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

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

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

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

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

Web リクエストを送信

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

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

Global admins can also set restrictions on which domains can be used by the action - read more about adding restrictions to automation components.

データ形式

以下の 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.

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

非表示の値

Web リクエストを設定する際、特定の値を非表示にして、セキュリティを強化することもできます。値が非表示としてマークされ、ルールが保存されると、値はアスタリスク (つまり *****) に置き換えられます。表示されなくなり、ペイロードを検査することもできなくなります。この操作は元に戻すことができません（つまり、非表示チェックボックスの選択を解除することはできません）が、ルールを編集する際に値自体は変更できます。

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

その他の注意点

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

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

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

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

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

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

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

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

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

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

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

You can also 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. Select More options to display additional fields for advanced field editing.

For Jira Service Management, you can edit both Jira fields and Assets fields. Learn more about Assets in 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:

• 1 つの組織と完全に一致 – その組織が自動的に選択されます

• 複数の組織と一致 – そのメール ドメインに関連付けられた組織のいずれか 1 つが選択されます

• どこにも表示されておらず、存在しない場合は組織を作成を選択している場合 – メール ドメインを名前として使用して新しい組織が作成されます

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

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

選択したエージェントが代わって応答を生成するよう促します。セカンダリアクションと組み合わせる必要があります。このセカンダリアクションは、コメントを追加などのテキストベースの出力を持ち、応答の送信先を指定します。

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

この作業項目の説明フィールドの品質を読んでレビューしてください。

サービス スペース顧客を追加

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

Jira Service Management スペースに新しい顧客を追加します。

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

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

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

この作業項目がルールに影響する場合、[サービス スペース顧客を追加] アクションの直前に [遅延] アクションを加えて、ルールの実行を遅らせることができます。

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

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

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.

インシデントを作成

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

• 必要な権限: スペースの参照、作業項目の作成

このアクションが実行されると、選択したリクエスト タイプのインシデントが、Jira Service Management の選択したサービス スペースに作成されます。たとえば、このアクションを使用して、作業項目が作成され、特定の条件を満たした場合に新しいインシデントを作成できます。

また、アクションによって同じタイプの未解決のインシデントがスペース内にすでに作成されている場合は、新しいインシデントの作成を回避するオプションもあります。

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

バージョンの作成

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

作業項目を割り当てることができる新しいバージョンを作成します。

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

リクエスト タイプで作業項目を作成

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

選択したリクエスト タイプを使用して、Jira Service Management スペースに新しい課題を作成します。

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 プランで利用できるメジャー インシデントは例外です。

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

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

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

既定では、このアクションは既存のリリース日でスペースの次の未リリース バージョンをリリースします。これは リリース でバージョンが設定された順序によって決まります。

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

添付ファイルを削除する

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

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

ログ アクション

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

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

This action is useful when testing smart values, and debugging rules.

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

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

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

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

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

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

ルール実行のトリガー作業項目に関連する作業項目、スペース、ユーザーにエンティティプロパティを設定します。

これらの非表示プロパティは、特定の機能でアプリによって使用される場合があります。エンティティプロパティを使用すると、プラグインで作業項目やスペースにキー/値ストアを追加できます。これらの値にはインデックスが作成され、REST API または JQL を使用してクエリできます。

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

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

選択したスペースのリリース済みバージョンのリリースを取り消します。既定では、このルールのスペースになりますが、その他のオプションを選択して別のスペースを選ぶことができます。

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

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

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

You can add up to 10 key-value pairs to an action. If you’d like to add more, contact support.

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

Make sure that your Amazon SNS topic allows Atlassian Automation to publish messages. Learn more about configuring Amazon SNS.

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

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

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

Make sure that the IAM role has a Permission Policy allowing Atlassian Automation to access and run SSM documents. Learn more about configuring AWS IAM.

仮想マシンを Azure で再起動

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

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

Make sure you’ve added Email in your Microsoft Azure profile information for authentication of the rule’s connection. Learn how to add or change profile information in Microsoft Azure

Azure でランブックを開始

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

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

Make sure you’ve added Email in your Microsoft Azure profile information for authentication of the rule’s connection. Learn how to add or change profile information in Microsoft Azure.

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

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

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

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

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

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

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

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

Read more about stakeholders in Jira Service Management.

インシデント事後レビューを作成

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

インシデントのインシデント事後レビュー (PIR) を自動的に作成します。これにより、チームはインシデント解決プロセスの一環としてナレッジとフォローアップアクションを記録できます。

PIR のタイトルと説明は、スマート値を使用して定義するか、元のインシデントからフィールドを取り込むことができます。

自動化を使用しない場合、インシデント事後レビューはインシデント ビューで手動で作成する必要があります。このアクションにより、ワークフローの一部として一貫して生成されることが保証されます。

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

Read more about post-incident reviews.

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

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

インシデントの対応者がコラボレーションするための Zoom ミーティングを開始します。これは、Jira Service Management スペースのチャットおよびビデオ ツール設定で接続された Zoom アカウントを使用します。

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

ミーティングは、スペース設定で Zoom アカウントを接続したユーザーの Zoom ユーザー トークンを使用して作成されます。自動化を通じて作成されたすべてのミーティングでこのトークンが使用されます。

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.

Set channel topic for incident Slack channel

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

Sets the topic of the Slack channel linked to the incident. Use smart values to update the channel topic when an incident is created or changed, so responders and stakeholders always have a quick context of the incident.

The channel topic supports emojis in Slack message format (for example : fire :), allowing teams to visually highlight incident status or urgency.

For this action to run successfully, the Slack channel must already be linked to the incident. The related Slack workspace must be connected from Jira Service Management > Settings () Jira admin settings > Operations > Chat and video tools.

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

To get started, connect your Slack workspace with your Jira Service Management site and project. Read how to connect Slack 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.

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

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

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

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

制限と動作:

• チャットまたはミーティング名には、作業項目キーのみをスマート値として安全に使用できます。Microsoft Teams ではチャット名に特殊文字がサポートされていないため、作業項目の要約や URL を使用するとルールが失敗する可能性があります。

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

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.

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

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

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

Read how to use Jira automation with Jira Edge Connector.

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

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

When SNOOZED is selected, you get to pick a custom snooze duration (between 1 minute and 7 days) which also supports the date and time smart values.

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

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

Make sure you’ve created an application in Ansible Automation Controller, as you’ll need its token to connect it with Atlassian Automation. Read more about connecting with Ansible

New Relic でクエリを実行する

When this action is executed, the given query is run in New Relic using NRQL. You can connect with New Relic using your user key.

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

遅延

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

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

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

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

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

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

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

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

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

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

設定:

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

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

  • 指定の値に等しい

  • 等しくない

  • 次のいずれかです

  • 次のいずれでもない

値を選択:

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

ルールの実行:

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

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

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

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

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

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

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

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