Syntaxe de requête XML pour les données de rapport XML (SSRS)
Reporting Servicesvous permet de créer des datasets pour des sources de données XML. Après avoir défini une source de données, vous devez créer une requête pour le dataset. Selon le type de données XML sur lesquelles pointent la source de données, vous pouvez créer la requête du dataset en incluant une requête XML ou un chemin d’élément. Une requête XML commence par une balise <Query> et comprend des espaces de noms et des éléments XML variant selon la source de données. Un chemin d'accès à un élément opère indépendamment des espaces de noms ; il précise les nœuds et les attributs de nœud à utiliser à partir des données XML sous-jacentes avec une syntaxe similaire à la syntaxe XPath. Pour plus d’informations sur les chemins d’éléments, consultez Syntaxe du chemin vers l’élément pour des données de rapport XML (SSRS).
Vous pouvez créer une source de données XML pour les types de données XML suivants :
Documents XML désignés par une URL utilisant le protocole HTTP
Points de terminaison du service Web retournant des données XML
Données XML incorporées
La manière dont vous spécifiez une requête XML ou un chemin d’élément dépend du type des données XML.
Pour un document XML, la requête XML est facultative. Si elle est incluse, elle peut contenir un ElementPathXML facultatif. La valeur du ElementPath XML utilise la syntaxe de chemin d’élément. Vous incluez la requête XML et le ElementPath XML pour traiter correctement les espaces de noms quand c’est nécessaire pour les données XML de la source de données.
Pour un point de terminaison de service web vers lequel pointe une URL de chaîne de connexion, la requête XML définit la méthode du service web, l’action SOAP ou les deux. Le fournisseur de données XML crée une demande de service Web qui extrait les données XML à utiliser pour le rapport.
Notes
Quand l’espace de noms d’un service web comporte une barre oblique ( /) , incluez à la fois la méthode du service web et l’action SOAP de sorte que l’extension de traitement des données XML puisse dériver correctement l’espace de noms.
Pour un document XML incorporé, la requête XML définit les données XML incorporées à utiliser, inclut des espaces de noms facultatifs et contient un ElementPathXML facultatif.
Spécification de paramètres de la requête pour des données XML
Vous pouvez spécifier des paramètres de la requête pour les documents XML.
Pour les requêtes URL, les paramètres de la requête sont inclus en tant que paramètres URL standard.
Pour les requêtes du service Web, les paramètres de la requête sont passés à la méthode du service Web. Pour définir un paramètre de requête, utilisez la page Paramètres de la boîte de dialogue Propriétés du dataset .
Exemple
Les exemples fournis dans le tableau ci-dessous illustrent la manière d'extraire des données du service Web Report Server, un document XML et des données XML incorporées.
| Source de données XML | Exemple de requête |
|---|---|
| Données XML du service web provenant de la méthode ListChildren . | <Query><Method Name="ListChildren" Namespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices" /></Query> |
| Données XML du service Web issues de SoapAction. | <Query xmlns=namespace><SoapAction>https://schemas/microsoft.com/sqlserver/2005/03/23/reporting/reportingservices/ListChildren</SoapAction></Query> |
| Document XML ou données XML incorporées qui utilisent des espaces de noms. Élément de requête spécifiant des espaces de noms pour un chemin d'accès à un élément. |
<Query xmlns:es="https://schemas.microsoft.com/StandardSchemas/ExtendedSales"><ElementPath>/Customers/Customer/Orders/Order/es:LineItems/es:LineItem</ElementPath></Query> |
| Document XML incorporé. | <Query><XmlData><Customers><Customer ID="1">Bobby</Customer></Customers></XmlData><ElementPath>Customer {@}</ElementPath></Query> |
| Document XML qui utilise la valeur par défaut. | Aucune requête. Le chemin d'accès à l'élément provient du document XML lui-même et est indépendant des espaces de noms. |
Notes
Le premier exemple de service web répertorie le contenu du serveur de rapports qui utilise la méthode ListChildren . Pour exécuter cette requête, vous devez créer une nouvelle source de données et définir la chaîne de connexion sur https://localhost/reportserver/reportservice2006.asmx. La méthode ListChildren accepte deux paramètres : Item et Recursive. Définissez la valeur par défaut pour Item à / et pour Recursive à 1.
Définition d'espaces de noms
Utilisez l’élément Requête XML pour spécifier les espaces de noms qui sont utilisés dans les données XML de la source de données. La requête XML suivante utilise l’espace de noms sales. Les nœuds ElementPath XML pour sales:LineItems et sales:LineItem utilisent l’espace de noms sales.
<Query xmlns:sales=
"https://schemas.microsoft.com/StandardSchemas/ExtendedSales">
<SoapAction>
https://schemas.microsoft.com/SalesWebService/ListOrders
</SoapAction>
<ElementPath>
Customers/Customer/Orders/Order/sales:LineItems/sales:LineItem
</ElementPath>
</Query>
Pour spécifier l’espace de noms du fournisseur de données afin que l’espace de noms par défaut reste vide, utilisez xmldp. Cela est illustré par l'exemple suivant.
Exemple
Les exemples suivants utilisent le document XML DPNamespace.xml fourni à titre d'illustration à la suite du tableau ci-après. Ce tableau présente deux exemples de syntaxe ElementPath XML incluant des préfixes d'espaces de noms.
| Élément de requête XML | Champs obtenus dans le dataset |
|---|---|
| <Query/> | Valeur A : https://schemas.microsoft.com/...Valeur B : https://schemas.microsoft.com/...Valeur C : https://schemas.microsoft.com/... |
<xmldp:Query xmlns:xmldp="https://schemas.microsoft.com/sqlserver/2005/02/reporting/XmlDPQuery" xmlns:ns="https://schemas.microsoft.com/..."><xmldp:ElementPath>Root {}/ns:Element2/Node</xmldp:ElementPath></xmldp:Query> |
Valeur D Valeur E Valeur F |
Document XML : DPNamespace.xml
Vous pouvez copier ce document XML et l’enregistrer dans une URL que le Concepteur de rapports pourra utiliser comme source de données XML : par exemple https://localhost/DPNamespace.xml..
<Root xmlns:ns="https://schemas.microsoft.com/...">
<ns:Element1>
<Node>Value A</Node>
<Node>Value B</Node>
<Node>Value C</Node>
</ns:Element1>
<ns:Element2>
<Node>Value D</Node>
<Node>Value E</Node>
<Node>Value F</Node>
</ns:Element2>
</Root>
Voir aussi
Type de connexion XML (SSRS)
Didacticiels sur Reporting Services (SSRS)
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour