Jira Automation のアクション

アクションによってルールが実際に実行されます。これによって、タスクを自動化してサイト内に変更を加えられます。また、課題の編集、通知の送信、サブタスクの作成など、多数のタスクも実行できます。

Jira Automation テンプレート ライブラリで、これらすべてのアクションの使用方法をご確認ください。

課題の割り当て

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

  • 必要な権限: 課題の割り当て、割り当て可能なユーザー

課題をユーザーに割り当てます。

課題の割り当てには以下の 8 個のオプションを使用できます。

  • 定義済みリストのユーザー: JQL で指定され制限をパスした課題は、ユーザーが選択した方法で、指定リストに掲載されているユーザーに割り当てられます。以下は選択可能なメソッドの例です。

    • バランスのとれたワークロード: リストの各ユーザーに同じ数の課題を割り当てます。これらの課題のスコープは JQL によって定義されます。

    • ランダム: ユーザーのリストからランダムに割り当てます。

    • ラウンドロビン: 指定ユーザー リスト内の順番に基づき課題を割り当てます。

  • 別のフィールド値またはコメント: 課題またはコメントのユーザー フィールドの値に基づき課題を割り当てます。たとえば、課題履歴に基づき前担当者に割り当てたり、作成者に割り当てたりします。除外するユーザーを指定する場合やユーザーが必ず含まれる必要のあるグループを指定する場合、この要件に一致しないユーザーはスキップされ、アクションは一致するユーザーを探し続けます (担当者の課題履歴をさらに遡るなど)。

  • 自動的: プロジェクトのデフォルトの担当者に課題を割り当てます。

  • 他の課題からコピー: 関連する課題から担当者をコピーします。JQL を使って課題を見つけて、そこから担当者をコピーすることもできます。

  • スマート バリュー: スマート バリューに基づいて課題を割り当てます。たとえば、課題のコメントが付けられた際、そのコメントの作成者に課題を割り当てられます。ユーザー スマート バリューの詳細をご確認ください。

  • ユーザー指定: 指定したユーザーに割り当てます。

  • 未割り当て: 既存のユーザーを削除して、課題を「未割り当て」に設定します。

  • イベントのトリガー実行者: イベントをトリガーしたユーザーに課題を割り当てます。

  • ロールのユーザー: チーム内の特定のロールに課題を割り当てます。

  • グループのユーザー: 選択したグループに属するユーザーに課題を割り当てます。

  • オンコール担当者: チームの Opsgenie オンコール スケジュールに基づいて、オンコールのユーザーに課題を割り当てます。

課題の割り当てアクションを含む自動化ルール

フォームを添付する

フォーム関連のコンポーネントはプロジェクト固有なので、グローバル自動化では設定できないことに注意してください。フォーム コンポーネントはプロジェクト自動化でのみ使用できます。

課題に 1 つ以上のフォームを添付します。このフォームの可視性も設定できます。課題ビューにおけるフォームの動作に関する詳細についてご確認ください。

フォームの添付アクションを含む自動化ルール

課題のクローンを作成する

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

同じプロジェクトまたは選択したプロジェクト内の課題を重複作成します。

このアクションは、プロジェクト間で課題を移動する際の次善策の一環として使用できます。

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

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

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

[その他のオプション] を選択して、高度なフィールド編集を行うための追加のフィールドを表示します。

このアクションでは、課題のリンクまたはコメントは複製されません。

課題の複製アクションを含む自動化ルール

課題にコメントする

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

課題にコメントを追加します。

スマート バリューを使用して課題フィールドを参照し、コメントをパーソナライズできます。コメントの公開範囲も設定できます。

"課題にコメント" アクションを含む自動化ルール

フォームをコピーする

フォーム関連のコンポーネントはプロジェクト固有なので、グローバル自動化では設定できないことに注意してください。フォーム コンポーネントはプロジェクト自動化でのみ使用できます。

1 つの課題から 1 つ以上のフォームを現在の課題にコピーします。

"フォームをコピー" アクションを含む自動化ルール

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

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

  • ブランチを Bitbucket で作成

  • ブランチを GitHub で作成

  • ブランチを GitLab で作成

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

