Selvstudium: Automatiser konfigurationen af installationen af skabelonappen ved hjælp af en Azure-funktion

Skabelonapps er en fantastisk måde for kunder at begynde at få indsigt fra deres data. Skabelonapps får dem hurtigt i gang ved at forbinde dem med deres data. Skabelonappsene giver kunderne færdigbyggede rapporter, som de kan tilpasse, hvis de ønsker det.

Kunderne kender ikke altid detaljerne for, hvordan de opretter forbindelse til deres data. At skulle angive disse oplysninger, når de installerer en skabelonapp, kan være et smertepunkt for dem.

Hvis du er datatjenesteudbyder og har oprettet en skabelonapp for at hjælpe dine kunder med at komme i gang med deres data på din tjeneste, kan du gøre det nemmere for dem at installere dit skabelonprogram. Du kan automatisere konfigurationen af parametrene for dit skabelonprogram.

Når kunden logger på din portal, vælger vedkommende et særligt link, du har forberedt. Dette link:

• Starter automatiseringen, som indsamler de oplysninger, den har brug for.
• Forudkonfigurer parametrene for skabelonappen.
• Omdirigerer kunden til deres Power BI-konto, hvor de kan installere appen.

Det eneste, de skal gøre, er at vælge Installér og godkend i forhold til deres datakilde, så er de klar!

Kundeoplevelsen illustreres her.

I dette selvstudium skal du bruge et eksempel på automatiseret installation af Azure Functions, som vi har oprettet for at forudkonfigurere og installere dit skabelonprogram. Dette eksempel er med vilje blevet holdt enkelt til demonstrationsformål. Den indkapsler konfigurationen af en Azure-funktion for at bruge Power BI-API til at installere en skabelonapp og konfigurere den automatisk for dine brugere.

Du kan få flere oplysninger om det generelle automatiseringsflow og de API'er, som appen bruger, under Automatiser konfigurationen af installationen af en skabelonapp.

Vores enkle program bruger en Azure-funktion. Du kan få flere oplysninger om Azure Functions i dokumentationen til Azure Functions.

Grundlæggende flow

Følgende grundlæggende flow viser, hvad programmet gør, når kunden starter det ved at vælge linket på portalen.

1. Brugeren logger på ISV'ens portal og vælger det angivne link. Denne handling starter flowet. ISV'ens portal forbereder den brugerspecifikke konfiguration på nuværende tidspunkt.

2. ISV'en henter et token kun til apps baseret på en tjenesteprincipal (kun app-token), der er registreret i ISV'ens lejer.

3. Ved hjælp af REST API'er til Power BI opretter ISV'en en installationsbillet, som indeholder den brugerspecifikke parameterkonfiguration, som er forberedt af ISV'en.

4. ISV'en omdirigerer brugeren til Power BI ved hjælp af en POST omdirigeringsmetode, som indeholder installationsbilletten.

5. Brugeren omdirigeres til sin Power BI-konto med installationsbilletten og bliver bedt om at installere skabelonappen. Når brugeren vælger Installér, installeres skabelonappen for vedkommende.

Bemærk

Selvom parameterværdier konfigureres af ISV'en i processen med at oprette installationsbilletten, leveres legitimationsoplysninger relateret til datakilden kun af brugeren i de sidste faser af installationen. Dette arrangement forhindrer dem i at blive eksponeret for en tredjepart og sikrer en sikker forbindelse mellem brugeren og datakilderne for skabelonappen.

Forudsætninger

• Din egen Microsoft Entra-lejer er konfigureret. Du kan finde oplysninger om, hvordan du konfigurerer en, under Opret en Microsoft Entra-lejer.
• En tjenesteprincipal (kun app-token), der er registreret i den foregående lejer.
• En parameteriseret skabelonapp , der er klar til installation. Skabelonappen skal oprettes i den samme lejer, som du registrerer dit program i Microsoft Entra ID i. Du kan få flere oplysninger under Tip til skabelonapps eller Opret en skabelonapp i Power BI.
• Hvis du vil kunne teste dit automatiseringsarbejdsflow, skal du føje tjenesteprincipalen til arbejdsområdet for skabelonappen som en Administration.
• En Power BI Pro-licens. Hvis du ikke er tilmeldt Power BI Pro, kan du tilmelde dig en gratis prøveversion, før du begynder.

