URL-Zugriff (SSRS)URL Access (SSRS)

Durch den URL-Zugriff des Berichtsservers in SQL Server Reporting Services (SSRS) können Sie Befehle an den Berichtsserver über eine URL-Anforderung senden.URL access of the report server in SQL Server Reporting Services (SSRS) enables you to send commands to a report server through a URL request. Beispielsweise können Sie das Rendering eines Berichts auf einem Berichtsserver im einheitlichen Modus oder in einer SharePoint-Bibliothek anpassen.For example, you can customize the rendering of a report on a native mode report server or in a SharePoint library. Möglicherweise haben Sie den Bericht unter Verwendung bestimmter Berichtsparameterwerte angezeigt oder eine bestimmte Berichtsseite gelesen, die für Sie von Interesse war.You may have viewed the report using a specific set of report parameter values, or you may have been viewing a particular page of interest in the report. Diese Informationen können mithilfe vordefinierter URL-Zugriffsparameter in der URL gekapselt werden.You can encapsulate this information in the URL using predefined URL access parameters. Außerdem kann die Berichtsverarbeitung auf dem Berichtsserver weiter angepasst werden, indem Sie Parameter für Renderingformate oder für das Erscheinungsbild des Berichts-Viewers einbetten.You can further customize how the report server processes the report by embedding parameters for rendering formats or for the look and feel of the report viewer. Anschließend können Sie diese URL direkt in eine E-Mail oder Webseite einfügen, damit andere Benutzer im Browser auf die gleiche Weise auf den Bericht zugreifen können.You can then paste this URL directly into an email or Web page to let others to access your report in the same manner in the browser.

Weitere Aktionen, die über den URL-Zugriff ausgeführt werden können:Other actions you can perform through URL access are:

  • Senden von Befehlen an den HTML-Viewer, z. B. zum Anpassen des ErscheinungsbildsSend commands to the HTML viewer, such as adjusting its look and feel

  • Auflisten der untergeordneten Elemente eines KatalogordnersList the children of a catalog folder

  • Abrufen der XML-Definition eines KatalogelementsRetrieve the XML definition of a catalog item

  • Rendern einer bestimmten Berichtsverlaufs-MomentaufnahmeRender a specific report history snapshot

  • Verwalten von BerichtssitzungenManage report sessions

    Eine vollständige Liste der über URL-Zugriff verfügbaren Befehle und Einstellungen finden Sie unter URL-Zugriffsparameterreferenz.For the complete list of commands and settings available through URL access, see URL Access Parameter Reference.

Konzepte für den URL-ZugriffURL Access Concepts

URL-Anforderungen an den Berichtsserver enthalten Parameter, die vom Berichtsserver verarbeitet werden.URL requests to the report server contain parameters that are processed by the report server. Wie URL-Anforderungen vom Berichtsserver behandelt werden, hängt von den Parametern, den Parameterpräfixen sowie den Elementtypen ab, die in der URL enthalten sind.The way in which the report server handles URL requests depends on the parameters, parameter prefixes, and types of items that are included in the URL. Berichtsserver-URLs erfüllen die URL-Formatierungsrichtlinien, wie sie vom gemeinsamen Entwurfsstandard des World Wide Web Consortium W3C/IETF vorgeschlagen wurden.Report server URLs adhere to the URL formatting guidelines as proposed by the joint World Wide Web Consortium W3C/IETF draft standard. Reporting ServicesReporting Services -URL-Funktionen sind kompatibel mit den meisten Internetbrowsern oder -anwendungen, die Standard-URL-Adressen unterstützen. URL functionality is compatible with most Internet browsers or applications that support standard URL addressing.

URL-ZugriffssyntaxURL Access Syntax

URL-Anforderungen können mehrere Parameter enthalten, die in beliebiger Reihenfolge aufgelistet werden.URL requests can contain multiple parameters that are listed in any order. Parameter werden durch das kaufmännische Und-Zeichen (&) getrennt, Name/Wert-Paare werden durch das Gleichheitszeichen (=) getrennt.Parameters are separated by an ampersand (&) and name/value pairs are separated by an equal sign (=).


rswebserviceurl  
?  
reportpath  
      [&prefix:param=value]...n]  

SyntaxbeschreibungSyntax Description

rswebserviceurlrswebserviceurl
Die Webdienst-URL des Berichtsservers.The Web service URL of the report server. Im einheitlichen Modus ist dies die Webdienst-URL der im Konfigurations-Manager für Reporting Services konfigurierten Berichtsserverinstanz. Weitere Informationen finden Sie unter Konfigurieren von Berichtsserver-URLs (SSRS-Konfigurations-Manager).For native mode, it is the Web service URL of the report server instance configured in Reporting Services Configuration Manager (see Configure Report Server URLs (SSRS Configuration Manager)). Beispiel:For example:

http://myrshost/reportserver  
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE  

Im integrierten SharePoint-Modus entspricht sie der URL des Reporting ServicesReporting Services -Proxys auf einer in Reporting ServicesReporting Servicesintegrierten SharePoint-Website.For SharePoint integrated mode, it is the URL of the Reporting ServicesReporting Services proxy at a SharePoint site integrated with Reporting ServicesReporting Services. Beispiel:For example:

http://myspsite/subsite/_vti_bin/reportserver  
Tipp

