Conseils d'utilisation des services Web
Dernière modification : mercredi 7 juillet 2010
S’applique à : SharePoint Foundation 2010
Les services Web Microsoft SharePoint Foundation fournis par l'espace de noms Microsoft.SharePoint.SoapServer incluent des méthodes pour accéder au contenu d'un site Web, par exemple pour utiliser des listes ou des données du site, ainsi que des méthodes pour personnaliser les réunions, la création d'images, les espaces de travail de documents ou la recherche.
Important
Chaque fois que possible, il est recommandé d’utiliser le nouveau modèle objet côté client pour utiliser à distance les données SharePoint Foundation, au lieu d’utiliser les services Web ASP.NET existants décrits ici-même.
Les interfaces SOAP utilisées dans ces services fournissent aux développeurs Microsoft .NET Framework des modèles d’objet permettant de créer des solutions qui fonctionnent avec SharePoint Foundation à distance à partir d’une application cliente ou personnalisée. Les interfaces sont définies par l’intermédiaire du modèle objet côté serveur de l’assembly Microsoft.SharePoint, et leur conception est optimisée afin de réduire le nombre de boucles traitées entre l’ordinateur client et le serveur.
La plupart des services Web fournissent leurs fonctionnalités par le biais du répertoire virtuel /_vti_bin, qui correspond au répertoire physique ISAPI %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\du système de fichiers. Le service d’administration Web utilise le répertoire virtuel /_vti_adm, qui correspond à ADMISAPI %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\.
Notes
SharePoint Foundation ne nécessite pas l’implémentation d’une version particulière de SOAP. La réponse SOAP dans toute transaction effectuée avec SharePoint Foundation est gérée par le .NET Framework.
Instructions sur l’utilisation des services Web ASP.NET
Vous pouvez créer un projet dans Microsoft Visual Studio, comme une application Windows Forms ou une application console, qui utilise un service Web SharePoint Foundation pour interagir avec des données de liste et de site SharePoint. Après avoir créé un projet, vous devez définir une référence au service Web que vous souhaitez implémenter dans votre code, en spécifiant le chemin d’accès complet du service Web par rapport au site contenant les données.
Pour ajouter une référence à un service Web SharePoint Foundation dans Visual Studio
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence de service.
Dans la boîte de dialogue Ajouter une référence de service, cliquez sur Paramètres avancés, et dans la boîte de dialogue Paramètres de référence de service, cliquez sur Ajouter une référence Web.
Dans la boîte de dialogue Ajouter une référence Web, pour URL, tapez l’URL absolue pour le service Web en spécifiant un chemin d’accès qui inclut le site Web pour lequel le service Web sera disponible. Par exemple, si vous voulez ajouter une référence à un service Web Listes, spécifiez le chemin en respectant le format suivant :
http://MyServer/[sites/][MySite/][MySubsite/]_vti_bin/Lists.asmxSi vous utilisez des méthodes dans le service Web d’administration, spécifiez plutôt un chemin d’accès qui conduit au port d’administration et qui utilise _vti_adm en tant que répertoire virtuel, comme suit.
http://MyServer:Port_Number/_vti_adm/Admin.asmxPour obtenir la liste des services Web ASP.NET par défaut fournis par SharePoint Foundation, voir Services Web SharePoint Foundation 2010.
Tapez un nom de référence Web, puis cliquez sur Ajouter une référence.
Instanciation d'un service
Instanciez un service Web au sein du code en utilisant un constructeur comme suit : Web_Reference.Service_NameServiceInstance = new Web_Reference.Service_Name(). Web_Reference représente le nom utilisé pour la référence au service Web dans Visual Studio et Service_Name le nom de la classe qui fournit les méthodes pouvant être appelées par le biais du service Web.
Établissement des informations d'identification utilisateur
Pour établir les informations d’identification du système correspondant au contexte de sécurité actuel dans lequel l’application s’exécute, ajoutez la ligne suivante après la ligne précédente ; celle-ci authentifie l’utilisateur ou le groupe qui exécute le code en passant ses informations d’identification par défaut au service Web à partir du cache des informations d’identification du système.
ServiceInstance.Credentials = System.Net.CredentialCache.DefaultCredentials
ServiceInstance.Credentials = System.Net.CredentialCache.DefaultCredentials;
Tâches de programmation
Les tâches de programmation suivantes montrent comment utiliser l’un des services Web par défaut fournis dans SharePoint Foundation :
Procédure : ajouter des utilisateurs à un groupe
Procédure : retourner des listes
Procédure : renvoyer des éléments de liste
Procédure : mettre à jour des éléments de liste
Procédure : personnaliser les espaces de travail de réunion en utilisant le service Web Réunions
Procédure : supprimer une réunion d'un espace de travail de réunion
Pour plus d’informations sur la création d’un service Web ASP.NET personnalisé qui implémente le modèle objet côté serveur SharePoint Foundation, voir Procédure pas à pas : création d’un service Web ASP.NET personnalisé. Pour plus d’informations sur la création d’un service WCF personnalisé qui implémente le modèle objet, ce qui constitue la solution recommandée pour créer un service Web dans SharePoint Foundation, voir Procédure pas à pas : création et implémentation d’un Service WCF personnalisé dans SharePoint Foundation.