Opsætning af Power BI Enterprise-integrationen

Denne guide viser dig, hvordan du forbinder Power BI Enterprise til Q-Play, så dine rapporter og dashboards kan vises i platformen.

Før du starter: Du skal have adgang til en Power BI Admin-konto (eller have nogen på dit team, der har det), for at gennemføre denne opsætning, da nogle af trinene kræver ændringer af tenant-indstillinger, som kun en admin kan foretage.

Krav til kapacitet: For at kunne embedde Power BI-indhold skal dit workspace køre på en betalt kapacitet — A (Power BI Embedded), P (Premium) eller F (Fabric) SKU. Shared eller Pro-kapacitet understøtter ikke generering af embed-tokens. Hvis dit workspace kører på shared/Pro-kapacitet, vil jobs fejle med en 403-fejl, indtil du opgraderer til en af disse kapaciteter.

Bruger du en SoC-afspiller? SoC-afspillere er den indbyggede smart-TV-platform, man finder i skærme fra f.eks. LG, Samsung eller Sony — modsat en ekstern mediaplayer-boks. Disse er ikke kraftfulde nok til at rendere et live, interaktivt Power BI-embed, så hvis din skærm kører på en, skal du bruge en af Screenshot-jobtyperne i stedet for den live Report/Dashboard-type — mere om dette i Trin 6 nedenfor.

Trin 1: Opret integrationen

Følg vores generelle guide om at arbejde med integrationer i Q-Play for at oprette en ny integration, og vælg Power BI Enterprise som type.

Trin 2: Indstillinger

Angiv din Timezone og dit Language for integrationen, og klik derefter på Next.

Trin 3: Credentials — godkend integrationen

Dette er trinnet, der forbinder Q-Play med dit Power BI-tenant.

1. Under Authentication type vælger du Authorize with Microsoft.

   Hvis du hellere vil bruge din egen App Registration, er den mulighed også tilgængelig her — men vi går ud fra, at du allerede ved, hvordan du sætter det op, hvis du vælger det, da vi ikke kan yde support på opsætning af custom app registrations.

2. Under Admin consent klikker du på Authorize for at godkende adgangen nu, eller springer det over og klikker på Create Integration for at færdiggøre opsætningen og godkende senere.
   • Hvis du godkender nu, bliver du sendt videre til en Microsoft-login- og godkendelsesskærm. Da Q-Play er en tredjepartsapp, kan dette trin kræve godkendelse fra en administrator i din Microsoft-organisation.
   • Hvis du springer det over, bliver integrationen oprettet, men virker endnu ikke — du skal komme tilbage senere og færdiggøre godkendelsen (se nedenfor).

Færdiggør godkendelsen senere

Hvis du klikkede på Tilføj Integration uden at godkende, havner du på fanen Oversigt. For at færdiggøre opsætningen:

1. Gå tilbage til integrationens indstillinger (ikke status-fanen).
2. Gennemfør Microsoft-godkendelsen som beskrevet ovenfor.
3. Klik på Save nederst på skærmen, når du er færdig.

Trin 4: Giv Q-Play adgang til dit Power BI-workspace

Når du godkender med Microsoft, opretter Q-Play en service principal-bruger i dit Power BI-tenant kaldet "Q-Play PowerBi v1.1". Det er denne, der reelt gør det muligt for Q-Play at læse dine rapporter — den skal have eksplicit adgang for at virke.

1. Åbn det workspace i Power BI, der indeholder de rapporter eller dashboards, du vil vise i Q-Play.
2. Tilføj "Q-Play PowerBi v1.1" som medlem af det workspace.
3. Sæt dens rettighedsniveau til mindst Member. (Dette er minimumskravet — den skal have Member-niveau for reelt at kunne læse rapportindhold, ikke bare Viewer.)

Trin 5: Tjek dine tenant-indstillinger

