Jira Automation のアクション

ルールを実行するのがアクションです。アクションによってタスクを自動化すると、サイト内で変更を行えるようになり、課題の編集、通知の送信、サブタスクの作成など、数多くのタスクを実行できます。

サービス デスクの顧客の追加

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

この便利かつ簡単なアクションで、新しい顧客を Jira Service Management プロジェクトに追加できます。スマート バリューをすべてのフィールドで使用できて、既存の組織のいずれかに顧客を追加できます。

課題をアーカイブする

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

Use this action to archive the issues that you don’t need anymore. This is a great way to clean the team's board and increase Jira's performance. Archiving the issues also simplifies the management of the instance size. If you need to, Jira will notify the team about the archived issues.

課題の割り当て

• スマート バリューの使用: あり
• Rule actor permission: Assign issues and Assignable user

This action is an easy to use and customizable way of assigning issues for most scenarios. Check out this article for a more in-depth explanation of this action.

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

定義されたリストのユーザー

このオプションによって、(JQL で指定された) 制限をパスした課題は、自分が選択したメソッドで指定したリスト上のユーザーに割り当てられます。次は、選択可能なメソッドの例です。

• 均一のワークロード: リストの各ユーザーに同じ数の課題を割り当てます。
• ランダム: ユーザーのリストからランダムに割り当てる
• ラウンド ロビン - 課題をユーザー リストの順序に基づいて割り当てるため、1 人のユーザーに課題を割り当てるとリスト内の次のユーザーに移ります。

他のフィールド値またはコメント

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

自動

課題はプロジェクトの初期設定の担当者に割り当てられます。

別の課題からコピー

このオプションによって、担当者を関連する課題からコピー、または担当者をコピーする課題を見つけるために JQL を記述できます。

スマート値

Use this option to assign the issue based on a smart value using any of the user smart values. For example, when an issue is commented on, you could assign it to the author of the comment.

ユーザーを指定

このオプションによって、選択した特定のユーザーに割り当てます。

未割り当て

このオプションによって、課題を未割り当てに設定します。

イベントを起動したユーザー

このオプションによって、イベントをトリガーしたユーザーに課題を割り当てます。

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

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

Cloning an issue lets you quickly create a duplicate of an issue within the same project or a project of your choosing. This can also be used as part of a workaround for moving issues between projects.

課題を複製するために利用できる API がないため、このアクションは新しい課題を作成して、可能であるすべてのフィールド全体でコピーします。その後、対応するワークフローの最初のステップにステータスが設定されて、元の課題にあるすべての解決状況が削除されます。ただし、これは純粋な複製ではないため、複製された課題は元の課題にリンクされません。

You can also set any supported fields to a value of your choosing that will override any copied values (see Edit additional fields for help on using additional fields in the advanced section).

課題にコメントする

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

Use this to add a comment to an issue. You can use smart values to reference issue fields to personalize the message along with setting the visibility of the comment.

課題の作成

• スマート バリューの使用: あり
• Rule actor permission: Browse projects and create issues

Use this action to create an issue of any type in any project. You can select any number of fields and set their values (see Edit additional fields for help on using the additional fields in the More Options section). If you are working with sub tasks then you may find our blog post, creating sub-tasks with required fields, helpful.

サービスデスク リクエストを作成する

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

Creates a new Jira Service Management request. Just like the above Create issue action, this allows you to configure any field available using smart values.

サブタスクの作成

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

複数のサブ タスクを課題にすばやく追加する方法です。このアクションは要約の指定のみをサポートします。

変数の作成

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

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

作成後に自動化ルールで変数を使用するには、構文 {{variable_name}} を使用してください。次の例で、構文は {{Stakeholders}} になります。

バージョンの作成

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

これによって、課題を割り当てられる新しいバージョンが作成されます。同名のバージョンがすでに存在する場合は、新しいバージョンは作成されません。

添付ファイルを削除する

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

このアクションによって、添付ファイルのファイル名に基づく正規表現の一致で古い添付ファイルを削除します。

コメントの削除

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

"コメントされた課題"、"移行済みの課題"、"更新された課題" などの、コメントの追加を伴うトリガーとのみ併用できます。このアクションは、ルールをトリガーするコメントを削除します。

入力に使用できるのは {{comment.id}} のみです。

課題を削除する

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

Deletes the current issue that is in context. This is a great way to remove unwanted issues from Jira, such as in automating moving issues between projects.

課題の編集

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

Using this action you can easily edit most fields of the current issue, simply choose the field to set and add the value for it. Some of the values can be dynamic. You can also use the flexibility of additional fields in More options for those more complicated situations.

課題のリンク

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

このアクションによって、リンク タイプとリンクする課題を選択するだけで課題を簡単にリンクできます。課題ドロップダウンのオプションを使用、特定の課題のドロップダウンに課題キーを入力、詳細なユース ケースではドロップダウンにスマート バリューを入力できます。 

ログ アクション

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

This action logs something to the audit log. This is a great way to try out smart values and see what they return, and a great way to debug your rules.

ログ

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

With this action you can log time against an issue. You can use date and time smart values to help you dynamically set the date started and text smart values to customise the description.

課題のルックアップ

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

Search issues using a JQL query up to a configurable limit (100 by default). Include the results list in other actions by using the {{lookupIssues}} smart value. Learn how to configure the issue results limit

