Compartilhar via


Registro em log do objeto WDTF

O registro em log de objetos WDTF é um recurso no WDTF que permite que objetos WDTF escrevam mensagens de log em um arquivo de log comum automaticamente. O nome do arquivo de log de objeto é chamado TestTextLog.log. O registro em log do objeto WDTF tem dois benefícios principais. Ele simplifica a criação de script de teste usando métodos de objeto WDTF para registrar em log a chamada de método de alto nível, os parâmetros do método e o resultado do método. O registro em log do objeto WDTF também melhora o diagnóstico, fornecendo um mecanismo consistente para gravar mensagens de log comuns.

Por padrão, o log de objetos WDTF está desabilitado. Você habilita o registro em log de objetos chamando o método IWDTFConfig2::EnableObjectLogging. Depois de habilitar o registro em log, você poderá desabilitá-lo temporariamente ou reabilitá-lo para ações ou coleções específicas de ações chamando os métodos IWDTFAction2::EnableObjectLogging, IWDTFAction2::DisableObjectLogging, IWDTFActions2::EnableObjectLogging e IWDTFActions2::DisableObjectLogging.

As mensagens de log que o WDTF grava no arquivo de log têm padrões comuns.

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

O exemplo a seguir mostra a saída de log de uma chamada para DeviceDepot.Query("Volume::") quando o registro em log está habilitado para um sistema de exemplo.

[ 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 o log de objetos estiver habilitado, o log de erros de objeto será habilitado por padrão. Caso contrário, o registro em log de erros usa como padrão desabilitado. Assim como o log de objetos, você pode habilitar/desabilitar o log de erros chamando os métodos IWDTFConfig2::EnableObjectErrorLogging, IWDTFConfig2::DisableObjectErrorLogging, IWDTFAction2::EnableObjectErrorLogging, IWDTFAction2::DisableObjectErrorLogging, IWDTFActions2::EnableObjectErrorLogging e IWDTFActions2::DisableObjectErrorLogging.

As mensagens de log que o WDTF grava no arquivo de log para registro de erros têm os seguintes padrões. Procure a palavra-chave "ERROR" para ir para o primeiro erro no log.

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

Você ainda tem a opção de gravar uma mensagem personalizada no arquivo de log chamando o método IWDTFLog2::OutputInfo ou IWDTFLog2::OutputError .

Para obter uma lista dos objetos disponíveis, consulte marcas de nome do objeto WDTF.

Marcas de nome do objeto WDTF
Habilitando e exibindo rastreamentos do WDTF