Dette er normalt en engangsopsætning — hvis det allerede er gjort i din organisation (f.eks. til en anden tredjepartsintegration), kan du springe det over. Det kræver Power BI Admin-adgang.

Åbn Admin Portal

1. Log ind i Power BI med en Power BI Admin-konto.
2. Klik på tandhjulsikonet (⚙️) øverst til højre.
3. Vælg Administrationsportal.
4. Vælg Lejerindstillinger i menuen i venstre side.

Tjek at disse to indstillinger er aktiveret

• Tjenesteprincipaler kan kalde offentlige Fabric-API'er — Uden denne kan den service principal, som Q-Play bruger, ikke godkende sig eller hente data via Power BI API'et. Integrationen vil simpelthen ikke virke uden den.
• Integrer indhold i apps — Det er denne, der gør det muligt for Power BI-indhold rent faktisk at blive embeddet og vist inde i Q-Play.

For begge indstillinger:

• Sæt kontakten til Aktiveret.
• Under scope vælger du enten Hele organisationen, eller en specifik sikkerhedsgruppe, som Q-Plays service principal er medlem af.

Når Trin 4 og 5 er gennemført, er din integration fuldt opsat. Nu er du klar til at oprette dit første job.

Trin 6: Opret et job

Et job er det, der reelt henter en specifik rapport eller et dashboard ind i Q-Play. Hver rapport eller hvert dashboard, du vil vise, skal have sit eget job.

Klik på Tilføj Job på integrationens Overview-side.

Job-navn

Giv jobbet et beskrivende navn — dette er kun til din egen reference i Q-Play.

Jobtype

Vælg, hvilken type Power BI-indhold jobbet skal vise:

• Report — embedder en live, interaktiv Power BI-rapport.
• Dashboard — embedder et live, interaktivt Power BI-dashboard.
• Report Screenshot — tager et stillbillede af en rapport i stedet for at embedde den live.
• Dashboard Screenshot — tager et stillbillede af et dashboard i stedet for at embedde det live.

Bruger du en SoC-afspiller? SoC-afspillere er den indbyggede smart-TV-platform, man finder i skærme fra f.eks. LG, Samsung eller Sony — modsat en ekstern mediaplayer-boks. Disse er ikke kraftfulde nok til at rendere et live embed. Brug en af Screenshot-jobtyperne i stedet — resultatet ser ens ud, det er bare et statisk billede frem for et interaktivt embed.

Trin 7: Find dit Workspace ID og Report/Dashboard ID

Dette er den del, hvor de fleste sidder fast, så lad os gennemgå det grundigt.

Når du har valgt Report eller Dashboard som Job Type, skal du udfylde et Workspace ID og et Report ID (eller Dashboard ID). Begge dele kommer fra URL'en for rapporten eller dashboardet, når du har det åbent i Power BI.

Her er et eksempel på en Power BI-rapport-URL:

https://app.powerbi.com/groups/89b63c7c-e8ab-4322-b1e6-cabb581c1d94/reports/90983b81-7237-4b0d-902c-5b8c196c205e/93a0bdd07004584f8f3b?experience=power-bi

Opdelt:

• Workspace ID: 89b63c7c-e8ab-4322-b1e6-cabb581c1d94 — ID'et lige efter /groups/.
• Report ID: 90983b81-7237-4b0d-902c-5b8c196c205e — ID'et lige efter /reports/. Dette er kun det første ID-segment.
• Page ID: 93a0bdd07004584f8f3b — ID'et lige efter Report ID'et, før ?experience=.... Dette er en separat værdi fra Report ID'et.

For dashboards er fremgangsmåden den samme, bortset fra at URL'en indeholder /dashboards/ i stedet for /reports/. Dashboards har ikke sider, så der er intet Page ID at bekymre sig om.

Er du ved at sætte et Screenshot-job op? Du skal også bruge Page ID'et — ID'et lige efter Report ID'et i URL'en. Det fortæller Q-Play, hvilken specifik side af rapporten der skal tages screenshot af. Da dashboards ikke har sider, gælder dette kun Report Screenshot-jobs.

