Beispiele für URLs von Elementen auf einem Berichtsserver (SharePoint-Modus)
Wenn Sie Berichte und verwandte Elemente in einer SharePoint-Bibliothek veröffentlichen möchten, können Sie den Inhalt mithilfe der Reporting Services-Erstellungstools, wie dem Report Designer, veröffentlichen. Sie können den Inhalt auch mithilfe von SharePoint-Websiteaktionen hochladen.
Im einheitlichen Modus werden für SharePoint-Websites andere Webadressen als für Reporting Services -Berichtsserver verwendet. SharePoint-Websitehierarchien enthalten die SharePoint-Webanwendung, eine Stammwebsite, optionale Unterwebsites und Bibliotheken. Ihnen muss das Verfahren zum Erstellen einer URL-Adresse bekannt sein, die den SharePoint-Server und den Speicherort in der SharePoint-Websitehierarchie angibt, an dem Sie einen Bericht oder verknüpfte Elemente veröffentlichen möchten.
Zu einem Bericht gehörende Elemente umfassen u. a. freigegebene Datenquellen, Unterberichte, Drillthroughberichten und Ressourcen wie webbasierte Bilddateien. In einem Bericht, der in einer SharePoint-Bibliothek veröffentlicht wird, müssen diese zugehörigen Elemente mit ihrem Speicherort in der SharePoint-Bibliothek angegeben werden.
Die Beispiele in diesem Artikel helfen Ihnen, URLs zu Berichten und verwandten Elementen in den Berichtslösungen zu erstellen.
Speicherorthierarchie
Wenn Sie einen Berichtsserver so konfigurieren, dass er im integrierten SharePoint-Modus ausgeführt wird, wird die SharePoint-Webhierarchie zum Adressieren von Elementen verwendet, die auf einem Berichtsserver verarbeitet und verwaltet werden.
Die folgenden Elemente der Webhierarchie können zum Zugreifen auf und Sichern von Berichtsserverinhalten verwendet werden. Andere Objekte wie Listen und Seiten werden für den Zugriff auf Berichtsserverinhalte nicht verwendet und daher in der folgenden Tabelle nicht beschrieben.
| Object | BESCHREIBUNG |
|---|---|
| SharePoint-Webanwendung | Eine SharePoint-Webanwendung kann als eigenständiger Server oder als Teil einer Farm installiert werden, die eine Auflistung von virtuellen Servern enthält. Eine Webanwendung besitzt eine URL (z.B. http:*//servername*) und kann mehrere Websites enthalten. |
| Website | Bei einer Website handelt es sich entweder um eine übergeordnete Website für eine Webanwendung oder um eine Unterwebsite. |
| SharePoint-Bibliothek | Eine Bibliothek enthält Dokumente oder Ordner. Eine Bibliothek bzw. ein Ordner in einer Bibliothek stellt das einzige Websiteobjekt dar, in dem Berichte, Berichtsmodelle, freigegebene Datenquellen und externe Bilder gespeichert werden können. |
| Element | Berichtsserverelemente, auf die Sie in einer URL verweisen können, enthalten eine Berichtsdefinition für einen Bericht oder Unterbericht, ein Berichtsmodell, eine freigegebene Datenquelle oder ein externes Bild. |
URL-Syntax und -Regeln
Sie können jedes Berichtsserverelement in einer Bibliothek anhand seiner vollqualifizierten URL identifizieren. Die URL enthält ein Protokollpräfix, den Servernamen, den Speicherort, die Bibliothek, den Dateinamen und die Dateinamenerweiterung für den Dateityp.
URL für einen SharePoint-Server
Wenn Sie in SQL Server Data Tools (SSDT) ein Berichtsserver- oder Berichtsmodellprojekt für den Berichtsserver bereitstellen, müssen Sie eine URL für den SharePoint-Server verwenden.
Öffnen Sie zum Suchen des zu verwendenden Servernamens einen Browser, und suchen Sie die SharePoint-Bibliothek, in der Sie einen Bericht veröffentlichen möchten. Der Servername wird unmittelbar nach dem Protokollpräfix angezeigt, z.B. http:*//servername*.
Die Verwendung des Reporting Services-URL-Proxyendpunkts wird nicht unterstützt. Ein Proxyendpunkt enthält eine Portnummer, z.B. http:*//servername:8080/reportserver*.
URL für eine SharePoint-Serverwebsite oder -Unterwebsite
Wenn Sie einen Bericht oder eine Berichtsdatenquelle bereitstellen, müssen Sie eine URL zu einer SharePoint-Website und ggf. -Unterwebsite verwenden. In der URL wird der Name der Website unmittelbar nach dem Servernamen angezeigt, z. B. https://*servername/site* oder https://*servername/site/subsite*.
In einer Microsoft Office SharePoint Server 2007- oder SharePoint Server 2010-Webanwendung entsprechen die Website und die Unterwebsite häufig den Registerkarten auf der Hauptwebsite. Wählen Sie zum Suchen des Website- oder Unterwebsitenamens Start und anschließend Gesamter Websiteinhalt aus. Führen Sie einen Bildlauf ganz nach unten durch, und suchen Sie nach Websites und Arbeitsbereiche. Im folgenden Abschnitt sind die Websites aufgeführt.
URL für eine SharePoint-Bibliothek
Wenn Sie einen Bericht oder ein verknüpftes Element in einer SharePoint-Bibliothek bereitstellen, müssen Sie eine URL zur SharePoint-Bibliothek verwenden. Die URL für eine Bibliothek unterscheidet sich je nach verwendeter SharePoint-Version.
In Microsoft Windows SharePoint Services 3.0 oder SharePoint Foundation 2010 wird die Bibliothek nach dem Servernamen angezeigt, z. B. https://*servername/*Shared Documents.
In Office SharePoint Server 2007 oder SharePoint Server 2010wird die Bibliothek nach der Website und der Unterwebsite angezeigt. Beispiel: https://*servername/site/*Documents.
Öffnen Sie zum Suchen der Pfadinformationen für eine neue SharePoint-Bibliothek oder für eine unbekannte Website einen Browser, und suchen Sie die SharePoint-Bibliothek, in der Sie die Berichte veröffentlichen möchten. Wenn die Bibliothek leer ist, laden Sie eine beliebige Datei hoch. Klicken Sie mit der rechten Maustaste auf die Datei, und wählen Sie Eigenschaften aus, um das Fenster Eigenschaften zu öffnen. Die Adresse der Datei enthält die URL-Werte, die Sie für einen Veröffentlichungsvorgang benötigen.
Vollqualifizierte URLs für Elemente auf einer SharePoint-Website
Elemente, die in einer SharePoint-Bibliothek gespeichert sind, werden stets über eine vollqualifizierte URL adressiert, die mit der Webanwendung (https://*server*) als Stammknoten beginnt und mit dem Namen der Datei endet, auf die Sie verweisen.
Dateinamen in der URL müssen eine Dateinamenerweiterung aufweisen.
In Berichten, die Sie auf einer SharePoint-Website veröffentlichen, können Sie für abhängige Elemente keine relativen URLs verwenden. Beispielsweise können Sie keine relative URL verwenden, um auf eine freigegebene Datenquelle, auf ein Berichtsmodell oder auf einen Unterbericht zu verweisen. Sie müssen für jedes Element stets die vollqualifizierte URL zu einer SharePoint-Bibliothek angeben. Es kann nicht vorhergesagt werden, wo sich eine abhängige Datei befindet. Es lässt sich nicht vorhersagen, weil es keine vordefinierte Hierarchie für die Websites gibt, die Sie zum Analysieren eines URL-Formats verwenden können.
Wenn Sie einen Bericht veröffentlichen oder hochladen, der abhängige Elemente enthält, müssen Sie die Verweise auf die abhängigen Elemente nach der Veröffentlichung des Berichts festlegen. Verweise, die im Vorschaumodus im Report Designer wie vorgesehen verwendet werden konnten, sind nach der Veröffentlichung des Berichts nicht notwendigerweise auch funktionsfähig. Weitere Informationen finden Sie unter Veröffentlichen in einer SharePoint-Bibliothek über ein Erstellungstool in diesem Artikel.
URLs für externe Bilder
Eine Berichtsdefinition kann eine Bilddatei enthalten, die als externe Datei gespeichert ist. Sie können in der Berichtsdefinition auf diese Datei verweisen, indem Sie eine vollqualifizierte URL für die Bilddatei festlegen. Er kann auf einer SharePoint-Website oder auf einem Remotecomputer gespeichert sein.
Wichtig
Falls die externe URL auf ein Bild auf einer SharePoint-Website verweist, wird das Symbol für beschädigte Bilder angezeigt, wenn Sie den Bericht im Berichts-Generator in der Vorschau anzeigen. Wenn Sie den Bericht auf die SharePoint-Website hochladen und im verbundenen Modus rendern, wird das Symbol für beschädigte Bilder eingeblendet, wenn Sie lediglich über die Berechtigung View Items verfügen.
Unabhängig vom Berichtsservermodus muss es sich in einem Bericht bei Verweisen auf eine externe Bilddatei um eine vollqualifizierte URL handeln. Zudem ist es für Verweise auf eine externe Bilddatei im Allgemeinen erforderlich, dass Sie das Konto für die unbeaufsichtigte Berichtsverarbeitung konfigurieren.
Angeben von Unterberichten und Drillthroughberichten
Unterberichte müssen sich im gleichen Ordner wie der Hauptbericht befinden. Sie können keinen relativen Ordner angeben.
Schließen Sie zum Angeben von Drillthroughberichten die URL in einem Ausdruck ein. Geben Sie z. B. den Bericht mit dem Namen „SalesDetails“ als Drillthroughbericht an. Legen Sie in der Aktion für das Textfeld oder den Platzhaltertext „ReportName“ auf den folgenden Ausdruck fest:
="https://site/subsite/documentlibrary/SalesDetails.rdl"
Reservierte Namen auf SharePoint-Websites
Wenn Sie eine URL für ein Element erstellen oder konstruieren, das sich auf einer SharePoint-Website befindet, ist zu beachten, dass die Wörter Persönlich und Websites unter der Standardwebsite reservierte Namen darstellen.
Beispiele für URLs
Wenn Sie Elemente in einer SharePoint-Bibliothek veröffentlichen, müssen Sie vollqualifizierte URLs zur Zielbibliothek angeben. Eine vollqualifizierte SharePoint-URL enthält die SharePoint-Webanwendung, die Website, die Bibliothek, den Ordner (optional), die Datei sowie die Dateinamenerweiterung. In den folgenden Beispielen wird die zu verwendende Syntax veranschaulicht.
| Ziel | Beispiel-URL |
|---|---|
| Ein SharePoint-Server. | https://TestServer |
| Eine SharePoint-Serverwebsite oder -Unterwebsite. | https://TestServer/toplevelsite/subsite |
| Der Beispielbericht Company Sales unter Shared Documents Windows SharePoint Services in einer SharePoint Foundation 2010 - oder -Bereitstellung. | https://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl |
| Der Beispielbericht „Company Sales“ im Ordner Documents/Doc einer Office SharePoint Server - oder SharePoint Server 2010 -Instanz. | https://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl |
| Der Beispielbericht "Company Sales" im Ordner Report Center einer Office SharePoint Server - oder SharePoint Server 2010 -Instanz. | https://TestServer/TestSite/Reports/Doc/Company%20Sales.rdl |
Veröffentlichen in einer SharePoint-Bibliothek über ein Erstellungstool
Wenn Sie ein Berichterstellungstool zum Veröffentlichen von Berichten und zugehörigen Dateien in einer Bibliothek verwenden, werden die Dateien überprüft, bevor sie hinzugefügt werden. Wenn Sie Berichte und zugehörige Dateien mithilfe der Upload -Aktion in einer SharePoint-Bibliothek hochladen, erfolgt keine Überprüfung. Sie wissen erst, ob die Datei gültig ist, wenn Sie den Bericht verwalten, bearbeiten oder ausführen und somit auf ihn zugreifen.
Hinweis
Damit Sie Berichte aus SQL Server Data Tools (SSDT)auf einer SharePoint-Website veröffentlichen können, müssen Sie die SharePoint-Website möglicherweise der Liste der vertrauenswürdigen Speicherorte im Internet Explorer-Browser hinzufügen.
Freigegebene Datenquellen
Wenn Sie eine freigegebene Datenquelle in einem Berichterstellungstool veröffentlichen, legen Sie die TargetDataSourceFolder-Projekteigenschaft fest. Der Ordner für die Zieldatenquelle muss eine URL zu einer SharePoint-Bibliothek darstellen. Anders als im nativen Modus von Reporting Services können Sie keinen relativen Ordner angeben. Relative Pfade sind ungültig. Wenn unter dem Pfad der Dokumentbibliothek kein Ordner vorhanden ist, wird einer erstellt.
Wenn Sie eine freigegebene Datenquellendatei (RDS-Datei) auf einer SharePoint-Website veröffentlichen, wird durch diese Aktion der Datenquellendatei die Dateinamenerweiterung RSDS zugewiesen. Die RSDS-Datei kann nicht lokal auf einer SharePoint-Website gespeichert und in ein vorhandenes Reporting Services -Projekt importiert werden. Freigegebene Datenquellen mit den Dateinamenerweiterungen RDS und RSDS können nicht ausgetauscht werden.
Freigegebene Datenquellen im Report Designer
Wenn Sie freigegebene Datenquellen in einem Report Designer-Projekt veröffentlichen, können Sie eine URL verwenden, die die Zielbibliothek angibt, oder die Eigenschaft leer lassen. Anders als im nativen Modus von Reporting Services können Sie keinen relativen Ordner angeben. Relative Pfade sind ungültig. Wenn unter dem Pfad der Dokumentbibliothek kein Ordner vorhanden ist, wird einer erstellt. Wenn Sie den Ordner für die Zieldatenquelle leer lassen, wird die Datenquelle im Zielberichtsordner veröffentlicht.
Dateinamen
Dateinamen in einer URL für Berichtselemente müssen eine Dateinamenerweiterung aufweisen. Durch die Dateinamenerweiterung wird der Dateityp bestimmt. Wenn Sie Berichtselemente über ein Berichterstellungstool veröffentlichen, wird die Dateinamenerweiterung automatisch eingeschlossen. Wenn Sie ein Berichtselement in eine SharePoint-Bibliothek hochladen, müssen Sie eine Dateinamenerweiterung einschließen.
Wenn Sie für Elemente, die Sie auf eine SharePoint-Website hochladen, keine Dateinamenerweiterung angeben, tritt der rsInvalidDataSourceReference-Fehler auf. Dateinamen dürfen keine Zeichen enthalten, die von SharePoint-Anwendungen nicht als gültige Dateinamenzeichen erkannt werden. Verwenden Sie keines der folgenden Zeichen: # % & * : < > ? / { | }.
Unterschiede zwischen Hochladen und Veröffentlichen
Wenn Sie den Report Designer oder den Berichts-Generator zum Veröffentlichen von Berichten und zugehörigen Dateien in einer Bibliothek verwenden, überprüft das System die Dateien, bevor sie hinzugefügt werden. Wenn Sie Berichte und zugehörige Dateien mithilfe der Upload -Aktion in einer SharePoint-Bibliothek hochladen, erfolgt keine Überprüfung. Sie wissen erst, ob die Datei gültig ist, wenn Sie den Bericht verwalten, bearbeiten oder ausführen und somit auf ihn zugreifen.
Aktualisieren eines veröffentlichten Elements
Nachdem Sie ein Element in einer SharePoint-Bibliothek veröffentlicht oder hochgeladen haben, müssen Sie das Element aus der Bibliothek auschecken, bevor Sie es aktualisieren. Wenn der Bericht für Sie ausgecheckt wird, sind Sie der einzige Benutzer, der berechtigt ist, Änderungen am Bericht vorzunehmen. Checken Sie den Bericht wieder ein, wenn Sie den Vorgang abgeschlossen haben.
Sie können einen Bericht hochladen oder veröffentlichen, ohne zuerst das Dokument auszuchecken, indem Sie beispielsweise ein Element hochladen, das denselben Namen wie ein vorhandenes Element hat. Der Berichtsserver checkt es in diesem Fall für Sie aus, fügt den aktualisierten Bericht als neue Version des vorhandenen Elements hinzu und checkt das Dokument dann wieder ein.
Externe Bilder als Ressourcen
Ein Berichtsserver, der im nativen Modus ausgeführt wird, unterstützt das Konzept einer Ressource. Das Konzept einer Ressource ist als eine Datei definiert, die auf dem Berichtsserver gespeichert und gesichert, vom Berichtsserver aber nicht verarbeitet wird. Im einheitlichen Modus kann es sich dabei um einen beliebigen Dateityp handeln.
Wenn ein Berichtsserver im integrierten SharePoint-Modus ausgeführt wird, gilt für das Konzept einer Ressource eine engere Definition. Für den Berichtsserver wird das Konzept einer Ressource zum Speichern von Berichten beibehalten, die auf ein externes Bild verweisen. Dieses Konzept gilt, wenn der Bericht eine Momentaufnahme oder eine Kopie darstellt, der bzw. die für die interne Verwendung beibehalten wird.