Partager via

Concevoir un modèle de connectivité de données métier

  • Article

Vous pouvez développer un modèle pour le service Business Data Connectivity (BDC) en ajoutant des entités et des méthodes à un fichier de modèle. Une entité décrit une collection de champs de données. Par exemple, une entité peut représenter une table dans une base de données. Une méthode effectue une tâche telle que l’ajout, la suppression ou la mise à jour de données représentées par les entités. Pour plus d’informations, consultez Intégrer des données métier dans SharePoint.

Ajouter des entités

Vous pouvez ajouter une entité en faisant glisser ou en copiant une entité de la boîte à outils Visual Studio vers le Concepteur BDC. Pour plus d’informations, consultez Guide pratique pour ajouter une entité à un modèle.

Définissez les champs de l’entité dans une classe. Par exemple, vous pouvez ajouter un champ nommé Address à une classe Customer. Vous pouvez ajouter une nouvelle classe au projet ou utiliser une classe existante créée avec d’autres outils comme le Concepteur Objet Relationnel (Concepteur O/R). Le nom de l'entité et le nom de la classe qui représentent l'entité ne doivent pas nécessairement correspondre. Vous reliez la classe à l'entité lorsque vous définissez les méthodes dans votre modèle.

Ajouter des méthodes

Le service BDC appelle les méthodes de votre modèle lorsque les utilisateurs affichent, ajoutent, mettent à jour ou suppriment des informations dans une liste ou un composant WebPart basée sur votre modèle. Vous devez ajouter une méthode au modèle pour chaque tâche que l’utilisateur peut effectuer. Créez des méthodes en sélectionnant l’un des cinq types de méthodes de base dans la fenêtre Détails de méthode BDC. Le tableau suivant décrit les cinq méthodes de base d’un modèle BDC.

Méthode Description
Finder Retourne une collection d’instances d’entité. Appelé lorsque l’utilisateur ouvre la liste ou le composant WebPart. Pour plus d’informations, consultez Guide pratique pour ajouter une méthode de recherche.
recherche spécifique Retourne une instance d’entité spécifique. Appelé lorsqu’un utilisateur affiche les détails d’un élément spécifique dans une liste. Pour plus d’informations, consultez Guide pratique pour ajouter une méthode de recherche spécifique.
Creator Ajoute de nouvelles données à la source de données d'une entité. Appelé lorsque les utilisateurs choisissent le bouton Nouvel élément sur le ruban d’une liste basée sur le modèle. Pour plus d’informations, consultez Guide pratique pour ajouter une méthode de création.
programme de mise à jour Modifie les données d’une liste. Appelé lorsque les utilisateurs mettent à jour les informations d’une liste. Pour plus d’informations, consultez Guide pratique pour ajouter une méthode de mise à jour.
programme de suppression Supprime les données. Appelé lorsque les utilisateurs suppriment un élément de la liste. Pour plus d’informations, consultez Guide pratique pour ajouter une méthode de mise à jour.

Définir les paramètres d’une méthode

Lorsque vous créez une méthode, Visual Studio ajoute les paramètres d’entrée et de sortie appropriés pour le type de méthode. Ces paramètres sont simplement des espaces réservés. Dans la plupart des cas, vous devez modifier les paramètres pour qu'ils passent ou renvoient le bon type de données. Par exemple, par défaut, une méthode de recherche (Finder) retourne une chaîne. Dans la plupart des cas, vous souhaitez modifier le paramètre de retour de la méthode de recherche afin qu'elle renvoie une collection d'entités. Pour ce faire, modifiez le descripteur de type du paramètre. Un descripteur de type est un ensemble d'attributs qui décrit le type de données d'un paramètre. Pour plus d’informations, consultez Guide pratique pour définir le descripteur de type d’un paramètre.