また、スマート値によってこれらのブランチに関連する情報にアクセスできます。作成済みブランチのスマート値に関する詳細についてご確認ください。

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

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

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

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

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

  • 末尾が .lock

  • スペースを含む名前

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

Confluence ページを作成する

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

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

Jira プロジェクトと Confluence 間の接続が必要です。Confluence での Jira Automation の利用に関する詳細をご確認ください

課題の作成

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

  • 必要な権限: プロジェクトの参照、課題の作成

任意のタイプの課題を作成してプロジェクトに追加します。設定するフィールドを選択して、その値を設定できます。サポートされる課題フィールドのリストから [添付ファイル] フィールドを選択して、添付ファイルのコピー元となるソース課題を選択することで、添付ファイルをコピーできます。

[その他のオプション] を選択して、高度なフィールド編集を行うための追加のフィールドを表示します。

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

グローバル ルールで [プロジェクト] > [トリガーと同じプロジェクト] を使用する場合は注意が必要です。プロジェクトのタイプはルールが実行されるまで不明なため、すべての課題のタイプを構成できます。そのため、プロジェクトに存在しない課題のタイプも選択できます。

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

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

「ルックアップテーブルを作成」アクションの画像。定義されているキーは、HR、IT、Ops、RandD とそれに対応する値です。

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

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

 

ユース ケースの例

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

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

「ルックアップ テーブルを作成」アクションの画像では、キーは異なる優先度名 (最低から最高) を表しています。

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

「課題を編集」アクションの画像。[期限] フィールドには、スマート値 {{dueDates.get(issue.Priority)}} が含まれます。

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

サブタスクの作成

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

課題のサブタスクを作成します。

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

[フィールドを追加] を選択すると [サブタスクを作成] アクションは [課題を作成] (課題タイプ: サブタスク) アクションに変換されて、追加フィールドを設定できるようになります。

スプリントの作成

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

  • Jira 専用です。 

選択したソフトウェアプロジェクトボードでスプリントを作成します。

  • 企業管理対象プロジェクトでは、ボードがスクラム ボードである必要があります。

  • チーム管理対象プロジェクトでは、ボードでスプリント機能が有効になっている必要があります。

また、開始日、終了日、目標に特定の値を入力できます。開始日と終了日では、日時のスマート バリューを使用すると便利な場合があります。たとえば、開始日として {{now}} を、終了日として {{now.plusweeks(2)}} を設定できます。日時のスマート バリューに関する詳細についてご確認ください

注意事項:

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

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

変数の作成

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

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

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

コメントの削除

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

課題のコメントを削除するために使用できます。このアクションを使用するには、次の 2 つの方法があります。

  • トリガー コメントの削除: コメントの追加を含むトリガーがルールで使用されている場合は ([コメントされた課題]、[トランジションされた課題]、[アップデートされた課題] など)、{{comment.id}} がそのコメントを削除します。

  • 他のコメントを削除する: {{issue.comment.first.id}} などのコメント スマート値によって、アクティブな課題のコメントを削除します。

課題を削除する

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

コンテキストにある現在の課題を削除します。

このアクションを使用すると、プロジェクト間での課題の移動を自動化する場合などに不要な課題をサイトから削除できます。

コンテキストにある現在の課題を削除します。このアクションは、プロジェクト間での課題の移動を自動化する場合などで、不要な課題を Jira から削除するのに最適です。

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

この操作では現在課題にある任意の課題リンクを削除できます。特定のタイプにおけるすべての課題リンクを削除するか (たとえば、すべての「ブロックされた」課題を削除するなど)、特定の課題を選択してリンクを解除できます。

コメントを編集する

  • スマートの使用: あり

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

  • 最初のコメント: 課題に関する最初のコメントを編集します。

  • 最後のコメント: 課題に関する最新のコメントを編集します。

  • トリガー コメント: ルールをトリガーしたコメントを編集します。コメントされた課題編集された課題のコメントといったトリガーで使用されます。自動化トリガーの詳細をご確認ください

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

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

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

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

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

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

課題の編集

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

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

一部の値は動的なものに設定できます。サポートされる課題フィールドのリストから [添付ファイル] フィールドを選択して、添付ファイルのコピー元となるソース課題を選択することで、添付ファイルもコピーできます。[その他のオプション] を選択して、高度なフィールド編集を行うための追加のフィールドを表示します。

