Hur bäddar man in Microsoft Power BI-rapporter i Umbraco-applikationer?

Översikt

Guide för att bädda in Power BI-rapporter och instrumentpaneler i UmbracoIntegrera Microsoft Power BI med Umbraco med hjälp av miniOrange Power BI Integrator plugin. Den här installationsguiden guidar dig genom stegen för att bädda in Power BI-rapporter, instrumentpaneler, paneler, dataset eller semantiska modeller i dina Umbraco-sidor och inlägg – vilket gör det möjligt för användare att se interaktiva Power BI-artefakter direkt från Umbraco-webbplatsen. Du kan också aktivera Row Level Security (RLS) för en detaljerad och personlig vy av Power BI-diagram i Umbraco.

Ladda ner

Prissättning planer

Förutsättningar: Ladda ner och installation

miniOrange Umbraco Integrator kräver:

En Umbraco-applikation som körs på version 9 till 15.

Applikationen ska vara kopplad till en MS SQL Server. (Om inte, kan vi föreslå lämplig version baserat på din databas.)

Om din applikation inte använder en databas kan vi även tillhandahålla en version som fungerar utan en databas.

A Microsoft Power BI konto.

Lägga till miniOrange i Umbraco-applikationen

installera miniOrange PowerBI Integrator Nuget-paket med hjälp av Nuget-pakethanteraren eller CLI.

NuGet-paketet

.NET CLI

PM> NuGet\Install-Package miniOrange.Umbraco.PowerBI.Integrator

När installationen är klar, bygg bara applikationen för att lägga till miniOrange-vyer och statiska filer.

Lägg till följande information i din program.cs fil.

                
                      using miniOrange.Umbraco.PowerBI;
                    
                     using Umbraco_PowerBI_Integrator;

                      using Umbraco_PowerBI_Integrator.RouteObserver;
                    
                      WebApplicationBuilder builder =  WebApplication.CreateBuilder(args);

  builder.Services.AddMiniOrangeServices(builder.Configuration);

                      builder.CreateUmbracoBuilder()
                    
.AddBackOffice()

.AddWebsite()

.AddDeliveryApi()

.AddComposers()

.Build()

  WebApplication app =  builder.Build();

  await app.BootUmbracoAsync();

  app.UseStaticFiles();

  app.UseUmbraco()

.WithMiddleware(u =>

{

              u.UseBackOffice();

              u.UseWebsite();

              u.AppBuilder.UseminiOrangeUmbracoPowerBIMiddleware();

})

.WithEndpoints(u =>

{

              u.UseInstallerEndpoints();

              u.UseBackOfficeEndpoints();

              u.UseWebsiteEndpoints();

});

  await app.RunAsync();

Bygg och kör applikationen.

Konfigurera Azure AD för PowerBI-integration

Vi kommer att göra lite PowerBI-konfiguration inuti miniOrange Dashboard

1. Konfigurera Azure AD-appregistreringen

Logga in Azure AD portalen som administratör.

Du kommer att presenteras med startskärmen för Azur Active Directory.

Under avsnittet Azure Services väljer du Microsoft Access ID.

På den vänstra fliken, under hantera avsnittet, välj Appregistreringar.

Azure Active Directory - Appregistreringar

Klicka på ny registrering.

Azure Active Directory – Nya registreringar

Tilldela Visningsnamn i namnfältet och välj kontotyp.

I Omdirigera URI fältet, ange bas-URL:en för din Umbraco-webbplats och klicka på Registrera knapp.

Azure Active Directory – Registrera ett program

Efter registreringen av ett program tilldelar Azure AD en unik ansöknings-ID till din ansökan.

Navigera till Översikt fliken, i den vänstra rutan.

kopiera ansöknings-ID och Katalog-ID, detta kommer att bli din kund-ID och Hyresgäst ID.

Azure Active Directory - Unikt applikations-ID

Från den vänstra navigeringsrutan, navigera till Certifikat & hemligheter fliken.

Klicka på en ny klienthemlighet. Ange beskrivningen och utgångstiden och klicka på ADDERA alternativ.

Azure Active Directory – Certifikat och hemligheter

Kopiera värdet på hemlig nyckel. Detta kommer att bli din Klientens hemliga nyckel.

2. Lägg till API-behörigheter till ditt Azure AD-program:

Gå till API-behörigheter från den vänstra navigeringsrutan och klicka på lägga till en behörighet alternativ.

Azure Active Directory - API-behörigheter

Välja Microsoft Graph under Microsoft API:er fliken.

Välja Applikationsbehörigheter och leta efter Användare.

Enligt Användare välj Användare.Läs och Användare.Läs.Alla behörigheter och klicka på Lägg till behörigheter knapp.(microsoft graf)