Visual Studio vous permet de copier des descripteurs de type entre les paramètres du modèle. Par exemple, vous pouvez définir un descripteur de type nommé CustomerTD pour le paramètre de retour de la méthode GetCustomer. Vous pouvez copier le descripteur de type CustomerTD dans l’Explorateur BDC, puis coller ce descripteur de type dans le paramètre d’entrée de la méthode CreateCustomer. Cela vous empêche de devoir définir le même descripteur de type plusieurs fois.

Instances de méthode

Lorsque vous créez une méthode, Visual Studio ajoute une instance de méthode par défaut. Une instance de méthode est une référence à une méthode, ainsi que les valeurs par défaut pour les paramètres. Une même méthode peut avoir plusieurs instances de méthode. Chaque instance est une combinaison de la signature de la méthode et d'un ensemble de valeurs par défaut. Pour plus d’informations, consultez Guide pratique pour définir le descripteur de type d’un paramètre.

Lorsque vous exécutez le projet, les instances de méthode apparaissent dans une liste déroulante au-dessus de la liste SharePoint. Les utilisateurs peuvent choisir des instances de méthode pour afficher les données.

Pour ajouter des valeurs par défaut à l'instance de la méthode, vous devez modifier directement la chaîne XML du modèle. Pour plus d’informations, consultez DefaultValue.

Ajouter des descripteurs de filtre

Les consommateurs du modèle peuvent décider de récupérer des instances d'une entité correspondant à certains critères. Pour activer cette fonctionnalité, vous pouvez ajouter un descripteur de filtre à une méthode. Les descripteurs de filtre permettent aux consommateurs de modèles de filtrer les ensembles de résultats des méthodes en passant des valeurs aux méthodes avant qu'elles ne s'exécutent. Pour plus d’informations, consultez Guide pratique pour ajouter des paramètres de filtrage aux opérations pour limiter les instances du système externe.

SharePoint fournit plusieurs fonctionnalités qui permettent aux utilisateurs de fournir des valeurs de filtre. Par exemple, les composants WebPart de données métier fournissent une zone de texte de filtre. Les utilisateurs peuvent limiter les données d’une liste en entrant une valeur dans la zone de texte. Pour plus d’informations sur l’ajout d’un descripteur de filtre à une méthode, consultez Guide pratique pour ajouter un descripteur de filtre à une méthode de recherche.

Propriétés du descripteur de filtre

Vous devez définir la valeur des propriétés Descripteur de type associé, Nom et Type d’un descripteur de filtre. Toutes les autres propriétés sont facultatives.

La propriété Descripteur de type associé associe le descripteur de filtre à un paramètre d’entrée. Lorsqu’un utilisateur fournit une valeur de filtre, le service BDC passe cette valeur à la méthode à l’aide du paramètre d’entrée.

La propriété Type décrit le modèle de filtrage que vous souhaitez utiliser. Dans SharePoint, le modèle de filtrage que vous sélectionnez affecte le texte qui apparaît dans l’interface utilisateur . Par exemple, pour un modèle de filtrage de type Comparateur, le texte est égal à celui d’un contrôle au-dessus d’un composant WebPart Données métier. Pour plus d’informations sur chaque modèle de filtrage, consultez Types de filtres pris en charge par le BDC.

Pour plus d’informations sur les propriétés d’un descripteur de filtre, consultez FilterDescriptor.

Fournir les valeurs par défaut

Dans certains cas, l’utilisateur peut ne pas fournir de valeur de filtre. Vous pouvez fournir une valeur par défaut en ajoutant une valeur par défaut à l’instance de méthode ou en définissant la valeur par défaut dans le code de votre méthode. Pour plus d’informations sur l’ajout d’une valeur par défaut à l’instance de méthode, consultez MethodInstance. Pour obtenir un exemple de définition de la valeur par défaut d’un paramètre d’entrée dans le code de votre méthode, consultez Guide pratique pour ajouter un descripteur de filtre à une méthode de recherche.

Valider le modèle

Vous pouvez valider votre modèle pendant le développement. Visual Studio identifie les problèmes qui peuvent empêcher votre modèle de se comporter comme prévu. Ces problèmes apparaissent dans la liste d’erreurs Visual Studio.

