Conception d'un modèle de connectivité de données métiersDesigning a Business Data Connectivity Model

Vous pouvez développer un modèle pour le service de connectivité de données métiers (BDC) en ajoutant des entités et des méthodes à un fichier de modèle.You can develop a model for the Business Data Connectivity (BDC) service by adding entities and methods to a model file. Une entité décrit une collection de champs de données.An entity describes a collection of data fields. Par exemple, une entité peut représenter une table dans une base de données.For example, an entity can represent a table in a database. Une méthode effectue une tâche telle que l’ajout, la suppression ou la mise à jour des données représentées par les entités.A method performs a task such as adding, deleting, or updating data represented by the entities. Pour plus d’informations, consultez intégration de données métiers dans SharePoint.For more information, see Integrating Business Data into SharePoint.

Ajout d’entitésAdding Entities

Vous pouvez ajouter une entité en faisant glisser ou en copiant un entité à partir de Visual Studio boîte à outils sur le concepteur BDC.You can add an entity by dragging or copying an Entity from the Visual Studio Toolbox onto the BDC Designer. Pour plus d’informations, consultez Comment : ajouter une entité à un modèle.For more information, see How to: Add an Entity to a Model.

Définissez les champs de l’entité dans une classe.Define the fields of the entity in a class. Par exemple, vous pouvez ajouter un champ nommé Address à un Customer classe.For example, you might add a field named Address to a Customer class. Vous pouvez ajouter une nouvelle classe au projet ou utiliser une classe existante créée à l’aide d’autres outils tels que le Concepteur Objet/Relationnel (Concepteur O/R).You can either add a new class to the project or use an existing class created by using other tools such as the Object Relational Designer (O/R Designer). Le nom de l’entité et le nom de la classe qui représente l’entité n’ont pas faire correspondre.The name of the entity and the name of the class that represents the entity do not have to match. Vous liez la classe à l’entité lorsque vous définissez les méthodes dans votre modèle.You relate the class to the entity when you define the methods in your model.

Ajout de méthodesAdding Methods

Le service BDC appelle des méthodes dans votre modèle lorsque les utilisateurs à afficher, ajoutent, mettre à jour ou supprimer des informations dans une liste ou un composant WebPart qui est basé sur votre modèle.The BDC service calls methods in your model when users view, add, update, or delete information in a list or Web Part that is based on your model. Vous devez ajouter une méthode au modèle pour chaque tâche de l’utilisateur peut effectuer.You must add a method to the model for each task that the user can perform. Créer des méthodes en sélectionnant une des cinq types de méthode de base à partir de la détails de méthode BDC fenêtre.Create methods by selecting any of the five basic method types from the BDC Method Details window. Le tableau suivant décrit les cinq méthodes de base d’un modèle BDC.The following table describes the five basic methods of a BDC model.

MéthodeMethod DescriptionDescription
FinderFinder Retourne une collection d’instances d’entité.Returns a collection of entity instances. Appelé lorsque l’utilisateur ouvre la liste ou un composant WebPart.Called when the user opens the list or Web Part. Pour plus d’informations, consultez Comment : ajouter une méthode de recherche.For more information, see How to: Add a Finder Method.
recherche spécifiqueSpecific Finder Retourne une instance d’entité spécifique.Returns a specific entity instance. Appelé lorsqu’un utilisateur affiche les détails d’un élément spécifique dans une liste.Called when a user views the details of a specific item in a list. Pour plus d’informations, consultez Comment : ajouter une méthode de recherche spécifique.For more information, see How to: Add a Specific Finder Method.
créateurCreator Ajoute de nouvelles données à la source de données d’une entité.Adds new data to the data source of an entity. Appelé lorsque les utilisateurs choisissent le un nouvel élément bouton sur le ruban d’une liste qui est basée sur le modèle.Called when users choose the New Item button on the Ribbon of a list that is based on the model. Pour plus d’informations, consultez Comment : ajouter une méthode de création.For more information, see How to: Add a Creator Method.
programme de mise à jourUpdater Modifie les données dans une liste.Modifies the data in a list. Appelé lorsque les utilisateurs mettent à jour les informations dans une liste.Called when users update information in a list. Pour plus d’informations, consultez Comment : ajouter une méthode de mise à jour.For more information, see How to: Add an Updater Method.
programme de suppressionDeleter Supprime les données.Removes data. Appelé lorsque les utilisateurs suppriment un élément dans la liste.Called when users delete an item from the list. Pour plus d’informations, consultez Comment : ajouter une méthode de suppression.For more information, see How to: Add a Deleter Method.