Es ist wichtig, dass die URL die _vti_bin -Proxysyntax zur Weiterleitung der Anforderung über SharePoint sowie den Reporting ServicesReporting Services -HTTP-Proxy enthält.It is important the URL include the _vti_bin proxy syntax to route the request through SharePoint and the Reporting ServicesReporting Services HTTP proxy. Durch den Proxy wird der HTTP-Anforderung Kontext hinzugefügt. Dieser ist erforderlich, damit der Bericht auf Berichtsservern im SharePoint-Modus ordnungsgemäß ausgeführt wird.The proxy adds some context to the HTTP request, context that is required to ensure proper execution of the report for SharePoint mode report servers.

pathinfopathinfo
Der relative Pfadname des Elements in der Berichtsserver-Datenbank im einheitlichen Modus oder die vollqualifizierte URL des Elements in einem SharePoint-Katalog.The relative path name of the item in the native mode report server database, or the fully qualified URL of the item in a SharePoint catalog.

Der Pfad des Katalogelements.The path of the catalog item. Im einheitlichen Modus ist dies der relative Pfad des Elements in der Berichtsserver-Datenbank, der mit einem Schrägstrich (/) beginnt.For native mode, it is the relative path of the item in the report server database, beginning with a slash (/). Beispiel:For example:

/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2  

Im integrierten SharePoint-Modus ist dies die vollqualifizierte URL des Elements in der SharePoint-Bibliothek, einschließlich der Elementerweiterung.For SharePoint integrated mode, it is the fully qualified URL of the item in the SharePoint library, including the item extension. Beispiel:For example:

http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl  

&
Wird verwendet, um Namen- und Wertpaare von URL-Zugriffsparametern zu trennen.Used to separate name and value pairs of URL access parameters.

Präfixprefix
Optional.Optional. Ein Präfix für den URL-Zugriffsparameter (z.B. rs: oder rc:), durch das auf einen bestimmten im Berichtsserver ausgeführten Prozess zugegriffen wird.A prefix for the URL access parameter (for example, rs: or rc:) that accesses a specific process running within the report server.

Hinweis

Wenn das Präfix für einen URL-Zugriffsparameter nicht enthalten ist, wird der Parameter vom Berichtsserver als Berichtsparameter verarbeitet.If a prefix for a URL access parameter is not included, the parameter is processed by the report server as a report parameter. Bei Berichtsparametern wird kein Parameterpräfix verwendet und nach Groß-/Kleinschreibung unterschieden.Report parameters do not use a parameter prefix and are case-sensitive.

paramparam
Der Name des Parameters.The parameter name.

valuevalue
URL-Text, der dem Wert des Parameters entspricht, der verwendet wird.URL text corresponding to the value of the parameter being used.

Hinweis: Eine Liste der verfügbaren URL-Zugriffsparameter finden Sie unter URL Access Parameter Reference.Note: For a list of the available URL access parameters, see URL Access Parameter Reference. Beispiele für die Übergabe von Berichtsparametern mit der URL finden Sie unter Pass a Report Parameter Within a URL.For examples passing report parameters on the URL, see Pass a Report Parameter Within a URL.

Verwandte AufgabenRelated Tasks

TaskbeschreibungenTask Descriptions LinksLinks
Zugreifen auf Berichtserverelemente, z. B. Berichte, freigegebene Datenquellen und RessourcenAccess report server items, such as reports, shared data sources, and resources. Zugreifen auf Berichtsserverelemente über den URL-ZugriffAccess Report Server Items Using URL Access
Übergeben von Berichtsparametern an einen BerichtPass report parameters to a report. Pass a Report Parameter Within a URLPass a Report Parameter Within a URL
Festlegen des Gebietsschemas der Berichtsparameter in der URL-Zugriffszeichenfolge, durch die die gebietsschemaspezifische Interpretation von Datumsangaben, Währungen usw. festgelegt wirdSet the locale of the report parameters in the URL access string, which defines the locale-specific interpretations of dates, currencies, and so on. Festlegen der Sprache für Berichtsparameter in einer URLSet the Language for Report Parameters in a URL
Senden spezifischer Einstellungen für Renderingerweiterungen, durch die das Rendern des Berichts angepasst wirdSend rendering extension specific settings that customize how the report is rendered. Angeben von Geräteinformationseinstellungen in einer URLSpecify Device Information Settings in a URL
Direktes Exportieren eines Berichts in ein Dateiformat, ohne ihn im Browser anzuzeigenExport a report directly to a file format without viewing it in the browser. Exportieren von Berichten über URL-ZugriffExport a Report Using URL Access
Öffnen eines Berichts und direktes Navigieren zur Position einer ZeichenfolgeOpen a report and navigate directly to the location of a string. Suchen eines Berichts mithilfe von URL-ZugriffSearch a Report Using URL Access
Rendern einer bestimmten Berichtsverlaufs-MomentaufnahmeRender a specific report history snapshot. Rendern von Berichtsverlaufs-Momentaufnahmen mit URL-ZugriffRender a Report History Snapshot Using URL Access

Siehe auchSee Also

Pass a Report Parameter Within a URL Pass a Report Parameter Within a URL
URL-Zugriffsparameterreferenz URL Access Parameter Reference
Integrieren von Reporting Services mit URL-Zugriff Integrating Reporting Services Using URL Access
Suchen, Anzeigen und Verwalten von Berichten (Berichts-Generator und SSRS) Finding, Viewing, and Managing Reports (Report Builder and SSRS )