Del via

Power BI-flis-kontroll i Power Apps

  • Artikkel

En kontroll som viser en Power BI-flis i en app.

Har du ikke Power BI? Registrer deg.

Beskrivelse

Dra nytte av eksisterende dataanalyser og rapportering ved å vise Power BI-flisene i appene dine. Angi flisen du ønsker å vise, ved å angi egenskapene Workspace, Dashboard og Tile i Data-fanen i panelet for alternativer.

Obs!

  • Power BI-flis-kontroll er ikke tilgjengelig i miljøene GCC High og DoD.
  • Power BI-flis-kontrollen er ikke tilgjengelig i Kina.
  • Hvis du vil ha lisenskrav ved innebygging av Power BI-flis, se Lisensiering.

Deling og sikkerhet

Når du deler en app som inneholder Power BI-innhold, må du dele både selve appen og instrumentbordet hvor flisen kommer fra. Ellers vises ikke Power BI-innholdet, selv ikke for brukere som åpner appen. Apper som inneholder Power BI-innhold respekterer tillatelsene for det innholdet.

Ytelse

Det er ikke anbefalt å ha mer enn tre Power BI-fliser lastet inn samtidig i appen. Du kan kontrollere hvordan du laster og fjerner fliser ved å stille inn LoadPowerBIContent-egenskapen.

Bygge inn alternativer

Innebygging er forskjellig mellom versjoner av Power BI-API-en. På grunn av den nye Power BI API-godkjenningsplanen kan det hende at flisen ikke er tilgjengelig på mobil eller i andre innebygde scenarier (Teams eller SharePoint).

Du kan styre bruken av API-versjon ved hjelp av egenskapen AllowNewAPI. Hvis du vil ha mer informasjon, se Nøkkelegenskaper.

Egenskapsverdien AllowNewAPI Virkemåte
Sann Du kan bygge inn et instrumentbord, en rapport eller en flis ved å ta Bygg inn nettadresse fra Power BI og gjøre den til TileUrl-verdi.
Usann Du kan bygge inn en instrumentbordflis ved enten å velge Bygg inn nettadresse og gjøre den til TileUrl-verdi, eller bruke det geografiske grensesnittet som er oppgitt.

Obs!

Innebygging av en Power BI-URL-adresse (for eksempel i en IFrame) støttes ikke på Power Apps-mobil siden godkjenning av Power BI-URL-forespørselen ikke håndteres av den mobile spilleren.

Filtrering

Filtrering er forskjellig mellom versjonene av Power BI-API-en. Se de aktuelle delene nedenfor, avhengig av hvordan du konfigurerer kontrollen.

Når du bruker den nye API-en til å kalle opp Power BI-tjeneste

Når egenskapen AllowNewAPI er satt til Sann, bruker du ny API-en til å kalle opp Power BI-tjenesten. For mer informasjon kan du se Filtrere en rapport ved å bruke spørringsstrengparametere i URL-adressen.

Når du bruker den opprinnelige API-en til å kalle opp Power BI-tjeneste

Når egenskapen AllowNewAPI er satt til Usann, bruker du opprinnelige API-en til å kalle opp Power BI-tjenesten. I dette tilfellet kan du filtrere resultatene som vises i en Power BI-flis, ved å sende én enkelt parameter fra appen. Bare strengverdier og Er lik-operatorer støttes, og filteret vil kanskje ikke fungere hvis tabellnavnet eller kolonnenavnet inneholder mellomrom.

Hvis du vil sende en enkelt filterverdi, endrer du verdien for TileURL-egenskapen, som følger denne syntaksen:

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

Til denne verdien kan du legge til denne syntaksen:

&$filter=<TableName>/<ColumnName> eq '<Value>'

For eksempel ved å bruke en verdi fra listeboksen:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Parameteren filtrerer en verdi i datasettet til rapporten som flisen er hentet fra. Filtreringsfunksjonen har imidlertid følgende begrensninger:

  • Bare ett filter kan brukes.
  • Bare eq-operatoren støttes.
  • Felttypen må være en streng.
  • Filtrering er bare tilgjengelig på festede visualiseringsfliser. Det støttes ikke for festede rapporter.
  • Visualobjekter for R- og Python-skript kan ikke filtreres.

Du kan bruke beregnede felt i Power BI-rapporten til å konvertere andre verdityper til streng eller kombinere flere felt i én.

Nøkkelegenskaper

AllowNewAPI – Angir om den nye API-en skal brukes når Power BI-tjenesten kalles opp. Hvis du setter verdien til Sann, kan den nye API-en for Power BI brukes (som ikke støttes i mobile og enkelte innebygde scenarioer, men som gjør at mer avansert filtrering kan brukes). False gjør at den opprinnelige API-en brukes. Standardverdien er false.

Dashboard – Power BI-instrumentbordet flisen kommer fra.

LoadPowerBIContent – Når True er angitt, blir Power BI-innholdet lastet inn og vist. Når False er angitt, fjernes Power BI-innholdet, som frigir minne og optimaliserer ytelsen.

PowerBIInteractions – Når det er satt til Sann, kan Power BI-innholdet samhandles med, men Power Apps OnSelect-hendelsen utløses ikke. Når den er satt til Usann, kan ikke flisen samhandles med, men Power Apps OnSelect-hendelsen utløses når flisen velges.

Tile – navnet på Power BI-flisen du vil vise.

Workspace – Power BI-arbeidsområdet flisen kommer fra.

Tilleggsegenskaper

BorderColor – fargen på kontrollens kantlinje.

BorderStyle – hvorvidt kontrollens kantlinje er heltrukket, stiplet, prikket eller ingen.

BorderThickness – tykkelsen på kontrollens kantlinje.

DisplayMode – hvorvidt kontrollen tillater brukerinndata (Rediger), bare viser data (Vis) eller er deaktivert (Deaktivert).

Height – avstanden mellom kontrollens øvre og nedre kant.

OnSelect – Handlinger som skal utføres når brukeren velger en kontroll. Power BI-rapporten som er tilknyttet med flisen åpnes som standard.

TileUrl – nettadressen som Power BI-tjenesten bruker til å spørre om flisen. Hvis du vil legge til spørringsstrengfiltrering i URL-adressen, kan du se filtrering-delen ovenfor.

Visible – om kontrollen vises eller skjules.

Width – avstanden mellom kontrollens venstre og høyre kant.

X – Avstanden mellom kontrollens venstre kant og den venstre kanten til kontrollens overordnede beholder (eller skjermen, hvis det ikke finnes noen overordnet beholder).

Y – avstanden mellom kontrollens øvre kant og den øvre kanten til kontrollens overordnede beholder (eller skjermen, hvis det ikke finnes noen overordnet beholder).

Eksempel

  1. Åpne Diagrammer-menyen på Sett inn-fanen, og legg deretter til en Power BI-flis-kontroll.

    Vet du ikke hvordan du legger til og konfigurerer en kontroll?

  2. Velg My Workspace for Workspace-innstillingen i Data-fanen til Innstillinger-panelet.

  3. Velg et instrumentbord i listen over instrumentbord, og velg deretter en flis i listen over fliser.

    Kontrollen gjengir Power BI-flisen.

Retningslinjer for tilgjengelighet

Power BI-flis er ganske enkelt en beholder for Power BI-innhold. Finn ut hvordan du oppretter tilgjengelig innhold med disse tilgjengelighetstipsene for Power BI.

Vurder å legge til en overskrift ved hjelp av en Etikett-kontroll for å støtte skjermlesere, hvis Power BI-innholdet ikke har en tittel. Du kan plassere etiketten rett før Power BI-flisen.

Obs!

Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)

Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).