Parametry adresu URL w raportach podzielonych na strony w usłudze Power BI

  • Artykuł

DOTYCZY: Power BI Report Builder Power BI Desktop

Polecenia można wysyłać do raportów podzielonych na strony w usłudze Power BI, dodając parametr do adresu URL. Na przykład raport mógł zostać wyświetlony przy użyciu określonego zestawu wartości parametrów raportu. Te informacje należy hermetyzować w adresie URL przy użyciu wstępnie zdefiniowanych parametrów dostępu do adresu URL. Dodatkowo dostosujesz sposób przetwarzania raportu przez osadzanie parametrów dla formatów renderowania lub wygląd i działanie paska narzędzi raportu. Następnie wklejasz ten adres URL bezpośrednio do wiadomości e-mail lub strony internetowej, aby inne osoby doświadczyły raportu w taki sam sposób w przeglądarce.

Poniżej przedstawiono akcje, które można wykonać za pomocą parametrów dostępu do adresu URL:

  • Wysyłanie parametrów raportu do raportu.
  • Zainicjuj eksport zawartości raportu w obsługiwanym formacie pliku.
  • Ukryj lub wyświetl okienko parametrów.
  • Określ ustawienie DeviceInfo .

Aby uzyskać pełną listę poleceń i ustawień dostępnych za pośrednictwem dostępu do adresu URL, zobacz Dokumentacja parametrów dostępu do adresu URL w tym artykule.

Pojęcia dotyczące dostępu do adresów URL

Żądania adresów URL do usługi Power BI zawierają parametry przetwarzane przez usługę. Sposób, w jaki usługa obsługuje żądania adresów URL, zależy od parametrów, prefiksów parametrów i typów elementów uwzględnionych w adresie URL. Funkcjonalność adresu URL raportu podzielonego na strony jest zgodna z większością przeglądarek i aplikacji, które obsługują standardowe adresowanie URL.

Składnia dostępu do adresu URL

Żądania adresów URL mogą zawierać wiele parametrów wymienionych w dowolnej kolejności. Parametry są rozdzielane znakami i (&). Pary nazw i wartości są oddzielone znakiem równości (=). Na przykład:

powerbiservicereporturl?rp:parameter=value&rdl:parameter=value

Opis składni

powerbiservicereporturl

Adres URL usługa Power BI raportu podzielonego na strony. Na przykład:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0

?

Służy do oddzielania parametrów dostępu powerbiservicereporturl i adresu URL.

&

Służy do oddzielania par nazw i wartości parametrów dostępu do adresu URL.

Prefiks

Prefiks parametru adresu URL określający akcję w usługa Power BI. Na przykład: rp: lub rdl:.

parametr

Nazwa parametru.

wartość

Tekst adresu URL odpowiadający wartości używanego parametru.

Dokumentacja parametrów raportu adresu URL

Parametry raportu można przekazać do raportu, dołączając je do adresu URL raportu podzielonego na strony.

Parametry raportu (rp:)

Przykłady przekazywania parametrów raportu w adresie URL można znaleźć w temacie Przekazywanie parametru raportu w adresie URL.

Uwaga

Parametry raportu wymagają prefiksu rp: parametru i są uwzględniane wielkość liter.

Dokumentacja parametrów dostępu do adresu URL

Poniższe parametry można użyć jako części adresu URL, aby skonfigurować wygląd i działanie raportów podzielonych na strony w usłudze Power BI. Najbardziej typowe parametry są wymienione w tej sekcji. Parametry są bez uwzględniania wielkości liter i zaczynają się od prefiksu rdl: parametru, jeśli są powiązane z formatem danych wyjściowych.

Polecenia raportu (rdl:)

Format eksportu

Określa format renderowania i eksportowania raportu.

  • Na przykład: rdl:format=PDF.

Dostępne wartości:

  • PPTX (PowerPoint)
  • MHTML
  • OBRAZ
  • EXCELOPENXML (EXCEL)
  • WORDOPENXML (WORD)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • Kod XML

Widok raportu

Określa typ użycia widoku do wyświetlania raportu.

  • rdl:reportView

Dostępne wartości:

  • interactive (ustawienie domyślne): ładuje raport w trybie interaktywnym.
  • pageView: ładuje raport w trybie widoku strony.

Panel parametrów

Określa, czy panel parametrów jest zamknięty, czy otwarty podczas ładowania raportu, czy jest całkowicie ukryty.

  • rdl:parameterPanel

Dostępne wartości:

  • zwinięty: ładuje raport z zamkniętym panelem parametrów. Przycisk parametru jest włączony, aby użytkownicy mogli wybrać przycisk, aby rozwinąć.
  • hidden: ładuje raport z zamkniętym panelem parametrów i wyłączonym przyciskiem parametru.
  • expanded (ustawienie domyślne): ładuje raport z otwartym panelem parametrów i włączonym przyciskiem parametru.

Informacje o urządzeniu

Możesz określić dodatkowe parametry wyjściowe dla następujących formatów eksportu.

  • PDF/ ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:HumanReadablePDF=true/false
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer

  • CSV:

    Uwaga

    W przypadku tych wartości ciągu zapoznaj się z ustawieniami informacji o urządzeniu CSV.

    • rdl:Encoding=string
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false

  • WORDOPENXML (WORD):

    • rdl:AutoFit=string —> true/False/Never/Default
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false

  • EXCELOPENXML (EXCEL):

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=true/false
    • rdl:SimplePageHeaders=true/false

  • PPTX (PowerPoint):

    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer
    • rdl:UseReportPageSize=true/false

  • XML:

    • rdl:Encoding=string
    • rdl:Indented=true/false
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

Możesz dołączyć rdl:targetSameWindow=true do adresu URL hiperłącza w raporcie, aby usługa Power BI otworzyła to hiperłącze w tym samym oknie przeglądarki. Aby uzyskać informacje na temat dodawania hiperlinków do raportu, zobacz Dodawanie hiperlinku do adresu URL.

Powiązana zawartość