Konfigurer dit udviklingsmiljø til automatisering af skabelonapps

Før du fortsætter med at konfigurere dit program, skal du følge vejledningen i Hurtig start: Opret en Azure Functions-app med Azure App Configuration for at udvikle en Azure-funktion sammen med en Azure-appkonfiguration. Opret din appkonfiguration som beskrevet i artiklen.

Registrer et program i Microsoft Entra ID

Opret en tjenesteprincipal som beskrevet i Integrer Power BI-indhold med tjenesteprincipal og en programhemmelighed.

Sørg for at registrere programmet som en serverbaseret webprogramapp . Du registrerer et serverbaseret webprogram for at oprette en programhemmelighed.

Gem program-id'et (ClientID) og programhemmeligheden (ClientSecret) til senere trin.

Du kan gennemgå værktøjet til konfiguration af integrering for hurtigt at komme i gang med at oprette en appregistrering. Hvis du bruger Værktøjet Til registrering af Power BI-apps, skal du vælge indstillingen Integrer for dine kunder.

Føj tjenesteprincipalen til arbejdsområdet for skabelonappen som en Administration, så du kan teste dit automatiseringsarbejdsflow.

Forberedelse af skabelonapp

Når du har oprettet dit skabelonprogram, og det er klar til installation, skal du gemme følgende oplysninger til de næste trin:

• App-id, pakkenøgle og ejer-id , som de vises i URL-adressen til installation i slutningen af processen Definer egenskaberne for skabelonappen , da appen blev oprettet.

  Du kan også få det samme link ved at vælge Hent link i ruden Udgivelsesadministration i skabelonappen.

• Parameternavne , som de er defineret i skabelonappens semantiske model. Der skelnes mellem store og små bogstaver i parameternavne. De kan også hentes fra fanen Parameter Indstillinger, når du definerer egenskaberne for skabelonappen eller fra indstillingerne for semantiske modeller i Power BI.

Bemærk

Du kan teste dit forudkonfigurerede installationsprogram i dit skabelonprogram, hvis skabelonappen er klar til installation, også selvom det endnu ikke er offentligt tilgængeligt på AppSource. Hvis brugere uden for din lejer skal kunne bruge det automatiserede installationsprogram til at installere dit skabelonprogram, skal skabelonappen være offentligt tilgængelig på markedspladsen for Power BI-apps. Før du distribuerer dit skabelonprogram ved hjælp af det automatiserede installationsprogram, du opretter, skal du sørge for at publicere det i Partnercenter.

Installér og konfigurer dit skabelonprogram

I dette afsnit skal du bruge et eksempel på automatiseret installation af Azure Functions, som vi har oprettet for at forudkonfigurere og installere dit skabelonprogram. Dette eksempel er med vilje blevet holdt enkelt til demonstrationsformål. Det giver dig mulighed for at bruge en Azure-funktion og Azure App Configuration til nemt at installere og bruge API'en til automatiseret installation til dine skabelonapps.

Download Visual Studio (version 2017 eller nyere)

Download Visual Studio (version 2017 eller nyere). Sørg for at downloade den nyeste NuGet-pakke.

Download eksemplet på automatiseret installation af Azure Functions

Download eksemplet på automatiseret installation af Azure Functions fra GitHub for at komme i gang.

Konfigurer konfigurationen af din Azure-app

Hvis du vil køre dette eksempel, skal du konfigurere konfigurationen af din Azure-app med de værdier og nøgler, der er beskrevet her. Nøglerne er program-id'et, programhemmeligheden og værdierne for AppId, PackageKey og OwnerId for dit skabelonprogram. Se følgende afsnit for at få oplysninger om, hvordan du henter disse værdier.

Nøglerne er også defineret i filen Constants.cs .

Konfigurationsnøgle	Betydning
TemplateAppInstall:Application:AppId	AppId fra URL-adressen til installationen
TemplateAppInstall:Application:PackageKey	PackageKey fra URL-adressen til installationen
TemplateAppInstall:Application:OwnerId	OwnerId fra URL-adressen til installationen
TemplateAppInstall:ServicePrincipal:ClientId	Program-id for tjenesteprincipal
TemplateAppInstall:ServicePrincipal:ClientSecret	Tjenesteprincipalens programhemmelighed

