Tipo di connessione XML (SSRS)XML Connection Type (SSRS)

Per includere dati nel report da un'origine dati XML, è necessario disporre di un set di dati basato su un'origine dati del report di tipo 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. Questo tipo di origine dati incorporato è basato sull'estensione per i dati XML.This built-in data source type is based on the XML data extension. Utilizzare questo tipo di origine dati per connettersi e recuperare dati da documenti XML, servizi Web o valori XML incorporati nella query.Use this data source type to connect to and retrieve data from XML documents, Web services, or XML that is embedded in the query.

Questa estensione per i dati supporta parametri e credenziali gestiti separatamente dalla stringa di connessione.This data extension supports parameters and credentials managed separately from the connection string.

Usare le informazioni presenti in questo argomento per compilare un'origine dati.Use the information in this topic to build a data source. Per istruzioni dettagliate, vedere Aggiungere e verificare una connessione dati (Generatore report e SSRS).For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

Stringa di connessione Connection String

La stringa di connessione deve essere un URL che punta al servizio Web, all'applicazione Web o al documento XML disponibile tramite HTTP.The connection string must be a URL that points to the Web service, Web-based application, or XML document available through HTTP. I documenti XML devono avere estensione xml.XML documents must have the XML extension. È inoltre possibile utilizzare una stringa di connessione vuota per i dati XML incorporati nella query del set di dati.You can also use an empty connection string for XML data embedded in the dataset query.

Nell'esempio seguente viene illustrata la sintassi della stringa di connessione, rispettivamente per un servizio Web e per un documento XML.The following examples illustrate the connection string syntax for a Web service and XML document, respectively. Il protocollo file:// non è supportato.The file:// protocol is not supported.

Tipo di documento XMLXML document type Esempio di stringa di connessioneConnection String Example
Servizio WebWeb service http://adventure-works.com/results.aspx
Documento XMLXML document http://localhost/XML/Customers.xml
Documento XML incorporatoEmbedded XML document VuotoEmpty

Per altri esempi di stringhe di connessione, vedere Connessioni dati, origini dati e stringhe di connessione in Generatore report.For more connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

Credenziali Credentials

Le credenziali sono necessarie per eseguire query, nonché per visualizzare l'anteprima del report in locale e dal server di report.Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.

Dopo aver pubblicato il report, potrebbe essere necessario modificare le credenziali per l'origine dati affinché quando il report viene eseguito nel server di report, le autorizzazioni per il recupero dei dati risultino valide.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.

Da un client di creazione di report sono disponibili le opzioni seguenti per la specifica delle credenziali:From a report authoring client, the following options are available to specify credentials:

  • Utente di Windows corrente (nota anche come sicurezza integrata).Current Windows user (also known as integrated security).

  • Non sono necessarie credenziali.No credentials are required. Se non si specificano credenziali, viene utilizzato l'accesso anonimo.If you select no credentials, Anonymous access is used. Verificare di aver definito l'account di esecuzione automatica per il server di report per eseguire la connessione a un'origine dei dati esterna.Make sure that you have defined the unattended execution account for the report server to connect to an external data source. L'estensione per l'elaborazione di dati XML non passa credenziali all'URL di destinazione o al servizio Web, pertanto la connessione ha esito positivo solo se è stato definito l'account di esecuzione automatica.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. Per altre informazioni, vedere Configurare l'account di esecuzione automatica (Gestione configurazione SSRS) nella documentazione relativa a Reporting ServicesReporting Services in SQL ServerSQL Server Documentazione onlinesu 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.

    Credenziali archiviate e credenziali fornite dall'utente non sono supportate.Stored and prompted credentials are not supported. Se la sicurezza integrata di Windows è disabilitata, non è possibile utilizzarla per recuperare dati.Remember that if you disable Windows integrated security, you cannot use it to retrieve data. Se si specificano credenziali archiviate o fornite dall'utente, si verificherà un errore in fase di esecuzione.If you specify stored or prompted credentials, an error will occur at run time.

    Per altre informazioni, vedere Connessioni dati, origini dati e stringhe di connessione (Generatore report e SSRS) e Specifica di credenziali in Generatore report.For more information, see Data Connections, Data Sources, and Connection Strings (Report Builder and SSRS) or Specify Credentials in Report Builder.

Query Queries

Una query consente di specificare quali dati recuperare per un set di dati del report.A query specifies which data to retrieve for a report dataset. Le colonne nel set di risultati per una query popolano la raccolta dei campi per un set di dati.The columns in the result set for a query populate the field collection for a dataset. In un report viene elaborato solo il primo set di risultati recuperato da una query.A report processes only the first result set retrieved by a query.