Définition des paramètres de méthodeDefining Method Parameters

Lorsque vous créez une méthode, Visual Studio ajoute les paramètres d’entrée et de sortie qui sont appropriés pour le type de méthode.When you create a method, Visual Studio adds the input and output parameters that are appropriate for the method type. Ces paramètres sont seulement des espaces réservés.These parameters are just placeholders. Dans la plupart des cas, vous devez modifier les paramètres afin qu’ils passent ou retournent le type de données approprié.In most cases, you must modify the parameters so that they pass in or return the correct type of data. Par exemple, par défaut, une méthode de recherche retourne une chaîne.For example, by default, a Finder method returns a string. Dans la plupart des cas, vous souhaitez modifier le paramètre de retour de la méthode de recherche afin qu’elle retourne une collection d’entités.In most cases, you want to modify the return parameter of the Finder method so that it returns a collection of entities. Vous pouvez accomplir cela en modifiant le descripteur de type du paramètre.You can accomplish that by modifying the type descriptor of the parameter. Un descripteur de type est une collection d’attributs qui décrit le type de données d’un paramètre.A type descriptor is a collection of attributes that describes the data type of a parameter. Pour plus d’informations, consultez Comment : définir le descripteur de Type d’un paramètre.For more information, see How to: Define the Type Descriptor of a Parameter.

Visual Studio vous permet de copier des descripteurs de type entre les paramètres dans le modèle.Visual Studio enables you to copy type descriptors between parameters in the model. Par exemple, vous pouvez définir un descripteur de type nommé CustomerTD pour le paramètre de retour de la GetCustomer (méthode).For example, you might define a type descriptor named CustomerTD for the return parameter of the GetCustomer method. Vous pouvez copier le CustomerTD tapez descripteur dans le Explorateur BDC, puis collez ce descripteur de type pour le paramètre d’entrée de la CreateCustomer (méthode).You can copy the CustomerTD type descriptor in the BDC Explorer, and then paste that type descriptor to the input parameter of the CreateCustomer method. Cela vous évite d’avoir à définir le même descripteur de type plusieurs fois.This prevents you from having to define the same type descriptor more than once.

Instances (méthode)Method Instances

Lorsque vous créez une méthode, Visual Studio ajoute une instance de la méthode par défaut.When you create a method, Visual Studio adds a default method instance. Une instance de méthode est une référence à une méthode, ainsi que les valeurs par défaut pour les paramètres.A method instance is a reference to a method, plus the default values for the parameters. Une méthode unique peut avoir plusieurs instances de méthode.A single method can have multiple method instances. Chaque instance est une combinaison de la signature de méthode et un ensemble de valeurs par défaut.Each instance is a combination of the method signature and a set of default values. Pour plus d’informations, consultez Comment : définir le descripteur de Type d’un paramètre.For more information, see How to: Define the Type Descriptor of a Parameter.

Lorsque vous exécutez le projet, les instances de méthode s’affichent dans une liste déroulante au-dessus de la liste SharePoint.When you run the project, method instances appear in a drop-down list above the SharePoint list. Les utilisateurs peuvent choisir des instances de méthode pour afficher les données.Users can choose method instances to view the data.

Pour ajouter des valeurs par défaut à l’instance de méthode, vous devez modifier le code XML du modèle directement.To add default values to the method instance, you have to modify the XML of the model directly. Pour plus d’informations, consultez DefaultValue.For more information, see DefaultValue.

Ajout de descripteurs de filtreAdding Filter Descriptors

Les consommateurs du modèle peuvent souhaiter extraire les instances d’une entité qui correspondent à certains critères.Consumers of the model might want to retrieve instances of an entity that match some criteria. Pour activer cette fonctionnalité, vous pouvez ajouter un descripteur de filtre à une méthode.To enable this functionality, you can add a filter descriptor to a method. Descripteurs de filtre permettent aux consommateurs de modèle filtrer les jeux de résultats de méthode en passant des valeurs aux méthodes avant leur exécution.Filter descriptors enable model consumers to filter method result sets by passing values to methods before they execute. Pour plus d’informations, consultez Comment : ajouter des paramètres de filtre aux opérations pour limiter les Instances du système externe.For more information, see How to: Add Filter Parameters to Operations to Limit Instances from the External System.

SharePoint fournit plusieurs fonctionnalités qui permettent aux utilisateurs de fournir des valeurs de filtre.SharePoint provides several features that enable users to provide filter values. Par exemple, les composants WebPart de données de l’entreprise fournissent une zone de texte de filtre.For example, Business Data Web Parts provide a filter text box. Les utilisateurs peuvent limiter les données dans une liste en entrant une valeur dans la zone de texte.Users can limit the data in a list by entering a value in the text box. Pour plus d’informations sur l’ajout d’un descripteur de filtre à une méthode, consultez Comment : ajouter un descripteur de filtre à une méthode de recherche.For more information about how to add a filter descriptor to a method, see How to: Add a Filter Descriptor to a Finder Method.

Propriétés du descripteur de filtreFilter Descriptor Properties

Vous devez définir la valeur de la descripteurs de Type associés, nom, et Type propriétés d’un descripteur de filtre.You must set the value of the Associated Type Descriptor, Name, and Type properties of a filter descriptor. Toutes les autres propriétés sont facultatives.All other properties are optional.

Le descripteurs de Type associés propriété concerne le descripteur de filtre à un paramètre d’entrée.The Associated Type Descriptor property relates the filter descriptor to an input parameter. Lorsqu’un utilisateur fournit une valeur de filtre, le service BDC passe cette valeur dans la méthode en utilisant le paramètre d’entrée.When a user provides a filter value, the BDC service passes that value into the method by using the input parameter.

Le Type propriété décrit le modèle de filtrage que vous souhaitez utiliser.The Type property describes the filtering pattern that you want to use. Dans SharePoint, le modèle de filtrage que vous sélectionnez affecte le texte qui apparaît dans l’Interface utilisateur (IU).In SharePoint, the filtering pattern you select affects the text that appears in the User Interface (UI). Par exemple, pour un modèle de filtrage comparateur, le texte est égal à apparaît sous la forme d’un contrôle au-dessus d’un composant WebPart données métier.For example, for a Comparator filtering pattern, the text is equal to appears as a control above a Business Data Web Part. Pour plus d’informations sur chaque modèle de filtrage, consultez Types de filtres pris en charge par le catalogue de données métiers.For more information about each filtering pattern, see Types of Filters Supported by the BDC.

Pour plus d’informations sur les propriétés d’un descripteur de filtre, consultez FilterDescriptor.For more information about the properties of a filter descriptor, see FilterDescriptor.

En fournissant des valeurs par défautProviding Default Values

Dans certains cas, l’utilisateur peut ne pas fournit une valeur de filtre.In some cases, the user might not provide a filter value. Vous pouvez fournir une valeur par défaut en ajoutant une valeur par défaut pour l’instance de méthode ou en définissant la valeur par défaut dans le code de votre méthode.You can provide a default value by adding a default value to the method instance, or by setting the default value in the code of your method. Pour plus d’informations sur l’ajout d’une valeur par défaut à l’instance de méthode, consultez MethodInstance.For more information about how to add a default value to the method instance, see MethodInstance. Pour obtenir un exemple montrant comment définir la valeur par défaut d’un paramètre d’entrée dans le code de votre méthode, consultez Comment : ajouter un descripteur de filtre à une méthode de recherche.For an example of how to set the default value of an input parameter in the code of your method, see How to: Add a Filter Descriptor to a Finder Method.

Validation du modèleValidating the Model

Vous pouvez valider votre modèle pendant le développement.You can validate your model during development. Visual Studio identifie les problèmes qui peuvent empêcher votre modèle de se comporter comme prévu.Visual Studio identifies issues that can prevent your model from behaving as expected. Ces problèmes s’affichent dans Visual Studio liste d’erreurs.These issues appear in the Visual Studio Error List.

