Registrazione oggetti WDTF

  • Articolo

La registrazione degli oggetti WDTF è una funzionalità in WDTF che consente agli oggetti WDTF di scrivere automaticamente i messaggi di log in un file di log comune. Il nome del file di registrazione dell'oggetto è denominato TestTextLog.log. La registrazione di oggetti WDTF offre due vantaggi chiave. Semplifica la creazione di script di test usando i metodi oggetto WDTF per registrare la chiamata al metodo di alto livello, i parametri del metodo e il risultato del metodo. La registrazione di oggetti WDTF migliora anche la diagnosability fornendo un meccanismo coerente per la scrittura di messaggi di log comuni.

Per impostazione predefinita, la registrazione degli oggetti WDTF è disabilitata. È possibile abilitare la registrazione degli oggetti chiamando il metodo IWDTFConfig2::EnableObjectLogging . Dopo aver abilitato la registrazione, è possibile disabilitarlo temporaneamente o riabilitarlo per azioni o raccolte specifiche chiamando i metodi IWDTFAction2::EnableObjectLogging, IWDTFAction2::D isableObjectLogging, IWDTFActions2::EnableObjectLogging e IWDTFActions2::D isableObjectLogging.

I messaggi di log scritti dal WDTF nel file di log hanno modelli comuni.

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

Nell'esempio seguente viene illustrato l'output della registrazione per una chiamata a DeviceDepot.Query("Volume::") quando la registrazione è abilitata per un sistema di esempio.

[ 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

Se la registrazione degli oggetti è abilitata, la registrazione degli errori dell'oggetto è abilitata per impostazione predefinita. In caso contrario, la registrazione degli errori viene predefinita disabilitata. Come la registrazione degli oggetti, è possibile abilitare/disabilitare la registrazione degli errori chiamando i metodi IWDTFConfig2::EnableObjectErrorLogging, IWDTFConfig2::D isableObjectErrorLogging, IWDTFAction2::EnableObjectErrorLogging, IWDTFAction2::D isableObjectErrorLogging, IWDTFActions2::EnableObjectErrorLogging e IWDTFActions2::D isableObjectErrorLogging.

I messaggi di log scritti dal WDTF nel file di log per la registrazione degli errori hanno i modelli seguenti. Cercare la parola chiave "ERROR" per passare al primo errore nel log.

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

È comunque possibile scrivere un messaggio personalizzato nel file di log chiamando il metodo IWDTFLog2::OutputInfo o IWDTFLog2::OutputError.

Per un elenco degli oggetti disponibili, vedere Tag nome oggetto WDTF.

Tag di nome oggetto WDTF
Abilitazione e visualizzazione di tracce WDTF