Share via

URL-parameters in gepagineerde rapporten in Power BI

  • Artikel

VAN TOEPASSING OP: Power BI Report Builder Power BI Desktop

U kunt opdrachten verzenden naar gepagineerde rapporten in Power BI door een parameter toe te voegen aan een URL. U hebt het rapport bijvoorbeeld bekeken met behulp van een specifieke set rapportparameterwaarden. U kunt deze informatie in de URL inkapselen met behulp van vooraf gedefinieerde URL-toegangsparameters. U kunt verder aanpassen hoe Power BI het rapport verwerkt door parameters voor renderingindelingen in te sluiten of door het uiterlijk van de rapportwerkbalk in te sluiten. Vervolgens plakt u deze URL rechtstreeks in een e-mail of webpagina, zodat anderen uw rapport op dezelfde manier in de browser ervaren.

Dit zijn acties die u kunt uitvoeren via URL-toegangsparameters:

  • Rapportparameters verzenden naar een rapport.
  • Start de export van de rapportinhoud in een ondersteunde bestandsindeling.
  • Het deelvenster Parameters verbergen of weergeven.
  • Geef de instelling DeviceInfo op.

Voor de volledige lijst met opdrachten en instellingen die beschikbaar zijn via URL-toegang, raadpleegt u de naslaginformatie over url-toegangsparameters in dit artikel.

Concepten voor URL-toegang

URL-aanvragen voor Power BI bevatten parameters die door de service worden verwerkt. De manier waarop de service URL-aanvragen verwerkt, is afhankelijk van de parameters, parametervoorvoegsels en typen items die zijn opgenomen in de URL. De functionaliteit voor gepagineerde rapport-URL's is compatibel met de meeste browsers en toepassingen die ondersteuning bieden voor standaard-URL-adressering.

Url-toegangssyntaxis

URL-aanvragen kunnen meerdere parameters bevatten, die in elke volgorde worden vermeld. Parameters worden gescheiden door een en-teken (&). Naam- en waardeparen worden gescheiden door een gelijkteken (=). Voorbeeld:

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

Syntaxisbeschrijving

powerbiservicereporturl

De Power BI-service-URL van uw gepagineerde rapport. Voorbeeld:

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

?

Wordt gebruikt om de powerbiservicereporturl en de URL-toegangsparameters te scheiden.

&

Wordt gebruikt om naam- en waardeparen van URL-toegangsparameters te scheiden.

Voorvoegsel

Een voorvoegsel voor de URL-parameter die een actie opgeeft in de Power BI-service. Bijvoorbeeld rp: of rdl:.

parameter

De parameternaam.

waarde

URL-tekst die overeenkomt met de waarde van de parameter die wordt gebruikt.

Naslaginformatie over URL-rapportparameter

U kunt rapportparameters doorgeven aan een rapport door ze op te slaan in een gepagineerde rapport-URL.

Rapportparameters (rp:)

Zie Een rapportparameter doorgeven in een URL voor voorbeelden van het doorgeven van rapportparameters in een URL.

Notitie

Rapportparameters vereisen het parametervoorvoegsel rp: en zijn hoofdlettergevoelig.

Naslaginformatie over URL-toegangsparameters

U kunt de volgende parameters gebruiken als onderdeel van een URL om het uiterlijk van uw gepagineerde rapporten in Power BI te configureren. De meest voorkomende parameters worden weergegeven in deze sectie. Parameters zijn niet hoofdlettergevoelig en beginnen met het parametervoorvoegsel rdl: als deze betrekking hebben op de uitvoerindeling.

Rapportopdrachten (rdl:)

Exportindeling

Hiermee geeft u de indeling op waarin een rapport moet worden weergegeven en geëxporteerd.

  • Bijvoorbeeld: rdl:format=PDF

Beschikbare waarden:

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

Rapport weergeven

Hiermee geeft u het type weergave dat wordt gebruikt om het rapport weer te geven.

  • rdl:reportView

Beschikbare waarden:

  • interactief (standaard): laadt het rapport in de interactieve modus.
  • pageView: laadt het rapport in de paginaweergavemodus.

Parameterpaneel

Hiermee geeft u op of het parameterpaneel wordt gesloten of geopend wanneer het rapport wordt geladen of helemaal verborgen is.

  • rdl:parameterPanel

Beschikbare waarden:

  • samengevouwen: laadt het rapport met gesloten parameterpaneel. De parameterknop is ingeschakeld, zodat gebruikers de knop kunnen selecteren om uit te vouwen.
  • verborgen: laadt het rapport met het parameterpaneel gesloten en de parameterknop is uitgeschakeld.
  • uitgevouwen (standaard): laadt het rapport met het parametervenster geopend en de parameterknop is ingeschakeld.

Apparaatgegevens

U kunt aanvullende uitvoerparameters opgeven voor de volgende exportindelingen.

  • 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:

    Notitie

    Raadpleeg voor deze tekenreekswaarden de instellingen voor gegevens van CSV-apparaten.

    • 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

U kunt toevoegen rdl:targetSameWindow=true aan de hyperlink-URL in uw rapport om power BI deze hyperlink in hetzelfde browservenster te laten openen. Zie Een hyperlink toevoegen aan een URL voor meer informatie over het toevoegen van hyperlinks aan een rapport.

Gerelateerde inhoud