Type de connexion XML (SSRS)XML Connection Type (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.To include data from an XML data source in your report, you must have a dataset that is based on a report data source of type XML. Ce type de source de données intégré est basé sur l'extension de données XML.This built-in data source type is based on the XML data extension. 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.Use this data source type to connect to and retrieve data from XML documents, Web services, or XML that is embedded in the query.

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.This data extension supports parameters and credentials managed separately from the connection string.

Utilisez les informations de cette rubrique pour générer une source de données.Use the information in this topic to build a data source. Pour obtenir des instructions pas à pas, consultez Ajouter et vérifier une connexion de données (Générateur de rapports et SSRS).For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

Chaîne de connexion Connection String

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.The connection string must be a URL that points to the Web service, Web-based application, or XML document available through HTTP. Les documents XML doivent disposer de l'extension XML.XML documents must have the XML extension. Vous pouvez également utiliser une chaîne de connexion vide pour les données XML incorporées dans la requête du dataset.You can also use an empty connection string for XML data embedded in the dataset query.

Les exemples suivants illustrent la syntaxe d'une chaîne de connexion pour un service Web ou pour un document XML.The following examples illustrate the connection string syntax for a Web service and XML document, respectively. Le protocole file:// n'est pas pris en charge.The file:// protocol is not supported.

Type de document XMLXML document type Exemple de chaîne de connexionConnection String Example
Service WebWeb service http://adventure-works.com/results.aspx
Document XMLXML document http://localhost/XML/Customers.xml
Document XML incorporéEmbedded XML document VideEmpty

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.For more connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

Informations d'identification Credentials

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.Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.

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.After you publish your report, you may need to change the credentials for the data source so that when the report runs on the report server, the permissions to retrieve the data are valid.

Sur un client de création de rapports, les options suivantes sont disponibles pour spécifier des informations d'identification :From a report authoring client, the following options are available to specify credentials:

  • Utilisateur Windows actuel (également appelé sécurité intégrée).Current Windows user (also known as integrated security).

  • Aucune information d'identification n'est requise.No credentials are required. Si vous choisissez de ne pas demander d'informations d'identification, l'accès anonyme est utilisé.If you select no credentials, Anonymous access is used. 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.Make sure that you have defined the unattended execution account for the report server to connect to an external data source. 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.The XML data processing extension does not pass credentials to the target URL or the Web service; the connection will be unsuccessful unless you have defined the unattended execution account. Pour plus d’informations, consultez Configurer le compte d’exécution sans assistance (Gestionnaire de configuration de SSRS) dans la section Reporting ServicesReporting Services de la documentation en ligne SQL ServerSQL Server sur msdn.microsoft.com.For more information, see Configure the Unattended Execution Account (SSRS Configuration Manager) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online on msdn.microsoft.com.

    Les informations d'identification stockées ou demandées ne sont pas prises en charge.Stored and prompted credentials are not supported. 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.Remember that if you disable Windows integrated security, you cannot use it to retrieve data. 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.If you specify stored or prompted credentials, an error will occur at run time.

    Pour plus d’informations, consultez Connexions de données, sources de données et chaînes de connexion (Générateur de rapports et SSRS) ou Spécifier des informations d’identification dans le Générateur de rapports.For more information, see Data Connections, Data Sources, and Connection Strings (Report Builder and SSRS) or Specify Credentials in Report Builder.

Requêtes Queries

Une requête spécifie les données à récupérer pour un dataset de rapport.A query specifies which data to retrieve for a report dataset. Les colonnes dans le jeu de résultats d'une requête remplissent la collection de champs pour un dataset.The columns in the result set for a query populate the field collection for a dataset. Un rapport traite uniquement le premier jeu de résultats récupéré par une requête.A report processes only the first result set retrieved by a query.

Vous devez utiliser le concepteur de requêtes textuel pour créer la requête.You must use the text-based query designer to create the query. La requête doit retourner des données XML.The query must return XML data.

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).For more information about the text-based query designer, see Text-based Query Designer User Interface (Report Builder).

