Freigeben über

Entscheidung zwischen URL-Zugriff und SOAP in Reporting Services

  • Artikel

Gilt für: SQL Server Reporting Services (2016) ❌ SQL Server Reporting Services (2017) ❌ Power BI-Berichtsserver

Die Integration von Reporting Services in benutzerdefinierte Anwendungen ist manchmal nicht ganz einfach. Die Herausforderung ist jedoch nicht die Komplexität des Programmiermodells oder der APIs, sondern die vielen möglichen Möglichkeiten, es zu integrieren. Reporting Services wurde von Grund auf als Entwicklerplattform entwickelt und ist daher mit Berücksichtigung der Programmierflexibilität aufgebaut. Die hohe Flexibilität fordert jedoch häufige Entscheidungen, wenn die Reporting Services-Berichtsnavigations- und Verwaltungsfunktionen in die vorhandenen Geschäftsanwendungen integriert werden.

Hinweis

Ab SQL Server 2017 Reporting Services ist der Zugriff auf die REST-API für die Entwicklung von Lösungen verfügbar. Der Zugriff auf die SOAP-API ist veraltet. Weitere Informationen finden Sie unter Develop with the REST APIs for Reporting Services (Entwickeln mit den REST-APIs für Reporting Services).

Sie können Reporting Services auf zwei verschiedene Arten in benutzerdefinierte Anwendungen integrieren: über den URL-Zugriff und über die Reporting Services-SOAP-API. Welche der beiden Arten verwendet werden soll, hängt von mehreren Faktoren ab. In einigen Fällen müssen für die Integration von Reporting Services in die benutzerdefinierten Geschäftsanwendungen sowohl URL-Zugriff als auch SOAP verwendet werden. Sie sollten sich folgende Fragen stellen:

  • Welche Art Berichtsfunktionen benötigen Sie oder die Endbenutzer? Brauchen Sie einfache Start- und Navigationsfunktionen für die Berichte, oder benötigen Sie ausgereifte Berichtsserver-Verwaltungsfunktionen aus Ihrer benutzerdefinierten Geschäftsanwendung?

  • In welcher Art Umgebung arbeiten die Benutzer normalerweise? Ist die Geschäftsanwendung eine Webanwendung oder eine Windows-Anwendung? Wie leicht können die Benutzer von einer Win32-Umgebung in eine Webumgebung wechseln? Welche Art der Kontrolle benötigen Sie für die Umgebung, in der die Berichte ausgeführt und verwaltet werden?

Nachdem Sie die vorherigen Fragen beantwortet haben, können Sie entscheiden, wie Reporting Services in Ihre IT-Infrastruktur integriert werden soll. Normalerweise wird der URL-Zugriff für die Anzeige und Navigation der Berichte bevorzugt. Der URL-Zugriff ermöglicht eine rasche Navigation durch die Berichte ohne den Aufwand eines Webdiensts. Außerdem ist der URL-Zugriff derzeit die einzige Programmiertechnik, die die komplette Funktionalität von HTML Viewer, einschließlich der Berichtssymbolleiste, für die Berichtsnavigation verwendet. Darüber hinaus sorgt der URL-Zugriff für eine bessere Leistung als SOAP, da das Marshalling der SOAP-Anforderungen zum Server hin und wieder zurück umgangen wird. In den Integrationsszenarien, in denen rasch und problemlos mit integrierten Anzeige- und Navigationstools auf die Berichte zugegriffen werden muss, ist der URL-Zugriff die bessere Variante.

Hinweis

Der Berichtsserver-URL-Zugriff unterstützt HTML Viewer und die erweiterten Funktionen der Berichtssymbolleiste. Die SOAP-API unterstützt diese Art des gerenderten Berichts nicht. Wenn Sie Berichte mithilfe der SOAP-API rendern, müssen Sie Ihre eigene Berichtssymbolleiste entwerfen und entwickeln.

Weitere Informationen zur Berichtssymbolleiste finden Sie unter HTML Viewer and the Report Toolbar (HTML-Viewer und die Berichtssymbolleiste).

Weitere Informationen zum URL-Zugriff finden Sie unter URL Access (URL-Zugriff).

Der URL-Zugriff ist nützlich zum Anzeigen von Berichten, bietet aber nicht die Berichts- und Namespaceverwaltungsfunktionen, die für jedes Unternehmensberichtsszenario von wesentlicher Bedeutung sein können. In diesem Fall empfiehlt sich die Verwendung der umfangreichen Funktionalität der Reporting Services-SOAP-API. Mit der SOAP-API können Sie Berichte verwalten und bereitstellen, Zeitpläne erstellen, Servereigenschaften konfigurieren, Berichtsserver-Namespaces verwalten, Abonnements erstellen und vieles mehr. Die SOAP-API stellt Ihnen die vollständige Verwaltungsfunktionalität in Reporting Services zur Verfügung. Die SOAP-API kann die Berichtsanzeige und -navigation auch über die Render-Methode der API ermöglichen. Das Anzeigen von Berichten über die SOAP-API ermöglicht jedoch nicht die integrierte Anzeigefunktion der Berichtssymbolleiste, oder es behandelt automatisch die Berichtsinteraktivität, die der URL-Zugriff bereitstellt.

Weitere Informationen zur Reporting Services-SOAP-API finden Sie unter Report Server Web Service (Berichtsserver-Webdienst).

In den meisten Fällen sind SOWOHL URL-Zugriff als auch SOAP-Aufrufe erforderlich, um Ihre Berichtsanforderungen zu erfüllen. SOAP wird verwendet, wenn Sie zunächst eine Verbindung mit der Berichtsserverdatenbank herstellen und die verfügbare Liste der Berichte auf einer Benutzeroberfläche darstellen. Der URL-Zugriff wird verwendet, um tatsächlich auf einzelne Berichte zuzugreifen und darin zu navigieren.

Ein Beispiel für die Kombination des URL-Zugriffs mit dem Webdienst, um eine integrierte Berichterstellung bereitzustellen, finden Sie unter SQL Server Reporting Services-Produktbeispiele.

Haben Sie dazu Fragen? Stellen Sie eine Frage im Reporting Services-Forum