過濾器動作

過濾器動作是指每當在步驟輸出中發現過濾器型樣時,所要採取的動作。您所建立的每個過濾器型樣都與單一過濾器動作相關聯。過濾器動作和型樣都定義於日誌過濾器中。

如果要建立日誌過濾器,請選取專案 > 日誌過濾器。如需詳細資料,請參閱日誌過濾器

過濾器動作 定義 步驟結果
設定失敗(預設值) 系統找到過濾器型樣時,會將步驟結果狀態設為失敗,並繼續在目前行搜尋集合中的過濾器型樣。 失敗
設定失敗/中止 系統找到過濾器型樣時,會將步驟結果狀態設為失敗,並停止在目前行搜尋集合中的過濾器型樣,然後跳到下一行,重新開始搜尋型樣。 失敗
清除失敗 系統找到過濾器型樣時,會將步驟結果狀態設為通過,並繼續在目前行搜尋集合中的過濾器型樣。 通過
清除失敗/中止 系統找到過濾器型樣時,會將步驟結果狀態設為通過,並停止在目前行搜尋集合中的過濾器型樣,然後跳到下一行,重新開始搜尋型樣。 通過
中止 系統找到過濾器型樣時,會停止在型樣集當中尋找過濾器型樣的現行行,然後跳到下一行,重新開始搜尋型樣。它不會變更步驟結果狀態。 不適用
併入 「併入」可讓您參照其他日誌過濾器中的一或多個日誌過濾器。請在「型樣」欄位中指定您要併入的日誌過濾器,並在「動作」欄位中選取併入。 不適用
警告 系統找到過濾器型樣時,會將步驟結果狀態設為「警告」,並繼續在現行行中搜尋集合中的過濾器型樣。(附註:「警告」狀態是通過狀態;指派給此步驟的任何通過鏈都將會執行。) 警告
清除警告 系統找到過濾器型樣時,會將步驟結果狀態設為通過,並繼續在目前行搜尋集合中的過濾器型樣。 通過
清除警告/中止 系統找到過濾器型樣時,會將步驟結果狀態設為通過,並停止在目前行搜尋集合中的過濾器型樣,然後跳到下一行,重新開始搜尋型樣。 通過
通知變更器

如果要使用通知變更器,則建立關係清單的配接器必須包含在專案中,而且該配接器步驟必須在包含通知變更器日誌過濾器的步驟之前執行。

配接器關係清單是以使用者和物件(例如,變更的檔案)作為配對組合。如需詳細資料,請參閱「配接器 XML 參照」。

當配接器執行並建立關係清單之後,如果含有通知變更器動作的日誌過濾器,符合它在步驟輸出線內的過濾器型樣時,就會再次掃描該行,以尋找關係清單中相符的物件。如果找到相符的物件,則與該物件配對的使用者,就會收到電子郵件通知。

例如,在下列步驟輸出行中,符合過濾器型樣 Error 的物件是 MyFile.c。因此在關係清單中,與 MyFile.c 物件配對的使用者,就會收到有關該錯誤的電子郵件通知。

Error: Invalid token on line 55 of MyFile.c

不適用
停止「失敗」結果的建置

系統找到過濾器型樣時,會將工作結果設為失敗,並結束工作。

若為 Java 引擎專案,則步驟結果為失敗。若為 Perl 引擎專案,則會根據結果來設定步驟結果。不會執行進一步的步驟。

若為 Java 引擎專案,則步驟結果為「失敗」。若為 Perl 引擎專案,則會根據結果來設定步驟結果。
停止「通過」結果的建置 系統找到過濾器型樣時,會將工作結果設為通過,並結束工作。

若為 Java 引擎專案,則步驟結果為通過。若為 Perl 引擎專案,則會根據結果來設定步驟結果。不會執行進一步的步驟。

若為 Java 引擎專案,則步驟結果為「通過」。若為 Perl 引擎專案,則會根據結果來設定步驟結果。
停止「警告」結果的建置 系統找到過濾器型樣時,會將工作結果設為警告,並結束工作。

若為 Java 引擎專案,則步驟結果為警告。若為 Perl 引擎專案,則會根據結果來設定步驟結果。不會執行進一步的步驟。

若為 Java 引擎專案,則步驟結果為「警告」。若為 Perl 引擎專案,則會根據結果來設定步驟結果。

意見