Procédure pas à pas : développement d'une application personnalisée à l'aide des services Web Excel

Article
09/18/2014

Dernière modification : mercredi 24 mars 2010

S’applique à : SharePoint Server 2010

La procédure pas à pas de cette section décrit le processus permettant d'accéder aux Excel Web Services à partir d'une application créée avec Microsoft Visual C#.

Au cours de cette procédure pas à pas, vous apprendrez à :

créer une application cliente à l’aide du modèle de projet Application console Microsoft Visual Studio ;
ajouter une référence Web pour les Excel Web Services ;
écrire du code pour accéder au service Web. Vous allez apprendre à ouvrir un classeur, obtenir l'ID de session, passer les informations d'identification par défaut, obtenir les informations de version du service Web, définir l'objet de coordonnées de plage, obtenir la plage qui utilise l'objet de coordonnées de plage, fermer le classeur, et intercepter l'exception SOAP ;
tester et exécuter l'application console en mode débogage.

Une application console cliente est simplement un moyen d'accéder au service Web. Il existe une méthode plus commune qui consiste à utiliser des applications serveur, par exemple les applications Microsoft ASP.NET. Cette procédure pas à pas utilise un exemple d'application console pour des raisons de simplicité, afin de mettre en relief les aspects relatifs aux API des Excel Web Services.

Conditions requises

Pour exécuter cette procédure pas à pas, vous avez besoin des éléments suivants :

Microsoft SharePoint Server 2010.
Visual Studio ou un outil de développement similaire compatible avec Microsoft .NET Framework ;
des autorisations suffisantes (au minimum, les autorisations d’« affichage ») pour pouvoir accéder à Excel Web Services sur l’ordinateur où se trouve SharePoint Server 2010 ;

Notes

Pour plus d'informations sur les autorisations spécifiques aux classeurs, voir la section ci-après, « Autorisations relatives aux classeurs ».
un exemple de classeur installé sur un lecteur local ou dans une bibliothèque de documents SharePoint locale ;
un emplacement approuvé où stocker les classeurs auxquels vous souhaitez accéder à l'aide des Excel Web Services. Si les classeurs ne sont pas stockés dans un emplacement approuvé, les appels des Excel Web Services pour ouvrir le classeur échoueront. Cette procédure pas à pas suppose que le classeur est présent sur l'ordinateur local ;

Notes

Pour plus d'informations sur la façon d'approuver un emplacement, voir Procédure : Approuver un emplacement et Procédure : approuver les emplacements des classeurs à l'aide de scripts.
créer le classeur à l’aide d’Excel ;
l'enregistrement du classeur en tant que fichier .xlsx ou .xlsb.

Le classeur utilisé dans cet exemple a une feuille de calcul intitulée « Sheet1 ». La feuille de calcul comporte 11 colonnes et 19 lignes. Chaque cellule de A1 à K19 contient une valeur numérique, par exemple 4245.955, 6960.673, etc.

Autorisations relatives aux classeurs

Pour obtenir l’intégralité du classeur (par exemple, en appelant la méthode GetWorkbook), l’appelant doit disposer de l’autorisation d’ouverture du classeur.
Pour appeler la méthode GetApiVersion, aucune autorisation n'est nécessaire.
Pour le reste des méthodes d’Excel Web Services, l’appelant nécessite une autorisation d’affichage (dans Microsoft SharePoint Foundation) ou de lecture (sur un partage de fichiers) pour le classeur.

Notes

Pour plus d’informations sur la configuration des autorisations, voir la documentation de SharePoint Foundation.