Partager via

  • Article

Type de connexion XML (SSRS)

Pour inclure les données d'une source de données XML dans votre rapport, vous devez avoir un dataset basé sur une source de données de rapport de type XML. Ce type de source de données intégré est basé sur l'extension de données XML. Ce type de source de données vous permet de vous connecter et de récupérer des données à partir de documents XML, de services Web ou de données XML incorporées dans la requête.

Cette extension de données prend en charge les paramètres et les informations d'identification gérés indépendamment de la chaîne de connexion.

Utilisez les informations de cette rubrique pour générer une source de données. Pour obtenir des instructions détaillées, consultez Procédure : ajouter et vérifier une connexion de données ou une source de données (Générateur de rapports version 3.0 et SSRS).

Dans cet article

Chaîne de connexion

Informations d'identification

Requêtes

Paramètres

Notes

Rubriques de procédures

Sections connexes

Chaîne de connexion

La chaîne de connexion doit être une URL qui pointe vers le service Web, l'application Web ou le document XML disponible via HTTP. Les documents XML doivent disposer de l'extension XML. Vous pouvez également utiliser une chaîne de connexion vide pour les données XML incorporées dans la requête du dataset.

Les exemples suivants illustrent la syntaxe d'une chaîne de connexion pour un service Web ou pour un document XML. Le protocole file:// n'est pas pris en charge.

Type de document XML

Exemple de chaîne de connexion

Service Web

http://adventure-works.com/results.aspx

Document XML

https://localhost/XML/Customers.xml

Document XML incorporé

Vide

Pour obtenir d'autres exemples de chaînes de connexion, consultez Connexions de données, sources de données et chaînes de connexion dans le Générateur de rapports version 3.0.

Informations d'identification

Les informations d'identification sont obligatoires pour exécuter des requêtes, afficher l'aperçu du rapport localement et afficher l'aperçu du rapport à partir du serveur de rapports.

Après avoir publié votre rapport, vous pouvez devoir modifier les informations d'identification pour la source de données afin que les autorisations soient valides pour récupérer les données lorsque le rapport s'exécute sur le serveur de rapports.

Sur un client de création de rapports, les options suivantes sont disponibles pour spécifier des informations d'identification :

  • Utilisateur Windows actuel (également appelé sécurité intégrée).

  • Aucune information d'identification n'est requise. Si vous choisissez de ne pas demander d'informations d'identification, l'accès anonyme est utilisé. Vérifiez que vous avez défini le compte d'exécution sans assistance pour le serveur de rapports afin d'établir une connexion à une source de données externe. L'extension pour le traitement des données XML ne transmet pas d'informations d'identification à l'URL cible ou au service Web ; la connexion ne peut aboutir que si vous avez défini le compte d'exécution sans assistance. Pour plus d'informations, consultez Configuration du compte d'exécution sans assistance dans la documentation relative à Reporting Services au sein de la documentation en ligne de SQL Server sur msdn.microsoft.com.

Les informations d'identification stockées ou demandées ne sont pas prises en charge. Notez bien que si vous désactivez la sécurité intégrée de Windows, vous ne pouvez pas l'utiliser pour récupérer des données. Si vous spécifiez des informations d'identification stockées ou demandées par invite, une erreur se produit au moment de l'exécution.

Pour plus d'informations, consultez Connexions de données, sources de données et chaînes de connexion (SSRS) ou Spécification des informations d'identification dans le Générateur de rapports version 3.0.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Requêtes

Une requête spécifie les données à récupérer pour un dataset de rapport. Les colonnes dans le jeu de résultats d'une requête remplissent la collection de champs pour un dataset. Un rapport traite uniquement le premier jeu de résultats récupéré par une requête.

Vous devez utiliser le concepteur de requêtes textuel pour créer la requête. La requête doit retourner des données XML.

Pour plus d'informations sur le concepteur de requêtes textuel, consultez Interface utilisateur du Concepteur de requêtes textuel (Générateur de rapports version 3.0).

Les valeurs possibles d'une requête de dataset pour une source de données de type XML sont présentées dans le tableau ci-dessous.

Requête de dataset

Description

Vide

Utilisez une requête vide pour créer un ensemble de résultats par défaut. La requête par défaut est créée en lisant la source de données et en parcourant la hiérarchie de nœuds XML jusqu'à la première collection inférieure. L'ensemble de résultats inclut tous les nœuds avec des valeurs de texte et tous les attributs de nœud rencontrés sur ce parcours. Les colonnes dans l'ensemble de résultats sont mappées avec les champs du dataset.

