Condividi tramite


Definizione di set di dati del report per i dati XML

Data aggiornamento: 14 aprile 2006

In Reporting Services è disponibile un'estensione per l'elaborazione dati che supporta il recupero dei dati del report da un'origine dei dati XML. I report consentono di utilizzare dati di servizi Web e documenti XML oppure di incorporare codice XML nella query. Non è disponibile alcun supporto predefinito per il recupero di documenti XML da un database di SQL Server. Un set di dati di Reporting Services include un'origine dei dati, una query e un insieme di campi.

Per istruzioni dettagliate sulla configurazione dell'origine dei dati e del set di dati, sull'aggiunta di campi al layout del report e sulla creazione di un report in cui vengano visualizzati i dati XML recuperati da un servizio Web XML, vedere Esercitazione: Utilizzo di dati XML in un report.

Connessione e recupero di dati da un'origine dei dati XML

Per recuperare dati XML in un report, creare un'origine dei dati con una stringa di connessione che specifica un URL di un servizio Web o di un documento XML. È inoltre possibile creare un'origine dei dati con una stringa di connessione vuota e incorporare dati XML nella query del set di dati.

Ogni origine dei dati XML deve avere le caratteristiche seguenti:

  • Il tipo di origine dei dati deve essere XML. In Reporting Services è disponibile un'estensione per l'elaborazione dati XML per recuperare ed elaborare i dati in un report.
  • Le credenziali devono essere configurate per la protezione integrata di Windows oppure non devono essere impostate.
    Credenziali archiviate e credenziali fornite dall'utente non sono supportate. Se la protezione integrata di Windows è disattivata, non è possibile utilizzarla per recuperare dati. Se si specificano credenziali archiviate o fornite dall'utente, si verificherà un errore in fase di esecuzione.
    Se non si specificano credenziali, viene utilizzato l'accesso anonimo. Verificare di aver definito l'account di esecuzione automatica per il server di report per eseguire la connessione a un'origine dei dati esterna. L'estensione per l'elaborazione 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. Per ulteriori informazioni, vedere Configurazione di un account per l'elaborazione automatica di un report.
  • La stringa di connessione deve essere un URL che punta al servizio Web, all'applicazione Web o al documento XML disponibile tramite HTTP. I documenti XML devono avere estensione xml. È inoltre possibile utilizzare una stringa di connessione vuota per i dati XML incorporati nella query del set di dati.
  • La query deve restituire dati XML. Per i documenti XML, è possibile specificare un percorso di elemento utilizzando una sintassi XML simile a XQuery, come descritto in Sintassi dei percorsi di elementi per la definizione di dati di report XML. Per un servizio Web, è possibile specificare un elemento <Query> che definisca un metodo da chiamare o un'azione SOAP. È 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. Gli attributi e i valori del nodo elemento XML recuperati quando la query viene eseguita sono mappati ai campi del set di dati utilizzati nel report.
  • Per creare la query, è necessario utilizzare Progettazione query standard. La query non viene analizzata per identificare i parametri, pertanto è necessario creare i parametri tramite la scheda Parametri della finestra di dialogo Set di dati. Per ulteriori informazioni sulla sintassi di query, vedere Sintassi di query XML per la definizione di dati di report XML. Per ulteriori informazioni su Progettazione query standard, vedere Strumenti di progettazione query in Reporting Services.

Stringhe di connessione per origini dei dati XML

Nell'esempio seguente viene illustrata la sintassi della stringa di connessione, rispettivamente per un servizio Web e per un documento XML. Il protocollo file:// non è supportato.

Tipo di documento XML Esempio di stringa di connessione

Servizio Web

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

Documento XML

https://localhost/XML/Customers.xml

Documento XML incorporato

Vuota

Per ulteriori informazioni sulla definizione di un'origine dei dati, vedere Procedura: Creazione o modifica di un'origine dei dati specifica del report (Progettazione report).

Query per set di dati con origini dei dati XML

Un set di dati include una query, che costituisce il testo del comando eseguito nell'origine dei dati per recuperare un set di risultati specifico. Il set di risultati è mappato all'insieme di campi di un set di dati. È inoltre possibile filtrare i valori nel set di dati per limitare i risultati restituiti dall'origine dei dati. I valori possibili di una query del set di dati per un'origine dei dati di tipo XML sono illustrati nella tabella seguente.

Query del set di dati

Descrizione

Vuota

Utilizzare una query vuota per creare un set di risultati predefinito. La query predefinita viene creata leggendo l'origine dei dati e attraversando la gerarchia del nodo XML fino al primo insieme foglia. Il set di risultati include tutti i nodi con valori di testo e tutti gli attributi dei nodi nel percorso. Le colonne del set di risultati sono mappate ai campi del set di dati.

Percorso di elemento

Specifica la sequenza di nodi da utilizzare per recuperare i dati XML dall'origine dei dati.

Elemento Query XML

Specifica di query XML con gli elementi facoltativi seguenti.

Origine dei dati XML

Elementi XML obbligatori

Elementi XML facoltativi

Per un servizio Web<Method Namespace="namespace" Name="MethodName" /> -oppure- <SoapAction>soap action</SoapAction>``<ElementPath> element path </ElementPath>``<Method Namespace="namespace" Name="MethodName" /> -oppure- <SoapAction>soap action</SoapAction>

Per un documento XML<ElementPath> element path </ElementPath>

Per un documento XML incorporato<XmlData> inner XML </XmlData><ElementPath> element path </ElementPath> -oppure- <ElementPath IgnoreNamespaces="true"> element path </ElementPath>

Utilizzare l'elemento Query XML per specificare gli spazi dei nomi o l'attributo IgnoreNamespaces in ElementPath XML per ignorarli. Per ulteriori informazioni sull'elemento Query XML, vedere Sintassi di query XML per la definizione di dati di report XML. Per ulteriori informazioni sulla sintassi del percorso di elemento, vedere Sintassi dei percorsi di elementi per la definizione di dati di report XML.

Requisiti per il recupero di dati del servizio Web XML

Lo schema non viene rilevato automaticamente dall'estensione per l'elaborazione dati XML. È pertanto necessario essere in grado di determinare i metodi SOAP tramite i quali verranno recuperati i dati desiderati. È inoltre necessario comprendere lo spazio dei nomi o lo schema di indirizzamento che il servizio Web utilizza per i dati.

Requisiti per il recupero di dati di documenti XML

Se si utilizza il protocollo HTTP, il server deve restituire dati XML oppure i dati XML devono essere incorporati nell'elemento Query XML. Se si fa riferimento a un documento XML direttamente utilizzando il protocollo HTTP, l'estensione deve essere xml. È necessario conoscere la procedura di creazione di una query XML per il recupero di tutti i dati che si desidera utilizzare. 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 un insieme nodo foglia nel documento XML. Se nel documento XML sono inclusi percorsi aggiuntivi di altri insiemi di nodi foglia di pari livello, questi nodi verranno ignorati a meno che non venga specificato un percorso nella query. Per ulteriori informazioni, vedere Sintassi dei percorsi di elementi per la definizione di dati di report XML.

Risorse esterne

Reporting Services: Utilizzo di origini dei dati del servizio Web e XML

Vedere anche

Concetti

Connessione a un'origine dei dati

Altre risorse

Esercitazione: Utilizzo di dati XML in un report

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione Cronologia

14 aprile 2006

Nuovo contenuto:
  • Collegamenti e informazioni sul percorso di elemento e sull'elemento Query XML.
  • Dati XML incorporati.