Wie bettet man Microsoft Power BI-Berichte in Umbraco-Anwendungen ein?

Übersicht

Anleitung zum Einbetten von Power BI-Berichten und Dashboards in UmbracoIntegrieren Sie Microsoft Power BI mit Umbraco mithilfe der miniOrange Power BI Integrator Plugin. Diese Einrichtungsanleitung führt Sie durch die Schritte zum Einbetten von Power BI-Berichten, Dashboards, Kacheln, Datensätzen oder semantischen Modellen in Ihre Umbraco-Seiten und -Beiträge. So können Benutzer interaktive Power BI-Artefakte direkt von der Umbraco-Site aus anzeigen. Sie können außerdem Row Level Security (RLS) für eine detaillierte und personalisierte Ansicht von Power BI-Diagrammen in Umbraco aktivieren.

Herunterladen

Tarifpläne

Voraussetzungen: Download und Installation

Der miniOrange Umbraco Integrator erfordert:

Eine Umbraco-Anwendung, die auf Version läuft 9 bis 15.

Die Anwendung sollte mit einem MS SQL Server. (Falls nicht, können wir Ihnen anhand Ihrer Datenbank die passende Version vorschlagen.)

Wenn Ihre Anwendung keine Datenbank verwendet, können wir auch eine Version bereitstellen, die funktioniert ohne Datenbank.

A Microsoft Power BI -Konto.

Hinzufügen von miniOrange zur Umbraco-Anwendung

Installieren Sie das miniOrange PowerBI Integrator Nuget-Paket mithilfe des Nuget-Paketmanagers oder der CLI.

NuGet-Paket

.NET-CLI

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

Nach der Installation erstellen Sie einfach die Anwendung, um miniOrange-Ansichten und statische Dateien.

Fügen Sie die folgenden Details in Ihrem program.cs Datei.

                
                      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();

Erstellen und Ausführen der Anwendung.

Konfigurieren von Azure AD für die PowerBI-Integration

Wir werden einige PowerBI-Konfigurationen im miniOrange Dashboard vornehmen

1. Konfigurieren Sie die Azure AD-App-Registrierung

Einloggen in Azure AD Portal als Administrator.

Ihnen wird der Startbildschirm von Azure Active Directory angezeigt.

Wählen Sie im Abschnitt „Azure-Dienste“ die Option aus Microsoft Entra-ID.

Azure Active Directory – Startbildschirm

Wählen Sie auf der linken Registerkarte im Abschnitt „Verwalten“ die Option aus App-Registrierungen.

Azure Active Directory – App-Registrierungen

Klicken Sie auf Neue Registrierung.

Azure Active Directory – Neue Registrierungen

Weisen Sie die Display Name im Namensfeld und wählen Sie die aus Konto Typ.

Im Umleitungs-URI Geben Sie im Feld die Basis-URL Ihres Umbraco-Site und klicken Sie auf Registrieren .

Azure Active Directory – Registrieren einer Anwendung

Nach der Registrierung einer Anwendung weist Azure AD eine eindeutige Anwendungs-ID zu Ihrer Bewerbung.

Navigieren Sie zu der Registerkarte Übersicht, im linken Bereich.

Kopieren Sie die Anwendungs-ID und der Verzeichnis-ID, das wird dein sein Kunden-ID als auch Mieter ID.

Azure Active Directory – Eindeutige Anwendungs-ID

Navigieren Sie im linken Navigationsbereich zu Zertifikate & Geheimnisse Tab.

Klicken Sie auf a neues Kundengeheimnis. Geben Sie die Beschreibung und die Ablaufzeit ein und klicken Sie auf ADD .

Azure Active Directory – Zertifikate und Geheimnisse

Kopieren Sie den Wert von Geheimer Schlüssel. Das wird Ihnen gehören Geheimer Clientschlüssel.

Azure Active Directory – Geheimer Schlüssel

2. Fügen Sie Ihrer Azure AD-Anwendung API-Berechtigungen hinzu:

Zurück Nach API-Berechtigungen aus dem linken Navigationsbereich und klicken Sie auf Fügen Sie eine Berechtigung hinzu .

Azure Active Directory – API-Berechtigungen

Auswählen Microsoft Graph unter dem Microsoft-APIs Tab.

Auswählen Anwendungsberechtigungen und suche nach dem Mitglied.

Der Mitglied wählen Benutzer.Lesen als auch Benutzer.Alles.lesen Berechtigungen und klicken Sie auf Berechtigungen hinzufügen Schaltfläche.(Microsoft Graph)

Klicken Sie auf „Berechtigung hinzufügen“, scrollen Sie nach unten und wählen Sie aus Power BI-Dienst unter der Option „API-Berechtigung anfordern“.

Auswählen Delegieren von Berechtigungen und suche nach dem Profil melden.

Der Reports wählen Melden.Alles lesen Erlaubnis und klicken Sie auf Berechtigung hinzufügen Taste. (Power BI)

Jetzt können Sie alle Berechtigungen im sehen API-Berechtigung Abschnitt

Klicken Sie auf Erteilen Sie die Zustimmung des Administrators für das Standardverzeichnis und klicken Sie auf Ja bei Bestätigung der Zustimmung des Administrators.

Sie haben die Azure AD-Anwendung erfolgreich konfiguriert.

3. Konfigurieren Sie die Azure AD-Sicherheitsgruppeneinstellungen

