自動化: 基本

主要な概念

ルール

ルールによって、設定した条件に基づいてシステム内でのアクションを自動化できます。自動化ルールは 3 つの部分で構成されています。ルールを開始するトリガー、ルールを絞り込む条件、サイトでタスクを実行するアクションです。

トリガー、条件、アクションは自動化の構成要素です。これらの構成要素を組み合わせるだけで、たとえば「古い課題を自動的に閉じる」や、「リリースが出荷された際に特定のチームに通知する」などといった、あらゆることに対応できるルールを作成することが可能です。

See this rule and others in the automation template library.

トリガー

すべてのルールはトリガーで開始されます。トリガーによってルールの実行が開始されます。トリガーは、課題の作成やフィールド値の変更時など、Jira のイベントを検知します。

トリガーの実行はスケジュール設定でき、ルールに適用する前にカスタマイズが可能です。

利用可能なトリガーの一覧を見る。

条件

条件によってルールの範囲を絞り込めます。条件を継続して実行するにはルールを満たす必要があります。たとえば、優先順位が高い課題のみをエスカレートするルールを設定できます。

条件が失敗した場合、ルールの実行は中止され、条件に続くアクションは実行されません。

利用可能な条件の一覧を見る。

アクション

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

利用可能なアクションの一覧を見る。

ブランチの作成 / 関連する課題

Jira での課題は独立して存在することはほとんどありません。サブタスクを含むこともあり、より大きなエピックの一部であるストーリーでもあり、特定の関係を使用したその他の課題にリンクしていることもあります。つまり、自動化を利用する際の多くの場合で、ルールをトリガーしたソースの課題だけでなくソースの課題に関連する課題にもアクションを適用する必要があります。

複雑な課題の関係に対応できる強力なルールを作成するためには、特別な条件とアクションを活用します。たとえば、1 つの親課題のサブタスクがすべて解決済みであると確認すること、などです。

関連する課題の操作について詳細を見る。

See this rule and others in the automation template library.

スマート値

スマート値によって、サイト内の広範な課題データにアクセスして操作できます。ルールをさらに強力に、複雑なものにもできます。たとえば、スマート値 {{now.plusDays(5)}} は、当日の 5 日後を示し、{{issue.summary}} は、課題の要約を提示します。

スマート値の使用について詳細を見る。

ルールアクター

ルールアクターとは、ルールを実行するユーザーです。このユーザーは、ルールのトリガーに関連する権限を持ち、実行するアクションを完了する必要があります。たとえば、実行時に課題に関してコメントするというルールを作成する場合、ルールアクターはコメント追加の権限を持つ必要があり、その権限がない場合、ルールはエラーになります。

サイトでのルールアクターは、自動化アプリユーザーとして設定されます。

ルールのステータス

自動化ルールのステータスを表示して、ルールが現在アクティブであるかそうでないかを識別できます。ルールが非アクティブである場合、有効化されないとルールは実行されません。ルールのステータスはその詳細画面で確認できます。

• 有効ルールは現在アクティブです。
• 無効ルールは現在使用されていません。
• 下書きルールの変更が未公開です。

ルールの有効化と無効化について詳細を見る。

監査ログ

各ルールには、ルールがトリガーされた時間、実行の最終結果、実行されたすべてのアクションを確認できる監査ログがあります。

個別のルール、プロジェクト全体、または広範なレベルの監査ログを確認できます。監査ログの確認は、ルールをデバッグする効果的な方法です。

ルールの作成

次のシナリオを考えてみてください。現行では、新しいバグが報告されると、その問題をユーザーに割り当てる前に、チームがその問題に関して適切なサブタスクを手動で作成する必要があります。

このプロセスは簡単に自動化できます。簡単なルールを作成して、サブタスクを自動的に新しいバグに追加し、さらに特定のユーザーにもそれらを割り当てられます。

このルールの構築方法

1. [Automation settings (自動化設定)] に移動し、右上隅にある [Create rule (ルールを作成)] を選択します。
2. [Issue created (課題が作成された)] トリガー、[保存] の順に選択します。
3. [New condition (新規条件)]、[Issue fields condition (課題フィールド条件)] の順に選択します。
4. 条件を次のように設定します。
   フィールドを [Issue Type (課題タイプ)] に設定
   条件を [equals (イコール)] に設定
   比較する値を [Bug (バグ)] に設定
   [保存] を選択。
5. [New action (新規アクション)]、[Create sub-tasks action (サブタスクのアクションを作成)] の順に選択します。
6. アクションを次のように設定します。
   3 つのサブタスク、呼び出した Inspect コード、トラブルシューティングと解決を追加します。
   [保存] を選択します。
7. [New action (新規アクション)]、[Assign issue (課題を割り当て)] アクションの順に選択します。
8. ユーザーを選択して担当者に指定し、[保存] を選択します。
9. ルールに名前を付けて、[Turn it on (有効化)] を選択します。