Bereitstellen von Modellen und freigegebenen Datenquellen auf einer SharePoint-Website
Wenn Sie Berichte, Berichtsmodelle, freigegebene Datenquellen und Ressourcen für eine SharePoint-Bibliothek bereitstellen möchten, können Sie den Inhalt mithilfe der Reporting Services-Berichterstellungstools (Berichts-Designer, Berichts-Generator und Modell-Designer) veröffentlichen oder den Inhalt mithilfe von SharePoint-Websiteaktionen hochladen.
Im systemeigenen 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 sowie den Speicherort in der SharePoint-Websitehierarchie angibt, an dem Sie einen Bericht oder verknüpfte Elemente veröffentlichen möchten. Wenn Sie Berichts-Designer, Berichts-Generator oder Modell-Designer 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.
Zudem muss es sich in einer Berichtsdefinition bei allen Verweisen auf freigegebene Datenquellen, Unterberichte und Ressourcen (z. B. webbasierte Bilder) um vollqualifizierte URLs zu einer SharePoint-Bibliothek handeln.
Websitehierarchie
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.
Objekt |
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. https://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
Jedes Berichtsserverelement in einer Bibliothek wird durch eine vollqualifizierte URL identifiziert, die ein Protokollpräfix, einen Servernamen, eine Website, eine Bibliothek, einen Dateinamen und eine Dateinamenerweiterung für den Dateityp enthält.
URL für einen SharePoint-Server
Wenn Sie in Business Intelligence Development Studio 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. https://servername.
Die Verwendung des Reporting Services-URL-Proxyendpunkts wird nicht unterstützt. Ein Proxyendpunkt enthält eine Portnummer, z. B. https://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 MicrosoftOffice SharePoint Server 2007-Webanwendung entsprechen die Website und die Unterwebsite häufig den Registerkarten auf der Hauptwebsite. Klicken Sie zum Suchen des Website- oder Unterwebsitenamens auf Homepage und anschließend auf Gesamter Websiteinhalt. Scrollen Sie ganz nach unten, 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 MicrosoftWindows SharePoint Services 3.0 wird die Bibliothek nach dem Servernamen angezeigt, z. B. https://servername/Shared Documents.
In Office SharePoint Server 2007 wird die Bibliothek nach der Website und der Unterwebsite angezeigt. Beispielsweise 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, da keine vordefinierte Hierarchie für die Websites zur Verfügung steht, 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 Berichts-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 Thema.
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.
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.
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. |
http://TestServer |
Eine SharePoint-Serverwebsite oder -Unterwebsite. |
http://TestServer/toplevelsite/subsite |
Der Beispielbericht Company Sales unter Gemeinsame Dokumente in einer Windows SharePoint Services-Bereitstellung. |
http://TestServer/TestSite/Shared Documents/CompanySales.rdl |
Der Beispielbericht Company Sales unter Dokumente in einer Office SharePoint Server -Instanz. |
http://TestServer/TestSite/Documents/Doc/CompanySales.rdl |
Der Beispielbericht Company Sales unter Berichtscenter in einer Office SharePoint Server -Instanz. |
http://TestServer/TestSite/Reports/Doc/CompanySales.rdl |
Veröffentlichen in einer SharePoint-Bibliothek über ein Erstellungstool
Wenn Sie Berichts-Designer, Berichts-Generator oder Modell-Designer 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.
Freigegebene Datenquellen
Wenn Sie eine freigegebene Datenquelle in einem Berichterstellungstool veröffentlichen, legen Sie die TargetDataSourceFolder-Projekteigenschaft fest. Der Zieldatenquellenordner muss eine URL zu einer SharePoint-Bibliothek darstellen. Anders als im systemeigenen 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 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 Berichts-Designer
Wenn Sie freigegebene Datenquellen in einem Berichts-Designer-Projekt veröffentlichen, können Sie eine URL verwenden, die die Zielbibliothek angibt, oder die Eigenschaft leer lassen. Anders als im systemeigenen 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 Zieldatenquellenordner leer lassen, wird die Datenquelle im Zielberichtsordner veröffentlicht.
Freigegebene Datenquellen im Modell-Designer
Wenn Sie freigegebene Datenquellen (RDS-Dateien oder SMDL-Dateien) über ein Modell-Designer-Projekt veröffentlichen, müssen Sie eine URL verwenden, die die Zielbibliothek angibt. Sie können keinen relativen Ordner angeben, relative Pfade sind ungültig. Wenn unter dem Pfad der Dokumentbibliothek kein Ordner vorhanden ist, wird einer erstellt. Das Modell (SMDL-Datei) und die freigegebene Datenquelle (RSDS-Datei) werden in diesem Ordner veröffentlicht, z. B. https://servername/site/Documents/Data Sources.
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: # % & * : < > ? / { | }.
Wenn Ihre Berichtsdefinition Verweise auf Unterberichte enthält, muss die vollqualifizierte URL für den Unterbericht angegeben werden. Sie können keinen relativen Ordner angeben, relative Pfade sind ungültig.
Festlegen von Verweisen auf abhängige Elemente
Für Berichte, die mithilfe des Berichts-Generators erstellt wurden, enthält die Berichtsdefinition Verweise auf das Berichtsmodell und die Modelldatenquelle, die zum Erstellen des Berichts verwendet wurden. Diese sind in der Berichtsdefinitionsdatei angegeben. Wenn Sie diesen Bericht einem Berichtsserverprojekt in Berichts-Designer hinzufügen, um Änderungen vorzunehmen, und ihn dann in einer SharePoint-Bibliothek veröffentlichen, müssen Sie den Bericht in der SharePoint-Bibliothek öffnen und den Datenquellenverweis erneut binden. Sie müssen die Datenquelle nur dann erneut binden, wenn Sie zuerst den Bericht veröffentlichen. Anhand der Berichtsdefinition kann vom Berichtsserver nicht bestimmt werden, ob es sich bei der Datenquelle um eine RSDS-Datei oder eine SMDL-Datei handelt. Weitere Informationen finden Sie unter Vorgehensweise: Binden eines Berichts oder Modells an eine freigegebene Datenquelle.
Veröffentlichen von Elementen aus Versionen vor SP2 auf einer SharePoint-Website
Wenn Sie Berichtsdefinitionen, Berichtsmodelle und freigegebene Datenquellen veröffentlichen möchten, die Sie in Versionen der Erstellungstools vor SP2 erstellt haben, müssen Sie ein Projekt in der Version von SP2 des Tools öffnen oder erstellen und die Dateien dann veröffentlichen.
Eine Alternative besteht darin, die Dateien direkt aus dem Dateisystem in eine SharePoint-Bibliothek hochzuladen und den Bericht anschließend erneut auszuführen, um sicherzustellen, dass er wie vorgesehen verwendet werden kann. Sie müssen Verweise auf abhängige Elemente festlegen, bevor Sie den Bericht ausführen.
Unterschiede zwischen Hochladen und Veröffentlichen
Wenn Sie Berichts-Designer, Berichts-Generator oder Modell-Designer 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.
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.
Wenn Sie einen Bericht hochladen oder veröffentlichen, ohne das Dokument vorher auszuchecken (z. B. indem Sie ein Element hochladen, das den gleichen Namen wie ein vorhandenes Element aufweist), wird das Dokument vom Berichtsserver ausgecheckt, der aktualisierte Bericht als neue Version des vorhandenen Elements hinzugefügt, und anschließend wird das Dokument erneut eingecheckt.
Externe Bilder als Ressourcen
Ein Berichtsserver, der im systemeigenen Modus ausgeführt wird, unterstützt das Konzept einer Ressource, die als eine Datei definiert ist, die auf dem Berichtsserver gespeichert und gesichert wird, die jedoch nicht vom Berichtsserver verarbeitet wird. Im systemeigenen 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. Dies gilt, wenn der Bericht einen Snapshot oder eine Kopie darstellt, der bzw. die für die interne Verwendung beibehalten wird.
Siehe auch