Den Constants.cs fil vises her.

Hent egenskaberne for skabelonappen

Udfyld alle relevante egenskaber for skabelonappen, som de defineres, når appen oprettes. Disse egenskaber er værdierne for AppId, PackageKey og OwnerId for skabelonappen.

Følg disse trin for at hente de foregående værdier:

1. Log på Power BI.

2. Gå til programmets oprindelige arbejdsområde.

3. Åbn ruden Udgivelsesadministration .

   

4. Vælg appversionen, og hent installationslinket.

   

5. Kopiér linket til Udklipsholder.

   

6. Denne URL-adresse til installation indeholder de tre URL-parametre, hvis værdier du har brug for. Brug værdierne appId, packageKey og ownerId for programmet. En EKSEMPEL-URL-adresse svarer til det, der vises her.

   https://app.powerbi.com/Redirect?action=InstallApp&appId=3c386...16bf71c67&packageKey=b2df4b...dLpHIUnum2pr6k&ownerId=72f9...1db47&buildVersion=5
   

Hent program-id'et

Udfyld applicationId-oplysningerne med program-id'et fra Azure. Værdien applicationId bruges af programmet til at identificere sig selv over for de brugere, du anmoder om tilladelser fra.

Følg disse trin for at hente program-id'et:

1. Log på Azure-portalen.

2. I ruden til venstre skal du vælge Alle tjenester>Appregistreringer.

   

3. Vælg det program, der skal bruge program-id'et.

   

4. Der er et program-id, der er angivet som et GUID. Brug dette program-id som applicationId-værdien for programmet.

   

Hent programhemmeligheden

Udfyld Oplysningerne om ApplicationSecret fra afsnittet Nøgler i afsnittet Appregistreringer i Azure. Denne attribut fungerer, når du bruger tjenesteprincipalen.

Følg disse trin for at hente programhemmeligheden:

1. Log på Azure-portalen.

2. I ruden til venstre skal du vælge Alle tjenester>Appregistreringer.

   

3. Vælg det program, der skal bruge programhemmeligheden.

   

4. Vælg Certifikater og hemmeligheder under Administrer.

5. Vælg Nye klienthemmeligheder.

6. Angiv et navn i feltet Beskrivelse , og vælg en varighed. Vælg derefter Gem for at hente værdien for dit program. Når du lukker ruden Nøgler , når du har gemt nøgleværdien, vises feltet Værdi kun som skjult. På det tidspunkt kan du ikke hente nøgleværdien. Hvis du mister nøgleværdien, skal du oprette en ny i Azure-portal.

   

Test din funktion lokalt

Følg trinnene som beskrevet i Kør funktionen lokalt for at køre funktionen.

Konfigurer din portal til at sende en POST anmodning til funktionens URL-adresse. Et eksempel er POST http://localhost:7071/api/install. Anmodningens brødtekst skal være et JSON-objekt, der beskriver nøgleværdipar. Nøgler er parameternavne som defineret i Power BI Desktop. Værdier er de ønskede værdier, der skal angives for hver parameter i skabelonappen.

Bemærk

I produktionen udledes parameterværdier for hver bruger af portalens tilsigtede logik.

Det ønskede flow skal være:

1. Portalen forbereder anmodningen pr. bruger eller session.
2. Anmodningen POST /api/install sendes til din Azure-funktion. Anmodningens brødtekst består af nøgleværdipar. Nøglen er parameternavnet. Værdien er den ønskede værdi, der skal angives.
3. Hvis alt er konfigureret korrekt, skal browseren automatisk omdirigere til kundens Power BI-konto og vise det automatiserede installationsflow.
4. Ved installationen angives parameterværdier som konfigureret i trin 1 og 2.

Relateret indhold

Publicer dit projekt på Azure

Hvis du vil publicere dit projekt på Azure, skal du følge vejledningen i dokumentationen til Azure Functions. Derefter kan du integrere api'er til automatiseret installation af skabelonapps i dit produkt og begynde at teste det i produktionsmiljøer.