Partager via


Paramètres d’URL dans les rapports paginés de Power BI

S’APPLIQUE À : Générateur de rapports Power BI Power BI Desktop

Vous pouvez envoyer des commandes à des rapports paginés dans Power BI en ajoutant un paramètre à une URL. Par exemple, vous pouvez avoir affiché le rapport en utilisant un ensemble spécifique de valeurs de paramètre de rapport. Vous encapsulez ces informations dans l’URL avec des paramètres d’accès par URL prédéfinis. Vous pouvez personnaliser davantage la façon dont Power BI traite le rapport en incorporant des paramètres pour les formats de rendu ou pour l’apparence de la barre d’outils du rapport. Vous collez ensuite cette URL directement dans un e-mail ou une page web pour que d’autres utilisateurs voient votre rapport de la même manière dans le navigateur.

Voici les actions que vous pouvez effectuer via des paramètres d’accès par URL :

  • Envoyer des paramètres de rapport à un rapport.
  • Lancer l’exportation du contenu du rapport dans un format de fichier pris en charge.
  • Masquer ou afficher le volet des paramètres.
  • Spécifier le paramètre DeviceInfo.

Pour obtenir la liste complète des commandes et paramètres disponibles via l’accès par URL, consultez Informations de référence sur les paramètres d’accès par URL dans cet article.

Concepts de l’accès par URL

Les demandes URL envoyées à Power BI contiennent des paramètres qui sont traités par le service. La façon dont le service gère les demandes URL dépend des paramètres, des préfixes de paramètre et des types d’éléments inclus dans l’URL. La fonctionnalité URL des rapports paginés est compatible avec la plupart des navigateurs et applications qui prennent en charge l’adressage URL standard.

Syntaxe de l’accès par URL

Les demandes URL peuvent contenir plusieurs paramètres, listés dans n’importe quel ordre. Les paramètres sont séparés par une esperluette (&). Les paires nom/valeur sont séparées par un signe égal (=). Par exemple :

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

Description de la syntaxe

powerbiservicereporturl

URL service Power BI de votre rapport paginé. Par exemple :

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

?

Utilisé pour séparer les paramètres d’accès à powerbiservicereporturl et à l’URL.

&

Utilisé pour séparer les paires nom/valeur des paramètres d'accès URL.

prefix

Préfixe pour le paramètre d’URL qui spécifie une action dans le service Power BI. Par exemple, rp: ou rdl:.

paramètre

Le nom du paramètre.

valeur

Texte de l’URL qui correspond à la valeur du paramètre utilisé.

Référence de paramètre de rapport d’URL

Vous pouvez passer des paramètres de rapport à un rapport en les incluant dans l’URL d’un rapport paginé.

Paramètres de rapport (rp:)

Pour obtenir des exemples de transmission de paramètres de rapport dans une URL, consultez Passer un paramètre de rapport dans une URL.

Notes

Les paramètres de rapport nécessitent le préfixe de paramètre rp: et respectent la casse.

Informations de référence sur les paramètres d’accès par URL

Vous pouvez utiliser les paramètres suivants dans une URL pour configurer l’apparence de vos rapports paginés dans Power BI. Les paramètres les plus courants sont listés dans cette section. Les paramètres ne respectent pas la casse et commencent par le préfixe de paramètre rdl: s’ils concernent le format de sortie.

Commandes de rapport (rdl:)

Format d'exportation

Spécifie le format de rendu et d’exportation d’un rapport.

  • Par exemple : rdl:format=PDF

Valeurs disponibles :

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

Vue Rapport

Spécifie le type de vue à utiliser pour afficher le rapport.

  • rdl:reportView

Valeurs disponibles :

  • interactive (par défaut) : charge le rapport en mode Interactif.
  • pageView : charge le rapport en mode Consultation de page.

Panneau de paramètres

Spécifie si le panneau des paramètres est fermé ou ouvert lors du chargement du rapport, ou s’il est entièrement masqué.

  • rdl:parameterPanel

Valeurs disponibles :

  • collapsed : charge le rapport avec le panneau de paramètres fermé. Le bouton de paramètre est activé pour que les utilisateurs puissent sélectionner le bouton pour développer.
  • hidden : charge le rapport avec le panneau de paramètres fermé et le bouton de paramètre désactivé.
  • expanded (valeur par défaut) : charge le rapport avec le panneau de paramètres ouvert et le bouton de paramètre activé.

Informations sur l’appareil

Vous pouvez spécifier des paramètres de sortie supplémentaires pour les formats d’exportation suivants.

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

    Notes

    Pour ces valeurs de chaîne, référencez les paramètres d’informations d’appareil CSV.

    • rdl:Encoding=chaîne
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=chaîne
    • rdl:NoHeader=true/false
    • rdl:Qualifier=chaîne
    • rdl:RecordDelimiter=chaîne
    • 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

Vous pouvez ajouter rdl:targetSameWindow=true à l’URL du lien hypertexte de votre rapport pour que Power BI ouvre ce lien hypertexte dans la même fenêtre de navigateur. Pour plus d’informations sur l’ajout de liens hypertexte à un rapport, consultez Ajouter un lien hypertexte à une URL.