Freigeben über

WDTF-Objektprotokollierung

  • Artikel

DIE WDTF-Objektprotokollierung ist ein Feature in WDTF, mit dem WDTF-Objekte automatisch Protokollnachrichten in eine allgemeine Protokolldatei schreiben können. Der Name der Objektprotokollierungsdatei heißt TestTextLog.log. Die WDTF-Objektprotokollierung bietet zwei wichtige Vorteile. Es vereinfacht die Testskripterstellung mithilfe 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 sie einen konsistenten Mechanismus zum Schreiben allgemeiner Protokollnachrichten bereitstellt.

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 für bestimmte Aktionen oder Aktionssammlungen vorübergehend 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 aufrufen. IWDTFConfig2::D isableObjectErrorLogging, IWDTFAction2::EnableObjectErrorLogging, IWDTFAction2::D isableObjectErrorLogging, IWDTFActions2::EnableObjectErrorLogging und IWDTFActions2::D isableObjectErrorLogging.

Die Protokollmeldungen, die der WDTF für die Fehlerprotokollierung in die Protokolldatei schreibt, weisen die folgenden Muster auf. Suchen Sie nach dem Schlüsselwort (keyword) "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-Objektnametags.

WDTF-Objektnametags
Aktivieren und Anzeigen von WDTF-Ablaufverfolgungen