Navigieren Sie auf der Azure Active Directory-Startseite zu Groups aus dem linken Bereich.

Klicken Sie auf Neue Gruppe um eine neue Sicherheitsgruppe hinzuzufügen.

Wähle aus Gruppentyp as Sicherheit aus der Dropdown-Liste und geben Sie die ein Gruppenname as Erlauben Sie Power BI-Administrator-APIs.

Sobald Sie die Details eingegeben haben, klicken Sie auf Schaltfläche erstellen um eine neue Sicherheitsgruppe zu erstellen.

Suchen und wählen Sie neu erstellte Sicherheitsgruppen aus (Power BI-Administrator-APIs zulassen).

Azure Active Directory – Neu erstellte Sicherheitsgruppen

Navigieren Sie zu der Mitglieder Klicken Sie im linken Bereich auf die Registerkarte und klicken Sie auf Mitglieder hinzufügen.

Azure Active Directory – Mitglieder hinzufügen

Suchen Sie nun nach dem Anwendungsnamen, den Sie zuvor konfiguriert haben, und klicken Sie auf wählen .

Sie haben das erfolgreich konfiguriert Azure AD-App zur Benutzersynchronisierung und Power BI-Integration in Ihre Umbraco-Anwendung.

Konfigurieren Sie PowerBI für die Integration.

Gehen Sie zur Power BI Dashboard und melden Sie sich als Administrator an.

Sie werden mit dem Startbildschirm von Power BI dargestellt.

Klicken Sie oben rechts auf Einstellungssymbol wie unten gezeigt.

Unter dem Governance und Erkenntnisse Klicken Sie auf die Admin-Portal .

Im Admin-Portal Abschnitt unter dem Mietereinstellungen, scrollen Sie nach unten zu Entwicklereinstellungen.

Klicken Sie auf Erlauben Sie Dienstprinzipalen, Profile zu erstellen und zu verwenden.

Aktivieren Sie die Umschalten und dann auf klicken Tragen Sie.

PowerBI – Mandanteneinstellungen des Admin-Portals

Scrollen Sie nach unten zum Admin-API-Einstellungen, aktivieren Sie den Schalter und wählen Sie dann die Option aus bestimmte Sicherheitsgruppen.

Suchen Sie nach Umbraco Power BI-Benutzergruppe dann klicken Sie auf Tragen Sie.

Navigieren Sie zurück zur Startseite. Wähle aus Workspaces Klicken Sie im linken Bereich auf die Registerkarte und wählen Sie dann Ihren Arbeitsbereich aus der Liste aus.

Navigieren Sie zu der Zugriff verwalten Tab.

Im Zugriff verwalten Abschnitt, klicken Sie auf die Schaltfläche Hinzufügen Personen oder Gruppen hinzufügen.

PowerBI – Personen oder Gruppen hinzufügen

Suchen Sie nach der Anwendung, die Sie zuvor konfiguriert haben. Wählen Sie aus der Dropdown-Liste die aus Viewer und klicken Sie auf Speichern Schaltfläche, um diese Azure AD-Anwendung Ihrem Power BI-Arbeitsbereich.

Wähle aus berichten die Sie einbetten möchten in Umbraco-Seite oder -Beitrag.

Dann kopieren Sie die Workspace_ID als auch Berichts_ID Rufen Sie die URL auf, wie im Bild unten gezeigt, und halten Sie sie griffbereit, da Sie sie später noch benötigen.

Konfigurieren Sie das miniOrange-Plugin mit der PowerBI-Einstellung

Besuchen Sie die Umbraco-Anwendung.

Fügen Sie in der Basis-URL Ihrer Anwendung Folgendes hinzu: /?action=config Abfrageparameter.(/?action=config)

Sie werden mit dem Anmeldeformular, füllen Sie aus und klicken Sie auf das Registrieren-Button.

Nach der Registrierung wird Ihnen das miniOrange Admin Dashboard angezeigt.

Gehen Sie zur Authentifizierungseinstellungen Tab und geben Sie ein Client-ID, Client-Geheimnis und Mandanten-ID Ihrer Azure AD-Anwendung und klicken Sie dann auf „Speichern“.

Umbraco – Authentifizierungseinstellungen

Gehe jetzt zum Power BI-Einstellungen Registerkarte und geben Sie die Berichtsname, Workspace_ID als auch Berichts_ID Ihres Berichts.

Das Skript wird generiert und angezeigt Workspace_ID als auch Berichts_ID Ihrer Power BI-Bericht.

Melden Sie sich bei Ihrem Umbraco BackOffice-Konto an.

Klicken Sie auf der Registerkarte „Inhalt“ auf die Option „PowerBI-Berichte“.

In der Testversion von miniOrange können Sie erst nach der Anmeldung mit Ihrem Entra-ID-Konto auf den Bericht zugreifen. Klicken Sie auf die Schaltfläche „Anmelden“ und melden Sie sich mit Ihrem Entra-ID-Konto an.

Der PowerBI-Bericht wird Ihnen angezeigt, sobald Sie sich anmelden.

Kontakt aufnehmen

Bitte erreichen Sie uns unter umbracosupport@xecurify.com, und unser Team unterstützt Sie bei der Einrichtung der Power BI-Integration in Umbraco. Wir helfen Ihnen auch bei der Auswahl der am besten geeigneten Lösung oder des am besten geeigneten Plans basierend auf Ihren Anforderungen.

Inhalte