Les valeurs possibles d’une requête de jeu de données pour une source de données de type XML sont indiquées ci-dessous.The possible values for a dataset query for a data source that is type XML are shown below.

  • VideEmpty

    Utilisez une requête vide pour créer un ensemble de résultats par défaut.Use an empty query to create a default result set. 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.The default query is created by reading the data source and traversing the XML node hierarchy to the first leaf collection. 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.The result set includes all nodes with text values and all node attributes along that path. Les colonnes dans l'ensemble de résultats sont mappées avec les champs du dataset.Columns in the result set are mapped to fields for the dataset.

  • Chemin d'accès à l'élémentAn element path

    Spécifie la séquence des nœuds à utiliser lors de l'extraction des données XML de la source de données.Specifies the sequence of nodes to use when retrieving XML data from the data source.

  • Élément de requête XMLAn XML Query element

    Spécification de requête XML avec les éléments facultatifs suivants :An XML query specification with the following optional elements:

    • La source de données XML est un service webXML data source is a Web service

      Éléments XML obligatoires :Required XML elements:

      <Method Namespace= "espace de noms" Name="MethodName" /><Method Namespace= "namespace" Name="MethodName" />

      -- or --

      <SoapAction> action soap </SoapAction><SoapAction> soap action </SoapAction>

      Éléments XML facultatifs :Optional XML Elements:

      <ElementPath> chemin d'accès à l'élément </ElementPath><ElementPath> element path </ElementPath>

      <Method Namespace= "espace de noms" Name="MethodName" /><Method Namespace= "namespace" Name="MethodName" />

      -- or --

      <SoapAction> action soap </SoapAction><SoapAction> soap action </SoapAction>

    • La source de données XML est un document XMLXML data source is an XML document

      Éléments XML obligatoires : aucunRequired XML elements: None

      Éléments XML facultatifs :Optional XML Elements:

      <ElementPath> chemin d'accès à l'élément </ElementPath><ElementPath> element path </ElementPath>

    • La source de données XML est un document XML incorporéXML data source is an embedded XML document

      Éléments XML obligatoires :Required XML elements:

      <XmlData> XML interne </XmlData><XmlData> inner XML </XmlData>

      Éléments XML facultatifs :Optional XML Elements:

      <ElementPath> chemin d'accès à l'élément </ElementPath><ElementPath> element path </ElementPath>

      -- or --

      <ElementPath IgnoreNamespaces="true"> chemin d'accès à l'élément </ElementPath><ElementPath IgnoreNamespaces="true"> element path </ElementPath>

    Pour plus d'informations sur la syntaxe des requêtes, consultez Syntaxe de requête XML pour les données de rapport XML (SSRS) dans la section Reporting ServicesReporting Services de la documentation en ligne SQL ServerSQL Server sur msdn.microsoft.com.For more information about query syntax, see XML Query Syntax for XML Report Data (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online on msdn.microsoft.com.

    Pour obtenir des exemples, consultez Reporting Services : utilisation de sources de données XML et de service web.For examples, see Reporting Services: Using XML and Web Service Data Sources.

Configuration requise pour la récupération de données d'un service Web XMLRequirements for Retrieving XML Web Service Data

L'extension pour le traitement des données XML ne détecte pas le schéma automatiquement.The XML data processing extension does not detect the schema for you. Vous devez donc disposer d'un moyen d'identifier quelles méthodes SOAP permettent d'extraire les données de votre choix.Therefore, you must have some way of discovering which SOAP methods will retrieve the data that you want. Vous devez également comprendre le schéma d'adressage ou l'espace de noms que le service Web utilise pour ses données.You must also understand the addressing scheme or namespace that the Web service uses for its data.

Pour un service Web, vous pouvez fournir un < requête> élément qui spécifie une méthode à l’appel ou action SOAP.For a Web service, you can provide a <Query> element that specifies a method to call or SOAP action. 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.You can leave the query empty and use the default query if the XML data source has a hierarchical structure that produces the data that you want to use for your report. 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.XML element node values and attributes retrieved when the query runs map to the dataset fields you use in your report.

