Procédure : Créer un type de contenu externe en écrivant un assembly de connectivité .NET
Dernière modification : vendredi 16 avril 2010
S’applique à : SharePoint Server 2010
Dans cet article
Comment créer un assembly de connectivité .NET
Comment étendre un type de contenu externe créé dans Visual Studio 2010 à l’aide de SharePoint Designer 2010
Comment créer un type de contenu externe basé sur un assembly de connectivité .NET à l’aide de SharePoint Designer 2010
Si le système externe n’est pas pris en charge directement par Microsoft Business Connectivity Services (BCS), vous pouvez créer une interface à votre système externe en écrivant du code Microsoft .NET Framework. Si le modèle d’entité est statique et contient un petit ensemble de types connus, vous pouvez écrire des services WCF (Windows Communication Foundation), des services Web ou des assemblys de connectivité .NET pour interfacer avec votre source de données externes. Si vous décidez d’écrire un service WCF ou un service Web pour votre système externe, Business Connectivity Services n’hébergera pas le service WCF ou le service Web. Vous devez héberger le service. Au lieu d’écrire un service Web ou WCF, vous pouvez créer un assembly de connectivité .NET avec la logique principale et le publier (avec tout autre assembly dont il dépend) dans la banque de métadonnées BDC à l’aide de Microsoft Visual Studio 2010. Business Connectivity Services hébergera l’assembly de connectivité .NET à l’aide du .NET Assembly Connector.
Notes
En revanche, si le modèle d’entité est dynamique, qu’il possède des types personnalisés et qu’il est à grande échelle, vous pouvez créer un connecteur personnalisé pour ce type de source de données. Pour plus d’informations, voir Différences entre l’utilisation du .NET Assembly Connector et l’écriture d’un connecteur personnalisé.
Le code d’assembly de connectivité .NET doit exposer les opérations stéréotypées comprises par Business Connectivity Services. Pour plus d’informations sur les stéréotypes, voir Opérations stéréotypées prises en charge par le service BDC.
L’écriture d’un assembly de connectivité .NET nécessite l’exécution des tâches suivantes :
Écrire du code en tant que classes Microsoft .NET Framework et compiler les classes en une DLL principal et en plusieurs DLL dépendantes.
Publier la DLL dans une base de données du Service BDC (Business Data Connectivity) à l’aide du déploiement de package de solution (WSP) ou à l’aide d’applets de commande Windows PowerShell fournies par SharePoint 2010.
Utiliser Microsoft SharePoint Designer pour découvrir la DLL et créer un modèle.
Mapper chaque entité à une « Classe » dans la DLL et mapper chaque opération BDC dans cette entité à une méthode à l’intérieur de cette « Classe ».
Au moment de l’exécution, lorsqu’un utilisateur exécute une opération BDC, la méthode correspondante dans la DLL principale ou dans une DLL dépendante est exécutée.
Comment créer un assembly de connectivité .NET
Pour découvrir comment créer un assembly de connectivité .NET à l’aide de Visual Studio 2010, voir les articles suivants :
Comment étendre un type de contenu externe créé dans Visual Studio 2010 à l’aide de SharePoint Designer 2010
Vous pouvez modifier un type de contenu externe qui a été créé et déployé à l’aide de Visual Studio 2010 dans SharePoint Designer 2010. Cela peut être nécessaire si vous souhaitez attacher des fonctionnalités clientes Microsoft Office au type de contenu externe, par exemple mapper le type de contenu externe à un type d’élément Microsoft Outlook et activer le travail hors connexion. Pour cela, procédez comme suit :
Dans SharePoint Designer, ouvrez le site SharePoint qui contient le type de contenu externe.
Cliquez sur Types de contenu externe, puis sur le type de contenu externe que vous avez créé à l’aide de Visual Studio.
Dans le champ Type d’élément Office, sélectionnez le type d’élément Outlook auquel ce type de contenu externe est mappé.
Dans le champ Synchronisation hors connexion pour la liste externe, sélectionnez Activé.
Cliquez sur le bouton Mode de création d’opérations dans le Ruban pour modifier l’opération Élément en lecture. Mappez les paramètres de retour de l’opération Élément en lecture aux propriétés Outlook appropriées.
Cliquez sur Enregistrer pour enregistrer les modifications dans la Banque de métadonnées BDC. Vous avez maintenu étendu le type de contenu externe créé à l’aide de Visual Studio 2010 avec des fonctionnalités clientes et de travail hors connexion.
Comment créer un type de contenu externe basé sur un assembly de connectivité .NET à l’aide de SharePoint Designer 2010
Il peut arriver que vous ayez déjà un assembly .NET qui contient des méthodes qui renvoient des données externes aux formats correctes attendus par BDC. Dans ces cas-là, vous pouvez déployer l’assembly dans la Banque de métadonnées BDC puis simplement utiliser le Concepteur de type de contenu externe dans SharePoint Designer 2010 pour créer un type de contenu externe qui établit une connexion à un assembly .NET. La procédure de création de type de contenu externe qui se connecte à un assembly .NET est similaire à la celle applicable à un type de contenu externe qui se connecte à un service WCF.
Ouvrez SharePoint Designer et effectuez les étapes décrites dans Procédure : Créer un type de contenu externe basé sur un service Web pour créer un type de contenu externe. À l’exception de la procédure « Ajouter une connexion au système externe », tout est exactement identique. Pour ajouter une connexion à un assembly .NET, effectuez les étapes suivantes.
Sélectionnez Cliquez ici pour découvrir les sources de données externes et définir les opérations en regard de Système connecté.
Dans la boîte de dialogue Ajouter une connexion, cliquez sur Type .NET.
Dans la boîte de dialogue Sélection du type .NET, cliquez sur le bouton Parcourir pour spécifier le système externe (LOBSystem) dans la Banque de métadonnées BDC qui contient la référence à l’assembly .NET auquel vous souhaitez vous connecter. Sélectionnez le système et cliquez sur OK.
Vous devriez maintenant voir tous els types .NET publics définis dans l’assembly et les méthodes qu’ils contiennent. Définissez les opérations comme vous le feriez pour un service Web, comme expliqué dans Procédure : Créer un type de contenu externe basé sur un service Web.
Cliquez sur Enregistrer pour enregistrer les modifications dans la Banque de métadonnées BDC. Vous avez maintenant créé un type de contenu externe qui établit une connexion à un assembly .NET.