Vous pouvez valider un modèle en ouvrant le menu contextuel pour le concepteur BDC, puis en choisissant Validate.You can validate a model by opening the shortcut menu for the BDC Designer and then choosing Validate. Si le modèle contient des erreurs, ils apparaissent dans le liste d’erreurs.If the model contains any errors, they appear in the Error List. Vous pouvez rapidement déplacer le curseur vers le code qui contient une erreur en double-cliquant sur l’erreur dans la liste.You can quickly move the cursor to the code that contains an error by double-clicking the error in the list. En guise d’alternative, vous pouvez choisir les touches F8 ou MAJ + F8 à plusieurs reprises pour avancer ou reculer dans les erreurs dans la liste.As an alternative, you can choose the F8 or Shift+F8 keys repeatedly to step forward or backward through the errors in the list.

Erreurs de validation peuvent se produire lorsque les règles du modèle sont enfreintes d’une certaine façon.Validation errors can occur when the rules of the model are violated in some way. Par exemple, si le IsCollection d’un descripteur de type est définie sur true, mais aucun descripteur de type enfant n’existe, une erreur de validation s’affiche.For example, if the IsCollection property of a type descriptor is set to true, but no child type descriptors exist, a validation error will appear. Vous devrez peut-être faire référence aux règles d’un modèle BDC pour comprendre certaines des erreurs qui s’affichent dans Visual Studio liste d’erreurs.You might have to refer to the rules of a BDC model to understand some errors that appear in the Visual Studio Error List. Pour plus d’informations sur les règles d’un modèle BDC, consultez BDCMetadata schéma.For more information about the rules of a BDC model, see BDCMetadata Schema.

Débogage de la Solution qui contient le modèleDebugging the Solution that Contains the Model

Vous pouvez déboguer votre code comme pour n’importe quel code dans Visual Studio.You can debug your code as you would debug any code in Visual Studio. Pour déboguer votre code, définir des points d’arrêt de n’importe où dans votre code et puis démarrez le débogueur.To debug your code, set breakpoints anywhere in your code and then start the debugger. Visual Studio ouvre le site SharePoint.Visual Studio opens the SharePoint site. Dans SharePoint, créez une liste ou un composant WebPart qui utilise vos données d’entreprise.In SharePoint, create a list or Web Part that uses your business data. Ensuite, vous pouvez parcourir votre code.Then, you can step through your code. Pour plus d’informations sur le débogage de projets SharePoint, consultez dépannage des Solutions SharePoint.For more information about debugging SharePoint projects, see Troubleshooting SharePoint Solutions.

Vous pouvez également déboguer du code dans des assemblys personnalisés que vous ajoutez au projet.You can also debug code in custom assemblies that you add to the project. Toutefois, pour déboguer le code dans un assembly personnalisé, vous devez ajouter l’assembly au package de solution.However, to debug code in a custom assembly, you must add the assembly to the solution package. Pour plus d’informations, consultez Comment : ajouter et supprimer des assemblys supplémentaires.For more information, see How to: Add and Remove Additional Assemblies.

Pour plus d’informations sur l’ajout d’un assembly personnalisé à votre projet, consultez Comment : inclure un Assembly personnalisé dans une fonctionnalité BDC.For more information about adding a custom assembly to your project, see How to: Include a Custom Assembly in a BDC Feature.

Configuration de la sécurité BDCConfiguring BDC Security

Vous devrez peut-être modifier vos paramètres de sécurité dans SharePoint avant de pouvoir déboguer votre solution.You might have to modify your security settings in SharePoint before you can debug your solution. Pour modifier ces paramètres, ouvrez l’Application de Service de connectivité de données métiers dans le site Web de SharePoint 2010 Central Administration.To modify these settings, open the Business Data Connectivity Service Application in the SharePoint 2010 Central Administration Web site. Dans le définir des autorisations de magasin de métadonnées boîte de dialogue, ajoutez votre compte d’utilisateur, puis sélectionnez l’une des options suivantes :In the Set Metadata Store Permissions dialog box, add your user account, and then select any of the following options:

