Freigeben über

Übergeben eines Berichtsparameters innerhalb einer URL

Sie können Berichtsparameter an einen Bericht übergeben, indem Sie sie in eine Berichts-URL einschließen. Diese URL-Parameter werden nicht vorangestellt, da sie direkt an das Berichtsverarbeitungsmodul übergeben werden.

Von Bedeutung

Es ist wichtig, dass die URL die _vti_bin -Proxysyntax zur Weiterleitung der Anforderung über SharePoint sowie den Reporting Services -HTTP-Proxy enthält. 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.

Wenn Sie die Proxysyntax nicht einschließen, müssen Sie dem Parameter das Präfix "rp:" voranstellen.

Alle Abfrageparameter können über entsprechende Berichtsparameter verfügen. Sie übergeben einen Abfrageparameter an einen Bericht, indem Sie den entsprechenden Berichtsparameter übergeben. Weitere Informationen finden Sie unter Erstellen einer Abfrage im relationalen Abfrage-Designer (Berichts-Generator und SSRS).For more information, see Build a Query in the Relational Query Designer (Report Builder and SSRS).

Von Bedeutung

Bei den Berichtsparametern wird die Groß-/Kleinschreibung beachtet.

Hinweis

Berichtsparameter sind groß- und kleinschreibungssensitiv und verwenden die folgenden Sonderzeichen:

  • Alle Leerzeichen in der URL-Zeichenfolge werden gemäß den URL-Codierungsstandards durch die Zeichen "%20" ersetzt.
  • Ein Leerzeichen im Parameterbereich der URL wird durch ein Pluszeichen (+) ersetzt.
  • Ein Semikolon in einem beliebigen Teil der Zeichenfolge wird durch die Zeichen "%3A" ersetzt."
  • Browser sollten automatisch die richtige URL-Codierung ausführen. Sie müssen keines der Zeichen manuell codieren.

Verwenden Sie die folgende Syntax, um einen Berichtsparameter in einer URL festzulegen:

  
parameter=value

Verwenden Sie beispielsweise die folgende URL für einen Berichtsserver im nativen Modus, um zwei Parameter anzugeben: "ReportMonth" und "ReportYear", die in einem Bericht definiert sind.

http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&ReportMonth=3&ReportYear=2008

Wenn Sie beispielsweise dieselben beiden in einem Bericht definierten Parameter angeben möchten, verwenden Sie die folgende URL für einen SharePoint-Berichtsserver im integrierten Modus. Beachten Sie Folgendes /_vti_bin:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl&ReportMonth=3&ReportYear=2008

Verwenden Sie die folgende Syntax, um einen Nullwert für einen Parameter zu übergeben:

  
parameter  
:isnull=true

Beispiel:

SalesOrderNumber:isnull=true

Um einen Boolean Wert zu übergeben, verwenden Sie "0" für "false" und "1" für "true". Um einen Float Wert zu übergeben, schließen Sie das Dezimaltrennzeichen des Servergebietsschemas ein

Hinweis

Wenn Ihr Bericht einen Berichtsparameter enthält, der einen Standardwert aufweist und der Wert der Prompt Eigenschaft lautet false (d. h. die Eingabeaufforderungsbenutzereigenschaft ist im Berichts-Manager nicht ausgewählt), können Sie keinen Wert für diesen Berichtsparameter innerhalb einer URL übergeben. Dadurch können Administratoren verhindern, dass Endbenutzer die Werte bestimmter Berichtsparameter hinzufügen oder ändern können.

Weitere Beispiele

Das folgende URL-Beispiel enthält Leerzeichen und mehrere Parameter.

  • Der Ordnername "SQL Server User Education Team" enthält Leerzeichen und ersetzt daher jedes Leerzeichen.

  • Der Berichtsname "team project report" enthält Leerzeichen, und daher wird jedes Leerzeichen durch ein "+" ersetzt.

  • Übergibt zwei Parameter von "teamgrouping2" mit dem Wert "xgroup" und "teamgrouping1" mit dem Wert "ygroup".

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup

Das folgende URL-Beispiel enthält einen Mehrwertparameter "OrderID". Das Format für einen Mehrfachwertparameter besteht darin, den Parameternamen für jeden Wert zu wiederholen.

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup&OrderID=747&OrderID=787&OrderID=12

Im folgenden URL-Beispiel wird ein einzelner Parameter von SellStartDate mit dem Wert "7/1/2005" für einen Berichtsserver im nativen Modus übergeben.

http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005

Siehe auch

URL-Zugriff (SSRS)
URL-Zugriffsparameterreferenz

  • Last updated on