オブジェクトを編集する

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

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

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

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

このアクションは、次の場合にのみ使用できます。

  • グローバル自動化ルールに対して、オブジェクトがルールのフォーカスになっている場合。たとえば、ルールがオブジェクト トリガーで始まる場合、ルールをトリガーしたオブジェクトが、このアクションによって編集されるオブジェクトになります。

  • AQL ブランチのブランチの下にある場合。単体では機能せず、[オブジェクトを検索] アクションと一緒には機能しません。

リクエスト タイプの編集

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

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

課題のリクエスト タイプをアップデートします。リクエスト タイプは課題タイプに基づいていることにご注意ください。複数のリクエスト タイプが 1 つの課題タイプに対応している場合もあります。ただし、自動化ルールが課題に作用する場合は、選択したリクエスト タイプがその課題タイプに対応している必要があります。そうでない場合は、アクションが実行されると監査ログでエラーが検出されます。

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

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

トリガーとなる脆弱性を課題にリンクします。

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

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

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

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

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

  2. 「課題を脆弱性にリンクする」アクションのドロップダウン メニューに、課題キーを入力します。

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

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

リンクのタイプとリンクする課題を選択して、別の課題とリンクします。

ルールをトリガーする課題、関連する課題ブランチにある現在の課題、スマート バリュー、または課題キーにリンクできます。

ログ

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

課題に対する時間を記録します

開始日を動的に設定するには日付と時間のスマート バリューを、そして説明をカスタマイズするにはテキストのスマート バリューを使用できます。

課題のルックアップ

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

JQL クエリを使用して最大 100 件の課題を検索します。{{lookupIssues}} スマート バリューを使用することで、他のアクションに結果リストを含めます。課題リストでスマート バリューを使用する方法の詳細をご確認ください。

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

