WDTF オブジェクトのログ記録
WDTF オブジェクト ログ は、WDTF オブジェクトが共通のログ ファイルにログ メッセージを自動的に書き込む WDTF の機能です。 オブジェクト ログ ファイルの名前は、TestTextLog.log と呼ばれます。 WDTF オブジェクト ログには、2 つの主な利点があります。 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" キーワード (keyword)を探して、ログの最初のエラーにジャンプします。
<OBJECT_NAME> : <TYPE> : - <METHOD_NAME>(<METHOD_PARAMS>) <Additional Info>
<OBJECT_NAME> : <TYPE> : Target: <DisplayName>
<OBJECT_NAME> : ERROR : Status: <ErrorString>
IWDTFLog2::OutputInfo メソッド、または IWDTFLog2::OutputError メソッドを呼び出して、カスタム メッセージをログ ファイルに書き込むオプションがあります。
使用可能なオブジェクトの一覧については、「WDTF オブジェクト名タグ」ご参照ください。