TâcheTask OptionOption
Pour déployer des modèles pour le service BDC.To deploy models to the BDC service. ModifierEdit
Pour créer des listes et les composants WebPart à l’aide d’externes des types de contenu (entités) dans votre modèle.To create lists and Web Parts by using external content types (entities) in your model. Sélectionnable dans les ClientsSelectable in Clients
Pour créer, lire, mettre à jour et supprimer des données d’entité.To create, read, update, and delete entity data. ExécuterExecute

Pour plus d’informations sur ces paramètres, consultez gestion des services de connectivité de données métiers.For more information about these settings, see Business Data Connectivity service management.

Vous pouvez également définir des autorisations de sécurité pour les modèles individuels ou des types de contenu externe.You can also set security permissions for individual models or external content types. Pour plus d’informations sur la façon de définir les autorisations de sécurité d’un modèle, consultez gérer les modèles BDC.For more information about how to set the security permissions of a model, see BDC model management. Pour plus d’informations sur la façon de définir les autorisations de sécurité d’un type de contenu externe, consultez gestion du type de contenu externe.For more information about how to set the security permissions of an external content type, see External content type management.

Note

Utilisez ces paramètres pour déboguer une solution sur votre serveur SharePoint local.Use these settings to debug a solution on your local SharePoint Server. Pour plus d’informations sur la façon de configurer les paramètres de sécurité BDC sur le serveur SharePoint de production, consultez vue d’ensemble de la sécurité Business Data Connectivity Services.For more information about how to configure BDC-related security settings on production SharePoint server, see Business Data Connectivity Services security overview.

Retrait des modèles corrompusRetracting Models That Become Corrupt

La première fois que vous démarrez le débogueur, Visual Studio déploie le modèle entier sur SharePoint.The first time that you start the debugger, Visual Studio deploys the entire model to 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.For each time thereafter, Visual Studio updates the model in SharePoint with any changes that you make between deployments.

Il peut y avoir des situations où vous souhaitez que Visual Studio pour retirer le modèle à partir de SharePoint complètement.There might be situations where you want Visual Studio to retract the model from SharePoint completely. Par exemple, un modèle peut être endommagé.For example, a model might become corrupt. Pour redéployer votre modèle sur SharePoint, vous devez définir le mise à jour incrémentielle propriété du modèle à False, puis démarrez le débogueur.To redeploy your model to SharePoint, set the Incremental Update property of the model to False, and then start the debugger. Le mise à jour incrémentielle propriété s’affiche dans le propriétés lorsque vous sélectionnez le nœud qui représente le modèle dans le Explorateur BDC.The Incremental Update property appears in the Properties window when you select the node that represents the model in the BDC Explorer. Par défaut, le nom du modèle est BdcModel1.By default, the name of the model is BdcModel1.

Modification des noms d’identificateur d’entités dans le modèleChanging Identifier Names of Entities in the Model

Si vous modifiez le nom d’un identificateur après avoir déployé le modèle, vous pouvez recevoir une erreur de déploiement.If you change the name of an identifier after you deploy the model, you might receive a deployment error. Vous ne pouvez pas résoudre cette erreur en définissant le mise à jour incrémentielle propriété du modèle à False.You cannot resolve this error by setting the Incremental Update property of the model to False. Vous devez retirer le modèle manuellement et puis redéployez la solution.You must retract the model manually, and then deploy the solution again. Pour plus d’informations, consultez dépannage des Solutions SharePoint.For more information, see Troubleshooting SharePoint Solutions. Vous pouvez éviter cette erreur en définissant le mise à jour incrémentielle propriété False avant le déploiement initial du modèle.You can avoid this error by setting the Incremental Update property to False before you initially deploy the model.

Localisation de Documentation pour les éléments de modèle BDCLocating Documentation for BDC Model Elements

Visual Studio ajoute un élément XML au modèle pour chaque entité, méthode ou un autre élément que vous créez.Visual Studio adds an XML element to the model for each entity, method, or other item that you create. Attributs de l’élément s’affichent en tant que propriétés dans le propriétés fenêtre.Element attributes appear as properties in the Properties window. Pour plus d’informations sur les éléments et attributs que Visual Studio génère comme vous concevez le modèle, consultez BDCMetadata schéma.For information about the elements and attributes that Visual Studio generates as you design the model, see BDCMetadata Schema.