Conditions requises pour la récupération de données de documents XMLRequirements for Retrieving XML Document Data

À 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.Using the http protocol, the server must return XML data or the XML data must be embedded in the XML Query element. Si vous faites directement référence à un document XML à l'aide du protocole HTTP, l'extension employée doit être l'extension .xml.If you refer to an XML document directly using the http protocol, the extension must be .xml.

Vous devez savoir comment créer une requête XML qui récupère toutes les données dont vous avez besoin.You must know how to create an XML query that retrieves all the data you need. 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.If you do not specify an element path, the default behavior for parsing an XML document is to select the first available path to a leaf-node collection in the XML 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.If the XML document includes additional paths to other sibling leaf-node collections, those nodes will be ignored unless you specify a path in your query.

Vous pouvez préciser un chemin d'accès de l'élément à l'aide d'une syntaxe XML semblable à la syntaxe XQuery.You can provide an element path using XML syntax similar to XQuery.

Pour plus d’informations, consultez Syntaxe du chemin d’accès à l’élément pour des données de rapport XML (SSRS) dans la documentation relative à Reporting ServicesReporting Services au sein de la documentation en ligne SQL ServerSQL Servermsdn.microsoft.com.For more information, see Element Path Syntax for XML Report Data (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online on msdn.microsoft.com.

Paramètres Parameters

La requête n'est pas analysée pour l'identification des paramètres.The query is not analyzed to identify parameters.

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 .To add parameters, you must create them manually through the Parameter page on the Dataset Properties dialog box.

Notes Remarks

L'extension de données XML prend en charge la création de rapports à partir de données XML tabulaires et non hiérarchiques.The XML data extension supports reporting from XML data that is tabular and not hierarchical. Pour plus d’informations, consultez Ajouter des données à partir de sources de données externes (SSRS).For more information, see Add Data from External Data Sources (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 ServerSQL Server .There is no built-in support for retrieving XML documents from a SQL ServerSQL Server database.

Rubriques de procédures How-To Topics

Cette section contient des instructions pas à pas sur l'utilisation des connexions de données, des sources de données et des datasets.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

Ajouter et vérifier une connexion de données (Générateur de rapports et SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

Créer un dataset partagé ou incorporé (Générateur de rapports et SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

Ajouter un filtre à un dataset (Générateur de rapports et SSRS)Add a Filter to a Dataset (Report Builder and SSRS)

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.These sections of the documentation provide in-depth conceptual information about report data, as well as procedural information about how to define, customize, and use parts of a report that are related to data.

Datasets de rapport (SSRS)Report Datasets (SSRS)
Fournit une vue d'ensemble de l'accès aux données pour votre rapport.Provides an overview of accessing data for your report.

Connexions de données, sources de données et chaînes de connexion dans le Générateur de rapportsData Connections, Data Sources, and Connection Strings in Report Builder
Fournit des informations sur les connexions de données et les sources de données.Provides information about data connections and data sources.

Datasets incorporés dans les rapports et datasets partagés (Générateur de rapports et SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
Fournit des informations sur les datasets incorporés et partagés.Provides information about embedded and shared datasets.

Collection de champs de dataset (Générateur de rapports et SSRS)Dataset Fields Collection (Report Builder and SSRS)
Fournit des informations sur la collection de champs de dataset générée par la requête.Provides information about the dataset field collection generated by the query.

Sources de données prises en charge par Reporting Services (SSRS) dans la section Reporting ServicesReporting Services de la documentation en ligne SQL ServerSQL Server.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
Fournit des informations détaillées sur la prise en charge des plateformes et des versions pour chaque extension de données.Provides in-depth information about platform and version support for each data extension.

Voir aussiSee Also

Paramètres de rapport (Générateur de rapports et Concepteur de rapports) Report Parameters (Report Builder and Report Designer)
Filtrer, regrouper et trier des données (Générateur de rapports et SSRS) Filter, Group, and Sort Data (Report Builder and SSRS)
Expressions (Générateur de rapports et SSRS) Expressions (Report Builder and SSRS)