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