Kontrolelementet Power BI-felt i Power Apps

Et kontrolelement, der viser et Power BI-felt i en app.

Har du ikke Power BI? Log på.

Beskrivelse

Udnyt din eksisterende dataanalyse og rapportering ved at vise dine Power BI-felter i dine apps. Angiv det felt, du vil have vist, ved at angive egenskaberne Workspace, Dashboard og Tile på fanen Data i panelet med indstillinger.

Bemærk

  • Power BI-feltkontrolelementet er ikke tilgængeligt i GCC High og DoD-miljøer.
  • Power BI-felt-kontrolelementet er ikke tilgængeligt i Kina.
  • Du kan se licenskrav ved indlejring af Power BI-felter under Licensering.

Deling og sikkerhed

Når du deler en app med Power BI-indhold, skal du ikke kun dele selve appen, men også det dashboard, hvor feltet kommer fra. Ellers vises Power BI-indholdet ikke – heller ikke for de brugere, der åbner appen. Apps med Power BI-indhold respekterer tilladelserne for det pågældende indhold.

Ydeevne

Det anbefales ikke at have flere end tre Power BI-felter indlæst samtidigt i en app. Du kan styre feltindlæsning og -fjernelse ved at angive egenskaben LoadPowerBIContent.

Indlejrer muligheder

Indlejring er forskellig mellem versioner af Power BI API. På grund af det nye Power BI API-godkendelsessystem er feltet muligvis ikke tilgængeligt på mobil eller i andre integrerede scenarier (Teams eller SharePoint).

Du kan styre brugen af API-versionen ved hjælp af egenskaben AllowNewAPI. Du kan finde flere oplysninger under Vigtige egenskaber.

Egenskabsværdien AllowNewAPI Adfærd
Sand Du kan indlejre et dashboard, en rapport eller et felt ved at tage Indlejre URL-adresse fra Power BI og gøre det værdien TileUrl.
Falsk Du kan indlejre et dashboard-felt enten med Indlejre URL-adresse og gøre det værdien TileUrl, eller ved at bruge den grafiske grænseflade, der er angivet.

Bemærk

Integrering af en Power BI URL-adresse (f.eks. i en IFrame) understøttes ikke på Power Apps-mobilenheder, da godkendelse af anmodningen om Power BI URL-adresse ikke håndteres af mobilafspilleren.

Filtrering

Filtreringen varierer mellem versionerne af Power BI API. Se de relevante afsnit nedenfor, afhængigt af hvordan du konfigurerer kontrolelementet.

Når du bruger den nye API til at kalde Power BI-tjeneste

Når egenskaben AllowNewAPI er angivet til "True", bruger du ny API til at kalde Power BI-tjeneste. Yderligere oplysninger findes i Filtrering af en rapport ved hjælp af parametre for forespørgselsstrengen i URL-adressen.

Når du bruger den originale API til at kalde Power BI-tjeneste

Når egenskaben AllowNewAPI er angivet til "Falsk", bruger du den originale API til at kalde Power BI-tjeneste. I dette tilfælde kan du filtrere de resultater, der vises i et Power BI-felt, ved at sende en enkelt parameter fra appen. Men det er kun strengværdier og lighedsoperatoren, der understøttes, og filteret fungerer muligvis ikke, hvis tabelnavnet eller kolonnenavnet indeholder mellemrum.

Hvis du vil overføre en enkelt filterværdi, skal du ændre værdien for egenskaben TileURL, som følger denne syntaks:

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

Til den pågældende værdi, skal du tilføje følgende syntaks:

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

Du kan f.eks. bruge en værdi fra et listefelt:

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

Parameteren filtrerer en værdi i datasættet for den rapport, som feltet stammer fra. Filtreringsfunktionen har imidlertid følgende begrænsninger:

  • Der kan kun anvendes ét filter.
  • Kun operatoren eq understøttes.
  • Felttypen skal være en streng.
  • Filtrering er kun tilgængelig for de fastgjorte visualiseringsfelter. Den understøttes ikke i forbindelse med fastgjorte rapporter.
  • Visuelle elementer af scriptet R og Script kan ikke filtreres.

Du kan bruge beregnede felter i Power BI-rapporten til at konvertere andre værdityper til en streng eller kombinere flere felter til én.

Vigtige egenskaber

AllowNewAPI – Hvorvidt du skal bruge den nye API, når du ringer til Power BI-tjenesten. Hvis værdien angives til True, kan den nye Power BI-API bruges (som ikke understøttes på mobilenheder og visse integrerede scenarier, men giver mulighed for mere avanceret filtrering). False bruger den oprindelige API. Standardværdien er false.

Dashboard – Det Power BI-dashboard, som feltet kommer fra.

LoadPowerBIContent – Når denne værdi er angivet til True, indlæses og vises Power BI-indholdet. Når værdien er indstillet til False, fjernes Power BI-indholdet, hvilket frigør hukommelse og optimerer ydeevnen.

PowerBIInteractions – Når det er angivet til Sand, kan Power BI-indholdet interageres med, men Power Apps-hændelsen OnSelect udløser ikke. Når feltet er angivet til Falsk, kan det ikke påvirkes, men Power Apps-hændelsen OnSelect udløses, når feltet er valgt.

Tile – Navnet på det Power BI-felt, du vil vise.

Workspace – Det Power BI-arbejdsområde, som feltet kommer fra.

Yderligere egenskaber

BorderColor – Farven på et kontrolelements kant.

BorderStyle – Om et kontrolelements kant er Solid, Dashed, Dotted eller None.

BorderThickness – Tykkelsen på et kontrolelements kant.

DisplayMode – Om kontrolelementet tillader brugerinput (Edit), kun viser data (View) eller er deaktiveret (Disabled).

Height – Afstanden mellem et kontrolelements øverste og nederste kant.

OnSelect – Handlinger, der skal udføres, når brugeren vælger et kontrolelement. Power BI-rapporten, der er knyttet til feltet, åbnes som standard.

TileUrl – den webadresse, som feltet er anmodet fra, i Power BI-tjenesten. Hvis du vil føje strengfiltrering til webadressen, skal du se filtreringsafsnittet ovenfor.

Visible – Om et kontrolelement vises eller skjules.

Width – Afstanden mellem et kontrolelements venstre og højre kant.

X – Afstanden mellem kontrolelementets venstre kant og venstre kant på den overordnede objektbeholder (skærmbilledet, hvis der ingen overordnet objektbeholder er).

Y – Afstanden mellem kontrolelementets øverste kant og den øverste kant af den overordnede objektbeholder (skærmbilledet, hvis der ingen overordnet objektbeholder er).

Eksempel

  1. Åbn menuen Diagrammer under fanen Indsæt, og tilføj derefter kontrolelementet Power BI-felt.

    Ved du ikke, hvordan du tilføjer og konfigurerer et kontrolelement?

  2. På fanen Data i panelet med indstillinger skal du vælge Mit arbejdsområde for indstillingen Workspace.

  3. Vælg et dashboard på listen over dashboards, og vælg derefter et felt på listen over felter.

    Kontrolelementet gengiver Power BI-felt.

Retningslinjer for tilgængelighed

Power BI-felt er ganske enkelt en objektbeholder til Power BI-indhold. Få mere at vide om, hvordan du opretter tilgængeligt indhold med disse tip til tilgængelighed i Power BI.

Hvis Power BI-indholdet ikke har en titel, kan du overveje at indsætte en overskrift ved hjælp af kontrolelementet Mærkat for at understøtte skærmlæsere. Du kan placere mærkaten umiddelbart før Power BI-feltet.

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).