Dépannage des clients des données métiers et des métadonnées
Voici des conseils pour vous aider à simplifier le débogage et le dépannage des erreurs et des exceptions d'exécution liées aux métadonnées.
Conseil 1 : comprendre le modèle de métadonnées
Vous devez lire la section Catalogue de données métiers : modèle de métadonnées et comprendre comment écrire chaque élément de métadonnées. Les rubriques répertorient également les enfants et les propriétés pris en charge, ainsi que leurs limites et les valeurs acceptées. Consultez aussi les rubriques et les commentaires de l'Exemple SQL Server 2000 AdventureWorks et les commentaires figurant dans SampleWebService, métadonnées.
Conseil 2 : utiliser des importations incrémentielles
Lorsque vous créez des métadonnées, essayez d'importer une entité à la fois, de façon à pouvoir identifier et déboguer les problèmes plus facilement.
Conseil 3 : utiliser les informations de numéro de ligne pour identifier des erreurs d'importation des métadonnées
Lorsque vous essayez d'importer des métadonnées non valides, le catalogue de données métiers affiche un message d'erreur expliquant le problème et fournit le numéro de ligne où l'erreur s'est produite. Il est utile d'ouvrir le code XML dans Microsoft Visual Studio 2005 ; utilisez la commande Aller à (menu Edition) pour trouver la ligne où l'erreur s'est produite, puis examinez les instructions XML près de cette ligne.
Conseil 4 : examiner le journal des événements du serveur et les fichiers journaux du service de journalisation unifiée (ULS) du serveur pour les erreurs du client de données métiers (exécution)
Si vous obtenez une erreur lorsque vous essayez d'utiliser un composant WebPart Données métiers, une colonne de données métiers ou le modèle objet, activez l'enregistrement des diagnostics dans l'administration centrale et vérifiez l'Observateur d'événements Windows ou les fichiers journaux du service de journalisation unifiée (ULS) du serveur. Le catalogue de données métiers écrit les messages et les exceptions d'exécution dans le journal des événements et dans les fichiers journaux du service de journalisation unifiée.
Les fichiers journaux du service de journalisation unifiée contiennent une copie des informations du journal des événements et la trace de la pile. Par conséquent, les journaux des événements peuvent être plus faciles à utiliser et à comprendre que les fichiers journaux du service de journalisation unifiée. Toutefois, si vous avez besoin des informations détaillées pour déboguer l'erreur, les fichiers journaux du service de journalisation unifiée peuvent devenir indispensables.
Le catalogue de données métiers crée un fichier journal du service de journalisation unifiée toutes les 30 minutes. Vous pouvez trouver les fichiers journaux à l'emplacement suivant : <drive>\Program Files\Common Files\Microsoft Shared\web server extensions\12\LOGS. Les fichiers journaux du service de journalisation unifiée contiennent des informations utiles sur toutes les exceptions d'exécution et peuvent vous aider à identifier les problèmes. Dans les fichiers journaux du service de journalisation unifiée, les messages sont classés par catégorie et contiennent les champs suivants :
Horodateur (Timestamp)
PID : les erreurs des clients Web apparaissent sous le PID de w3wp.exe. Les erreurs de recherche et d'importation de profil utilisateur apparaissent sous le PID de mssdmin.exe.
TID
Produit
Catégorie : (le champ Catégorie est Business Data pour les erreurs liées au catalogue de données métiers)
ID d'événement
Niveau
Message
Corrélation
Un moyen facile pour rechercher les messages liés au catalogue de données métiers consiste à rechercher « metadataexception », « ApplicationRegistry » ou « exception » dans le champ Message, puis à regarder dans la catégorie Données métiers.
Conseil 5 : consulter la documentation sur les messages d'erreur dans le Kit de développement (SDK)
Voir Avertissements et messages d'erreur