Passer un paramètre de rapport dans une URL pour un rapport paginé Power BI

  • Article

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

Vous pouvez passer des paramètres de rapport à un rapport en les incluant dans une URL de rapport pour des rapports paginés. Ces paramètres URL ne sont pas préfixés parce qu'ils sont directement passés au moteur de traitement des rapports.

Tous les paramètres de requête peuvent avoir des paramètres de rapport correspondants. Vous passez un paramètre de requête à un rapport en transmettant le paramètre de rapport correspondant. Pour plus d’informations, consultez Créer une requête dans le Concepteur de requêtes relationnelles (Générateur de rapports Power BI).

Règles du paramètre de rapport paginé

Les paramètres de rapport respectent la casse et utilisent les caractères spéciaux suivants :

  • Tout espace figurant dans la chaîne d'URL est remplacé par le caractère « % 20 », conformément aux normes d'encodage des URL.
  • Un espace dans la partie Paramètre de l'URL est remplacé par un caractère Plus (+).
  • Un point-virgule dans toute partie de la chaîne est remplacé par les caractères « %3A ».
  • Les navigateurs doivent effectuer automatiquement l'encodage d'URL approprié. Vous n'avez pas besoin d'encoder manuellement les caractères.
  • Si vous n’incluez pas la syntaxe de proxy, faites précéder le paramètre de rp:.

Exemples de paramètre de rapport paginé

Pour définir un paramètre de rapport au sein d'une URL, utilisez la syntaxe suivante :

  
rp:parameter=value

Par exemple, pour spécifier deux paramètres, « Vendeur » et « État », définis dans un rapport de Mon espace de travail, vous devez utiliser l’URL suivante :

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah

Pour spécifier les deux mêmes paramètres définis dans un rapport d’une application, vous devez utiliser l’URL suivante :

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

Pour passer une valeur NULL pour un paramètre, utilisez la syntaxe suivante :

  
parameter:isnull=true

Par exemple,

rp:SalesOrderNumber:isnull=true

Pour passer une valeur booléenne , utilisez 0 pour false et 1 pour true. Pour passer une valeur à virgule flottante, incluez le séparateur décimal des paramètres régionaux du serveur.

Notes

Si votre rapport contient un paramètre de rapport qui a une valeur par défaut et que la valeur de la propriété Demander est false (autrement dit, si la propriété Demander à l’utilisateur n’est pas sélectionnée dans le Gestionnaire de rapports), vous ne pouvez pas passer de valeur pour ce paramètre de rapport dans une URL. Cela permet aux administrateurs d'empêcher les utilisateurs finaux d'ajouter ou de modifier les valeurs de certains paramètres de rapport.

Exemples supplémentaires

L’exemple d’URL suivant comprend un paramètre à valeurs multiples, « Salesperson ». Le format d’un paramètre à valeurs multiples est de répéter le nom du paramètre pour chaque valeur.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

L’exemple d’URL suivant passe un seul paramètre SellStartDate avec la valeur « 7/1/2005 ».

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

Considérations et limitations

  • Si votre rapport contient un paramètre de rapport qui a une valeur par défaut et que la valeur de la propriété Demander est false (autrement dit, si la propriété Demander à l’utilisateur n’est pas sélectionnée dans le Générateur de rapports Power BI), vous ne pouvez pas passer une valeur pour ce paramètre de rapport dans une URL. Ceci permet aux administrateurs d’empêcher les utilisateurs finaux d’ajouter ou de modifier les valeurs de certains paramètres de rapport.
  • Power BI ne prend pas en charge les chaînes de requête de plus de 2 000 caractères. Vous risquez de dépasser par inadvertance cette valeur si vous utilisez des paramètres d’URL pour afficher votre rapport paginé, en particulier si votre chaîne de requête contient plusieurs valeurs de paramètre. Pour charger correctement le rapport, réduisez le nombre de caractères à moins de 2 000.
  • La limite dans la chaîne de requête est évaluée après que vous êtes connecté à Power BI. Si vous ouvrez le rapport avant de vous connecter, la limite est réduite.

Contenu connexe