Vous pouvez valider un modèle en ouvrant le menu contextuel du Concepteur BDC, puis en choisissant Valider. Si le modèle contient des erreurs, ces erreurs apparaissent dans la liste d’erreurs. Vous pouvez rapidement déplacer le curseur vers le code qui contient une erreur en double-cliquant sur l’erreur dans la liste. Vous pouvez appuyer sur les touches F8 ou Maj+F8 à plusieurs reprises pour avancer ou reculer dans la liste d’erreurs.

Les erreurs de validation peuvent se produire lorsque les règles du modèle sont violées d’une certaine manière. Par exemple, si la propriété IsCollection d’un descripteur de type a la valeur true, mais qu’aucun descripteur de type enfant n’existe, une erreur de validation s’affiche. Vous devrez peut-être faire référence aux règles d’un modèle BDC pour comprendre certaines erreurs qui apparaissent dans la liste d’erreurs Visual Studio. Pour plus d’informations sur les règles d’un modèle BDC, consultez SchémaBDCMetadata.

Déboguer la solution qui contient le modèle

Vous pouvez déboguer votre code comme vous le feriez pour déboguer n’importe quel code dans Visual Studio. Pour déboguer votre code, définissez des points d’arrêt n’importe où dans votre code, puis démarrez le débogueur. Visual Studio ouvre le site SharePoint. Dans SharePoint, créez une liste ou un composant WebPart qui utilise vos données métier. Vous pouvez ensuite parcourir votre code. Pour plus d’informations sur le débogage de projets SharePoint, consultez Résoudre les problèmes liés aux solutions SharePoint.

Vous pouvez également déboguer du code dans des assemblys personnalisés que vous ajoutez au projet. Toutefois, pour déboguer du code dans un assembly personnalisé, vous devez ajouter l’assembly au package de solution. Pour plus d’informations, consultez Guide pratique pour ajouter et supprimer des assemblys supplémentaires.

Pour plus d’informations sur l’ajout d’un assembly personnalisé à votre projet, consultez Guide pratique pour inclure un assembly personnalisé dans une fonctionnalité BDC.

Configurer la sécurité BDC

Vous devez peut-être modifier vos paramètres de sécurité dans SharePoint pour pouvoir déboguer votre solution. Pour modifier ces paramètres, ouvrez l’application du service de connectivité de données métier dans le site web Administration centrale de SharePoint 2010. Dans la boîte de dialogue Définir les autorisations du magasin de métadonnées, ajoutez votre compte d’utilisateur, puis sélectionnez l’une des options suivantes :

Tâche Option
Pour déployer des modèles sur le service BDC. Modifier
Pour créer des listes et des composants WebPart à l’aide de types de contenu externes (entités) dans votre modèle. Sélectionnable dans les clients
Pour créer, lire, mettre à jour et supprimer des données d’entité. Execute

Pour plus d’informations sur ces paramètres, consultez Gestion du service de connectivité de données métier.

Vous pouvez également définir des autorisations de sécurité pour des modèles individuels ou des types de contenu externe. Pour plus d’informations sur la définition des autorisations de sécurité d’un modèle, consultez Gestion des modèles BDC. Pour plus d’informations sur la définition des autorisations de sécurité d’un type de contenu externe, consultez Gestion des types de contenu externe.

Notes

Utilisez ces paramètres pour déboguer une solution sur votre serveur SharePoint local. Pour plus d’informations sur la configuration des paramètres de sécurité liés à BDC sur le serveur SharePoint de production, consultez Vue d’ensemble de la sécurité des services de connectivité de données métier.

Retirer des modèles qui deviennent endommagés

La première fois que vous démarrez le débogueur, Visual Studio déploie l’intégralité du modèle sur SharePoint. Pour chaque fois par la suite, Visual Studio met à jour le modèle dans SharePoint avec les modifications que vous apportez entre les déploiements.

