Freigeben über

URL-Parameter in paginierten Berichten in Power BI

  • Artikel

GILT FÜR: ️ Power BI Report Builder ️Power BI Desktop

Sie können Befehle an paginierte Berichte in Power BI senden, indem Sie einen Parameter zu einer URL hinzufügen. Beispielsweise haben Sie den Bericht vielleicht mithilfe bestimmter Berichtsparameterwerte angezeigt. Sie kapseln diese Informationen in der URL, indem Sie vordefinierte URL-Zugriffsparameter verwenden. Ferner passen Sie an, wie Power BI den Bericht verarbeitet, indem Sie Parameter zum Rendern von Formaten oder für die Benutzeroberfläche der Berichtssymbolleiste einbetten. Sie fügen diese URL anschließend in eine E-Mail oder Webseite ein, damit sich Andere Ihren Bericht auf dieselbe Weise im Browser anzeigen lassen können.

Folgende Aktionen können Sie mithilfe von URL-Zugriffsparametern durchführen:

  • Senden von Berichtsparametern an einen Bericht
  • Initiieren des Berichtsinhaltsexports in einem unterstützten Dateiformat
  • Ausblenden oder Anzeigen des Parameterbereichs
  • Festlegen der DeviceInfo-Einstellung

Eine umfassende Liste der Befehle und Einstellungen, die über den URL-Zugriff verfügbar sind, finden Sie unter Referenz zu URL-Zugriffsparametern in diesem Abschnitt.

URL-Zugriffskonzepte

URL-Anforderungen an Power BI enthalten Parameter, die vom Dienst verarbeitet werden. Die Art und Weise, in der der Dienst URL-Anforderungen verarbeitet, hängt von den Parametern, Parameterpräfixen und Elementtypen ab, die in der URL enthalten sind. Die URL-Funktionalität für paginierte Berichte ist mit den meisten Browsern und Anwendungen kompatibel, die die Standard-URL-Adressierung unterstützen.

URL-Zugriffssyntax

URL-Anforderungen können mehrere Parameter enthalten, die in beliebiger Reihenfolge aufgelistet sind. Parameter sind durch ein kaufmännisches Und-Zeichen (&) getrennt. Name-Wert-Paare sind durch ein Gleichheitszeichen (=) getrennt. Beispiel:

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

Syntaxbeschreibung

powerbiservicereporturl

Die Power BI-Dienst-URL Ihres paginierten Berichts. Beispiel:

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

?

Wird verwendet, um den powerbiservicereporturl und die URL-Zugriffsparameter zu trennen.

&

Wird verwendet, um Namen- und Wertpaare von URL-Zugriffsparametern zu trennen.

prefix

Ein Präfix für den URL-Parameter, das eine Aktion im Power BI-Dienst angibt. Zum Beispiel: rp: oder rdl:.

parameter

Der Name des Parameters.

value

Der URL-Text, der dem Wert des verwendeten Parameters entspricht.

URL-Berichtsparameterverweis

Sie können Berichtsparameter an einen Bericht übergeben, indem Sie diese in die URL eines paginierten Berichts einschließen.

Berichtsparameter (rp:)

Beispiele für das Übergeben von Berichtsparametern in einer URL finden Sie unter Übergeben eines Berichtsparameters in einer URL.

Hinweis

Berichtsparameter erfordern das Parameterpräfix rp:, und die Groß-/Kleinschreibung wird beachtet.

Referenz zu URL-Zugriffsparametern

Sie können die folgenden Parameter als Teil einer URL verwenden, um die Benutzeroberfläche der paginierten Berichte in Power BI zu konfigurieren. Die häufigsten Parameter sind in diesem Abschnitt aufgeführt. Bei Parametern wird die Groß-/Kleinschreibung nicht beachtet und sie beginnen mit dem Parameterpräfix rdl:, wenn sie mit dem Ausgabeformat verknüpft sind.

Berichtsbefehle (rdl:)

Exportformat

Gibt das Format an, in dem ein Bericht gerendert und exportiert werden soll.

  • Beispiel: rdl:format=PDF

Verfügbare Werte:

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

Berichtsansicht

Gibt den Ansichtstyp an, der zum Anzeigen des Berichts verwendet wird.

  • rdl:reportView

Verfügbare Werte:

  • interactive (Standard): Der Bericht wird im interaktiven Modus geladen.
  • pageView: Der Bericht wird im Seitenansichtsmodus geladen.

Parameterbereich

Gibt an, ob der Parameterbereich beim Laden des Berichts geschlossen, geöffnet oder vollständig ausgeblendet ist.

  • rdl:parameterPanel

Verfügbare Werte:

  • collapsed: Der Bericht wird mit geschlossenem Parameterbereich geladen. Die Schaltfläche „Parameter“ ist aktiviert, sodass Benutzer ihn auswählen können, um den Bereich aufzuklappen.
  • hidden: Der Bericht wird mit geschlossenem Parameterbereich geladen, und die Schaltfläche „Parameter“ ist deaktiviert.
  • expanded (Standard): Der Bericht wird mit geöffnetem Parameterbereich geladen, und die Schaltfläche „Parameter“ ist aktiviert.

Geräteinformationen

Sie können zusätzliche Ausgabeparameter für die folgenden Exportformate angeben.

  • 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:MarginRight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer

  • CSV:

    Hinweis

    Verweisen Sie Für diese Zeichenfolgenwerte auf CSV-Geräteinformationseinstellungen.

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

Sie können der Hyperlink-URL in Ihrem Bericht rdl:targetSameWindow=true anfügen, damit Power BI diesen Hyperlink im selben Browserfenster öffnen kann. Informationen zum Hinzufügen von Links zu einem Bericht finden Sie unter Hinzufügen eines Hyperlinks zu einer URL.

Zugehöriger Inhalt