TitreTitle DescriptionDescription
Vue d’ensemble des outils de conception du modèle BDCBDC Model Design Tools Overview Décrit les outils que vous pouvez utiliser pour concevoir visuellement un modèle pour le BDC.Describes the tools that you can use to visually design a model for the BDC.
Guide pratique pour ajouter une entité à un modèleHow to: Add an Entity to a Model Vous montre comment ajouter des types de contenu externe, ou les entités, au modèle.Shows you how to add external content types, or entities, to the model.
Guide pratique pour ajouter une méthode de rechercheHow to: Add a Finder Method Vous montre comment ajouter une méthode qui permet aux utilisateurs d’afficher une liste d’entités dans une liste ou un composant WebPart.Shows you how to add a method that enables users to view a list of entities in a list or Web Part.
Guide pratique pour ajouter une méthode de recherche spécifiqueHow to: Add a Specific Finder Method Vous montre comment ajouter une méthode qui permet aux utilisateurs d’afficher les détails d’une entité spécifique.Shows you how to add a method that enables users to view the details of a specific entity.
Guide pratique pour ajouter une méthode de créationHow to: Add a Creator Method Vous 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 un composant WebPart.Shows you how to add a method that enables users to add records to a data source directly from a list or Web Part.
Guide pratique pour ajouter une méthode de suppressionHow to: Add a Deleter Method Vous montre comment ajouter une méthode qui permet aux utilisateurs de supprimer des données à partir d’une source de données à l’aide des options dans l’Interface utilisateur (UI) d’une liste ou le composant WebPart.Shows you how to add a method that enables users to remove data from a data source by using options in the User Interface (UI) of a list or Web Part.
Guide pratique pour ajouter une méthode de mise à jourHow to: Add an Updater Method Vous montre comment ajouter une méthode qui permet aux utilisateurs de modifier des enregistrements de données dans une source de données directement à partir d’une liste ou un composant WebPart.Shows you how to add a method that enables users to change data records in a data source directly from a list or Web Part.
Guide pratique pour ajouter un paramètre à une méthodeHow to: Add a Parameter to a Method Vous montre comment utiliser la fenêtre Détails de méthode dans Visual Studio pour ajouter des paramètres d’entrée et de retournés à une méthode.Shows you how to use the Method Details Window in Visual Studio to add input and return parameters to a method.
Guide pratique pour définir le descripteur de type d’un paramètreHow to: Define the Type Descriptor of a Parameter Vous montre comment définir des types de données de paramètre dans le modèle.Shows you how to define parameter data types in the model.
Guide pratique pour définir une instance de méthodeHow to: Define a Method Instance Vous montre comment créer une instance d’une méthode que le BDC exécute.Shows you how to create an instance of a method that the BDC executes.
Guide pratique pour ajouter un descripteur de filtre à une méthode de rechercheHow to: Add a Filter Descriptor to a Finder Method Vous montre comment permettre aux utilisateurs limiter le nombre d’instances retourné par une méthode de recherche.Shows you how to enable users to limit the number of instances returned by a Finder method.
Création d’une association entre des entitésCreating an Association Between Entities Décrit comment vous pouvez définir des relations entre des entités dans le modèle.Describes how you can define relationships between entities in the model. Les composants WebPart de données de l’entreprise, listes externes et des applications personnalisées peuvent afficher ces relations de données dans une interface utilisateur (IU).Business Data Web Parts, External Lists, and custom applications can display these data relationships in a user interface (UI).
Comment : créer une Association entre des entitésHow to: Create an Association between Entities Vous montre comment définir des relations entre des entités dans le modèle.Shows you how to define relationships between entities in the model.
Procédure pas à pas : création d’une liste externe dans SharePoint à l’aide de données métiersWalkthrough: Creating an External List in SharePoint by Using Business Data Fournit des instructions pas à pas qui vous montrent comment créer et tester un modèle qui affiche les contacts dans une liste externe SharePoint.Provides step-by-step instructions that show you how to create and test a model that displays contacts in a SharePoint external list.
Intégration de données métiers dans SharePointIntegrating Business Data into SharePoint Fournit une vue d’ensemble de la création et la conception de modèles pour le service BDC.Provides an overview of creating and designing models for the BDC service.