Udostępnij za pośrednictwem

Przekazywanie parametru raportu w adresie URL raportu podzielonego na strony w usłudze Power BI

  • Artykuł

DOTYCZY: Power BI Report Builder Power BI Desktop

Parametry raportu można przekazać do raportu, dołączając je do adresu URL raportu dla raportów podzielonych na strony. Te parametry adresu URL nie są poprzedzone prefiksem, ponieważ są przekazywane bezpośrednio do aparatu przetwarzania raportów.

Wszystkie parametry zapytania mogą mieć odpowiednie parametry raportu. Parametr zapytania przekazuje się do raportu, przekazując odpowiedni parametr raportu. Aby uzyskać więcej informacji, zobacz Tworzenie zapytania w projektancie zapytań relacyjnych (Power BI Report Builder).

Reguły parametrów raportu podzielonego na strony

Parametry raportu są uwzględniane w wielkości liter i używają następujących znaków specjalnych:

  • Wszystkie znaki spacji w ciągu adresu URL są zastępowane znakami "%20", zgodnie ze standardami kodowania adresów URL.
  • Znak spacji w części parametru adresu URL jest zastępowany znakiem plus (+).
  • Średnik w dowolnej części ciągu jest zastępowany znakami "%3A".
  • Przeglądarki powinny automatycznie wykonywać odpowiednie kodowanie adresów URL. Nie trzeba kodować żadnych znaków ręcznie.
  • Jeśli nie dołączysz składni serwera proxy, prefiks parametru z rp:.

Przykłady parametrów raportu podzielonego na strony

Aby ustawić parametr raportu w adresie URL, użyj następującej składni:

  
rp:parameter=value

Aby na przykład określić dwa parametry: "Sprzedawca" i "State" zdefiniowane w raporcie w obszarze Mój obszar roboczy, należy użyć następującego adresu URL:

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

Aby określić te same dwa parametry zdefiniowane w raporcie w aplikacji, należy użyć następującego 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

Aby przekazać wartość null dla parametru, użyj następującej składni:

  
parameter:isnull=true

Na przykład:

rp:SalesOrderNumber:isnull=true

Aby przekazać wartość logiczną, użyj wartości 0 dla wartości false i 1 dla wartości true. Aby przekazać wartość zmiennoprzecinkową , uwzględnij separator dziesiętny ustawień regionalnych serwera.

Uwaga

Jeśli raport zawiera parametr raportu, który ma wartość domyślną, a wartość właściwości Prompt ma wartość false (oznacza to, że właściwość Monituj użytkownika nie jest zaznaczona w Menedżerze raportów), nie można przekazać wartości dla tego parametru raportu w adresie URL. Dzięki temu administratorzy mogą uniemożliwić użytkownikom końcowym dodawanie lub modyfikowanie wartości określonych parametrów raportu.

Dodatkowe przykłady

Poniższy przykład adresu URL zawiera parametr o wielu wartościach "Salesperson". Format parametru wielowartego jest powtórzenie nazwy parametru dla każdej wartości.

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

Poniższy przykład adresu URL przekazuje pojedynczy parametr SellStartDate z wartością "7/1/2005".

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

Rozważania i ograniczenia

  • Jeśli raport zawiera parametr raportu, który ma wartość domyślną, a wartość właściwości Prompt ma wartość false (oznacza to, że właściwość Monituj użytkownika nie jest zaznaczona w programie Power BI Report Builder), nie można przekazać wartości dla tego parametru raportu w adresie URL. Zapewnia to administratorom możliwość uniemożliwienia użytkownikom końcowym dodawania lub modyfikowania wartości określonych parametrów raportu.
  • Usługa Power BI nie obsługuje ciągu zapytania przekraczającego 2000 znaków. Możesz przypadkowo przekroczyć tę wartość, jeśli używasz parametrów adresu URL do wyświetlania raportu podzielonego na strony, zwłaszcza jeśli ciąg zapytania zawiera wiele wartości parametrów. Aby prawidłowo załadować raport, zmniejsz liczbę znaków do poniżej 2000.
  • Limit w ciągu zapytania jest obliczany po zalogowaniu się do usługi Power BI. Jeśli otworzysz raport przed zalogowaniem, limit zostanie zmniejszony.

Powiązana zawartość