Power Bi

Power BI — Opsætning af integration

Vis en Power BI-rapport eller et dashboard på dine Q-Play-skærme ved at forbinde med en Microsoft-konto. Den konto, du logger ind med, skal have en Power BI Pro- eller PPU-licens og adgang til det indhold, du vil vise. Der kræves ingen Power BI Premium- eller Fabric-kapacitet på infrastruktursiden.

Hvis den tilknyttede kontos adgangskode nulstilles, eller MFA-kravene ændres, vil integrationen holde op med at virke og skal genauthoriseres. Se afsnittet Genautoriser integrationen nederst i denne guide.

Vi anbefaler at oprette en dedikeret Microsoft-konto til Q-Play frem for at bruge en personlig eller delt medarbejderkonto. Hvis den tilknyttede konto slettes fra din organisation, vil integrationen holde op med at virke. En dedikeret konto sikrer kontinuitet uanset personaleændringer.

Inden du går i gang, bør du have dit Workspace ID og Report ID (eller Dashboard ID) klar. Du skal indtaste dem umiddelbart efter, du har logget ind med Microsoft, så det sparer tid at have dem ved hånden.

For en generel introduktion til, hvordan integrationer fungerer i Q-Play — herunder hvordan du finder integrationer, tilføjer en ny og håndterer versioner — se Sådan arbejder du med integrationer i Q-Play.

Trin 1 — Tilføj integrationen og log ind

Find Power BI i integrationslisten, giv den et navn, og gennemfør opsætningsforløbet.

I Settings-trinnet skal du angive din foretrukne Timezone og Language.

I Credentials-trinnet kan du vælge at klikke på Sign in with Microsoft med det samme — eller springe dette over nu og logge ind senere, når du har konfigureret dit job og er klar til at køre det umiddelbart efter. Hvis du logger ind her, bliver du viderestillet til Microsofts loginside og derefter automatisk tilbage til Q-Play. Uanset hvad oprettes integrationen, når du klikker på Opret integration.

Når du er tilbage i Q-Play, har du 10 minutter til at konfigurere og køre screenshot-jobbet (trin 2 nedenfor). Dette er en Microsoft-begrænsning — den autorisationskode, Q-Play modtager fra Microsoft, er kun gyldig i 10 minutter. Hvis du kører et job inden for dette vindue, udveksles den kortlivede kode med et langtidsvirkende token, som Q-Play kan bruge fremover. Hvis du overskrider vinduet, kan du blot åbne integrationens Indstillinger og klikke på Sign in with Microsoft igen for at få et nyt 10-minutters vindue.

Trin 2 — Tilføj og kør screenshot-jobbet

På integrationssiden skal du klikke på + Tilføj job. Et panel glider ind fra højre.

Udfyld jobindstillingerne:

Job Name — et navn til dette job, fx Screenshot.
Job Type — lad denne stå som Screenshot.

Under Content:

Content type — vælg Report eller Dashboard afhængigt af, hvad du vil vise.
Workspace ID — indtast Workspace ID fra Power BI.
Report ID / Dashboard ID — indtast ID'et for den rapport eller det dashboard, du vil vise.

Dine ID'er findes i URL'en, når du åbner indholdet 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 direkte efter /groups/.
Report ID eller Dashboard ID: 90983b81-7237-4b0d-902c-5b8c196c205e — afhængigt af din indholdstype er dette ID'et direkte efter /reports/ (for rapporter) eller /dashboards/ (for dashboards). Dette er kun det første ID-segment.
Page ID: 93a0bdd07004584f8f3b — ID'et direkte 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.

Hvis du opsætter et screenshot-job, skal du også bruge Page ID'et — dette fortæller Q-Play, hvilken specifik side af rapporten der skal tages screenshot af. Dette gælder kun for rapport-screenshot-jobs, ikke dashboards.

Report page name — (kun rapporter, valgfrit) hvis din rapport har flere sider, skal du indtaste navnet på den specifikke side, du vil vise. Lad feltet stå tomt for at vise rapportens standardside.
Dashboard fit — (kun dashboards) vælg, hvordan dashboardet tilpasses skærmen: Fit to width, Actual size eller One column. Power BI-dashboards er ikke dynamiske, så dette styrer, hvordan de skaleres.
Image width / Image height — opløsningen på screenshottet. Standard er 1920×1080, hvilket passer til de fleste skærme.

Under Scheduling:

Schedule type — lad denne stå som Scheduled.
Refresh schedule — vælg, hvor ofte Q-Play skal gengive og opdatere screenshottet. Standard er hvert 30. minut. Intervaller under 30 minutter er tilgængelige på betalte abonnementer.

Klik på Gem integration, og klik derefter på Run now øverst til højre. Dette første manuelle kørsel er nødvendigt for at autorisere forbindelsen. Efter en vellykket kørsel vil jobbet automatisk fortsætte på den valgte tidsplan.

Vis flere rapporter eller dashboards

En enkelt integrationsinstans kan vise både rapporter og dashboards — tilføj blot et separat job for hvert stykke indhold, du vil vise, og angiv Content type for hvert job.

Row-Level Security

Row-Level Security (RLS) anvendes automatisk baseret på den tilknyttede konto. Alle skærme, der bruger denne integration, viser data præcis som den konto ser det i Power BI.

Genautoriser integrationen

Hvis integrationen holder op med at virke efter en adgangskodernulstilling eller en MFA-ændring, skal du genauthorisere den. Åbn integrationens Indstillinger-panel (tandhjulsikonet øverst til højre på integrationssiden) og klik på Sign in with Microsoft under Credentials.

Når du logger ind med Microsoft, gemmer Q-Play et refresh-token — ikke din adgangskode. Tænk på det som et adgangskort: du beviser din identitet én gang i receptionen, og adgangskortet fortsætter med at virke på egen hånd, så du ikke behøver at tjekke ind hver gang. Men Microsoft kan ugyldiggøre det adgangskortet, når kontooens sikkerhedstilstand ændres.

Der er to situationer, hvor dette sker:

Adgangskodernulstilling: refresh-tokenet blev udstedt mod den gamle adgangskode. Når en adgangskode ændres, ugyldiggør Microsoft alle tokens udstedt før det tidspunkt — dette er bevidst sikkerhedsadfærd for at sikre, at stjålne tokens også dør, når en adgangskode nulstilles. Q-Plays token bliver ramt af dette, så genauthorisering er nødvendig.

MFA- eller Conditional Access-ændring: hvis din organisation nyligt kræver MFA eller strengere godkendelse for denne konto eller app, blev det eksisterende token udstedt, før denne regel eksisterede, og opfylder ikke længere politikken. Microsoft tvinger et nyt interaktivt login for at opfylde det nye krav.

Dette er ikke Q-Play, der mister forbindelsen — det er Microsoft, der bevidst tilbagekalder tokenet, når kontoens sikkerhedstilstand ændres. Daglige tokenfornyelser håndteres lydløst i baggrunden og kræver ingen handling.

Dette er endnu en grund til, at vi anbefaler at bruge en dedikeret tjenestekonto til Q-Play — en stabil konto med en fast adgangskode og MFA allerede opfyldt betyder, at ingen af disse udløsere nogensinde aktiveres, og den engangsauthorisering varer i praksis på ubestemt tid.

Når din integration er sat op, er næste trin at konfigurere Power BI-appen i Q-Play. Klik her for at lære, hvordan du opsætter Power BI-appen.