XML-Verbindungstyp (SSRS)XML Connection Type (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.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. Dieser integrierte Datenquellentyp basiert auf der XML-Datenerweiterung.This built-in data source type is based on the XML data extension. Verwenden Sie diesen Datenquellentyp, um eine Verbindung mit XML-Dokumenten, Webdiensten oder in die Abfrage eingebetteten XML-Daten herzustellen und Daten abzurufen.Use this data source type to connect to and retrieve data from XML documents, Web services, or XML that is embedded in the query.

Diese Datenerweiterung unterstützt Parameter und Anmeldeinformationen, die getrennt von der Verbindungszeichenfolge verwaltet werden.This data extension supports parameters and credentials managed separately from the connection string.

Verwenden Sie die Informationen in diesem Thema, um eine Datenquelle zu erstellen.Use the information in this topic to build a data source. Eine Schritt-für-Schritt-Anleitung finden Sie unter Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS).For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

VerbindungszeichenfolgeConnection String

Bei der Verbindungszeichenfolge muss es sich um eine URL handeln, von der auf den Webdienst, die webbasierte Anwendung oder das per HTTP verfügbare XML-Dokument verwiesen wird.The connection string must be a URL that points to the Web service, Web-based application, or XML document available through HTTP. XML-Dokumente müssen die Erweiterung XML aufweisen.XML documents must have the XML extension. Für in der Datasetabfrage eingebettete XML-Daten können Sie auch eine leere Verbindungszeichenfolge verwenden.You can also use an empty connection string for XML data embedded in the dataset query.

Im folgenden Beispiel wird die Syntax der Verbindungszeichenfolge für einen Webdienst bzw. für ein XML-Dokument angegeben.The following examples illustrate the connection string syntax for a Web service and XML document, respectively. Das file:// -Protokoll wird nicht unterstützt.The file:// protocol is not supported.

XML-DokumenttypXML document type Beispiel für VerbindungszeichenfolgeConnection String Example
WebdienstWeb service http://adventure-works.com/results.aspx
XML-DokumentXML document http://localhost/XML/Customers.xml
Eingebettetes XML-DokumentEmbedded XML document LeerEmpty

Weitere Informationen sowie Beispiele für Verbindungszeichenfolgen finden Sie unter Datenverbindungen, Datenquellen und Verbindungszeichenfolgen in Berichts-Generator.For more connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

AnmeldeinformationenCredentials

Anmeldeinformationen sind erforderlich, um Abfragen auszuführen und den Bericht lokal oder vom Berichtsserver aus in der Vorschau anzuzeigen.Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.

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.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.

Auf einem Berichterstellungsclient sind die folgenden Optionen zum Angeben von Anmeldeinformationen verfügbar:From a report authoring client, the following options are available to specify credentials:

  • Aktueller Windows-Benutzer (auch bekannt als integrierte Sicherheit).Current Windows user (also known as integrated security).

  • Anmeldeinformationen sind nicht erforderlich.No credentials are required. Wenn Sie keine Anmeldeinformationen auswählen, wird der anonyme Zugriff verwendet.If you select no credentials, Anonymous access is used. Stellen Sie sicher, dass für die Verbindung des Berichtsservers mit einer externen Datenquelle ein Konto für die unbeaufsichtigte Ausführung definiert ist.Make sure that you have defined the unattended execution account for the report server to connect to an external data source. 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.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. Weitere Informationen finden Sie unter Konfigurieren des unbeaufsichtigten Ausführungskontos (SSRS-Konfigurations-Manager) in der Reporting ServicesReporting Services-Dokumentation in der SQL ServerSQL Server-Onlinedokumentation auf 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.

    Gespeicherte Anmeldeinformationen oder Aufforderungen zur Eingabe von Anmeldeinformationen werden nicht unterstützt.Stored and prompted credentials are not supported. Wenn Sie die integrierte Sicherheit von Windows deaktiviert haben, können Sie sie nicht zum Abrufen von Daten verwenden.Remember that if you disable Windows integrated security, you cannot use it to retrieve data. Wenn Sie gespeicherte Anmeldeinformationen oder auf Anforderung einzugebende Anmeldeinformationen angeben, tritt ein Laufzeitfehler auf.If you specify stored or prompted credentials, an error will occur at run time.

    Weitere Informationen finden Sie unter Datenverbindungen, Datenquellen und Verbindungszeichenfolgen (Berichts-Generator und SSRS) und Angeben von Anmeldeinformationen im Berichts-Generator.For more information, see Data Connections, Data Sources, and Connection Strings (Report Builder and SSRS) or Specify Credentials in Report Builder.

