Leçon 1 : Définition d'un dataset de rapport pour un service Web Reporting Services

Mis à jour : 14 avril 2006

Suivez les étapes suivantes pour apprendre à spécifier une connexion de source de données et à retourner des données XML à partir d'un service Web. Dans cette leçon, vous allez créer un dataset en appelant la méthode ListChildren du service Web Report Server qui retourne une liste de tous les éléments du dossier racine dans la base de données Report Server. Définissez les paramètres requis par la méthode ListChildren et définissez des valeurs par défaut pour effectuer une itération dans la hiérarchie en commençant au dossier racine. Les propriétés d'élément définies par le service Web apparaissent sous la forme de champs pour le dataset dans la fenêtre Datasets. Enfin, faites glisser les champs du dataset vers la mise en page de rapport pour élaborer votre rapport. Lorsque vous prévisualisez le rapport, vous voyez des éléments et des propriétés d'élément dans votre base de données de serveur de rapports, tels que des rapports, des dossiers et des sources de données.

Pour définir une source de données XML, un dataset et une requête

1. Ouvrez une fenêtre de votre navigateur et tapez https://localhost/reportserver/reportservice2005.asmx?wsdl pour vous procurer des informations sur les espaces de noms pour le service Web Report Server. Plus tard, vous devrez définir l'espace de noms dans la requête.

   Remarque :
   Si vous n'obtenez pas de réponse de définition XML WSDL dans votre navigateur en essayant cette opération, vérifiez la section relative à la configuration requise pour Didacticiel : Utilisation de données XML dans un rapport.

   Remarque :

   Les informations sur la version des espaces de noms peuvent changer d'un produit à l'autre. Pour vérifier les informations sur l'espace de noms pour le serveur de rapports en cours d'utilisation, vous pouvez générer WSDL pour contrôler l'exactitude de la référence du service Web. Le format de l'espace de noms est https://schemas.microsoft.com/sqlserver/<year>/<month>/<day>/reporting/reportingservices.

2. Démarrez le Concepteur de rapports et créez un nouveau rapport. Si vous n'êtes pas certain de la façon de créer un rapport, consultez Didacticiel : Création d'un rapport de base.

3. Dans la vue Données, sélectionnez Nouveau dataset. Tapez le nom du dataset (par exemple, DatasetXML).

4. Dans la boîte de dialogue Dataset, dans Source de données, sélectionnez Nouvelle source de données. La boîte de dialogue Source de données apparaît.

5. Tapez un nom pour la source de données (par exemple, SourceDonnéesXML).

6. Dans la zone Type, sélectionnez XML.

7. Dans Chaîne de connexion, tapez l'URL suivante pour accéder au service Web Report Server :

   https://localhost/reportserver/reportservice2005.asmx
   

   La boîte de dialogue doit apparaître comme dans l'illustration suivante :

   

   Remarque :
   Dans SQL Server 2005 Reporting Services (SSRS) Service Pack 2 (SP2) et versions ultérieures, utilisez la chaîne de connexion suivante pour un serveur de rapports exécuté en mode intégré SharePoint : http://<servername>/_vti_bin/ReportServer/ReportService2006.asmx

8. Sous l'onglet Informations d'identification, sélectionnez Utiliser l'authentification Windows (sécurité intégrée).

9. Cliquez sur OK pour enregistrer les modifications et fermer la boîte de dialogue Source de données.

10. Dans la boîte de dialogue Dataset, tapez la requête suivante à l'aide des informations de version d'espace de noms que vous avez vérifiées à l'étape 1 :

    <Query>
    <SoapAction>https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ListChildren</SoapAction>
    </Query>
    

    La boîte de dialogue doit apparaître comme dans l'illustration suivante :

    

11. Sous l'onglet Paramètres de la boîte de dialogue Dataset, tapez deux paramètres. Il s'agit des paramètres sur la méthode ListChildren qui indiquent où commencer dans la hiérarchie du dossier du serveur de rapports et s'il est nécessaire d'inclure tous les dossiers imbriqués :

    Item

    Recursive

    Remarque :
    Dans SP2 et versions ultérieures, seul le paramètre Item est disponible.

12. Définissez Item sur /. Supprimez le symbole « = » ajouté par le Concepteur de rapports. Le symbole / spécifie le nœud racine de l'espace de noms de dossier du serveur de rapports.

    Remarque :
    Dans SP2 et versions ultérieures, si vous exécutez Reporting Services en mode intégré SharePoint, le paramètre doit correspondre à une URL menant au site, au dossier ou à la bibliothèque de documents de niveau supérieur SharePoint. Par exemple, http://<servername>/<top level site>, http://<servername>/<top level site>/<folder> ou http://<servername>/<top level site>/<document library>.

13. Définissez Recursive sur 1. Supprimez le symbole « = » ajouté par le Concepteur de rapports.

    La boîte de dialogue doit apparaître comme dans l'illustration suivante :

    

14. Cliquez sur OK. Le dataset est ajouté dans la fenêtre Datasets.

15. Cliquez sur Exécuter (!) pour consulter l'ensemble de résultats. Si la base de données du serveur de rapports contient des rapports et d'autres éléments, vous devez voir s'afficher une ligne de données pour chaque élément.

    Remarque :
    Si l'erreur « Une erreur s'est produite lors de l'exécution de la requête » s'affiche, vérifiez que vous avez défini les paramètres tels qu'ils sont décrits dans l'étape 11. La méthode ListChildren nécessite les paramètres Item et Recursive.

16. Cliquez sur le bouton Actualiser les champs () dans la barre d'outils. Cette opération enregistre la définition de rapports et met à jour la vue des champs dans la fenêtre Datasets du rapport pour afficher tous les champs utilisables.

    La boîte de dialogue doit apparaître comme dans l'illustration suivante :

    

Étapes suivantes

À l'aide du service Web Report Server, vous avez correctement défini les métadonnées pour un dataset de rapport destiné aux éléments de la base de données Report Server. Lorsque vous traitez le rapport, les données représentées par les métadonnées du dataset sont extraites de la base de données du serveur de rapports. Ensuite, vous allez créer un dataset de rapport à partir d'un service Web qui retourne un objet XML System.Data.DataSet object. Voir Leçon 2 : Définition d'un dataset du rapport pour un dataset ADO.NET à partir d'un service Web.

Voir aussi

Concepts

Didacticiels de Reporting Services

Autres ressources

Définition de datasets de rapport pour des données XML
Connexion à une source de données
Définition des datasets de rapports
Procédure : créer ou modifier une source de données propre à un rapport (Concepteur de rapports)
Procédure : créer un dataset (Concepteur de rapports)
Utilisation de champs dans un Dataset de rapport
Procédure : ajouter, modifier ou supprimer un champ dans la fenêtre Datasets (Générateur de rapports)
Datasets du rapport (Concepteur de rapports)

Aide et Informations

Assistance sur SQL Server 2005