API Paramètres de requête Power BI Embedded

Les paramètres de requête permettent aux utilisateurs de définir des paramètres et de rendre des parties de leurs rapports et de leurs modèles de données (tels qu’un filtre de requête, une référence de source de données ou une définition de mesure) dépendantes d’une ou de plusieurs valeurs de paramètre. Les paramètres sont définis sur le fichier PBIX via Power BI Desktop. Pour en savoir plus sur les paramètres de requête, consultez ce billet de blog.

La nouvelle API Query Parameters (Paramètres de requête) pour Power BI Embedded permet aux développeurs de modifier dynamiquement les valeurs des paramètres et d’automatiser leur utilisation. L’API inclut un appel pour obtenir tous les paramètres définis sur un jeu de données spécifique et un appel pour définir de nouvelles valeurs pour les paramètres existants.

Avec cette nouvelle API, vous pouvez automatiser de nombreux processus pour plusieurs clients. Voici quelques exemples :

• Modifiez la chaîne de connexion. En configurant des paramètres sur la chaîne de connexion, vous pouvez utiliser l’API chaque fois que vous intégrez un nouveau client. Clonez simplement le rapport et modifiez les valeurs des paramètres pour vous connecter à la base de données du client. L’API peut également aider à automatiser la mise à jour des connexions aux sources de données qui ne sont pas prises en charge via l’API Update Datasources (Mettre à jour les sources de données).
• Modifiez les paramètres de requête. En définissant des paramètres sur l’API, vous pouvez définir les valeurs et obtenir des résultats et des données différents pour refléter uniquement ce que les utilisateurs de ce rapport doivent voir.
• Paramètres de mesure. Modifiez dynamiquement différentes mesures calculées pour répondre aux besoins de chaque client sur le même rapport. Par exemple, vous pouvez définir la devise à l’aide de paramètres pour différents clients ou succursales basés dans différents pays.

Notez que les paramètres sont basés sur le jeu de données et sont donc définis par rapport/tableau de bord, mais pas au niveau de la session de l’utilisateur. Cela signifie que les différents utilisateurs qui utilisent le même rapport en même temps voient toujours la valeur du même paramètre.