Freigeben über


XML-Verbindungstyp (SSRS)

Wenn Sie Daten aus einer XML-Datenquelle in den Bericht einschließen möchten, benötigen Sie ein Dataset, das auf einer Berichtsdatenquelle vom Typ "XML" basiert. Dieser integrierte Datenquellentyp basiert auf der XML-Datenerweiterung. Verwenden Sie diesen Datenquellentyp, um eine Verbindung mit XML-Dokumenten, Webdiensten oder in die Abfrage eingebetteten XML-Daten herzustellen und Daten abzurufen.

Diese Datenerweiterung unterstützt Parameter und Anmeldeinformationen, die getrennt von der Verbindungszeichenfolge verwaltet werden.

Verwenden Sie die Informationen in diesem Thema, um eine Datenquelle zu erstellen. Schrittweise Anweisungen finden Sie unter Vorgehensweise: Hinzufügen und Prüfen einer Datenverbindung oder Datenquelle (Berichts-Generator 3.0 und SSRS).

In diesem Artikel

Verbindungszeichenfolge

Anmeldeinformationen

Abfragen

Parameter

Hinweise

Gewusst wie-Themen

Verwandte Abschnitte

Verbindungszeichenfolge

Bei der Verbindungszeichenfolge muss es sich um eine URL handeln, von der auf den Webdienst, die internetbasierte Anwendung oder das per HTTP verfügbare XML-Dokument verwiesen wird. XML-Dokumente müssen die Erweiterung XML aufweisen. Für in der Datasetabfrage eingebettete XML-Daten können Sie auch eine leere Verbindungszeichenfolge verwenden.

Im folgenden Beispiel wird die Syntax der Verbindungszeichenfolge für einen Webdienst bzw. für ein XML-Dokument angegeben. Das file://-Protokoll wird nicht unterstützt.

XML-Dokumenttyp

Beispiel für Verbindungszeichenfolge

Webdienst

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

XML-Dokument

https://localhost/XML/Customers.xml

Eingebettetes XML-Dokument

Leer

Weitere Beispiele für Verbindungszeichenfolgen finden Sie unter Datenverbindungen, Datenquellen und Verbindungszeichenfolgen in Report Builder 3.0.

Anmeldeinformationen

Anmeldeinformationen sind erforderlich, um Abfragen auszuführen und den Bericht lokal oder vom Berichtsserver aus in der Vorschau anzuzeigen.

Nachdem Sie den Bericht veröffentlicht haben, müssen Sie eventuell die Anmeldeinformationen für die Datenquelle ändern, sodass die Berechtigungen zum Abrufen der Daten beim Ausführen des Berichts auf dem Berichtsserver gültig sind.

Auf einem Berichterstellungsclient sind die folgenden Optionen zum Angeben von Anmeldeinformationen verfügbar:

  • Aktueller Windows-Benutzer (auch bekannt als integrierte Sicherheit)

  • Anmeldeinformationen sind nicht erforderlich. Wenn Sie keine Anmeldeinformationen auswählen, wird der anonyme Zugriff verwendet. Stellen Sie sicher, dass für die Verbindung des Berichtsservers mit einer externen Datenquelle ein Konto für die unbeaufsichtigte Ausführung definiert ist. Die XML-Datenverarbeitungserweiterung übergibt keine Anmeldeinformationen an die Ziel-URL oder den Webdienst. Die Verbindung wird nur dann hergestellt, wenn Sie das Konto für die unbeaufsichtigte Ausführung definiert haben. Weitere Informationen finden Sie unter Konfigurieren des Kontos für die unbeaufsichtigte Ausführung in der Dokumentation zu Reporting Services in der SQL Server-Onlinedokumentation auf "msdn.microsoft.com".

Gespeicherte Anmeldeinformationen oder Aufforderungen zur Eingabe von Anmeldeinformationen werden nicht unterstützt. Wenn Sie die integrierte Sicherheit von Windows deaktiviert haben, können Sie sie nicht zum Abrufen von Daten verwenden. Wenn Sie gespeicherte Anmeldeinformationen oder auf Anforderung einzugebende Anmeldeinformationen angeben, tritt ein Laufzeitfehler auf.

Weitere Informationen finden Sie unter Datenverbindungen, Datenquellen und Verbindungszeichenfolgen (SSRS) oder Angeben von Anmeldeinformationen im Berichts-Generator 3.0.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurück zum Anfang

Abfragen

Mit einer Abfrage wird angegeben, welche Daten für ein Berichtsdataset abgerufen werden sollen. Die Feldauflistung für ein Dataset wird mit den Spalten aus dem Resultset einer Abfrage aufgefüllt. In Berichten wird nur das erste Resultset verarbeitet, das von einer Abfrage abgerufen wird.

Sie müssen den textbasierten Abfrage-Designer verwenden, um die Abfrage zu erstellen. Die Abfrage muss XML-Daten zurückgeben.

Weitere Informationen zum textbasierten Abfrage-Designer finden Sie unter Benutzeroberfläche des textbasierten Abfrage-Designers (Berichts-Generator 3.0).

Die folgende Tabelle enthält die möglichen Werte einer Datasetabfrage für eine Datenquelle vom Typ "XML":

