Tipo di connessione XML (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. Questo tipo di origine dati incorporato è basato sull'estensione per i dati XML. Utilizzare questo tipo di origine dati per connettersi e recuperare dati da documenti XML, servizi Web o valori XML incorporati nella query.
Questa estensione per i dati supporta parametri e credenziali gestiti separatamente dalla stringa di connessione.
Utilizzare le informazioni disponibili in questo argomento per compilare un'origine dati. Per istruzioni dettagliate, vedere Procedura: Aggiunta e verifica di una connessione dati o di un'origine dati (Generatore report 3.0 e SSRS).
Contenuto dell'articolo
Stringa di connessione
Credenziali
Query
Parametri
Osservazioni
Procedure
Sezioni correlate
Stringa di connessione
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.
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 |
Vuoto |
Per ulteriori esempi di stringhe di connessione, vedere Connessioni dati, origini dati e stringhe di connessione in Generatore report 3.0.
Credenziali
Le credenziali sono necessarie per eseguire query, nonché per visualizzare l'anteprima del report in locale e dal server di report.
Dopo aver pubblicato il report, potrebbe essere necessario modificare le credenziali per l'origine dati affinché le autorizzazioni per il recupero dei dati risultino valide al momento dell'esecuzione del report sul server di report.
Da un client di creazione di report sono disponibili le opzioni seguenti per la specifica delle credenziali:
Utente di Windows corrente (nota anche come sicurezza integrata).
Non sono necessarie credenziali. 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 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. Per ulteriori informazioni, vedere Configurazione dell'account di esecuzione automatica nella documentazione di Reporting Services inclusa nella documentazione online di SQL Server sul sito msdn.microsoft.com.
Credenziali archiviate e credenziali fornite dall'utente non sono supportate. Se la sicurezza integrata di Windows è disabilitata, non è possibile utilizzarla per recuperare dati. Se si specificano credenziali archiviate o fornite dall'utente, si verificherà un errore in fase di esecuzione.
Per ulteriori informazioni, vedere Connessioni dati, origini dati e stringhe di connessione (SSRS) o Specifica di credenziali in Generatore report 3.0.
.gif "Icona freccia utilizzata con il collegamento Torna all'inizio")
Torna all'inizio
Query
Una query specifica quali dati recuperare per un set di dati del report. Le colonne nel set di risultati per una query popolano la raccolta dei campi per un set di dati. In un report viene elaborato solo il primo set di risultati recuperato da una query.
Per creare la query, è necessario utilizzare la finestra Progettazione query basata su testo. La query deve restituire dati XML.
Per ulteriori informazioni sulla finestra Progettazione query basata su testo, vedere Interfaccia utente di Progettazione query basata su testo (Generatore report 3.0).
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 alla prima raccolta 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 XMLElementi XML obbligatoriElementi XML facoltativi
Per un servizio Web <Method Namespace= "namespace" Name="MethodName" /> -- or -- <SoapAction> soap action </SoapAction> <ElementPath> element path </ElementPath> <Method Namespace= "namespace" Name="MethodName" /> -- or -- <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> -- or -- <ElementPath IgnoreNamespaces="true"> element path </ElementPath>
|
Per ulteriori informazioni sulla sintassi di query, vedere Sintassi di query XML per la definizione di dati di report XML (SSRS) nella documentazione di Reporting Services inclusa nella documentazione online di SQL Server sul sito msdn.microsoft.com.
Per consultare degli esempi, vedere Reporting Services: Using XML and Web Service Data Sources.
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 individuare 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.
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 durante l'esecuzione della query sono mappati ai campi del set di dati utilizzati nel report.
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 una raccolta di nodi foglia nel documento XML. 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.
È possibile specificare un percorso di elemento utilizzando una sintassi XML simile a XQuery.
Per ulteriori informazioni, vedere Sintassi del percorso di elemento per la definizione di dati di report XML (SSRS) nella documentazione di Reporting Services inclusa nella documentazione online di SQL Server sul sito msdn.microsoft.com.
Parametri
La query non viene analizzata per identificare parametri.
Per aggiungere i parametri, è necessario crearli manualmente utilizzando la pagina Parametri nella finestra di dialogo Proprietà set di dati.
Torna all'inizio
Osservazioni
L'estensione per i dati XML supporta report di dati XML tabulari e non gerarchici. Per ulteriori informazioni, vedere Aggiunta di dati da origini dati esterne (SSRS).
Non è disponibile alcun supporto predefinito per il recupero di documenti XML da un database di SQL Server.
Torna all'inizio
Procedure
In questa sezione sono contenute le istruzioni dettagliate per l'utilizzo di connessioni dati, origini dati e set di dati.
Procedura: Aggiunta di un filtro a un set di dati (Generatore report 3.0 e SSRS)
Torna all'inizio
Sezioni correlate
In queste sezioni della documentazione sono incluse informazioni concettuali approfondite sui dati dei report, nonché le procedure per definire, personalizzare e utilizzare parti di un report correlate ai dati.
Aggiunta di dati a un report (Generatore report 3.0 e SSRS)
Viene fornita una panoramica sull'accesso ai dati del report.Connessioni dati, origini dati e stringhe di connessione in Generatore report 3.0
Vengono fornite informazioni sulle connessioni dati e sulle origini dati.Creazione e aggiunta di set di dati (Generatore report 3.0 e SSRS)
Vengono fornite informazioni sui set di dati incorporati e condivisi.Utilizzo di campi in un set di dati del report (Generatore di report 3.0 e SSRS)
Vengono fornite informazioni sulla raccolta di campi di set di dati generata dalla query.Origini dei dati supportate da Reporting Services (SSRS) nella documentazione di Reporting Services inclusa nella documentazione online di SQL Server.
Vengono fornite informazioni dettagliate sul supporto delle piattaforme e delle versioni per ogni estensione per i dati.
Torna all'inizio