Guide de développement d'Excel Services

Article
09/18/2014

Dernière modification : mercredi 14 avril 2010

S’applique à : SharePoint Server 2010

Dans cet article
Service Web Excel
Fonctions définies par l'utilisateur (UDF)
Excel Web Access
ECMAScript (JavaScript, JScript)
API REST

L’un des aspects importants d’Excel Services est que les développeurs de solutions peuvent utiliser sa puissance par programme depuis leurs applications. Il peut s’agir de produits métiers ou de solutions d’entreprise personnalisées qu’une organisation développe en interne.

Voici quelques exemples de ces applications :

Applications multiniveaux, dont la couche de présentation est implémentée sous la forme d’une application Web (par exemple une application ASP.NET) qui appelle Excel Web Services.
Applications dans Microsoft SharePoint Server 2010 ou intégrées à des produits d’entreprise.

Cinq types de développement peuvent être effectués à l’aide d’Excel Services :

Développement de solutions à l’aide d’Excel Web Services
Extension de la bibliothèque de fonctions Microsoft Excel dans Excel Services à l’aide de fonctions définies par l’utilisateur
Personnalisation du composant WebPart Excel Web Access
Développement de solutions à l’aide d’ECMAScript (JavaScript, JScript)
Utilisation de l’API REST pour effectuer des opérations sur des classeurs Excel

Service Web Excel

Les principaux scénarios d’Excel Web Services sont les suivants :

Server-side Excel calculation

Ce scénario est orienté application. Dans celui-ci, vous utilisez des modèles définis dans des classeurs Excel et calculés sur le serveur dans le cadre de la logique d’application.
Automating workbook updates on the server

Ce scénario est orienté fichier. Dans celui-ci, Excel Web Services traite un classeur et enregistre des copies du classeur ou des captures instantanées.
Opening workbooks in edit sessions

Excel Web Services prend en charge l’ouverture de classeurs dans des sessions d’édition dans SharePoint Server 2010. Dans ce scénario, vous utilisez du code pour modifier un classeur.

Calcul Excel côté serveur

Pour le calcul Excel côté serveur, une application personnalisée utilise généralement un modèle Excel dans sa logique. Au lieu de devoir recoder la logique métier du classeur Excel dans un langage de programmation, l’utilisateur professionnel peut conserver le modèle dans Excel dans un emplacement de serveur. Le développeur n’a jamais besoin de modifier aucune ligne de code dans l’application qui utilise le modèle créé par l’utilisateur professionnel.

Dans ce scénario, l'application personnalisée appelle à plusieurs reprises Excel Web Services, qui envoie les appels à un service de calcul principal. Excel Calculation Services effectue les opérations suivantes :

Charge le classeur Excel spécifié
Reçoit des entrées
Traite le classeur (par exemple, actualise les données ou effectue des calculs)
Envoie les résultats à l'application personnalisée

Automatisation des mises à jour des classeurs sur le serveur

Lorsque les développeurs automatisent la mise à jour des classeurs Excel sur le serveur, ils ont souvent deux objectifs :

générer des fichiers Excel ou modifier des modèles Excel à l’aide de Formats Open XML, puis calculer le fichier Excel généré ;
ouvrir périodiquement un fichier Excel pour actualiser les données externes (une seule fois, ou éventuellement plusieurs fois par utilisateur), puis calculer les classeurs résultants et les enregistrer ou les envoyer par courrier aux différents utilisateurs.

Dans ce scénario, une application personnalisée utilise Excel Web Services pour effectuer les opérations suivantes :

Charger le classeur Excel spécifié
Paramètres d'entrée
Traiter le classeur (par exemple, actualiser les données ou effectuer des calculs)

L’application personnalisée extrait la version active du classeur ou la capture instantanée, puis utilise Excel Web Services pour enregistrer le classeur ou la capture instantanée.

Notes

Lorsque vous apportez des modifications à un classeur, par exemple en affectant des valeurs à une plage à l’aide d’Excel Web Services, ces modifications sont conservées uniquement pour cette session particulière. Elles ne sont pas enregistrées ou rendues persistantes dans le classeur d’origine. Lorsque la session de classeur en cours se termine (par exemple lorsque vous appelez la méthode CloseWorkbook ou que la session expire), les modifications que vous avez apportées sont perdues.

Si vous souhaitez enregistrer les modifications que vous apportez à un classeur, vous pouvez utiliser la méthode GetWorkbook puis enregistrer le classeur à l’aide de la méthode SaveWorkbook ou SaveWorkbookCopy Pour plus d’informations sur l’API Excel Web Services, voir Microsoft.Office.Excel.Server.WebServices.

Utilisation des services Web Excel

Vous pouvez utiliser Excel Web Services en tant que :

service Web régulier en appelant les méthodes Web par le biais du protocole SOAP (Simple Object Access Protocol) sur HTTP ;
assembly local par une liaison directe à Microsoft.Office.Excel.Server.Webservices.dll.

