Créer un type de contenu externe à partir d’une source OData dans SharePoint

Article
03/21/2023

Découvrez comment utiliser Visual Studio 2012 pour découvrir une source OData publiée et créer un type de contenu externe réutilisable pour utilisation dans Business Connectivity Services (BCS) dans SharePoint.

Conditions préalables à la création de types de contenu externe OData

Pour créer un type de contenu externe à partir d'une source d'Open Data protocol (OData), vous devez les éléments suivants :

Une instance de SharePoint
Visual Studio 2012
Outils de développement Office pour Visual Studio 2012
Un service OData publiée disponible via Internet

Pour plus d’informations sur la configuration de votre environnement de développement SharePoint, voir Configurer un environnement de développement général pour SharePoint.

Remarque

[!REMARQUE] SharePoint Designer 2013 ne peut être utilisé pour générer automatiquement des modèles BDC à partir d'une source OData. Vous pouvez utiliser Visual Studio 2012 à la place.

Concepts de base pour l’utilisation des types de contenu externe OData

Les articles suivants fournissent des informations générales sur OData et le connecteur OData dans SharePoint.

Tableau 1. Concepts de base pour les types de contenu externe OData

Titre d’article	Description
À l'aide de sources OData avec Business Connectivity Services dans SharePoint	Démarrez en créant des types de contenu externe basés sur des sources OData et découvrez comment utiliser ces données dans les composants SharePoint ou Office.
Types de contenu externe dans SharePoint	Découvrez les types de contenu externe BCS et les éléments nécessaires à leur création dans SharePoint.

Créer un type de contenu externe OData

Les étapes suivantes indiquent comment utiliser Visual Studio 2012 pour créer un type de contenu externe basé sur une source OData.

Pour créer un complément SharePoint

Dans Visual Studio 2012, créez un projet Application pour SharePoint, qui se trouve sous le nœud Modèle SharePoint.
Nommez votre projet, puis choisissez OK.
Pour spécifier les paramètres de SharePoint, entrez un nom pour votre application et l'URL du serveur SharePoint que vous allez déboguer.
Cliquez sur Terminer.

Une fois le projet créé, vous utilisez la création automatique de nouvelle outils pour les sources OData et ajoutez un modèle BDC pour la source OData à votre application.

Pour ajouter un nouveau modèle BDC

Dans L'Explorateur de solutions, ouvrez le menu contextuel du projet et choisissez Ajouter, types de contenu pour la source de données externe.

Cette opération démarre un Assistant qui vous aideront à découvrir les sources de données sélectionnées et créer le modèle BDC.
La première page de l'Assistant sert à collecter l'URL du service de données. Dans la page Spécifier la Source de OData, entrez l'URL du service OData que vous souhaitez vous connecter. L'URL doit ressembler à ce qui suit : http://services.odata.org/Northwind/Northwind.svc/.

Remarque

Vous allez afficher le service Northwind disponible dans la liste des producteurs disponible sur le site web Open Data Protocol.
Choisissez un nom pour votre source OData, puis cliquez sur suivant.
Une liste des entités de données qui sont exposés par le OData Service apparaît. Sélectionnez une ou plusieurs des entités, cliquez sur Terminer.

Pour afficher la structure des entités

Notez que Visual Studio créé un nouveau dossier nommé des Types de contenu externe. À l'intérieur de ce dossier, vous trouverez un sous-dossier avec le nom de votre nouvelle source de données. Si vous développez davantage ceci, vous verrez un élément qui représente l'entité que vous avez sélectionné. Pour afficher la liste des entités et leurs types de graphique, ouvrez le fichier de type de contenu externe que vous souhaitez afficher.

Vous pouvez également afficher le code XML des entités en ouvrant les fichiers de type de contenu externe dans un éditeur XML.

Utiliser un accesseur de flux pour la source OData

Le code suivant, vous pouvez accéder à un flux de données utilisable par le connecteur OData.


/*Invoke  Stream Accessor Method */
        internal void ExecuteStreamAccessorMethod(IEntityInstance entityInstance, string streamAccessorName)
        {
            this.Log.Comment("ExecuteStreamAccessorMethod enter");
            this.Log.Comment("streamAccesor method" + streamAccessorName);
            IStreamableField isf = entityInstance.GetStreamableField(streamAccessorName);
            Stream resStream = isf.GetData();
            using (BinaryReader reader = new BinaryReader(resStream))
            {
                using (FileStream fs = File.Create(@"C:\\" + entityInstance.GetIdentity().GetIdentifierValues()[0] + ".jpg"))
                {
                    int bytesRead = 0;
                    do
                    {
                        int nrBytes = 80 * 1000 * 1000;
                        byte[] streamData = new byte[nrBytes];
                        bytesRead = reader.Read(streamData, 0, nrBytes);
                        this.Log.Comment("Total Bytes Read - " + bytesRead);
                        if (bytesRead > 0)
                        {
                            fs.Write(streamData, 0, bytesRead);
                        }
                    } while (bytesRead > 0);
                }
            }
            isf.Dispose();
            this.Log.Comment("ExecuteStreamAccessorMethod Exit" );
        }

Étapes suivantes

Une fois que vous avez créé un type de contenu externe, vous pouvez l’utiliser pour présenter des données au cœur de SharePoint en utilisant les objets intégrés (des listes externes, des composants WebPart de données de l'entreprise ou du code personnalisé).

Pour plus d’informations, voir Guide pratique pour créer une liste externe à l’aide d’une source de données OData dans SharePoint.

Partager via