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

  • Article

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 préalables

In order to complete this walkthrough, you will need:

  • 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 ;

    Remarque

    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 ;

    Remarque

    Pour plus d’informations sur la façon d’approuver un emplacement, consultez How to : Trust a Location et How to : Trust Workbook Locations Using Script.

  • Pour 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 de classeur

  • 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.

    Remarque

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

Voir aussi