Übergeben eines Berichtsparameters in einer URL für einen paginierten Power BI-Bericht

  • Artikel

GILT FÜR:️ Power BI Report Builder ️Power BI Desktop

Sie können Berichtsparameter an einen Bericht übergeben, indem Sie diese in die Berichts-URL für paginierte Berichte einschließen. Diesen URL-Parametern wird nichts vorangestellt, da sie direkt an die Berichtsverarbeitungs-Engine übergeben werden.

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 (Power BI Report Builder).

Regeln für Parameter für paginierter Berichte

Bei Berichtsparametern wird zwischen Groß-/Kleinschreibung unterschieden, und es werden folgende Sonderzeichen verwendet:

  • Alle Leerzeichen in der URL-Zeichenfolge werden entsprechend den URL-Codierungsstandards durch die Zeichen "%20" ersetzt.
  • Ein Leerzeichen im Parameterteil der URL wird durch ein Pluszeichen (+) ersetzt.
  • Ein Semikolon in einem beliebigen Teil der Zeichenfolge wird durch die Zeichen "%3A" ersetzt.
  • Die Browser sollten die richtige URL-Codierung automatisch ausführen. Sie müssen keines der Zeichen manuell codieren.
  • Wenn Sie keine Proxysyntax einschließen, stellen Sie dem Parameter rp: voran.

Beispiele für Parameter für paginierte Berichte

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

  
rp:parameter=value

Wenn Sie z. B. die beiden Parameter „Salesperson“ und „State“ angeben möchten, die Sie in einem Bericht unter „Mein Arbeitsbereich“ definiert haben, verwenden Sie folgende URL:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah

Wenn Sie dieselben zwei Parameter angeben möchten, die Sie in einem Bericht in einer App definiert haben, verwenden Sie die folgende URL:

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

Verwenden Sie die folgende Syntax, um einen NULL-Wert für einen Parameter zu übergeben:

  
parameter:isnull=true

Beispiel:

rp:SalesOrderNumber:isnull=true

Um einen Boolean -Wert zu übergeben, verwenden Sie 0 für "false" und 1 für "true". Schließen Sie zum Übergeben eines Gleitkommawerts das Dezimaltrennzeichen des Servergebietsschemas ein.

Hinweis

Wenn Ihr Bericht einen Berichtsparameter enthält, der einen Standardwert besitzt, und der Wert der Prompt -Eigenschaft FALSE ist (dies bedeutet, dass die PromptUser-Eigenschaft im Berichts-Manager nicht ausgewählt ist), können Sie keinen Wert für diesen Berichtsparameter innerhalb einer URL übergeben. Dies ermöglicht Administratoren, Benutzer daran zu hindern, die Werte bestimmter Berichtsparameter hinzuzufügen oder zu ändern.

Weitere Beispiele

Das folgende URL-Beispiel enthält einen mehrwertigen Parameter „Salesperson“. Das Format für einen mehrwertigen Parameter sieht vor, den Parameternamen für jeden Wert zu wiederholen.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

Im folgenden URL-Beispiel wird ein einzelner Parameter von SellStartDate mit dem Wert „7/1/2005“ übergeben.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

Überlegungen und Einschränkungen

  • Wenn Ihr Bericht einen Berichtsparameter enthält, der über einen Standardwert verfügt, und der Wert der Prompt-Eigenschaft FALSE ist (d. h., die Prompt User-Eigenschaft ist in Power BI Report Builder nicht ausgewählt), können Sie für diesen Berichtsparameter keinen Wert innerhalb einer URL übergeben. Dadurch können Administratoren verhindern, dass Endbenutzer die Werte bestimmter Berichtsparameter hinzufügen oder ändern.
  • Power BI unterstützt keine Abfragezeichenfolge mit mehr als 2.000 Zeichen. Es kann vorkommen, dass Sie diesen Wert versehentlich überschreiten, wenn Sie URL-Parameter verwenden, um Ihren paginierten Bericht anzuzeigen, insbesondere, wenn die Abfragezeichenfolge mehrere Parameterwerte enthält. Verringern Sie die Anzahl der Zeichen auf unter 2.000, um den Bericht ordnungsgemäß zu laden.
  • Der Grenzwert in der Abfragezeichenfolge wird ausgewertet, nachdem Sie sich bei Power BI angemeldet haben. Wenn Sie den Bericht vor der Anmeldung öffnen, wird der Grenzwert reduziert.

Zugehöriger Inhalt