Accès à l'API SOAP

Le service Web Report Server utilise le protocole SOAP (Simple Object Access Protocol) sur HTTP et joue le rôle d'interface de communication entre les programmes clients et le serveur de rapports. Le service Web fournit deux points de terminaison ; un pour l'exécution des rapports et un autre pour la gestion des rapports. Par ailleurs, il se compose de méthodes et d'un jeu d'objets de type complexe que vous pouvez utiliser pour accéder aux fonctionnalités complètes de Reporting Services. Pour appeler le service, vous devez référencer WSDL (Web Services Description Language) Reporting Services.

Référencement deWSDL Reporting Services

Pour parvenir à appeler un service Web, vous devez savoir comment accéder à ce service, quelles opérations sont prises en charge, quels paramètres sont attendus et ce que ce service retourne. WSDL fournit ces informations dans un document XML qui peut être lu ou traité par un ordinateur.

Les services Web Report Server sont exposés dans trois points de terminaison différents. Le nom du fichier WSDL est différent pour chaque point de terminaison. Le point de terminaison ReportService2010 contient des méthodes pour gérer des objets dans un serveur de rapports en mode natif ou intégré SharePoint. L'accès au fichier WSDL de ce point de terminaison est réalisé à travers ReportService2010.asmx?wsdl..

Note

Les points de terminaison ReportService2005 et ReportService2006 sont déconseillés dans SQL Server 2008 R2. Le point de terminaison ReportService2010 inclut les fonctionnalités des deux points de terminaison, ainsi que des fonctionnalités de gestion supplémentaires.

  • Le point de terminaison ReportExecution2005 permet aux développeurs de traiter les rapports par programme et d'en effectuer le rendu sur un serveur de rapports. L'accès au fichier WSDL de ce point de terminaison est réalisé à travers ReportExecution2005.asmx?wsdl.

WSDL peut être utilisé par les kits de développement qui prennent en charge SOAP et les services Web, comme le Kit de développement logiciel Microsoft .NET Framework.

L'exemple suivant montre le format de l'URL au fichier WSDL de gestion Reporting Services.

http://server/reportserver/ReportService2010.asmx?wsdl

Le tableau suivant décrit chaque élément de l'URL.

Élément de l'URL

Description

serveur

Nom du serveur sur lequel le serveur de rapports est déployé.

serveur_de_rapports

Nom du dossier qui contient le service Web XML. Cet élément est configuré au moment de l'installation.

<nom_point_de_terminaison>.asmx

Nom du point de terminaison du service Web.

Pour plus d'informations sur le format WSDL, consultez la spécification WSDL du W3C (World Wide Consortium) à l'adresse http://www.w3.org/TR/wsdl.