URLs in Konfigurationsdateien (Reporting Services)

Reporting Services speichert Anwendungseinstellungen in einer RSReportServer.config-Datei. In dieser Datei befinden sich Konfigurationseinstellungen sowohl für URLs als auch für URL-Reservierungen. Diese Konfigurationseinstellungen haben ganz verschiedene Zwecke und Regeln für Änderungen. Wenn Sie es gewohnt sind, Konfigurationsdateien zu ändern, um eine Bereitstellung zu optimieren, finden Sie in diesem Thema hilfreiche Informationen dazu, wie jede URL-Einstellung verwendet wird.

URL-Einstellungen in der RSReportServer.config-Datei

Reporting Services speichert URLs für den Anwendungs- und Berichtszugriff und zur Verbindung von Web-Front-End-Komponenten mit einem Back-End-Berichtsserver.

URLs für Anwendungszugriff

URLs werden für den Zugriff auf den Report Server-Webdienst und den Berichts-Manager verwendet. Verwenden Sie zum Konfigurieren der URLs das Reporting Services-Konfigurationstool. Das Tool erstellt die URL-Reservierungen für jede Anwendung in HTTP.SYS und fügt Einträge für die URLs im Abschnitt URLReservations der RSReportServer.config-Datei hinzu.

URLs für Berichtszugriff

Reporting Services umfasst eine Berichtsserver-E-Mail-Übermittlungserweiterung, mit der Sie Berichtslinks oder Anlagen senden können. Ein Berichtshyperlink wird erstellt, wenn der Bericht übermittelt wird. Die Berichtsserver-E-Mail-Übermittlungserweiterung erstellt den Link mithilfe der UrlRoot-Einstellung in der Konfigurationsdatei. Die UrlRoot-Einstellung wird außerdem dazu verwendet, Links in einem gerenderten Bericht, der über die unbeaufsichtigte Berichtsverarbeitung generiert wird, aufzulösen.

UrlRoot wird automatisch in der RSReportServer.config-Datei angegeben, wenn Sie URLs für den Anwendungszugriff konfigurieren. Wenn Sie diesen Wert in der Konfigurationsdatei ändern, müssen Sie eine gültige URL-Adresse für einen Report Server-Webdienst angeben, der mit einer Berichtsserver-Datenbank mit Berichten, die Sie übermitteln möchten, verbunden ist. Sie können nur einen UrlRoot-Wert für eine einzelne Berichtsserverinstanz angeben. In der RSReportServer.config-Datei kann nur ein UrlRoot-Eintrag für eine bestimmte Berichtsserverinstanz vorhanden sein. Wenn mehrere URLs für den Report Server-Webdienst reserviert sind, müssen Sie einen der verfügbaren Werte für UrlRoot auswählen.