AbfragenQueries

Mit einer Abfrage wird angegeben, welche Daten für ein Berichtsdataset abgerufen werden sollen.A query specifies which data to retrieve for a report dataset. Die Feldauflistung für ein Dataset wird mit den Spalten aus dem Resultset einer Abfrage aufgefüllt.The columns in the result set for a query populate the field collection for a dataset. In Berichten wird nur das erste Resultset verarbeitet, das von einer Abfrage abgerufen wird.A report processes only the first result set retrieved by a query.

Sie müssen den textbasierten Abfrage-Designer verwenden, um die Abfrage zu erstellen.You must use the text-based query designer to create the query. Die Abfrage muss XML-Daten zurückgeben.The query must return XML data.

Weitere Informationen über den textbasierten Abfrage-Designer finden Sie unter Benutzeroberfläche des textbasierten Abfrage-Designers (Berichts-Generator).For more information about the text-based query designer, see Text-based Query Designer User Interface (Report Builder).

Die möglichen Werte einer Datasetabfrage für eine Datenquelle vom Typ "XML" sind unten dargestellt.The possible values for a dataset query for a data source that is type XML are shown below.

  • LeerEmpty

    Verwenden Sie eine leere Abfrage, um ein Standardresultset zu erstellen.Use an empty query to create a default result set. Die Standardabfrage wird erstellt, indem die Datenquelle gelesen und die XML-Knotenhierarchie bis zur ersten Blattauflistung durchsucht wird.The default query is created by reading the data source and traversing the XML node hierarchy to the first leaf collection. Das Resultset enthält alle Knoten mit Textwerten und alle Knotenattribute unter diesem Pfad.The result set includes all nodes with text values and all node attributes along that path. Die Spalten im Resultset werden den Feldern für das Dataset zugeordnet.Columns in the result set are mapped to fields for the dataset.

  • ElementpfadAn element path

    Gibt die Sequenz von Knoten an, die beim Abrufen von XML-Daten aus der Datenquelle verwendet wird.Specifies the sequence of nodes to use when retrieving XML data from the data source.

  • XML-AbfrageelementAn XML Query element

    Eine XML-Abfragespezifikation mit den folgenden optionalen Elementen:An XML query specification with the following optional elements:

    • Die XML-Datenquelle stellt einen Webdienst darXML data source is a Web service

      Erforderliche XML-Elemente:Required XML elements:

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

      -- or --

      <SoapAction> SOAP-Aktion </SoapAction><SoapAction> soap action </SoapAction>

      Optionale XML-Elemente:Optional XML Elements:

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

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

      -- or --

      <SoapAction> SOAP-Aktion </SoapAction><SoapAction> soap action </SoapAction>

    • Die XML-Datenquelle stellt ein XML-Dokument darXML data source is an XML document

      Erforderliche XML-Elemente: keineRequired XML elements: None

      Optionale XML-Elemente:Optional XML Elements:

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

    • Die XML-Datenquelle stellt ein eingebettetes XML-Dokument darXML data source is an embedded XML document

      Erforderliche XML-Elemente:Required XML elements:

      <XmlData> inneres XML-Element </XmlData><XmlData> inner XML </XmlData>

      Optionale XML-Elemente:Optional XML Elements:

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

      -- or --

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

    Weitere Informationen zur Abfragesyntax finden Sie unter XML-Abfragesyntax für XML-Berichtsdaten (SSRS) in der Dokumentation zu Reporting ServicesReporting Services in der SQL ServerSQL Server-Onlinedokumentation auf 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.

    Beispiele finden Sie unter Reporting Services: Verwenden von XML und Webdienst-Datenquellen.For examples, see Reporting Services: Using XML and Web Service Data Sources.

Anforderungen für das Abrufen von XML-WebdienstdatenRequirements for Retrieving XML Web Service Data

Die XML-Datenverarbeitungserweiterung kann das Schema nicht selbstständig erkennen.The XML data processing extension does not detect the schema for you. 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.Therefore, you must have some way of discovering which SOAP methods will retrieve the data that you want. Sie müssen außerdem wissen, welches Adressierungsschema oder welchen Namespace der Webdienst für seine Daten verwendet.You must also understand the addressing scheme or namespace that the Web service uses for its data.

Für einen Webdienst können Sie ein <Abfrage>-Element angeben, das eine aufzurufende Methode oder eine SOAP-Aktion angibt.For a Web service, you can provide a <Query> element that specifies a method to call or SOAP action. 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.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. Mit der Abfrage abgerufene Werte und Attribute von XML-Elementknoten werden den im Bericht verwendeten Datasetfeldern zugeordnet.XML element node values and attributes retrieved when the query runs map to the dataset fields you use in your report.