Datasetabfrage

Beschreibung

Leer

Verwenden Sie eine leere Abfrage, um ein Standardresultset zu erstellen. Die Standardabfrage wird erstellt, indem die Datenquelle gelesen und die XML-Knotenhierarchie bis zur ersten Blattauflistung durchsucht wird. Das Resultset enthält alle Knoten mit Textwerten und alle Knotenattribute unter diesem Pfad. Die Spalten im Resultset werden den Feldern für das Dataset zugeordnet.

Elementpfad

Gibt die Sequenz von Knoten an, die beim Abrufen von XML-Daten aus der Datenquelle verwendet wird.

XML-Abfrageelement

Eine XML-Abfragespezifikation mit den folgenden optionalen Elementen.

XML-DatenquelleErforderliche XML-ElementeOptionale XML-Elemente
Für einen Webdienst <Method Namespace= "namespace" Name="MethodName" /> -- or -- <SoapAction> SOAP-Aktion </SoapAction> <ElementPath> Elementpfad </ElementPath> <Method Namespace= "namespace" Name="MethodName" /> -- or -- <SoapAction> SOAP-Aktion </SoapAction>
Für ein XML-Dokument <ElementPath> Elementpfad </ElementPath>
Für ein eingebettetes XML-Dokument <XmlData> inneres XML-Element </XmlData> <ElementPath> Elementpfad </ElementPath> -- or -- <ElementPath IgnoreNamespaces="true"> Elementpfad </ElementPath>

Weitere Informationen zur Abfragesyntax finden Sie unter XML-Abfragesyntax zum Angeben von XML-Berichtsdaten (SSRS) in der Dokumentation zu Reporting Services in der SQL Server-Onlinedokumentation auf "msdn.microsoft.com".

Beispiele finden Sie unter Reporting Services: Using XML and Web Service Data Sources.

Anforderungen für das Abrufen von XML-Webdienstdaten

Die XML-Datenverarbeitungserweiterung kann das Schema nicht selbstständig erkennen. Daher müssen Sie über eine Möglichkeit verfügen, die SOAP-Methoden zu ermitteln, mit denen die gewünschten Daten abgerufen werden können. Sie müssen außerdem wissen, welches Adressierungsschema oder welchen Namespace der Webdienst für seine Daten verwendet.

Für einen Webdienst können Sie ein <Query>-Element angeben, das eine aufzurufende Methode oder eine SOAP-Aktion angibt. Sie können die Abfrage leer lassen und die Standardabfrage verwenden, wenn die XML-Datenquelle eine hierarchische Struktur besitzt, die die im Bericht zu verwendenden Daten bereitstellt. Mit der Abfrage abgerufene Werte und Attribute von XML-Elementknoten werden den im Bericht verwendeten Datasetfeldern zugeordnet.

Anforderungen für das Abrufen von XML-Dokumentdaten

Bei Verwendung von HTTP muss der Server XML-Daten zurückgeben, oder die XML-Daten müssen im XML-Query-Element eingebettet sein. Wenn Sie über HTTP direkt auf ein XML-Dokument verweisen, muss die Erweiterung .xml verwendet werden.

Sie müssen wissen, wie Sie eine XML-Abfrage erstellen, die alle benötigten Daten abruft. Wenn Sie keinen Elementpfad angeben, besteht das Standardverhalten zum Analysieren eines XML-Dokuments darin, dass der erste verfügbare Pfad zu einer Blattknotenauflistung im XML-Dokument ausgewählt wird. Wenn das XML-Dokument zusätzliche Pfade zu anderen Auflistungen gleichgeordneter Blattknoten enthält, werden diese Knoten ignoriert, es sei denn, Sie geben in der Abfrage einen Pfad ein.

Zum Angeben eines Elementpfads können Sie eine XQuery-ähnliche XML-Syntax verwenden.

Weitere Informationen finden Sie unter Syntax für Elementpfade zum Angeben von XML-Berichtsdaten (SSRS) in der Dokumentation zu Reporting Services in der SQL Server-Onlinedokumentation auf "msdn.microsoft.com".

Parameter

Die Abfrage wird nicht analysiert, um Parameter zu identifizieren.

Zum Hinzufügen von Parametern müssen diese im Dialogfeld Dataseteigenschaften auf der Seite Parameter manuell erstellt werden.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurück zum Anfang

Hinweise

Die XML-Datenerweiterung unterstützt das Erstellen von Berichten auf Basis von tabellarischen (nicht hierarchischen) XML-Daten. Weitere Informationen finden Sie unter Hinzufügen von Daten aus externen Datenquellen (SSRS).

Es ist keine integrierte Unterstützung zum Abrufen von XML-Dokumenten aus einer SQL Server-Datenbank vorhanden.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurück zum Anfang

Verwandte Abschnitte

Diese Abschnitte der Dokumentation enthalten umfassende grundlegende Informationen zu Berichtsdaten sowie Informationen zum Definieren, Entwerfen, Anpassen und Verwenden der mit Daten zusammenhängenden Teile eines Berichts.

Pfeilsymbol, dass mit dem Link 'Zurück zum Anfang' verwendet wirdZurück zum Anfang