Partager via

Journalisation des objets WDTF

  • Article

La journalisation des objets WDTF est une fonctionnalité de WDTF qui permet aux objets WDTF d’écrire automatiquement des messages de journal dans un fichier journal commun. Le nom du fichier de journalisation d’objets est appelé TestTextLog.log. La journalisation des objets WDTF présente deux avantages clés. Il simplifie la création de script de test en utilisant des méthodes d’objet WDTF pour journaliser l’appel de méthode de haut niveau, les paramètres de la méthode et le résultat de la méthode. La journalisation des objets WDTF améliore également le diagnostic en fournissant un mécanisme cohérent pour écrire des messages de journal courants.

Par défaut, la journalisation des objets WDTF est désactivée. Vous activez la journalisation des objets en appelant la méthode IWDTFConfig2::EnableObjectLogging . Après avoir activé la journalisation, vous pouvez temporairement la désactiver ou la réactiver pour des actions spécifiques ou des collections d’actions en appelant les méthodes IWDTFAction2::EnableObjectLogging, IWDTFAction2::D isableObjectLogging, IWDTFActions2::EnableObjectLogging et IWDTFActions2::D isableObjectLogging.

Les messages de journal que le WDTF écrit dans le fichier journal ont des modèles communs.

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

L’exemple suivant montre la sortie de journalisation d’un appel à DeviceDepot.Query(« Volume:: ») lorsque la journalisation est activée pour un exemple de système.

[ 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

Si la journalisation des objets est activée, la journalisation des erreurs d’objet est activée par défaut. Sinon, la journalisation des erreurs est désactivée par défaut. Comme la journalisation des objets, vous pouvez activer/désactiver la journalisation des erreurs en appelant les méthodes IWDTFConfig2::EnableObjectErrorLogging, IWDTFConfig2::D isableObjectErrorLogging, IWDTFAction2::EnableObjectErrorLogging, IWDTFAction2::D isableObjectErrorLogging, IWDTFActions2::EnableObjectErrorLogging et IWDTFActions2::D isableObjectErrorLogging.

Les messages de journal que le WDTF écrit dans le fichier journal pour la journalisation des erreurs présentent les modèles suivants. Recherchez le mot clé « ERROR » pour accéder à la première erreur dans le journal.

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

Vous avez toujours la possibilité d’écrire un message personnalisé dans le fichier journal en appelant la méthode IWDTFLog2::OutputInfo ou IWDTFLog2::OutputError .

Pour obtenir la liste des objets disponibles, consultez Balises de nom d’objet WDTF.

Balises de nom d’objet WDTF
Activation et affichage des traces WDTF