In den meisten Fällen ist es nicht notwendig, UrlRoot zu ändern. Wenn der Zugriff auf den Berichtsserver jedoch über einen vollqualifizierten URL erfolgt und Sie keinen URL konfiguriert haben, der einen Hostheader zum vollqualifizierten Websitenamen verwendet, müssen Sie die RSReportServer.config-Datei manuell bearbeiten, um UrlRoot auf den vollqualifizierten URL des Berichtsservers festzulegen, mit dem der Bericht gerendert wird (z. B. https://www.adventure-works.com/mywebapp/reportserver).

URLs zur Verbindung des Berichts-Managers und Webparts zum Report Server-Webdienst

Der Berichts-Manager und SharePoint 2.0 Webparts für Reporting Services sind Web-Front-End-Komponenten, die eine Verbindung zu einem Berichtsserver herstellen. URLs, die verwendet werden, um eine Verbindung mit einem Back-End-Berichtsserver herzustellen, umfassen Folgendes:

  • ReportServerUrl (wird vom Berichts-Manager verwendet)

  • ReportServerExternalUrl (wird von Webparts verwendet)

HinweisHinweis

Frühere Versionen von Reporting Services beinhalteten das ReportServerVirtualDirectory-Element. Dieser Wert ist in SQL Server 2008 veraltet. Wenn Sie eine vorhandene Installation aktualisiert haben und eine Konfigurationsdatei mit dieser Einstellung verwenden, wird dieser Wert vom Berichtsserver nicht mehr gelesen.

Die folgende Tabelle bietet einen Überblick über alle URLs, die in einer Reporting Services-Konfigurationsdatei angegeben werden können.

Einstellung

Verwendung

Beschreibung

ReportServerUrl

Optional. Dieses Element ist nicht in der RSReportServer.config-Datei enthalten, es sei denn, Sie fügen es selbst hinzu.

Legen Sie dieses Element nur fest, wenn Sie eines der folgenden Szenarios konfigurieren:

  • Der Berichts-Manager bietet Web-Front-End-Zugriff auf einen Report Server-Webdienst, der auf einem anderen Computer oder einer anderen Instanz desselben Computers ausgeführt wird.

  • Wenn Sie mehrere URLs zu einem Berichtsserver haben und der Berichts-Manager einen bestimmten URL verwenden soll.

  • Sie haben einen bestimmten Berichtsserver-URL, der für alle Berichts-Manager-Verbindungen verwendet werden soll.

    Sie aktivieren beispielsweise den Berichts-Manager-Zugriff für alle Computer im Netzwerk, möchten jedoch, dass sich der Berichts-Manager über eine lokale Verbindung mit dem Berichtsserver verbindet. In diesem Fall könnten Sie ReportServerUrl mit "https://localhost/reportserver" konfigurieren.

Anweisungen zum Implementieren dieser Szenarios finden Sie unter Vorgehensweise: Konfigurieren des Berichts-Managers.

Dieser Wert gibt einen URL zum Report Server-Webdienst an. Dieser Wert wird von der Berichts-Manager-Anwendung beim Start gelesen. Wenn dieser Wert festgelegt ist, stellt der Berichts-Manager eine Verbindung zu dem im URL angegebenen Berichtsserver her.

Der Berichts-Manager bietet standardmäßig Web-Front-End-Zugriff auf den Report Server-Webdienst, der innerhalb derselben Berichtsserver-Instanz ausgeführt wird wie der Berichts-Manager. Wenn Sie den Berichts-Manager jedoch mit einem Report Server-Webdienst verwenden möchten, der zu einer anderen Instanz gehört oder in einer Instanz auf einem anderen Computer ausgeführt wird, können Sie diesen URL zur Weiterleitung des Berichts-Managers festlegen, sodass dieser eine Verbindung mit dem externen Report Server-Webdienst herstellt.

Wenn ein SSL-Zertifikat (Secure Sockets Layer) auf dem Berichtsserver installiert ist, mit dem Sie eine Verbindung herstellen, muss der Wert ReportServerUrl dem Namen des Servers entsprechen, der für das Zertifikat registriert ist. Wenn Sie die Fehlermeldung "Die zugrunde liegende Verbindung wurde geschlossen: Für den geschützten SSL/TLS-Kanal konnte keine Vertrauensstellung hergestellt werden" erhalten, legen Sie ReportServerUrl auf den vollqualifizierten Domänennamen des Servers fest, für den das Zertifikat ausgestellt wurde. Wenn das Zertifikat beispielsweise für https://adventure-works.com.onlinesales registriert ist, dann lautet der URL des Berichtsservers https://adventure-works.com.onlinesales/reportserver.

ReportServerExternalUrl

Optional. Dieses Element ist nicht in der RSReportServer.config-Datei enthalten, es sei denn, Sie fügen es selbst hinzu.

Legen Sie dieses Element nur fest, wenn Sie SharePoint 2.0 Webparts verwenden und möchten, dass Benutzer einen Bericht abrufen und in einem neuen Browserfenster öffnen können.

Fügen Sie <ReportServerExternalUrl> unter dem <ReportServerUrl>-Element hinzu, und legen Sie dieses anschließend auf einen vollqualifizierten Berichtsservernamen fest, der bei Zugriff in einem separaten Browserfenster in eine Berichtsserver-Instanz aufgelöst wird. Löschen Sie <ReportServerUrl> nicht.

Das folgende Beispiel veranschaulicht die Syntax:

<ReportServerExternalUrl>http://myserver/reportserver</ReportServerExternalUrl>

Dieser Wert wird von SharePoint 2.0 Webparts verwendet.

In früheren Versionen wurde empfohlen, diesen Wert festzulegen, um den Berichts-Generator auf einem mit dem Internet verbundenen Berichtsserver bereitzustellen. Dies ist ein ungeprüftes Bereitstellungsszenario. Wenn Sie diese Einstellung in der Vergangenheit verwendet haben, um den Zugriff auf den Berichts-Generator aus dem Internet zu unterstützen, sollten Sie sich eine Alternative überlegen.