Jira Automation のアクション

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

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

課題の割り当て

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

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

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

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

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

    • 均一のワークロード: リストの各ユーザーに同じ数の課題を割り当てます。

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

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

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

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

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

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

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

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

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

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

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

フォームを添付する

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

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

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

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

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

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

また、値を設定してサポートされるフィールド内のすべてのコピー データを上書きできます。Jira Service Management では、Jira フィールドと Insight フィールドの両方を設定します。Jira Service Management の Insight についてはこちらを参照してください。

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

このアクションでは課題のリンク、コメント、添付ファイルのクローンは作成されません。

課題にコメントする

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

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

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

スプリントの完了

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

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

Jira Software ボードを選択して、アクティブ スプリントを終了します。企業管理対象プロジェクトでは、ボードがスクラム ボードである必要があります。チーム管理対象プロジェクトでは、ボードでスプリント機能が有効になっている必要があります。また、グローバル ルールでは、すべてのプロジェクトの全スクラム ボードでスプリントを開始するように選択できます。

フォームをコピーする

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

課題の作成

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

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

任意のタイプのプロジェクトに課題を作成します。 設定するフィールドを選択し、その値を設定します。 

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

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

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

スプリントの作成

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

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

選択した Jira Software ボードにスプリントを作成します。企業管理対象プロジェクトでは、ボードがスクラム ボードである必要があります。チーム管理対象プロジェクトでは、ボードでスプリント機能が有効になっている必要があります。また、グローバル ルールでは、すべてのプロジェクトにある全スクラム ボードでスプリントを作成するオプションが用意されています。

また、開始日、終了日、目標に特定の値を入力できます。開始日と終了日では、日時のスマート バリューの使用が役立ちます。日時のスマート バリューに関する詳細についてご確認ください

サブタスクの作成

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

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

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

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

変数の作成

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

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

コメントの削除

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

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

  • トリガー コメントの削除: [課題のコメント時]、[課題のトランジション時]、[課題の更新時] など、コメントの追加を伴うトリガーがルールで使用されている場合は {{comment.id}} によってそのコメントを削除します。

  • 他のコメントの削除: {{issue.comment.first.id}} などのコメント スマート バリューを使用して、アクティブな課題のコメントを削除します。

課題を削除する

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

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

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

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

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

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

コメント アクションを編集する

  • スマートの使用: あり

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

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

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

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

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

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

Insight フィールド属性の編集

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

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

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

課題の編集

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

設定するフィールドと追加する値を選択して、現在の課題を編集します。Jira Service Management では、Jira フィールドと Insight フィールドの両方を編集できます。Jira Service Management の Insight についてはこちらを参照してください。

一部の値は動的なものに設定できます。[その他のオプション] を選択して、高度なフィールド編集を行うための追加のフィールドを表示します。

オブジェクトを編集する

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

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

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

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

このアクションは、グローバルな自動化ルールに対してのみ使用できます。

リクエスト タイプの編集

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

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

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

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

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

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

ログ

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

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

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

課題のルックアップ

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

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

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

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

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

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

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

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

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

Insight IQL クエリを使用して最大 100 件の課題を検索します。Jira Service Management の Insight についてはこちらを参照してください。

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

ウォッチャーの管理

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

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

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

課題のトランジション

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

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

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

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

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

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

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

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

 Jira Service Management では、Jira フィールドと Insight フィールドの両方を編集できます。Jira Service Management の Insight についてはこちらを参照してください。

メールを送信

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

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

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

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

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

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

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

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

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

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

Microsoft Teams のメッセージを送って、ルール実行時にチームに通知します

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

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

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

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

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

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

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

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

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

Web リクエストを送信

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

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

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

スプリントの開始

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

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

選択した Jira Software ボードでスプリントを開始します。企業管理対象プロジェクトでは、ボードがスクラム ボードである必要があります。チーム管理対象プロジェクトでは、ボードでスプリント機能が有効になっている必要があります。また、グローバル ルールでは、すべてのプロジェクトの全スクラム ボードでスプリントを開始するように選択できます。

開始するスプリントを選択する際は、次のオプションが用意されています。

Jira Service Management の顧客を追加する

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

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

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

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

{{customer}} スマート バリューではユーザー検索結果に表示されない既存のユーザーは返されないため、アクションを使用するとエラーが発生します。

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

Jira Service Management リクエストを作成する

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

新しい Jira Service Management リクエストを作成します。

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

バージョンの作成

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

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

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

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

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

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

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

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

添付ファイルを削除する

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

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

ログ アクション

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

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

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

課題データを再取得する

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

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

初期設定では {{issue}} 参照値はルール実行中に更新されず、ルールが最初にトリガーされた際と同じ値が含まれます。

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

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

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

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

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

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

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

その他のヘルプ