• Article

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.

Le service Web Report Server est exposé dans deux points de terminaison différents. Le nom du fichier WSDL est différent pour chaque point de terminaison. Le point de terminaison ReportService2005 contient les méthodes permettant de gérer les objets sur un serveur de rapports. L'accès au fichier WSDL de ce point de terminaison est réalisé à travers ReportService2005.asmx?wsdl.

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

https://server/reportserver/ReportService2005.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.