Klicka på lägg till behörighet, scrolla ner och välj Power BI-tjänst under alternativet för begäran om API-behörighet.

Välja Delegeringsbehörighet och leta efter Rapport.

Enligt Rapport välj Rapportera.Läs.Allt tillstånd och klicka på Lägg till rättighet knapp. (Power BI)

Nu kan du se alla behörigheter i API-behörighet avsnitt

Klicka på ge administratörstillstånd för standardkatalog och klicka på Ja på bekräftelse av administratörens samtycke.

Du har konfigurerat Azure AD-applikationen.

3. Konfigurera inställningarna för Azure AD-säkerhetsgruppen

På startsidan för Azure Active Directory, navigera till Grupper från vänstra rutan.

Klicka på Nya Koncernen för att lägga till en ny säkerhetsgrupp.

Välj Grupptyp as Säkerhet från rullgardinsmenyn och ange Grupp namn as Tillåt Power BI Admin API:er.

När du har angett detaljerna klicka på Skapa knapp för att skapa en ny säkerhetsgrupp.

Sök och välj nyskapade säkerhetsgrupper (tillåt Power BI Admin APIs).

Azure Active Directory - Nya skapade säkerhetsgrupper

Navigera till Medlemmar fliken från den vänstra rutan och klicka på Lägg till medlemmar.

Azure Active Directory – Lägg till medlemmar

Sök nu efter applikationsnamnet du tidigare har konfigurerat och klicka på välj knapp.

Du har framgångsrikt konfigurerat Azure AD-app för att uppnå användarsynkronisering och Power BI-integration i din Umbraco-applikation.

Konfigurera PowerBI för integration.

Gå till Power BI instrumentpanelen och logga in som administratör.

Du kommer att representeras med startskärmen för Power BI.

Klicka på i det övre högra hörnet inställningsikon som visas nedan.

Enligt styrning och insikter Klicka på admin portal alternativ.

I admin portal avsnitt, under hyresgästinställningar, bläddra ner till utvecklarinställningar.

Klicka på Tillåt tjänstens huvudpersoner att skapa och använda profiler.

aktivera toggle och klicka sedan på Ansök.

PowerBI - Inställningar för hyresgäster i administratörsportalen

Bläddra ner till Admin API-inställningar, aktivera växlingen och välj sedan alternativet för specifika säkerhetsgrupper.

Sök efter Umbraco Power BI användargrupp klicka sedan på Ansök.

Navigera tillbaka till startsidan. Välj Arbetsplatser fliken från den vänstra rutan och välj sedan din arbetsyta från listan.

Navigera till Hantera åtkomst fliken.

I Hantera åtkomst avsnittet, klicka på lägg till Lägg till personer eller grupper.

PowerBI - Lägg till personer eller grupper

Sök efter programmet som du tidigare har konfigurerat. Från rullgardinsmenyn väljer du Viewer och klicka på Lägg till knappen för att tilldela den här Azure AD-applikationen till din Power BI-arbetsyta.

Välj rapport som du vill bädda in i Umbraco-sida eller -inlägg.

Kopiera sedan Workspace_ID och Rapport_ID från webbadressen som visas i bilden nedan och ha den till hands eftersom du behöver den ytterligare.

Konfigurera miniOrange-pluginet med PowerBI-inställningar

Besök Umbraco-appen.

Lägg till följande i bas-URL:en för din applikation: /?action=config frågeparameter.(/?action=config)

Du kommer att visas med ANMÄLNINGSBLANKETT, fyll i och klicka på Registrera knapp.

När du har registrerat dig kommer du att visas miniOrange-administratörspanelen.

Gå till Autentiseringsinställningar fliken och enter Klient-ID, klienthemlighet och hyresgäst-ID av ditt Azure AD-program och klicka sedan på Spara.

Gå nu till Power BI-inställningar fliken och ange Rapportnamn, Arbetsyte-ID och Rapport_ID av din rapport.

Skriptet kommer att genereras som visar Workspace_ID och Rapport_ID av din Power BI-rapport.

Logga in på ditt Umbraco BackOffice-konto.

På fliken Innehåll -> Klicka på alternativet PowerBI-rapporter.

I miniOrange-testversionen kommer du bara att kunna komma åt rapporten efter att du har loggat in med Entra ID-kontot. Klicka på knappen Logga in och logga in med Entra ID-kontot.

Du kommer att visas med PowerBI-rapporten så snart du loggar in.

Hör av dig

Hör av dig till oss på umbracosupport@xecurify.com, och vårt team hjälper dig att konfigurera Power BI-integrationen i Umbraco. Vi hjälper dig också att välja den lämpligaste lösningen eller planen baserat på dina behov.

Innehåll