Utilisation du modèle objet Liste SharePoint et du modèle objet Client SharePoint avec des listes externes
Dernière modification : jeudi 15 avril 2010
S’applique à : SharePoint Server 2010
Dans cet article
Avantages offerts par l’utilisation du modèle objet Liste et du modèle objet Client SharePoint
Limitations liées à l’utilisation du modèle objet client et du modèle objet Liste SharePoint
Choses à savoir lors de l’utilisation du modèle objet Liste avec des listes externes
Vous pouvez manipuler par programme des données externes exposées par le biais de Microsoft Business Connectivity Services (BCS) à l’aide des modèles objet suivants :
le modèle objet BDC, disponibles sur le serveur et le client ;
le modèle objet Microsoft SharePoint 2010, qui se compose de la classe SPList dans le modèle objet côté serveur dans l’espace de noms Microsoft.SharePoint et de sa classe équivalente List dans le modèle objet côté client dans les espaces de noms Microsoft.SharePoint.Client et Microsoft.SharePoint.Client.Silverlight.
Le Tableau 1 récapitule les modèles objet disponibles.
Tableau 1. Modèles objet serveur et client SharePoint disponibles
Modèle objet |
Serveur |
Client |
Description |
|---|---|---|---|
Modèle objet BDC |
Oui |
Oui |
Procure une bibliothèque d’espaces de noms fournis par Business Connectivity Services. Présent dans SharePoint Foundation 2010, SharePoint Server 2010 et Office Professionnel Plus 2010. Le modèle objet BDC effectue des opérations Create, Read, Update et Delete (CRUD) par le biais d’un type de contenu externe sur les données du système externe à partir du serveur et du client de manière symétrique. |
Classe SPList (modèle objet côté serveur) |
Oui |
Non |
Représente une liste sur un site Web SharePoint. (Microsoft.SharePoint.dll) La classe SPList repose sur le modèle objet BDC pour effectuer des opérations CRUD sur une liste externe à partir du serveur. |
Modèle objet côté client |
Non |
Oui |
Représente les API clientes SharePoint Foundation 2010 pour l’interaction avec des sites SharePoint à partir d’applications managées Microsoft .NET Framework, d’applications Microsoft Silverlight et à partir d’ECMAScript (JavaScript, JScript) qui s’exécute dans le navigateur. Les API permettent d’interagir avec des données SharePoint depuis un ordinateur distant, en extrayant un objet de contexte client pour obtenir l’accès aux objets clients à un niveau de collection de site ou à un niveau inférieur. (Microsoft.SharePoint.Client.dll et Microsoft.SharePoint.Client.Silverlight.dll) Le modèle objet côté client repose sur la classe SPList pour effectuer des opérations CRUD à partir du client par le biais des services Web SharePoint. |
Le diagramme d’architecture suivant montre les modèles objet présents sur le serveur et sur le client, la manière dont ils interagissent les uns avec les autres et avec d’autres composants Business Connectivity Services, ainsi que la manière dont ils interagissent avec des solutions générées à l’aide de Business Connectivity Services.
Figure 1. Modèles objet sur le serveur et le client
.gif "SharePoint Server et architecture de client riche")
Vous pouvez choisir contre quel point d’entrée de pile programmer sur le client ou sur le serveur. La classe SPList possède toutefois des limitations ; si celles-ci posent problème, vous pouvez utiliser des API de niveau inférieur dans le modèle objet BDC pour manipuler les types de contenu externe réels.
Avantages offerts par l’utilisation du modèle objet Liste et du modèle objet Client SharePoint
Voici les avantages offerts par l’utilisation des modèles objet Liste et Client SharePoint.
Modèle objet simple et familier Le modèle objet Liste SharePoint (classe SPList) est facile à utiliser et bien connu des développeurs SharePoint.
Disponibilité. Le modèle objet BDC est disponible uniquement sur les clients sur lesquels Office Professionnel Plus 2010 est installé. Toutefois, le modèle objet SharePoint est disponible à la fois sur le serveur et sur le client.
Exécution dans un environnement de confiance partielle. Le modèle objet SharePoint peut s’exécuter dans un environnement de confiance partielle, ce qui n’est pas le cas des modèles objet BDC.
Limitations liées à l’utilisation du modèle objet client et du modèle objet Liste SharePoint
Voici les limitations liées à l’utilisation des modèles objet Liste et Client SharePoint.
Listes externes obligatoires. Les modèles objet Client et Liste SharePoint effectuent des opérations CRUD sur une liste externe à partir du serveur. Par conséquent, ils nécessitent la création d’une liste externe sur le serveur. Le modèle objet BDC ne présente pas cette exigence, car il effectue les opérations CRUD directement par le biais d’un type de contenu externe.
Fonctionne uniquement pour les types simples pris en charge. Les modèles objet Client et Liste SharePoint fonctionnent uniquement si la liste externe possède des champs simples. De par leur conception, les listes externes sont des représentations de données plates et basées sur des lignes. Les types complexes et les types simples qui ne sont pas pris en charge par le système de type Liste SharePoint sont omis. Plus spécifiquement, vous ne pouvez pas avoir de champs des types suivants :
Types complexes Par exemple, un champ « CustomerAddress » dans le cadre de la structure « Customer », qui à sont tour possède des éléments enfants définissant « Street », « City », « State » et « PostalCode ».
Types personnalisés Par exemple, un champ « Resume » dans le cadre de la structure « Applicant », qui peut ne pas avoir d’éléments enfants mais ne peut pas être représentée à l’aide de l’un des champs de type Liste SharePoint pris en charge.
Types .NET non pris en charge Les types .NET Framework suivants ne sont pas pris en charge par les listes externes : System.GUID, System.Object, System.URI, System.UInt64 et System.Int64. Par conséquent, si l’un des champs de la liste externe est d’un type .NET Framework répertorié ici, ce champ est omis.
Le modèle objet BDC ne présente pas cette exigence et peut fonctionner avec tous les types de champs complexes mentionnés ici.
Aucune prise en charge des fonctionnalités avancées du service BDC. Les modèles objet Client et Liste SharePoint ne prennent pas en charge les fonctionnalités avancées suivantes prises en charge par le service BDC :
Pagination Les listes externes ne fournissent pas de pagination ou de segmentation des données.
Opérations en bloc Les listes externes ne peuvent pas effectuer d’opérations en bloc, telles que la lecture simultanée de 25 instances.
Diffusion en continu Il n’y a aucune prise en charge de la diffusion en continu de données (telles que des objets BLOB) à partir de systèmes externes.
Associations complexes Les listes externes ne prennent pas en charge les associations.
Choses à savoir lors de l’utilisation du modèle objet Liste avec des listes externes
BdcIdentity est un champ de l’objet Liste SharePoint qui représente l’identité d’un élément de liste spécifique. Il s’agit de la seule manière déterministe d’identifier de manière unique un élément de liste particulier. Vous pouvez l’obtenir à l’aide de la collection Fields de l’objet SPList. Pour obtenir des exemples, voir Extraits de code : Utilisation du modèle objet Liste SharePoint avec des listes externes sur le serveur et Extraits de code : Utilisation du modèle objet Client SharePoint avec des listes externes.
L’ItemID des éléments de liste externe est toujours zéro. Vous devez utiliser BdcIdentity à la place.
Lorsque vous utilisez le modèle objet Client SharePoint avec des listes externes, d’autres facteurs doivent être pris en considération. Pour plus d’informations, voir Extrait de code : obtenir les données d’éléments d’une liste externe sur le client.
Voir aussi
Concepts
Définition du contexte pour l’utilisation des modèles objet BDC
Autres ressources
Extraits de code : Utilisation du modèle objet Client SharePoint avec des listes externes
Extraits de code du modèle objet des services Business Connectivity