Share via

Jelentésparaméter átadása egy többoldalas Power BI-jelentés URL-címében

  • Cikk

A következőkre vonatkozik: Power BI Jelentéskészítő Power BI Desktop

A jelentésparamétereket úgy adhatja át egy jelentésnek, hogy a lapszámozott jelentésekhez tartozó jelentés URL-címében szerepel. Ezek az URL-paraméterek nincsenek előtagban, mert közvetlenül a jelentésfeldolgozó motornak adhatók át.

Minden lekérdezési paraméter rendelkezhet megfelelő jelentésparaméterekkel. A lekérdezési paramétert a megfelelő jelentésparaméter átadásával adhatja át egy jelentésnek. További információ: Lekérdezés létrehozása a relációs lekérdezési Tervező (Power BI Jelentéskészítő).

Többoldalas jelentésparaméter-szabályok

A jelentésparaméterek megkülönböztetik a kis- és nagybetűket, és a következő speciális karaktereket használják:

  • Az URL-sztringben lévő szóköz karakterek helyébe a következő karakterek lépnek: "%20" az URL-kódolási szabványoknak megfelelően.
  • Az URL paraméterrészében lévő szóköz karaktert plusz karakterre (+) cseréli a rendszer.
  • A sztring bármely részének pontosvesszője helyébe a következő karakterek lépnek: "%3A".
  • A böngészőknek automatikusan végre kell hajtaniuk a megfelelő URL-kódolást. A karaktereket nem kell manuálisan kódolnia.
  • Ha nem tartalmazza a proxyszintaxist, akkor a paraméter előtagja az rp:.

Többoldalas jelentésparaméterek – példák

Ha egy jelentésparamétert egy URL-címen belül szeretne beállítani, használja a következő szintaxist:

  
rp:parameter=value

Ha például a Saját munkaterületen egy jelentésben definiált "Értékesítő" és "State" paramétert szeretne megadni, a következő URL-címet kell használnia:

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

Ha ugyanazt a két paramétert szeretné megadni egy jelentésben egy alkalmazásban, a következő URL-címet kell használnia:

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

Egy paraméter null értékének átadásához használja az alábbi szintaxist:

  
parameter:isnull=true

Például:

rp:SalesOrderNumber:isnull=true

Logikai érték átadásához használja a 0 értéket a hamis és az 1 értéket igaz értékre. Lebegőpontos érték átadásához adja meg a kiszolgáló területi beállításának tizedesjelét.

Feljegyzés

Ha a jelentés olyan jelentésparamétert tartalmaz, amely alapértelmezett értékkel rendelkezik, és a Prompt tulajdonság értéke hamis (vagyis a Prompt User tulajdonság nincs kiválasztva a Jelentéskezelőben), akkor nem adhat át értéket a jelentésparaméternek egy URL-címen belül. Ez lehetővé teszi a rendszergazdák számára, hogy megakadályozzák, hogy a végfelhasználók hozzáadják vagy módosítsák bizonyos jelentésparaméterek értékeit.

További példák

Az alábbi URL-példa egy többértékű "Salesperson" paramétert tartalmaz. A többértékű paraméterek formátuma az egyes értékek paraméternevének megismétlése.

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

Az alábbi URL-példa a SellStartDate egyetlen paraméterét adja át "2005.07.01." értékkel.

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

Szempontok és korlátozások

  • Ha a jelentés egy alapértelmezett értékkel rendelkező jelentésparamétert tartalmaz, és a Prompt tulajdonság értéke hamis (vagyis a Prompt User tulajdonság nincs kiválasztva a Power BI Jelentéskészítő), akkor nem adhat meg értéket a jelentésparaméternek egy URL-címen belül. Ez lehetővé teszi a rendszergazdák számára, hogy megakadályozzák, hogy a végfelhasználók hozzáadják vagy módosítsák bizonyos jelentésparaméterek értékeit.
  • A Power BI nem támogatja a 2000 karakternél hosszabb lekérdezési sztringet. Véletlenül túllépheti ezt az értéket, ha URL-paraméterekkel tekinti meg a lapszámozott jelentést, különösen akkor, ha a lekérdezési sztring több paraméterértéket tartalmaz. A jelentés megfelelő betöltéséhez csökkentse a karakterek számát 2000 alá.
  • A lekérdezési sztring korlátja a Power BI-ba való bejelentkezés után lesz kiértékelve. Ha a bejelentkezés előtt megnyitja a jelentést, a korlát csökken.

Kapcsolódó tartalom