Per creare la query, è necessario utilizzare la finestra Progettazione query basata su testo.You must use the text-based query designer to create the query. La query deve restituire dati XML.The query must return XML data.

Per altre informazioni sulla finestra Progettazione query basata su testo, vedere Interfaccia utente di Progettazione query basata su testo (Generatore report ).For more information about the text-based query designer, see Text-based Query Designer User Interface (Report Builder).

I valori possibili di una query del set di dati per un'origine dati di tipo XML sono illustrati di seguito.The possible values for a dataset query for a data source that is type XML are shown below.

  • VuotoEmpty

    Utilizzare una query vuota per creare un set di risultati predefinito.Use an empty query to create a default result set. La query predefinita viene creata leggendo l'origine dei dati e attraversando la gerarchia del nodo XML fino alla prima raccolta foglia.The default query is created by reading the data source and traversing the XML node hierarchy to the first leaf collection. Il set di risultati include tutti i nodi con valori di testo e tutti gli attributi dei nodi nel percorso.The result set includes all nodes with text values and all node attributes along that path. Sulle colonne del set di risultati viene eseguito il mapping ai campi del set di dati.Columns in the result set are mapped to fields for the dataset.

  • Percorso di elementoAn element path

    Specifica la sequenza di nodi da utilizzare per recuperare i dati XML dall'origine dei dati.Specifies the sequence of nodes to use when retrieving XML data from the data source.

  • Elemento Query XMLAn XML Query element

    Specifica di query XML con gli elementi facoltativi seguenti:An XML query specification with the following optional elements:

    • L'origine dati XML è un servizio WebXML data source is a Web service

      Elementi XML obbligatori:Required XML elements:

      <Method Namespace= "namespace" Name="MethodName" /><Method Namespace= "namespace" Name="MethodName" />

      -- or --

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

      Elementi XML facoltativi:Optional XML Elements:

      <ElementPath> element path </ElementPath><ElementPath> element path </ElementPath>

      <Method Namespace= "namespace" Name="MethodName" /><Method Namespace= "namespace" Name="MethodName" />

      -- or --

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

    • L'origine dati XML è un documento XMLXML data source is an XML document

      Elementi XML obbligatori: nessunoRequired XML elements: None

      Elementi XML facoltativi:Optional XML Elements:

      <ElementPath> element path </ElementPath><ElementPath> element path </ElementPath>

    • L'origine dati XML è un documento XML incorporatoXML data source is an embedded XML document

      Elementi XML obbligatori:Required XML elements:

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

      Elementi XML facoltativi:Optional XML Elements:

      <ElementPath> element path </ElementPath><ElementPath> element path </ElementPath>

      -- or --

      <ElementPath IgnoreNamespaces="true"> element path </ElementPath><ElementPath IgnoreNamespaces="true"> element path </ElementPath>

    Per altre informazioni sulla sintassi di query, vedere Sintassi di query XML per i dati del report XML (SSRS) nella documentazione di Reporting ServicesReporting Services in SQL ServerSQL Server Documentazione online su 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.

    Per consultare degli esempi, vedere Reporting Services: Using XML and Web Service Data Sources.For examples, see Reporting Services: Using XML and Web Service Data Sources.

Requisiti per il recupero di dati del servizio Web XMLRequirements for Retrieving XML Web Service Data

Lo schema non viene rilevato automaticamente dall'estensione per l'elaborazione dati XML.The XML data processing extension does not detect the schema for you. È pertanto necessario essere in grado di individuare i metodi SOAP tramite i quali verranno recuperati i dati desiderati.Therefore, you must have some way of discovering which SOAP methods will retrieve the data that you want. È inoltre necessario comprendere lo spazio dei nomi o lo schema di indirizzamento che il servizio Web utilizza per i dati.You must also understand the addressing scheme or namespace that the Web service uses for its data.

Per un servizio Web, è possibile fornire un < Query> elemento che specifica un metodo a chiamata o l'azione SOAP.For a Web service, you can provide a <Query> element that specifies a method to call or SOAP action. È possibile lasciare la query vuota e utilizzare la query predefinita se l'origine dei dati XML ha una struttura gerarchica che genera i dati che si desidera utilizzare per il report.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. Per gli attributi e i valori del nodo elemento XML recuperati durante l'esecuzione della query viene eseguito il mapping ai campi del set di dati utilizzati nel report.XML element node values and attributes retrieved when the query runs map to the dataset fields you use in your report.