Anforderungen für das Abrufen von XML-DokumentdatenRequirements for Retrieving XML Document Data

Bei Verwendung von HTTP muss der Server XML-Daten zurückgeben, oder die XML-Daten müssen im XML- Query -Element eingebettet sein.Using the http protocol, the server must return XML data or the XML data must be embedded in the XML Query element. Wenn Sie über HTTP direkt auf ein XML-Dokument verweisen, muss die Erweiterung .xml verwendet werden.If you refer to an XML document directly using the http protocol, the extension must be .xml.

Sie müssen wissen, wie Sie eine XML-Abfrage erstellen, die alle benötigten Daten abruft.You must know how to create an XML query that retrieves all the data you need. 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.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. 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.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.

Zum Angeben eines Elementpfads können Sie eine XQuery-ähnliche XML-Syntax verwenden.You can provide an element path using XML syntax similar to XQuery.

Weitere Informationen finden Sie unter Syntax für Elementpfade für XML-Berichtsdaten (SSRS) in der Dokumentation zu Reporting ServicesReporting Services in der SQL ServerSQL Server-Onlinedokumentation auf 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.

ParameterParameters

Die Abfrage wird nicht analysiert, um Parameter zu identifizieren.The query is not analyzed to identify parameters.

Zum Hinzufügen von Parametern müssen diese im Dialogfeld Dataseteigenschaften auf der Seite Parameter manuell erstellt werden.To add parameters, you must create them manually through the Parameter page on the Dataset Properties dialog box.

HinweiseRemarks

Die XML-Datenerweiterung unterstützt das Erstellen von Berichten auf Basis von tabellarischen (nicht hierarchischen) XML-Daten.The XML data extension supports reporting from XML data that is tabular and not hierarchical. Weitere Informationen finden Sie unter Add Data from External Data Sources (SSRS) (Hinzufügen von Daten aus externen Datenquellen).For more information, see Add Data from External Data Sources (SSRS).

Es ist keine integrierte Unterstützung zum Abrufen von XML-Dokumenten aus einer SQL ServerSQL Server -Datenbank vorhanden.There is no built-in support for retrieving XML documents from a SQL ServerSQL Server database.

Themen zur VorgehensweiseHow-To Topics

Dieser Abschnitt enthält schrittweise Anweisungen zum Arbeiten mit Datenverbindungen, Datenquellen und Datasets.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

Erstellen eines freigegebenen Datasets oder eingebetteten Datasets (Berichts-Generator und SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

Hinzufügen eines Filters zu einem Dataset (Berichts-Generator und SSRS)Add a Filter to a Dataset (Report Builder and SSRS)

Diese Abschnitte der Dokumentation enthalten umfassende grundlegende Informationen zu Berichtsdaten sowie Informationen zum Definieren, Anpassen und Verwenden der mit Daten zusammenhängenden Teile eines Berichts.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.

Berichtsdatasets (SSRS)Report Datasets (SSRS)
Bietet eine Übersicht über den Zugriff auf Daten für den Bericht.Provides an overview of accessing data for your report.

Datenverbindungen, Datenquellen und Verbindungszeichenfolgen in Berichts-GeneratorData Connections, Data Sources, and Connection Strings in Report Builder
Enthält Informationen zu Datenverbindungen und Datenquellen.Provides information about data connections and data sources.

Erstellen von Berichten zu eingebetteten und freigegebenen Datasets (Berichts-Generator und SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
Enthält Informationen zu eingebetteten und freigegebenen Datasets.Provides information about embedded and shared datasets.

Datasetfelder-Sammlung (Berichts-Generator und SSRS)Dataset Fields Collection (Report Builder and SSRS)
Enthält Informationen zur von der Abfrage generierten Datasetfeldauflistung.Provides information about the dataset field collection generated by the query.

Von Reporting Services unterstützte Datenquellen (SSRS) in der Reporting ServicesReporting Services-Dokumentation der Onlinedokumentation zu SQL ServerSQL Server.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
Enthält ausführliche Informationen zur Plattform- und Versionsunterstützung für die einzelnen Datenerweiterungen.Provides in-depth information about platform and version support for each data extension.

Siehe auchSee Also

Berichtsparameter (Berichts-Generator und Berichts-Designer) Report Parameters (Report Builder and Report Designer)
Filtern, Gruppieren und Sortieren von Daten (Berichts-Generator und SSRS) Filter, Group, and Sort Data (Report Builder and SSRS)
Ausdrücke (Berichts-Generator und SSRS)Expressions (Report Builder and SSRS)