1 2 3 {{#lookupIssues}} * {{key}} {{/}}

以下の例では、課題リストのすべてのストーリー ポイントを集計しています。

1 There are {{lookupIssues.Story Points.sum}} story points remaining.

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

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

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

アセット AQL クエリで最大 100 個のオブジェクトを検索します。Jira Service Management のアセットに関する詳細をご確認ください

{{lookupObjects}} スマート値によってオブジェクトの結果リストを他のアクションに渡します。これはオブジェクトのリストにアクセスして印刷するために使用できますが、他のルールのトリガーには使用できません。JSM アセットのスマート値に関する詳細についてご確認ください

ウォッチャーの管理

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

課題に/からウォッチャーを追加/削除します。

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

課題のトランジション

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

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

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

  • 課題からコピー: 関連課題やブランチ ルールの課題からステータスをコピーします。

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

  • エピックからコピー: 課題に関連するエピックからステータスをコピーします。

  • トリガー課題からコピー: ルールをトリガーした課題からステータスをコピーします。

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

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

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

メールを送信

「返信先」のアドレスを変更する

2021 年 6 月 28 日から、[返信先] フィールドにリストされた最初のメールのみが返信メールを受信します。これは次のことを意味します。

  • [メールを送信] アクションを持つ新しい自動化ルールでは、[返信先] フィールドにアドレスを 1 つだけ入力することをお勧めします。

  • [メールを送信] アクションを使用する既存のルールについては、[返信先] フィールドで 1 つのアドレスだけが使用されるようにルールを再構成することをお勧めします。

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

メールを送信します。 このアクションのすべてのフィールドで、スマート バリューを使ったカスタマイズがサポートされています。

[宛先] フィールドから [参加しているすべての顧客] を選択すると、報告者、リクエスト参加者、課題に組織が追加された顧客、課題通知を購読している顧客に、メールが送信されるようになります。Jira Service Management の顧客と組織に関する詳細についてご確認ください。

このアクションで送信できるメールの数には制限があることにご注意ください。Automation サービスの制限に関する詳細についてご確認ください

このアクションでは、メールのメッセージ ID が監査ログに自動的に記録されます。メールを追跡する必要がある場合は、<message-id>@automation.atlassian.com の形式で記録された情報を使用してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Web リクエストを送信

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

この機能を使用するには、ネットワークでアトラシアンからのリクエストを許可する必要があります。発信接続については、「アトラシアンのクラウド製品の IP アドレスとドメイン」をご覧ください。

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

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

データ形式

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

非表示の値

ウェブ・リクエストを設定する際、特定の値を非表示にして安全性を高めることもできます。値が非表示としてマークされ、ルールが保存されると、値はアスタリスク(つまり、*****)に置き換えられます。値が表示されなくなるため、ペイロードを検査することもできなくなります。一度値を非表示にすると、元に戻すことはできません(つまり、[非表示] チェックボックスを選択解除することはできません)。ただし、ルールを編集する際に値自体を変更することはできます。

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

その他の注意点

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

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

サービス プロジェクト カスタマーを追加する

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

Jira Service Management のプロジェクトに新しい顧客を追加します。

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

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

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

この課題がルールに影響する場合、課題データの再取得アクションを何回かサービス プロジェクト顧客を追加アクションの直前に加えて、ルールの実行を遅らせることができます。ただし、この方法がうまくいかないケースもあります。

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

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

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

このアクションを現在のワークフロー ステータスで承認が保留されている Jira Service Management の課題に使用できます。承認はワークフロー経由で管理されます。Jira Service Management での承認の詳細をご確認ください

リクエスト タイプを使用して課題を作成する

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

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

このアクションでは、サービス プロジェクトに追加したすべてのリクエスト タイプを使用できます。リクエスト タイプをポータル グループに整理する方法をご確認ください

[課題を作成] アクションと同様に、このアクションではスマート値を使用して任意のフィールドを設定できます。

インシデントを作成

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

  • 必要な権限: プロジェクトの参照、課題の作成

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

アクションによってプロジェクト内に同じタイプの未解決のインシデントがすでに作成されている場合は、新しいインシデントが作成されないようにすることもできます。

このアクションを使用するには、サービス プロジェクトインシデントのリクエスト タイプが必要です。

バージョンの作成

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

課題を割り当てられる新しいバージョンを作成します。

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

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

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

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

デフォルトでは、このアクションによって、次回リリース予定のバージョンのプロジェクトは既存のリリース日にリリースされます。これは、「リリース」で設定されたバージョンの順序に基づいて決定されます。

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

添付ファイルを削除する

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

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

ログ アクション

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

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

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

課題データを再取得する

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

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

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

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

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

ルール実行のトリガー課題に関連する課題、プロジェクト、ユーザーにエンティティのプロパティを設定します。

これらの非表示のプロパティは、特定の機能でアプリに使用されます。エンティティのプロパティでは、プラグインから課題とプロジェクトにキー/値ストアを追加できます。これらの値は、REST API または JQL を使ってインデックス化してクエリを実行できます。

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

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

選択したプロジェクトのリリース済みバージョンのリリースを元に戻します。初期設定ではこれはルールのプロジェクトですが、[その他のオプション] を選択して、異なるプロジェクトを選択できます。

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

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

このアクションを実行すると、選択した Amazon Simple Notification Service トピックに JSON メッセージが送信されます。最大 10 件のキーと値のペアをアクションに追加できます。さらに追加する場合は、サポートにお問い合わせください

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

Amazon SNS トピックで Atlassian Automation によるメッセージの公開が許可されていることを確認してください。Amazon SNS の設定の詳細をご確認ください

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

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

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

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

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションによって、AWS SSM からレスポンスを受信するまでルールを一時停止できます。有効にすると、AWS SSM が指定された時間 (最大 15 分) 以内に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開: AWS SSM が指定された時間内に失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開する: AWS SSM が指定された時間内に応答を返さない場合でも、ルールは再開されます。

AWS SSM からペイロードにアクセスするには、{{awsSsm.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{awsSsm.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

仮想マシンを Azure で再起動

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

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

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

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションにより、Azure 仮想マシンから応答を受信するまでルールを一時停止できます。有効にすると、Azure 仮想マシンが指定された時間 (最大 15 分) 内に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答がないと再開する: Azure Virtual Machine が指定された時間内に応答を返さない場合、ルールは再開されます。

応答のステータスを判断するには、スマート値 {{azureVm.status}}を使用できます。応答が受信されない場合、値は空になります。

Azure でランブックを開始

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

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

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

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションによって、Azure から応答を受信するまでルールを一時停止できます。有効にすると、Azure が指定された時間内 (最大 15 分) に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答が失敗したら再開する: 指定された時間内に Azure が失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開する: 指定された時間内に Azure が応答を返さない場合でも、ルールは再開されます。

Azure からペイロードにアクセスするには、{{azureRunbook.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{azureRunbook.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

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

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

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

チャンネルを作成するための Slack ワークスペースを選択したり、プレーン テキストとスマート バリューを使用してチャンネルの名前と説明をカスタマイズしたり、チャンネルに追加するチーム メンバーを選択したりできます。既定では、チャンネルの名前と説明は、ルールをトリガーするインシデントのキー、要約、URLになります。

このアクションの実行は、リクエスト タイプがインシデントである課題に対してのみ成功します。リクエスト タイプを作成する方法

はじめに、Slack ワークスペースを Jira Service Management のサイトやプロジェクトに接続してください。Slack をJira Service Management に接続する方法を確認する

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

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

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

チャットやミーティングを作成するための Microsoft テナントを選択したり、プレーン テキストとスマート値を使用して名前と説明をカスタマイズしたり、追加するチーム メンバーを選択したりできます。既定では、チャットまたはミーティングの名前と説明は、ルールをトリガーするインシデントのキー、要約、URL になります。

このアクションの実行は、リクエスト タイプがインシデントである課題に対してのみ成功します。リクエスト タイプの作成に関する詳細をご確認ください

はじめに、Microsoft テナントを Jira Service Management のサイトやプロジェクトに接続してください。Microsoft Teams を Jira Service Management に接続する方法をご確認ください

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

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

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

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

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションによって、JEC から応答を受信するまでルールを一時停止できます。有効にすると、JEC が指定された時間内(最大 15 分)に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開:JEC が指定された時間内に失敗した応答を返した場合でも、ルールを再開します。

  • 応答がないと再開: JEC が指定された時間内に応答を返さなくても、ルールは再開されます。

JEC からペイロードにアクセスするには、{{jecAction.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{jecAction.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

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

このアクションは、Jira Service Management の Premium と Enterprise の各プランでのみ利用できます。

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

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

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

このアクションは、Jira Service Management の Premium と Enterprise の各プランでのみ利用できます。

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

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

このアクションは、Enterprise プランでのみ応答待ちをサポートします。

このアクションにより、Ansible から応答を受信するまでルールを一時停止できます。有効にすると、Ansible が指定された時間 (最大 15 分) 以内に成功の応答を返した場合にのみ、ルールが再開されます。この時間内に成功の応答が受信されない場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開: Ansible が指定された時間内に失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開: Ansible が指定された時間内に応答を返さない場合でも、ルールは再開されます。

Ansible からペイロードにアクセスするには、{{ansibleJobTemplate.output}} スマート値 を使用します。

応答のステータスを確認するには、スマート値 {{ansibleJobTemplate.status}}を使用すると「成功」または「失敗」のいずれかが表示されます。応答が受信されない場合、値は空になります。

 

New Relic でクエリを実行する

このアクションは、Jira Service Management の Premium と Enterprise の各プランでのみ利用できます。

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

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

このアクションは応答待ちをサポートします

New Relic では、このオプションは既定で有効になっているため、New Relic が 15 分以内に正常な応答を返した場合にのみルールが再開されます。それ以外の場合、ルールは失敗します。

さらに、次の場合にルールが再開されるように設定できます。

  • 応答失敗時に再開: New Relic が指定された時間内に失敗した応答を返した場合でも、ルールは再開されます。

  • 応答がないと再開する: New Relic が指定された時間内に応答を返さない場合、ルールは再開されます。

New Relic からペイロードにアクセスするには、{{newRelicQuery.results}} スマート値を使用します。

遅延

このアクションは、すべての Premium プランと Enterprise プランでのみ利用できます。

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

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

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

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

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

このアクションは、すべての Premium プランと Enterprise プランでのみ利用できます。

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

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

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

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

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

設定:

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

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

    • 指定の値に等しい

    • 等しくない

    • 次のいずれかです

    • 次のいずれでもない

値を選択:

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

ルールの実行:

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

  • イベントが 15 分以内に発生しない場合、ルールは自動的に再開されます。

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

さらにヘルプが必要ですか?

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