Modèle BDC : FAQ
Cette rubrique répond aux questions fréquemment posées sur le modèle BDC.
Dernière modification : vendredi 16 juillet 2010
S’applique à : SharePoint Server 2010
Dans cet article
Pourquoi l’opération de mise à jour échoue-t-elle avec l’erreur « Le champ "CustomerId" est fourni comme entrée mais est introuvable sur la signature de méthode "Updater" pour la méthode "UpdateCustomer" sur l’entité (type de contenu externe) "Customer" dans l’espace de noms "WestCoastSales" » ? Les opérations de création et de suppression fonctionnent normalement.
Je viens de créer un modèle BDC pour les services Web hébergés sur les services IIS (Internet Information Services), et seule l’authentification de base est activée. Lorsque j’essaie d’accéder à WSDL pour ce service Web par l’intermédiaire d’un navigateur, un formulaire apparaît me demandant un nom d’utilisateur et un mot de passe. Dans ce cas, comment puis-je passer les informations d’identification de manière sécurisée pour pouvoir importer le modèle BDC dans SharePoint ?
Comment puis-je voir les demandes et les réponses SOAP entre le BDC sur un ordinateur et les services Web sur un autre ordinateur ?
Pourquoi d’autres personnes ne peuvent-elles pas afficher ma liste externe ? Au lieu de cela, elles obtiennent l’erreur suivante : « Impossible d’afficher ce composant WebPart. Pour résoudre le problème, ouvrez cette page Web dans un éditeur HTML compatible avec Microsoft SharePoint Foundation tel que Microsoft SharePoint Designer. Si le problème persiste, contactez l’administrateur du serveur Web. »
Comment dois-je nommer un fichier de modèle BDC ?
Pourquoi l’opération de mise à jour échoue-t-elle avec l’erreur « Le champ "CustomerId" est fourni comme entrée mais est introuvable sur la signature de méthode "Updater" pour la méthode "UpdateCustomer" sur l’entité (type de contenu externe) "Customer" dans l’espace de noms "WestCoastSales" » ? Les opérations de création et de suppression fonctionnent normalement.
Vous rencontrez ce problème car, même si votre identificateur n’est pas marqué comme étant en lecture seule, votre méthode Update ne peut pas mettre à jour la valeur de l’identificateur.
Si votre identificateur doit être en lecture seule, résolvez ce problème en affectant à tous les éléments TypeDescriptor qui correspondent à l’identificateur dans les paramètres de sortie la valeur ReadOnly = "true".
Notes
Votre identificateur reste en lecture seule lorsque l’élément est créé et peut être défini par l’utilisateur, mais il ne peut pas être modifié une fois créé.
Si votre identificateur est en lecture seule, cette erreur peut être due au fait que les API de votre système externe sont incorrectes. Ceci peut signifier :
que la méthode Update ne peut pas mettre à jour cet identificateur spécifique ;
que votre modèle est incorrect, car l’identificateur est incorrectement spécifié ;
qu’il y a plusieurs jeux d’identificateurs dans votre entité et que chaque jeu peut identifier distinctement un EntityInstance, ce qui n’est pas pris en charge.
Notes
Pour que l’identificateur puisse être mis à jour, le système externe doit obtenir la valeur précédente et la nouvelle valeur de l’identificateur dans la signature de méthode.
Je viens de créer un modèle BDC pour les services Web hébergés sur les services IIS (Internet Information Services), et seule l’authentification de base est activée. Lorsque j’essaie d’accéder à WSDL pour ce service Web par l’intermédiaire d’un navigateur, un formulaire apparaît me demandant un nom d’utilisateur et un mot de passe. Dans ce cas, comment puis-je passer les informations d’identification de manière sécurisée pour pouvoir importer le modèle BDC dans SharePoint ?
Vous pouvez utiliser la Banque d’informations sécurisée pour passer les informations d’identification. Définissez le mode d’informations d’identification Credentials dans le modèle BDC et renseignez l’identificateur ou le mot de passe de l’utilisateur dans la Banque d’informations sécurisée pour l’application cible correspondante.
Comment puis-je voir les demandes et les réponses SOAP entre le BDC sur un ordinateur et les services Web sur un autre ordinateur ?
WCF (Windows Communication Foundation) propose à cet effet sa propre infrastructure pour les messages de journal et les activités de suivi. Vous êtes probablement intéressé par la journalisation de messages, et non le suivi d’activités. Vous pouvez configurer la journalisation en modifiant le fichier web.config. Pour plus d’informations, voir Configuration de la journalisation de messages.
Notes
Vous pouvez configurer la journalisation de messages côté client (réponse SOAP) en modifiant le fichier web.config pour la liaison cliente. Quant à la journalisation de messages côté serveur (demande SOAP), vous pouvez la configurer en modifiant le fichier web.config pour l’application Web qui héberge votre service. Vous pouvez afficher les messages journalisés en utilisant SvcTraceViewer.exe. Pour plus d’informations, voir Service Trace Viewer Tool (SvcTraceViewer.exe).
Pourquoi d’autres personnes ne peuvent-elles pas afficher ma liste externe ? Au lieu de cela, elles obtiennent l’erreur suivante : « Impossible d’afficher ce composant WebPart. Pour résoudre le problème, ouvrez cette page Web dans un éditeur HTML compatible avec Microsoft SharePoint Foundation tel que Microsoft SharePoint Designer. Si le problème persiste, contactez l’administrateur du serveur Web. »
Plusieurs raisons peuvent expliquer cette erreur. Par exemple, d’autres personnes n’ont peut-être pas accès au système externe ou aux métadonnées.
Si un utilisateur obtient une erreur de type « accès refusé », il n’a pas accès aux métadonnées (par défaut, vous seul y avez accès). Vous pouvez alors modifier la liste de contrôle d’accès dans votre modèle ou type de contenu externe pour donner à l’utilisateur des droits « Exécuter ». La manière la plus simple pour réaliser cette opération consiste à utiliser l’interface utilisateur administrative BDC dans l’Administration centrale de SharePoint pour définir des autorisations et les propager aux objets enfants sur le type de contenu externe. Si vous souhaitez contrôler les droits à un niveau plus granulaire, vous pouvez exporter les ressources pour le modèle (en incluant uniquement les autorisations), modifier les autorisations, puis réimporter les ressources.
Comment dois-je nommer un fichier de modèle BDC ?
À l’aide de Microsoft Business Connectivity Services (BCS), vous pouvez générer un modèle BDC avec Microsoft SharePoint Designer 2010, Microsoft Visual Studio 2010 ou l’interface utilisateur administrative BDC dans l’Administration centrale de SharePoint. Lorsque le modèle est généré, il reçoit l’extension de nom de fichier .bdcm.
Le déploiement d’une solution Business Connectivity Services exige que le modèle BDC qui est inclus avec la solution soit nommé metadata.xml. L’outil BCS Solution Packaging Tool (éventuellement en anglais) accepte un modèle de ce nom ou un modèle BDC avec l’extension de nom de fichier .bdcm. Cependant, si vous choisissez de créer votre propre outil de packaging ou que vous voulez ajouter manuellement une action de post-déploiement pour les solutions Microsoft Office ClickOnce qui sont créées avec Outils de développement Microsoft Office dans Microsoft Visual Studio 2010, vous devez renommer le modèle BDC metadata.xml au lieu d’utiliser l’extension de nom de fichier .bdcm par défaut.