フィルター・アクション

フィルター・アクションには、ステップ出力からフィルター・パターンが検出されたときにとるアクションを定義します。作成するそれぞれのフィルター・パターンは、1 つのフィルター・アクションと関連付けられます。ログ・フィルターには、フィルター・アクションとフィルター・パターンの両方が定義されます。

ログ・フィルターを作成するには、「プロジェクト」 > 「ログ・フィルター」を選択します。詳しくは、ログ・フィルターを参照してください。

フィルター・アクション 定義 ステップ結果
失敗の設定 (デフォルト) フィルター・パターンが検出されると、ステップ結果状況が「失敗」に設定され、その後も引き続き、セット内のフィルター・パターンがないか現在行を検索します。 失敗
失敗/停止の設定 フィルター・パターンが検出されると、ステップ結果状況が「失敗」に設定され、セット内のフィルター・パターンを対象とした現在行の検索は停止し、次の行にスキップしてパターン検索を再開します。 失敗
失敗のクリア フィルター・パターンが検出されると、ステップ結果状況が「成功」に設定され、その後も引き続き、 セット内のフィルター・パターンがないかどうかを現在行で検索します。 成功
失敗/停止のクリア フィルター・パターンが検出されると、ステップ結果状況が「成功」に設定され、セット内のフィルター・パターンを対象とした現在行の検索は停止し、次の行にスキップしてパターン検索を再開します。 成功
停止 フィルター・パターンが検出されると、セット内のフィルター・パターンを対象とした現在行の検索が停止し、次の行にスキップしてパターン検索を再開します。ステップ結果状況は変更されません。 適用外
組み込み 「組み込み」を使用すると、あるログ・フィルター内にある 1 つ以上のログ・フィルターを参照することができます。「パターン」フィールドに、組み込むログ・フィルターを指定し、「アクション」フィールドで「組み込み」を選択します。 適用外
警告 フィルター・パターンが検出されると、ステップ結果状況が「警告」に設定され、その後も引き続き、セット内のフィルター・パターンがないか現在行を検索します。(注: 「警告」状況は成功途中の状況であるため、このステップに割り当てられたすべての成功チェーンが実行されます。) 警告
警告のクリア フィルター・パターンが検出されると、ステップ結果状況が「成功」に設定され、その後も引き続き、セット内のフィルター・パターンがないか現在行を検索します。 成功
警告/停止のクリア フィルター・パターンが検出されると、ステップ結果状況が「成功」に設定され、セット内のフィルター・パターンを対象とした現在行の検索は停止し、次の行にスキップしてパターン検索を再開します。 成功
通知チェンジャー

通知チェンジャーを使用するには、関係リストを作成するアダプターをプロジェクト内に組み込む必要があり、そのアダプター・ステップは、通知チェンジャーのログ・フィルターを含むステップの前に実行する必要があります。

アダプターの関係リストは、ユーザーとオブジェクト (変更されたファイルなど) を組み合わせてペアにします。 詳しくは、『アダプター XML 参照』を参照してください。

アダプターが実行され、関係リストが作成された後、通知チェンジャーのアクションを含むログ・フィルターがステップ出力行のフィルター・パターンと一致する場合、この行は、関係リスト内のオブジェクトとの照合を試みるために再度スキャンされます。オブジェクトの一致が見つかると、オブジェクトとペアになっているユーザーに E メール通知が送信されます。

以下のステップ出力の行の例では、 フィルター・パターン Error のオブジェクト一致は MyFile.c です。 そのため、関係リスト内で MyFile.c オブジェクトとペアになっているユーザーに、E メールのエラーの通知が送信されます。

Error: Invalid token on line 55 of MyFile.c

適用外
失敗の結果でビルドを停止 フィルター・パターンが検出されると、 ジョブ結果が「失敗」に設定され、ジョブが終了します。ステップ結果は、 その結果に応じて設定されます。それ以降のステップは実行されません。 結果
成功の結果でビルドを停止 フィルター・パターンが検出されると、 ジョブ結果が「成功」に設定され、ジョブが終了します。ステップ結果は、 その結果に応じて設定されます。それ以降のステップは実行されません。 結果
警告の結果でビルドを停止 フィルター・パターンが検出されると、 ジョブ結果が「警告」に設定され、ジョブが終了します。ステップ結果は、 その結果に応じて設定されます。それ以降のステップは実行されません。 結果

フィードバック