Pour plus d’informations sur le moment propice à une liaison directe à Microsoft.Office.Excel.Server.Webservices.dll, voir Appels SOAP de retour de boucle et liaison directe.

Pour plus d’informations sur l’API Excel Web Services, voir la documentation de référence de l’espace de noms Microsoft.Office.Excel.Server.Webservices. Pour un exemple illustrant la manière de développer une application personnalisée à l’aide d’Excel Web Services, voir Procédure pas à pas : développement d'une application personnalisée à l'aide des services Web Excel.

Fonctions définies par l'utilisateur (UDF)

Excel Services prend en charge les fonctions UDF à code managé. Les fonctions UDF Excel Services vous permettent d’utiliser des formules dans des cellules pour appeler des fonctions personnalisées écrites en code managé et déployées sur SharePoint Server 2010. Vous pouvez créer des fonctions UDF pour :

Appeler des fonctions mathématiques personnalisées.
Obtenir des données à partir des sources de données personnalisées dans des feuilles de calcul.
Appeler des services Web à partir des fonctions UDF.
Envelopper des appels à des fonctions de bibliothèque de code natif existant, par exemple, des fonctions UDF Excel existantes.

Pour plus d'informations sur les fonctions définies par l'utilisateur Excel Services, voir Présentation des fonctions définies par l'utilisateur Excel Services.

À l'aide des fonctions UDF

Pour plus d’informations sur les définitions de fonctions UDF Excel Services, voir la documentation de référence de l’espace de noms Microsoft.Office.Excel.Server.Udf.

Pour consulter un exemple de création de fonctions UDF à code managé, voir Procédure pas à pas : développement d'une UDF avec code managé.

Excel Web Access

Vous pouvez utiliser les propriétés extensibles du composant WebPart Excel Web Access pour :

Configurer Excel Web Access par programme.
Modifier par programme les propriétés Excel Web Access.
Appliquer un thème ou personnaliser une page de composants WebPart à l’aide de feuilles de style en cascade (CSS).

Utilisation de l’extensibilité du composant WebPart Excel Web Access

Pour obtenir des informations sur :

les propriétés extensibles Excel Web Access, voir la documentation de référence de l’espace de noms Microsoft.Office.Excel.Server.WebUI.
CSS Excel Web Access, voir la documentation de référence CSS.
la façon de configurer par programme un composant WebPart, voir le Kit de développement logiciel SDK SharePoint Foundation.

ECMAScript (JavaScript, JScript)

Dans SharePoint Server 2010, Excel Services a ajouté la prise en charge d’JavaScript. Le modèle objet JavaScript dans Excel Services permet aux développeurs d’automatiser, personnaliser et interagir avec le contrôle de composant WebPart Excel Web Access sur une page. Grâce au modèle objet JavaScript, vous pouvez générer des applications Web hybrides et autres solutions intégrées qui interagissent avec un ou plusieurs contrôles de composants WebPart Excel Web Access sur une page. Il vous permet également d’ajouter davantage de fonctionnalités à vos classeurs et au code qui les englobe.

Pour plus d’informations sur le modèle objet JavaScript dans Excel Services, voir la documentation de référence de l’espace de noms Ewa.

Utilisation d’ECMAScript (JavaScript, JScript)

Pour plus d’informations sur JavaScript, voir les liens suivants :

Pour plus d’informations sur le modèle objet JavaScript dans Excel Services, voir la documentation de référence de l’espace de noms Ewa.
Pour obtenir un exemple d’interaction avec le modèle objet JavaScript dans Excel Services au moyen du composant WebPart Éditeur de contenu, voir Procédure pas à pas : Développement à l’aide du composant WebPart Éditeur de contenu.

API REST

L’API REST dans Excel Services est une nouveauté dans SharePoint Server 2010. Son utilisation vous permet d’accéder à des composants ou des éléments de classeur directement par le biais d’une URL.

Les mécanismes de découverte intégrés à l’API REST Excel Services permettent également aux développeurs et aux utilisateurs d’explorer le contenu d’un classeur manuellement ou par programme, en fournissant des flux Atom qui contiennent des informations sur les éléments résidant dans un classeur spécifique. Les ressources accessibles par le biais de l’API REST sont les plages, les graphiques, les tables et les tableaux croisés dynamiques.

L’utilisation du flux Atom fourni par l’API REST simplifie l’obtention des données qui vous intéressent. Ce flux contient des éléments traversables qui permettent à tout code de découvrir les éléments qui existent dans un classeur.

Pour plus d’informations, voir API REST Excel Services.

Utilisation de l’API REST

Pour plus d’informations sur :

l’accès au service REST et pour afficher des exemples d’URI pour le service REST dans Excel Services, voir Accès à l’API REST Excel Services ;
l’accès à un schéma pour le service REST dans Excel Services, voir Accès à un schéma.