Chemin d'accès à l'élément

Spécifie la séquence des nœuds à utiliser lors de l'extraction des données XML de la source de données.

Élément de requête XML

Spécification de requête XML avec les éléments facultatifs suivants.

Source de données XMLÉléments XML requisÉléments XML facultatifs
Pour un service Web <Method Namespace= "espace de noms" Name="MethodName" /> -- or -- <SoapAction> action soap </SoapAction> <ElementPath> chemin d'accès à l'élément </ElementPath> <Method Namespace= "espace de noms" Name="MethodName" /> -- or -- <SoapAction> action soap </SoapAction>
Pour un document XML <ElementPath> chemin d'accès à l'élément </ElementPath>
Pour un document XML incorporé <XmlData> XML interne </XmlData> <ElementPath> chemin d'accès à l'élément </ElementPath> -- or -- <ElementPath IgnoreNamespaces="true"> chemin d'accès à l'élément </ElementPath>

Pour plus d'informations sur la syntaxe de requête, consultez Syntaxe de requête XML employée pour la spécification des données de rapport XML (SSRS) dans la documentation relative à Reporting Services au sein de la documentation en ligne de SQL Server sur msdn.microsoft.com.

Pour avoir des exemples, consultez Reporting Services: Using XML and Web Service Data Sources (en anglais).

Configuration requise pour la récupération de données d'un service Web XML

L'extension pour le traitement des données XML ne détecte pas le schéma automatiquement. Vous devez donc disposer d'un moyen d'identifier quelles méthodes SOAP permettent d'extraire les données de votre choix. Vous devez également comprendre le schéma d'adressage ou l'espace de noms que le service Web utilise pour ses données.

Pour un service Web, vous pouvez fournir un élément <Query> qui spécifie une méthode à appeler ou une action SOAP. Vous pouvez laisser la requête vide et adopter la requête par défaut si la source de données XML dispose d'une structure hiérarchique produisant les données que vous souhaitez utiliser dans votre rapport. Les valeurs de nœud d'élément XML et les attributs récupérés lors de l'exécution de la requête correspondent aux champs de dataset que vous utilisez dans votre rapport.

Conditions requises pour la récupération de données de documents XML

À l'aide du protocole HTTP, le serveur doit retourner les données XML ou ces dernières doivent être incorporées dans l'élément Query XML. Si vous faites directement référence à un document XML à l'aide du protocole HTTP, l'extension employée doit être l'extension .xml.

Vous devez savoir comment créer une requête XML qui récupère toutes les données dont vous avez besoin. Si vous ne spécifiez pas un chemin d'accès à l'élément, le comportement par défaut pour l'analyse d'un document XML consiste à sélectionner le premier chemin d'accès disponible vers une collection de nœuds terminaux dans le document. Si le document XML inclut des chemins d'accès supplémentaires à d'autres collections sœurs de nœuds terminaux (inférieurs), ces nœuds seront ignorés sauf si vous spécifiez un chemin dans votre requête.

Vous pouvez préciser un chemin d'accès de l'élément à l'aide d'une syntaxe XML semblable à la syntaxe XQuery.

Pour plus d'informations, consultez Syntaxe du chemin d'accès à l'élément pour la spécification de données de rapport XML (SSRS) dans la documentation relative à Reporting Services au sein de la documentation en ligne de SQL Server sur msdn.microsoft.com.

Paramètres

La requête n'est pas analysée pour l'identification des paramètres.

Pour ajouter des paramètres, vous devez les créer manuellement via la page Paramètre dans la boîte de dialogue Propriétés du dataset.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Notes

L'extension de données XML prend en charge la création de rapports à partir de données XML tabulaires et non hiérarchiques. Pour plus d'informations, consultez Ajout de données de sources de données externes (SSRS).

Il n'existe pas de prise en charge intégrée pour la récupération de documents XML à partir d'une base de données SQL Server.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Sections connexes

Ces sections de la documentation fournissent des informations de fond d'ordre conceptuel sur les données de rapport, ainsi que des informations sur les procédures de définition, de personnalisation et d'utilisation des parties d'un rapport qui sont liées aux données.

Icône de flèche utilisée avec le lien Retour au débutRetour au début