WDTF 對象 記錄 是 WDTF 中的一項功能,可讓 WDTF 物件自動將記錄訊息寫入通用記錄檔。 對象記錄檔的名稱稱為 TestTextLog.log。 WDTF 對象記錄有兩個主要優點。 它藉由使用 WDTF 物件方法來記錄高階方法呼叫、方法的參數和方法的結果,簡化測試腳本撰寫。 WDTF 對象記錄也會藉由提供一致的機制來撰寫一般記錄訊息,以改善可診斷性。
預設會停用 WDTF 對象記錄。 您可以呼叫 IWDTFConfig2::EnableObjectLogging 方法來啟用對象記錄。 啟用記錄之後,您可以透過呼叫方法IWDTFAction2::EnableObjectLogging、IWDTFAction2::DisableObjectLogging、IWDTFActions2::EnableObjectLogging和IWDTFActions2::DisableObjectLogging來暫時停用或重新啟用針對特定操作或操作集合的記錄。
WDTF 寫入記錄檔的記錄訊息具有常見的模式。
<OBJECT_NAME> : <TYPE> : - <METHOD_NAME>(<METHOD_PARAMS>) <Additional Info>
<OBJECT_NAME> : <TYPE> : Target: <DisplayName>
下列範例顯示當為範例系統啟用記錄功能時,呼叫 DeviceDepot.Query("Volume::") 的記錄輸出。
[ Output ]
WDTF_TARGETS : INFO : - Query("Volume::")
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: HL-DT-ST RW/DVD MU10N ATA Device
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: Generic volume
WDTF_TARGETS : INFO : Target: Generic volume
如果啟用物件記錄,預設會啟用物件錯誤記錄。 否則,錯誤記錄預設為停用。 如同對象記錄,您可以呼叫 IWDTFConfig2::EnableObjectErrorLogging、IWDTFConfig2::DisableObjectErrorLogging、IWDTFAction2::EnableObjectErrorLogging、IWDTFAction2::DisableObjectErrorLogging、IWDTFActions2::EnableObjectErrorLogging 和 IWDTFActions2::DisableObjectErrorLogging 方法來啟用/停用錯誤記錄。
WDTF 寫入記錄檔以進行錯誤記錄的記錄訊息具有下列模式。 尋找關鍵字 「ERROR」 以跳至記錄中的第一個錯誤。
<OBJECT_NAME> : <TYPE> : - <METHOD_NAME>(<METHOD_PARAMS>) <Additional Info>
<OBJECT_NAME> : <TYPE> : Target: <DisplayName>
<OBJECT_NAME> : ERROR : Status: <ErrorString>
您仍然可以透過呼叫 IWDTFLog2::OutputInfo 或 IWDTFLog2::OutputError 方法,將自定義訊息寫入記錄檔。
如需可用物件的清單,請參閱 WDTF 物件名稱標籤。