Share via

Odovzdanie parametra zostavy v rámci URL adresy stránkovanej zostavy služby Power BI

  • Článok

VZŤAHUJE SA NA: Power BI Zostavovač zostáv Power BI Desktop

Parametre zostavy môžete odovzdať do zostavy tak, že ich zahrnujete do URL adresy zostavy pre stránkované zostavy. Tieto parametre URL adresy nemajú predponu, pretože sa odovzdávajú priamo do modulu spracovania zostáv.

Všetky parametre dotazu môžu mať zodpovedajúce parametre zostavy. Parameter dotazu odovzdáte do zostavy odovzdaním príslušného parametra zostavy. Ďalšie informácie nájdete v téme Vytvorenie dotazu v návrhárovi relačných dotazov (Zostavovač zostáv Power BI).

Pravidlá parametrov stránkovanej zostavy

V parametroch zostavy sa rozlišujú malé a veľké písmená a používajú nasledujúce špeciálne znaky:

  • Všetky znaky medzery v reťazci URL adresy sa nahradia znakmi "%20", podľa štandardov kódovania URL adries.
  • Znak medzery v časti parametra URL adresy sa nahradí znakom plus (+).
  • Bodkočiarka v ľubovoľnej časti reťazca sa nahradí znakmi "%3A".
  • Prehliadače by mali automaticky vykonať správne kódovanie URL adresy. Žiadne znaky netreba kódovať manuálne.
  • Ak nezahrniete syntax servera proxy, predponujte parameter rp:.

Príklady parametrov stránkovanej zostavy

Ak chcete nastaviť parameter zostavy v rámci URL adresy, použite nasledujúcu syntax:

  
rp:parameter=value

Ak napríklad chcete zadať dva parametre, Salesperson (Predajca) a State (Štát), ktoré sú definované v zostave v časti Môj pracovný priestor, použijete nasledujúcu URL adresu:

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

Ak chcete zadať rovnaké dva parametre definované v zostave v aplikácii, použijete nasledujúcu URL adresu:

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

Ak chcete odovzdať hodnotu null pre parameter, použite nasledujúcu syntax:

  
parameter:isnull=true

Napríklad

rp:SalesOrderNumber:isnull=true

Ak chcete odovzdať booleovskú hodnotu, použite hodnotu 0 pre možnosť False a hodnotu 1 pre možnosť True. Ak chcete odovzdať hodnotu typu Float , zahrňte oddeľovač desatinných miest miestneho nastavenia servera.

Poznámka

Ak zostava obsahuje parameter zostavy, ktorý má predvolenú hodnotu, a hodnota vlastnosti Prompt je false (to znamená, že vlastnosť Prompt User nie je vybratá v Správcovi zostáv), potom nie je možné odovzdať hodnotu pre tento parameter zostavy v rámci URL adresy. To poskytuje správcom možnosť zabrániť koncovým používateľom pridávať hodnoty určitých parametrov zostavy alebo ich upravovať.

Ďalšie príklady

Nasledujúci príklad URL adresy obsahuje parameter s viacerými hodnotami Salesperson (Predajca). Formát parametra s viacerými hodnotami je zopakovanie názvu parametra pre každú hodnotu.

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

Nasledujúci príklad URL adresy odovzdáva jednému parametru SellStartDate hodnotu 7/1/2005.

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

Dôležité informácie a obmedzenia

  • Ak zostava obsahuje parameter zostavy, ktorý má predvolenú hodnotu, a hodnota vlastnosti Prompt je false (to znamená, že vlastnosť Prompt User nie je vybratá v službe Power BI Zostavovač zostáv), potom nie je možné odovzdať hodnotu pre tento parameter zostavy v rámci URL adresy. To poskytuje správcom možnosť zabrániť koncovým používateľom pridávať hodnoty určitých parametrov zostavy alebo ich upravovať.
  • Power BI nepodporuje reťazec dotazu s viac ako 2 000 znakmi. Tieto hodnoty môžete neúmyselne prekročiť, ak na zobrazenie stránkovanej zostavy použijete parametre URL adresy, a to najmä v prípade, že reťazec dotazu obsahuje viacero hodnôt parametrov. Ak chcete zostavu správne načítať, znížte počet znakov na menej ako 2 000.
  • Limit v reťazci dotazu sa vyhodnotí po prihlásení do služby Power BI. Ak otvoríte zostavu pred prihlásením, limit je nižší.

Súvisiaci obsah