Requisiti per il recupero di dati di documenti XMLRequirements for Retrieving XML Document Data

Se si usa il protocollo HTTP, il server deve restituire dati XML oppure i dati XML devono essere incorporati nell'elemento Query XML.Using the http protocol, the server must return XML data or the XML data must be embedded in the XML Query element. Se si fa riferimento a un documento XML direttamente utilizzando il protocollo HTTP, l'estensione deve essere xml.If you refer to an XML document directly using the http protocol, the extension must be .xml.

È necessario conoscere la procedura di creazione di una query XML per il recupero di tutti i dati che si desidera utilizzare.You must know how to create an XML query that retrieves all the data you need. Se non viene specificato un percorso di elemento, il comportamento predefinito previsto per l'analisi di un documento XML consiste nel selezionare il primo percorso disponibile di una raccolta di nodi foglia nel documento XML.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. Se nel documento XML sono inclusi percorsi aggiuntivi di altre raccolte di nodi foglia di pari livello, tali nodi verranno ignorati a meno che non venga specificato un percorso nella query.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.

È possibile specificare un percorso di elemento utilizzando una sintassi XML simile a XQuery.You can provide an element path using XML syntax similar to XQuery.

Per altre informazioni sulla sintassi di query, vedere Sintassi del percorso di elemento per i dati del report XML (SSRS) nella documentazione di Reporting ServicesReporting Services in SQL ServerSQL Server Documentazione online su msdn.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.

Parametri Parameters

La query non viene analizzata per identificare parametri.The query is not analyzed to identify parameters.

Per aggiungere i parametri, è necessario crearli manualmente usando la pagina Parametri nella finestra di dialogo Proprietà set di dati .To add parameters, you must create them manually through the Parameter page on the Dataset Properties dialog box.

Osservazioni Remarks

L'estensione per i dati XML supporta report di dati XML tabulari e non gerarchici.The XML data extension supports reporting from XML data that is tabular and not hierarchical. Per altre informazioni, vedere Aggiungere dati da origini dati esterne (SSRS).For more information, see Add Data from External Data Sources (SSRS).

Non è disponibile alcun supporto predefinito per il recupero di documenti XML da un database di SQL ServerSQL Server.There is no built-in support for retrieving XML documents from a SQL ServerSQL Server database.

Procedure How-To Topics

In questa sezione sono contenute istruzioni dettagliate per l'utilizzo di connessioni dati, origini dati e set di dati.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

Aggiungere e verificare una connessione dati (Generatore report e SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

Creare un set di dati condiviso o un set di dati incorporato (Generatore report e SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

Aggiungere un filtro a un set di dati ( Generatore report e SSRS )Add a Filter to a Dataset (Report Builder and SSRS)

In queste sezioni della documentazione sono incluse informazioni concettuali approfondite sui dati dei report, nonché le informazioni necessarie sulle procedure per definire, personalizzare e usare parti di un report correlate ai dati.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.

Set di dati del report (SSRS)Report Datasets (SSRS)
Viene fornita una panoramica sull'accesso ai dati del report.Provides an overview of accessing data for your report.

Connessioni dati, origini dati e stringhe di connessione in Generatore ReportData Connections, Data Sources, and Connection Strings in Report Builder
Vengono fornite informazioni sulle connessioni dati e sulle origini dati.Provides information about data connections and data sources.

Report di set di dati incorporati e condivisi ( Generatore report e SSRS )Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
Vengono fornite informazioni sui set di dati incorporati e condivisi.Provides information about embedded and shared datasets.

Raccolta di campi del set di dati ( Generatore report e SSRS )Dataset Fields Collection (Report Builder and SSRS)
Vengono fornite informazioni sulla raccolta di campi di set di dati generata dalla query.Provides information about the dataset field collection generated by the query.

Origini dati supportate da Reporting Services (SSRS) nella documentazione relativa a Reporting ServicesReporting Services inclusa nella documentazione online di SQL ServerSQL Server.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
Vengono fornite informazioni dettagliate sul supporto delle piattaforme e delle versioni per ogni estensione per i dati.Provides in-depth information about platform and version support for each data extension.

Vedere ancheSee Also

I parametri di report ( Generatore report e progettazione Report ) Report Parameters (Report Builder and Report Designer)
Filtro, gruppo e ordinamento dei dati ( Generatore report e SSRS ) Filter, Group, and Sort Data (Report Builder and SSRS)
Espressioni ( Generatore report e SSRS )Expressions (Report Builder and SSRS)