スマート値について詳しくは、次のリソースをご確認ください。

• {{LookupIssues}} スマート値で利用できるプロパティ
• 課題リストでのスマート値の使用

課題のルックアップ アクションの使用例

各課題の課題キーを箇条書き形式で表示します。

{{#lookupIssues}}
* {{key}}
{{/}}

ルックアップ アクションで見つかった課題数を表示します。

There are {{lookupIssues.size}} issues found by the lookup action.

課題リスト内のすべてのストーリー ポイントを合計します。

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

ウォッチャーの管理

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

課題が更新された時に、特定のユーザーに確実に通知したい場合があります。このアクションによって、必要に応じてウォッチャーを追加または削除できます。また、{{smart values}} をフィールドに直接入力して、追加または削除するユーザーを指定できます。

イベントを公開する

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

これによって、他のアドオンや統合がリッスンできる Jira イベント (システムまたはカスタム) を公開します。

課題データを再取得する

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

このアクションにより、スマート値が Lucene インデックスの最新の課題フィールド値で更新されます。既定では、{{issue}} 参照はルールの実行時に更新されないため、ルールが最初にトリガーされた時点の値と変わりません。なお、再取得されるのは課題フィールドのみであり、課題リンクは除外されます。

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

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

バージョンのリリースに使用します。初期設定では、これによって、次回リリース予定のバージョンのプロジェクトは既存のリリース日にリリースされます。「次のバージョン」は、ソフトウェア プロジェクトの [リリース] タブで設定した順序によって決まります。リリースする特定のバージョンを選択して、スマート値によって動的な名前を設定できます。

メールを送信

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

このアクションによって、メールを送信できます。すべてのフィールドがスマート値によるカスタマイズに対応しています。

メールの初期設定の「差出人」アドレスは、Jira の初期設定のメールです。

Hipchat メッセージを送信する

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

ルールが実行された際に、チームまたは個人に通知します。提供されたフィールドで、メッセージをカスタマイズできます。

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

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

Notify a team when the rule is run. You can personalize the message using the provided fields. Refer to how to integrate Microsoft Teams for detailed instructions.

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

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

Notify a team or an individual when the rule is run. You can personalize the message using the provided fields. Refer to how to integrate Slack for detailed instructions.

初期設定の URL を変更する

We’re validating whether the webhook URL includes this prefix: https://hooks.slack.com/. If you’d like to change this prefix, you can do it by setting the following property:

slack.notification.action.url.prefix

Stride メッセージを送信する

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

ルールが実行された際に、チームまたは個人に通知します。提供されたフィールドで、メッセージをカスタマイズできます。

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

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

多くのサービス チームは、オンコール シナリオで SMS に依存しています。このアクションによって、Twilio サービスで通知を送信できます。

発信用 Web リクエストを送信する

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

Quite often you need to integrate with other systems. This action allows you send an outgoing web request to notify another system when the rule is run, and optionally return response data that can then be used in a subsequent action. It is an extremely powerful action. Learn more about it in this blog.

You can also create and edit masked secret keys for automation rules while sending the web requests. Learn how to manage the secrets

The default request timeout for an outgoing web request is 3000 ms. You can change it by setting the following property:

outgoing.webhook.timeout.ms

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

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

これによって非表示の「エンティティ」プロパティを、ルール実行のトリガー課題に関連する課題、プロジェクト、またはユーザーに設定します。これらのプロパティはアプリで一部の機能に使用できます。エンティティのプロパティによって、プラグインでキー/値ストアを課題やプロジェクトといった Jira エンティティに追加できます。これらの値は Jira によってインデックス化して、API または JQL によってクエリできます。

サードパーティのアクション

サーバーの Automation for Jira によって、Atlassian Marketplace で他のアプリ ベンダーが提供する拡張機能が UI で自動化アクションに直接寄与できるようになります。次のアクションのサポートが必要な場合は、アクションのベンダーにお問い合わせください。

次の表には、Automation for Jira で自動化できるサードパーティのアクションが含まれています。

サード パーティのアプリはイベント処理、シリアライズ、計算されたカスタム フィールド、パフォーマンスなどで問題を引き起こす可能性があることにご注意ください。問題の原因となっているアドオンには、次のようなものがあります。

• ScriptRunner
• Jira Misc Custom Fields
• Powerscript

パフォーマンスに関する問題がある、またはルールが正しく実行されていない、またはこれらのアドオンのいずれかがインストールされている場合は、それらを無効にして問題が解決するかどうかをご確認ください。

課題のトランジション

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

このアクションは、課題をワークフローを通じて移行します。また、更新するフィールドを課題のトランジションの一部として選択できます。たとえば、次を更新できます。

• 課題からコピー - 関連する課題またはブランチ ルールの課題からステータスをコピーする必要がある際に使用します。
• 親からコピー: サブタスクと併用するために、親課題からステータスを引用します。
• エピックからコピー: 課題に関連するエピックからステータスを引用します。
• トリガー課題からコピー - このルールをトリガーした課題からステータスを取得します。ブランチで最も役立ちます。
• 同じステータス (ループ) - トランジションした課題が現在のステータスに戻ってくる際に使用します。通常、ユーザーから詳細なデータを収集するために画面と併用します (例:「エスカレート」トランジション)。