Partager via

Utilisation de l’API REST Excel Services 2010

  • Article

Bannière Démarrage rapide SharePoint
Prise en main du développement Web dans SharePoint 2010 : découvrez comment utiliser l’API REST Excel Services pour accéder à des éléments et exploiter des données dans une feuille de calcul.

Dernière modification : jeudi 27 janvier 2011

S’applique à : Excel Services | Office 2010 | SharePoint Foundation 2010 | SharePoint Server 2010 | Visual Studio 2010

Dans cet article
Découvrir les éléments d’un classeur
Récupérer différents éléments dans différents formats
Modifier des valeurs de données
Étapes suivantes

L’API REST Excel Services 2010 est une nouvelle infrastructure de programmabilité qui facilite la découverte des données et des objets dans une feuille de calcul et l’accès à ceux-ci. Si vous pouvez écrire une URL, vous pouvez utiliser l’API REST. Cela rend cette dernière accessible aux non-développeurs, tout en offrant des fonctionnalités qui en font un outil très puissant pour les développeurs professionnels. Dans ce scénario, vous allez découvrir plusieurs exemples d’utilisation de l’API REST pour accéder à des objets et exploiter des données dans un classeur qui se trouve sur un site SharePoint 2010. Ce scénario comprend les tâches suivantes :

  • Découvrir les éléments d’un classeur

  • Récupérer différents éléments dans différents formats

  • Modifier des valeurs de données

Ce scénario suppose qu’un classeur nommé Sales_Report.xlsx est enregistré dans une bibliothèque de documents sur un site SharePoint 2010. Le classeur contient deux plages, un graphique, un tableau et un tableau croisé dynamique.

Découvrir les éléments d’un classeur

Dans cette tâche, vous utilisez l’API REST pour découvrir les différents objets de l’exemple de classeur. Supposons que le classeur se trouve à l’emplacement http://monserveur/monsiteWeb/shared%20documents/Sales_Report.xlsx.

Pour découvrir les éléments du classeur

  1. Ouvrez le site Web contenant le classeur dans un navigateur.

  2. Dans l’URL qui apparaît dans la zone d’adresse du navigateur, ajoutez _vti_bin/ExcelRest.aspx/ après le nom du site Web afin que l’URL soit similaire à celle de l’exemple suivant.

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx

  3. Après le nom du classeur, ajoutez le mot Model. L’URL doit ressembler à l’exemple suivant.

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model

  4. Appuyez sur la touche Entrée. Au bout de quelques instants, le navigateur affiche une page similaire à celle illustrée dans la figure 1 dans un format de flux ATOM.

    Figure 1. L’API REST retourne cette page Web

    L’API REST retourne cette page Web

Actuellement, l’API REST peut accéder aux plages, aux graphiques, aux tableaux et aux tableaux croisés dynamiques. L’API REST retourne des éléments dans les formats suivants :

  • image ;

  • HTML ;

  • flux Atom ;

  • classeur Excel.

Récupérer différents éléments dans différents formats

Dans cette tâche, vous écrivez des URL avec une notation API REST qui retournent différents éléments. Vous pouvez utiliser les éléments retournés dans des pages Web, des blogs, des wikis, incorporer des graphiques actifs sous la forme d’image liée dans un document Word 2010, une présentation PowerPoint 2010 ou un courrier Outlook 2010 ou bien créer des applications Web hybrides qui utilisent Excel Services pour le calcul, les fonctions graphiques et en tant que source de données.

Pour récupérer des éléments du classeur

  1. Ouvrez un navigateur Web et, dans la zone d’adresse, tapez l’URL suivante, puis appuyez sur la touche Entrée.

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Ranges

    La page Web illustrée dans la figure 2 apparaît. Notez qu’elle contient les noms de quatre plages nommées.

    Figure 2. Classer les listings

    Classer les listings

  2. Dans la zone d’adresse du navigateur, ajoutez le texte ci-après à l’URL, juste après le mot Ranges, puis appuyez sur la touche Entrée. Cela permet d’afficher les données de la plage RegionalSalesSummary au format HTML (figure 3).

    ('RegionalSalesSummary')?$format=HTML

    Figure 3. Données récapitulatives des ventes régionales

    Données récapitulatives des ventes régionales

  3. La découverte des graphiques et des tableaux et l’accès à ceux-ci est tout aussi simple. Tapez l’URL suivante dans le navigateur et vous verrez le graphique ResellerSalesChart s’afficher sous la forme d’une image (figure 4).

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Sales%20Reports/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?$format=image

    Figure 4. Graphique des ventes par revendeur

    Graphique des ventes par revendeur

  4. Outre les plages nommées, vous pouvez renvoyer des plages normales. L’URL suivante retourne la plage A1:D4 de la feuille Sheet2.

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Ranges(‘Sheet2!A1|D4’)?$format=HTML

    Notez que vous devez remplacer le symbole deux-points dans la notation de style A1 pour les plages par une barre verticale.

Modifier des valeurs de données

L’API REST permet de modifier les valeurs du classeur. Ces modifications n’affectent que les valeurs, les informations de rendu HTML ou les graphiques retournés par l’API REST pour la demande formulée. Ces modifications ne sont pas enregistrées dans le classeur et n’ont aucune incidence sur les autres sessions de navigateur de l’API REST ou d’Excel Web Access. Dans cette tâche, vous écrivez une URL qui modifie de 167 690 € à 0 € les données de ventes pour le type de revendeur Chaîne de magasins afin de voir l’impact de la modification sur le graphique des ventes par revendeur. Avant la modification, le graphique et la valeur associée au type Chaîne de magasins se présentent comme indiqués dans la figure 5.

Figure 5. Graphique des ventes par revendeur avant la modification

Graphique des ventes par revendeur avant la modification

Pour modifier des valeurs de données dans un graphique

  1. Dans le navigateur, remplacez l’URL par l’URL ci-après, appuyez sur la touche Entrée et observez la modification de la valeur Chaîne de magasins, comme l’illustre la figure 6.

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0

    Figure 6. Graphique des ventes par revendeur après la modification

    Graphique des ventes par revendeur après la modification

  2. Vous pouvez également placer des valeurs dans différentes cellules à l’aide de l’URL suivante.

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellersSalesChart')?Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011

  3. En outre, vous pouvez placer des valeurs dans différentes cellules et spécifier une mise en forme spécifique ou commune à l’aide des URL suivantes, respectivement.

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011?$format=HTML

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0&?format=HTML&Ranges('FiscalYear')=2011

    http://monserveur/monsiteWeb/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?$format=HTML&Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011

Étapes suivantes