Démarrage rapide : incorporer un rapport Power BI à l’aide d’un iFrame et de paramètres d’URLQuickstart: Embed a Power BI report using an iFrame and URL parameters

Vous pouvez intégrer un rapport dans votre application à l’aide d’un iFrame.You can embed any report by using an iFrame in your application.

Paramètre d’URLURL parameter

Pour toute URL d’un rapport, vous pouvez ajouter un paramètre querystring défini sur ?rs:Embed=true.For any URL to a report, you can add a querystring parameter of ?rs:Embed=true.

Par exemple :For example:

http://myserver/reports/powerbi/Sales?rs:embed=true

Cela fonctionne sur tous les types de rapports dans Power BI Report Server.This will work on all report types within Power BI Report Server.

iFrameiFrame

Une fois que vous avez votre URL, vous pouvez créer un iFrame dans une page Web pour héberger le rapport.Once you have your URL, you can create an iFrame within a web page, to host the report.

Par exemple :For example:

<iframe width="800" height="600" src="http://myserver/reports/powerbi/Sales?rs:embed=true" frameborder="0" allowFullScreen="true"></iframe>

Filtre d’URLURL filter

Vous pouvez ajouter un paramètre de chaîne de requête à l’URL pour filtrer les données retournées dans le rapport Power BI.You can add a query string parameter to the URL to filter the data that's returned in the Power BI report.

La syntaxe est simple. Il suffit d’accéder à l’URL du rapport, d’ajouter un point d’interrogation, puis cette syntaxe de filtre.The syntax is straightforward; start with the report URL, add a question mark, then this filter syntax.

URL?filter=Tableau/Champ eq 'valeur'URL?filter=Table/Field eq 'value'

Gardez les considérations suivantes à l’esprit :Keep these considerations in mind:

  • Les noms de Tableau et de Champ respectent la casse, pas la valeur.Table and Field names are case sensitive; value isn't.
  • Vous pouvez filtrer un rapport dont des champs sont masqués dans l’affichage Rapport.You can filter a report with fields that are hidden from report view.
  • La valeur doivent être placée entre apostrophes.Value has to be enclosed with single quotes.
  • Le type de champ doit être une chaîne.Field type has to be string.
  • Les noms de table et de champ ne peuvent pas contenir d’espace.Table and field names can't have spaces.

Exemple : filtrer sur un champExample: Filter on a field

Prenons l’Exemple Analyse de la vente au détail.Take for example the Retail Analysis sample. Supposons que ceci est l’URL du rapport sur le serveur de rapports dans un dossier nommé « power bi » :Say this is the URL to the report on the report server in a folder called "power-bi":

https://report-server/reports/power-bi/Retail-Analysis-Sample

Vous voyez que la visualisation de la carte dans l’exemple Analyse de la vente au détail affiche des magasins en Caroline du Nord et dans d’autres États.You see the map visualization in the Retail Analysis sample shows stores in North Carolina and other states.

Visualisation de la carte de l’exemple Analyse de la vente au détail

NC est la valeur pour North Carolina (Caroline du Nord) stockée dans le champ Territoire du tableau Magasin.NC is the value for North Carolina stored in the Territory field of the Store table. Ainsi, pour filtrer le rapport afin d’afficher uniquement les données des magasins situés en Caroline du Nord, ajoutez à l’URL le code suivant :So to filter the report to show data only for stores in North Carolina, append the following to the URL:

?filter=Store/Territory eq 'NC'?filter=Store/Territory eq 'NC'

À présent, le rapport étant filtré sur la Caroline du Nord, les visualisations affichées sur la page du rapport présentent uniquement des données relatives à la Caroline du Nord.Now the report is filtered for North Carolina; all the visualizations on the report page show data for only North Carolina.

Visualisations filtrées de l’exemple Analyse de la vente au détail

Créer une formule DAX pour filtrer sur plusieurs valeursCreate a DAX formula to filter on multiple values

Une autre façon de filtrer sur plusieurs champs consiste à créer une colonne calculée dans Power BI Desktop, qui concatène deux champs pour former une seule valeur.Another way to filter on multiple fields is by creating a calculated column in Power BI Desktop that concatenates two fields to a single value. Ensuite, vous pouvez utiliser cette valeur pour le filtrage.Then you can filter on that value.

Par exemple, l’exemple Analyse de la vente au détail comporte deux champs : Territoire et Chaîne.For example, the Retail Analysis sample has two fields: Territory and Chain. Dans Power BI Desktop, vous pouvez créer une colonne calculée (champ) nommée TerritoryChain (TerritoireChaîne).In Power BI Desktop, you can create a calculated column (Field) called TerritoryChain. N’oubliez pas que le nom de Champ ne peut pas contenir d’espaces.Remember that the Field name can't have any spaces. Voici la formule DAX pour cette colonne.Here is the DAX formula for that column.

TerritoryChain = [Territoire] & "-" & [Chaîne]TerritoryChain = [Territory] & "-" & [Chain]

Publiez le rapport sur le serveur Power BI Report Server, puis utilisez la chaîne de requête d’URL pour filtrer afin d’afficher des données uniquement pour les magasins Lindseys de Caroline du Nord.Publish the report to the Power BI Report Server, then use the URL query string to filter to display data for only Lindseys stores in NC.

https://report-server/reports/power-bi/Retail-Analysis-Sample?filter=Store/TerritoryChain eq 'NC-Lindseys'

Étapes suivantesNext steps

Démarrage rapide : créer un rapport Power BI pour Power BI Report ServerQuickstart: Create a Power BI report for Power BI Report Server
Démarrage rapide : créer un rapport paginé pour Power BI Report ServerQuickstart: Create a paginated report for Power BI Report Server

D’autres questions ?More questions? Essayez d’interroger la communauté Power BITry asking the Power BI Community