Partager via

Configurer la journalisation améliorée des diagnostics pour les contrôles hébergés personnalisés

  • Article

 

Unified Service Desk vous permet de configurer la journalisation des diagnostics pour enregistrer les événements et les erreurs opérationnelles de l'application cliente dans un fichier journal, qui peut ensuite être utilisé pour identifier et résoudre les problèmes de performances ou les erreurs. Pour plus d'informations sur la journalisation des diagnostics, voir TechNet : Configurer la journalisation des diagnostics clients dans Unified Service Desk.

Avec la version 2.2.1 d'Unified Service Desk, la journalisation des diagnostics pour les types de contrôles hébergés prédéfinis a été améliorée pour fournir des informations complètes sur une exception ou une erreur, comme la source où l'erreur s'est produite (nom du contrôle hébergé, type de contrôle hébergé, ID de session) et des informations détaillées sur l'erreur et la trace de la pile. Les informations de diagnostics détaillées permettent d'identifier et de résoudre rapidement les problèmes dans Unified Service Desk.

Vous pouvez utiliser les mêmes fonctionnalités améliorées de journalisation des diagnostics disponibles dans les contrôles hébergés prédéfinis pour vos contrôles personnalisés en utilisant la LogException Method dans votre code de contrôle personnalisé pour fournir des informations détaillées sur l'exception (si elle se produit) afin d'identifier plus facilement si le problème provient de votre code personnalisé ou d'un autre contrôle dans Unified Service Desk.

La LogException Method est surchargée, et utilise en interne DynamicsLogger pour fournir des informations de diagnostics détaillées pour les exceptions de votre contrôle personnalisé. Utilisez l'une des deux signatures suivantes pour utiliser cette méthode :

  • Passez l'objet d'exception et le type d'événement à l'origine du suivi (facultatif). Si vous ne spécifiez pas le type d'événement, le type d'événement de suivi Error par défaut est passé :

    LogException(Exception ex, TraceEventType eventType = TraceEventType.Error);

  • Passez la valeur de chaîne pour le message d'erreur personnalisé, le type d'événement à l'origine du suivi et l'objet d'exception :

    LogException(string errorMessage, TraceEventType eventType, Exception ex);

Voici un exemple d'informations de diagnostics résultant de l'utilisation de la LogException Method, où des informations détaillées sur la source (ID de session, nom et type de contrôle hébergé) et les détails de l'exception sont enregistrées :

Exception raised in :  Session ID : d14893b0-6859-4827-9ddc-949d3fd36854 - Application : DemoControl - USD Component Type : USDHostedControl - Hosting Type : USD Hosted Control - Display Group : MainPanel - 
Exception details: 
Source: DemoControl
Target: Void ThrowAndLogException_Click(System.Object, System.Windows.RoutedEventArgs)
Exception: SampleLogException
StackTrace:   at DemoControl.USDControl.ThrowAndLogException_Click(Object sender, RoutedEventArgs e

Voir aussi

TechNet : Configurer la journalisation des diagnostics clients dans Unified Service Desk
Contrôles hébergés du Centre de services unifié
Guide pas-à-pas : Créer un contrôle hébergé personnalisé pour Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Tous droits réservés. Copyright