URL-parametrar i sidnumrerade rapporter i Power BI

  • Artikel

GÄLLER FÖR: Power BI Report Builder Power BI Desktop

Du kan skicka kommandon till sidnumrerade rapporter i Power BI genom att lägga till en parameter i en URL. Du kan till exempel ha visat rapporten med hjälp av en specifik uppsättning rapportparametervärden. Du kapslar in den här informationen i URL:en med hjälp av fördefinierade URL-åtkomstparametrar. Du kan ytterligare anpassa hur Power BI bearbetar rapporten genom att bädda in parametrar för renderingsformat, eller för utseendet och känslan i rapportverktygsfältet. Sedan klistrar du in den här URL:en direkt i ett e-postmeddelande eller på en webbsida så att andra upplever rapporten på samma sätt i webbläsaren.

Här är åtgärder som du kan utföra via URL-åtkomstparametrar:

  • Skicka rapportparametrar till en rapport.
  • Starta exporten av rapportinnehållet i ett filformat som stöds.
  • Dölj eller visa parameterfönstret.
  • Ange Inställningen DeviceInfo .

En fullständig lista över kommandon och inställningar som är tillgängliga via URL-åtkomst finns i REFERENS för URL-åtkomstparameter i den här artikeln.

Begrepp för URL-åtkomst

URL-begäranden till Power BI innehåller parametrar som bearbetas av tjänsten. Hur tjänsten hanterar URL-begäranden beror på parametrar, parameterprefix och typer av objekt som ingår i URL:en. Url-funktioner för sidnumrerade rapporter är kompatibla med de flesta webbläsare och program som stöder url-adressering av standardtyp.

URL-åtkomstsyntax

URL-begäranden kan innehålla flera parametrar som anges i valfri ordning. Parametrar avgränsas med ett et-tecken (&). Namn- och värdepar avgränsas med ett likhetstecken (=). Till exempel:

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

Syntaxbeskrivning

powerbiservicereporturl

Den Power BI-tjänst URL:en för din sidnumrerade rapport. Till exempel:

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

?

Används för att separera powerbiservicereporturl och URL-åtkomstparametrarna.

&

Används för att separera namn- och värdepar med URL-åtkomstpar.

Prefix

Ett prefix för URL-parametern som anger en åtgärd i Power BI-tjänst. Exempel: rp: eller rdl:.

parameter

Parameternamnet.

värde

URL-text som motsvarar värdet för parametern som används.

Referens för URL-rapportparameter

Du kan skicka rapportparametrar till en rapport genom att inkludera dem i en sidnumrerad rapport-URL.

Rapportparametrar (rp:)

Exempel på hur du skickar rapportparametrar i en URL finns i Skicka en rapportparameter i en URL.

Kommentar

Rapportparametrar kräver parameterprefixet rp: och är skiftlägeskänsliga.

Referens för URL-åtkomstparameter

Du kan använda följande parametrar som en del av en URL för att konfigurera utseendet på dina sidnumrerade rapporter i Power BI. De vanligaste parametrarna visas i det här avsnittet. Parametrarna är skiftlägeskänsliga och börjar med parameterprefixet rdl: om det är relaterat till utdataformatet.

Rapportkommandon (rdl:)

Exportera format

Anger i vilket format en rapport ska återges och exporteras.

  • Till exempel: rdl:format=PDF

Tillgängliga värden:

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

Rapportvy

Anger vilken typ av vy som ska användas för att visa rapporten.

  • rdl:reportView

Tillgängliga värden:

  • interactive (standard): läser in rapporten i interaktivt läge.
  • pageView: läser in rapporten i sidvisningsläge.

Parameterpanelen

Anger om parameterpanelen är stängd eller öppen när rapporten läses in eller är helt dold.

  • rdl:parameterPanel

Tillgängliga värden:

  • komprimerad: läser in rapporten med parameterpanelen stängd. Parameterknappen är aktiverad så att användarna kan välja knappen för att expandera.
  • dold: läser in rapporten med parameterpanelen stängd och parameterknappen inaktiverad.
  • expanderad (standard): läser in rapporten med parameterpanelen öppen och parameterknappen aktiverad.

Enhetsinformation

Du kan ange ytterligare utdataparametrar för följande exportformat.

  • PDF/ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=heltal
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=heltal
    • rdl:DpiY=heltal
    • rdl:EndPage=heltal
    • 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=heltal

  • CSV:

    Kommentar

    För dessa strängvärden refererar du till CSV-enhetsinformationsinställningar.

    • 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=heltal
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=heltal
    • rdl:DpiY=heltal
    • rdl:EndPage=heltal
    • 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=heltal
    • 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

Du kan lägga rdl:targetSameWindow=true till hyperlänk-URL:en i rapporten så att Power BI öppnar den här hyperlänken i samma webbläsarfönster. Information om hur du lägger till hyperlänkar i en rapport finns i Lägga till en hyperlänk till en URL.

Relaterat innehåll