Předání parametru sestavy v adrese URL stránkované sestavy Power BI

  • Článek

PLATÍ PRO: Power BI Tvůrce sestav Power BI Desktopu

Parametry sestavy můžete do sestavy předat jejich zahrnutím do adresy URL sestavy pro stránkované sestavy. Tyto parametry adresy URL nejsou předpony, protože se předávají přímo modulu pro zpracování sestav.

Všechny parametry dotazu můžou mít odpovídající parametry sestavy. Parametr dotazu předáte sestavě předáním odpovídajícího parametru sestavy. Další informace najdete v tématu Vytvoření dotazu v Návrháři relačních dotazů (Power BI Tvůrce sestav).

Pravidla parametrů stránkované sestavy

Parametry sestavy rozlišují malá a velká písmena a využívají následující speciální znaky:

  • Všechny znaky mezery v řetězci adresy URL se nahradí znaky %20 podle standardů kódování adresy URL.
  • Znak mezery v části parametru adresy URL se nahradí znakem plus (+).
  • Středník v jakékoli části řetězce se nahradí znaky %3A.
  • Prohlížeče by měly automaticky provádět správné kódování adresy URL. Nemusíte kódovat žádné znaky ručně.
  • Pokud syntaxi proxy serveru nezadáte, zadejte předponu parametru rp :.

Příklady parametrů stránkované sestavy

Pokud chcete nastavit parametr sestavy v adrese URL, použijte následující syntaxi:

  
rp:parameter=value

Pokud například chcete zadat dva parametry , Prodejce a State (Stát) definované v sestavě v pracovním prostoru, použijte následující adresu URL:

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

Pokud chcete zadat stejné dva parametry definované v sestavě v aplikaci, použijte následující adresu 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

Pokud chcete předat hodnotu null parametru, použijte následující syntaxi:

  
parameter:isnull=true

Příklad:

rp:SalesOrderNumber:isnull=true

Pokud chcete předat logickou hodnotu, použijte hodnotu 0 pro false a 1 pro true. Pokud chcete předat hodnotu Float , zadejte oddělovač desetinných míst národního prostředí serveru.

Poznámka:

Pokud sestava obsahuje parametr sestavy, který má výchozí hodnotu a hodnota vlastnosti Prompt je false (to znamená, že vlastnost Prompt User není vybrána ve Správci sestav), nelze předat hodnotu pro tento parametr sestavy v adrese URL. To správcům umožňuje zabránit koncovým uživatelům v přidávání nebo úpravách hodnot určitých parametrů sestavy.

Další příklady

Následující příklad adresy URL obsahuje parametr "Salesperson" s více hodnotami. Formát parametru s více hodnotami je opakování názvu parametru pro každou hodnotu.

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

Následující příklad adresy URL předá jeden parametr SellStartDate s hodnotou 7/1/2005.

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

Úvahy a omezení

  • Pokud sestava obsahuje parametr sestavy, který má výchozí hodnotu a hodnota vlastnosti Prompt je false (to znamená, že v Power BI Tvůrce sestav není vybraná vlastnost Prompt User), nemůžete předat hodnotu parametru sestavy v adrese URL. To správcům umožňuje zabránit koncovým uživatelům v přidávání nebo úpravách hodnot určitých parametrů sestavy.
  • Power BI nepodporuje řetězec dotazu s více než 2 000 znaky. Tuto hodnotu můžete neúmyslně překročit, pokud k zobrazení stránkované sestavy použijete parametry adresy URL, zejména pokud řetězec dotazu obsahuje více hodnot parametrů. Pokud chcete sestavu správně načíst, snižte počet znaků na méně než 2 000.
  • Limit v řetězci dotazu se vyhodnotí po přihlášení k Power BI. Pokud sestavu otevřete před přihlášením, omezení se sníží.

Související obsah