Il peut arriver que Visual Studio retire complètement le modèle de SharePoint. Par exemple, un modèle peut devenir endommagé. Pour redéployer votre modèle dans SharePoint, définissez la propriété Mise à jour incrémentielle du modèle sur False, puis démarrez le débogueur. La propriété Mise à jour incrémentielle s’affiche dans la fenêtre Propriétés lorsque vous sélectionnez le nœud qui représente le modèle dans l’Explorateur BDC. Par défaut, le nom du modèle est BdcModel1.

Modifier les noms d’identificateur des entités dans le modèle

Si vous modifiez le nom d’un identificateur après avoir déployé le modèle, vous pouvez recevoir une erreur de déploiement. Vous ne pouvez pas résoudre cette erreur en définissant la propriété Mise à jour incrémentielle du modèle sur False. Vous devez retirer le modèle manuellement, puis redéployer la solution. Pour plus d’informations, consultez Résolution des problèmes des solutions SharePoint. Vous pouvez éviter cette erreur en définissant la propriété Mise à jour incrémentielle sur False avant de déployer initialement le modèle.

Rechercher la documentation pour les éléments de modèle BDC

Visual Studio ajoute un élément XML au modèle pour chaque entité, méthode ou autre élément que vous créez. Les attributs d’élément apparaissent sous forme de propriétés dans la fenêtre Propriétés. Pour plus d’informations sur les éléments et les attributs générés par Visual Studio lors de la conception du modèle, consultez Schéma BDCMetadata.

Intitulé Description
Vue d’ensemble des outils de conception du modèle BDC Décrit les outils que vous pouvez utiliser pour concevoir visuellement un modèle pour le BDC.
Guide pratique pour ajouter une entité à un modèle Montre comment ajouter des types de contenu externe ou des entités au modèle.
Guide pratique pour ajouter une méthode de recherche Montre comment ajouter une méthode qui permet aux utilisateurs d’afficher une liste d’entités dans une liste ou un composant WebPart.
Guide pratique pour ajouter une méthode de recherche spécifique Montre comment ajouter une méthode qui permet aux utilisateurs d’afficher les détails d’une entité spécifique.
Guide pratique pour ajouter une méthode de création Montre comment ajouter une méthode qui permet aux utilisateurs d’ajouter des enregistrements à une source de données directement à partir d’une liste ou d’un composant WebPart.
Guide pratique pour ajouter une méthode de suppression Montre comment ajouter une méthode qui permet aux utilisateurs de supprimer des données d’une source de données à l’aide d’options dans l’interface utilisateur d’une liste ou d’un composant WebPart.
Guide pratique pour ajouter une méthode de mise à jour Montre comment ajouter une méthode qui permet aux utilisateurs de modifier les enregistrements de données dans une source de données directement à partir d’une liste ou d’un composant WebPart.
Guide pratique pour ajouter un paramètre à une méthode Montre comment utiliser la fenêtre Détails de méthode dans Visual Studio pour ajouter des paramètres d’entrée et de retour à une méthode.
Guide pratique pour définir le descripteur de type d’un paramètre Montre comment définir des types de données de paramètre dans le modèle.
Guide pratique pour définir une instance de méthode Montre comment créer une instance d’une méthode exécutée par le BDC.
Guide pratique pour ajouter un descripteur de filtre à une méthode de recherche Montre comment permettre aux utilisateurs de limiter le nombre d’instances retournées par une méthode de recherche.
Création d'une association entre des entités Décrit comment définir des relations entre des entités dans le modèle. Les composants WebPart Données métier, listes externes et applications personnalisées peuvent afficher ces relations de données dans une interface utilisateur.
Guide pratique pour créer une association entre des entités Montre comment définir des relations entre des entités dans le modèle.
Procédure pas à pas : créer une liste externe dans SharePoint à l’aide de données métiers Fournit des instructions pas à pas qui vous montrent comment créer et tester un modèle qui affiche des contacts dans une liste externe SharePoint.
Intégrer des données métier dans SharePoint Fournit une vue d’ensemble de la création et de la conception de modèles pour le service BDC.