Freigeben über


WDTF-Objektprotokollierung

DIE WDTF-Objektprotokollierung ist ein Feature in WDTF, mit dem WDTF-Objekte Protokollnachrichten automatisch in eine gemeinsame Protokolldatei schreiben können. Der Name der Protokolldatei ist TestTextLog.log. Die WDTF-Objektprotokollierung bietet zwei wichtige Vorteile. Sie vereinfacht die Erstellung von Testscripts durch die Verwendung von WDTF-Objektmethoden, um den allgemeinen Methodenaufruf, die Parameter der Methode und das Ergebnis der Methode zu protokollieren. Die WDTF-Objektprotokollierung verbessert auch die Diagnosefähigkeit, indem ein konsistenter Mechanismus zum Schreiben allgemeiner Protokollnachrichten bereitgestellt wird.

Standardmäßig ist die WDTF-Objektprotokollierung deaktiviert. Sie aktivieren die Objektprotokollierung, indem Sie die IWDTFConfig2::EnableObjectLogging-Methode aufrufen. Nachdem Sie die Protokollierung aktiviert haben, können Sie sie vorübergehend für bestimmte Aktionen oder Auflistungen von Aktionen deaktivieren oder erneut aktivieren, indem Sie die Methoden IWDTFAction2::EnableObjectLogging, IWDTFAction2::D isableObjectLogging, IWDTFActions2::EnableObjectLogging und IWDTFActions2::D isableObjectLogging aufrufen.

Die Protokollmeldungen, die der WDTF in die Protokolldatei schreibt, weisen allgemeine Muster auf.

<OBJECT_NAME> : <TYPE> : - <METHOD_NAME>(<METHOD_PARAMS>) <Additional Info>
<OBJECT_NAME> : <TYPE> : Target: <DisplayName>

Das folgende Beispiel zeigt die Protokollierungsausgabe für einen Aufruf von DeviceDepot.Query("Volume::"), wenn die Protokollierung für ein Beispielsystem aktiviert ist.

[ 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

Wenn die Objektprotokollierung aktiviert ist, ist die Objektfehlerprotokollierung standardmäßig aktiviert. Andernfalls ist die Fehlerprotokollierung standardmäßig deaktiviert. Wie bei der Objektprotokollierung können Sie die Fehlerprotokollierung aktivieren/deaktivieren, indem Sie die Methoden IWDTFConfig2::EnableObjectErrorLogging, IWDTFConfig2::DisableObjectErrorLogging, IWDTFAction2::EnableObjectErrorLogging, IWDTFAction2::DisableObjectErrorLogging, IWDTFActions2::EnableObjectErrorLogging und IWDTFActions2::DisableObjectErrorLogging aufrufen.

Die Protokollmeldungen, die der WDTF in die Protokolldatei für die Fehlerprotokollierung schreibt, weisen die folgenden Muster auf. Suchen Sie nach dem Schlüsselwort "ERROR", um zum ersten Fehler im Protokoll zu springen.

<OBJECT_NAME> : <TYPE> : - <METHOD_NAME>(<METHOD_PARAMS>) <Additional Info>
<OBJECT_NAME> : <TYPE> : Target: <DisplayName>
<OBJECT_NAME> : ERROR : Status: <ErrorString>

Sie haben weiterhin die Möglichkeit, eine benutzerdefinierte Nachricht in die Protokolldatei zu schreiben, indem Sie die IWDTFLog2::OutputInfo - oder IWDTFLog2::OutputError-Methode aufrufen.

Eine Liste der verfügbaren Objekte finden Sie unter WDTF Object Name Tags.

WDTF-Objektnamentags
Aktivieren und Anzeigen von WDTF-Ablaufverfolgungen