Trin 8: Screenshot-størrelse og tilpasning

Disse indstillinger vises kun for jobtyperne Report Screenshot og Dashboard Screenshot.

Report/Dashboard Width & Height — dette angiver den opløsning, screenshottet bliver renderet i, ligesom man angiver en virtuel skærmstørrelse, som Power BI skal rendere ind i. Den behøver ikke matche din fysiske skærms opløsning præcist, men det er et godt udgangspunkt, hvis du er i tvivl om, hvad du skal bruge.

For Dashboard Screenshot-jobs er der en ekstra indstilling:

Dashboard fitment — styrer, hvordan dashboardet skaleres ind i screenshottet:

• Fit to width — skalerer dashboardet, så det matcher den bredde, du har angivet.
• Actual size — renderer dashboardet i sin reelle størrelse, uden skalering.

Power BI-dashboards er ikke dynamiske på samme måde som rapporter — de omstrukturerer ikke automatisk. Hvis dashboardets elementer er store, kan Fit to width få dem til at se strakte eller mærkeligt proportionerede ud. Sker det, kan du prøve Actual size i stedet, eller justere bredde/højde, så de bedre matcher dashboardets faktiske layout.

Trin 9: Scheduling

Schedule type styrer, hvornår jobbet reelt kører:

• On-demand — jobbet kører kun, når det aktivt bliver brugt (dvs. vist), og først efter at Resource timeout er passeret siden sidste kørsel.
• Scheduled — jobbet kører automatisk med et fast interval, uanset om det aktuelt bliver vist.

Bemærk: "Resource timeout" og "Refresh schedule" beskriver, hvor ofte et nyt screenshot genereres. Denne betegnelse gælder specifikt for Report Screenshot- og Dashboard Screenshot-jobs — for live Report/Dashboard-jobs er der ikke noget, der bliver "opdateret", da indholdet allerede er live, så Schedule type er den eneste indstilling, der betyder noget der.

Resource timeout (kun On-demand) — den minimumstid, der skal gå mellem screenshots. Dette forhindrer jobbet i at køre oftere end nødvendigt, mens det er aktivt i brug.

Refresh schedule (kun Scheduled) — hvor ofte et nyt screenshot automatisk skal genereres, f.eks. hver time.

Trin 10: Kør et job

Jobs kører ikke automatisk, i det øjeblik integrationen er sat op — du skal selv udløse en kørsel for at bekræfte, at forbindelsen virker, og se et resultat.

Det kan du gøre på to måder:

Fra Overview-siden: Klik på ▶ (afspil)-ikonet ud for et job i Jobs-listen.

Inde fra et specifikt job: Åbn jobbet, og klik på Run Job Now øverst til højre.

Uanset hvad, vil kørslen dukke op under Recent Runs, når den er færdig, og vise, om den lykkedes eller fejlede. Hvis den fejler, se afsnittet om fejlfinding nedenfor.

Hvad så nu?

Når dit job er sat op og kører korrekt, er selve dataen klar — men der vil endnu ikke vises noget på en skærm. Integrationen gemmer kun forbindelsen; selve visningen af rapporten eller dashboardet sker i Q-Play-appen.

Se Power Bi Enterprise app setup guide for, hvordan du tilføjer dit jobs output til en skærm.

Fejlfinding ved fejlede jobs

Hvis et job viser status Failed eller Error, kan du se præcis, hvad der gik galt, i logs.

Sådan tjekker du logs

Hver jobkørsel har sin egen log.

• Klik på en specifik kørsel i Recent Runs-tabellen for at åbne dens individuelle log.
• Eller klik på View logs for at se logs på tværs af alle kørsler.

Loggen viser en tidsstemplet fejlmeddelelse, som som regel indeholder en HTTP-statuskode og en fejlkode — det fortæller dig, hvad der reelt gik galt.

Almindelige fejl, og hvad de betyder