Comment intégrer des rapports Microsoft Power BI dans les applications Umbraco ?

Marché

Guide pour intégrer les rapports et tableaux de bord Power BI dans Umbraco. Intégrez Microsoft Power BI avec Umbraco à l'aide de Intégrateur miniOrange Power BI Plugin. Ce guide d'installation vous guidera pas à pas pour intégrer des rapports, tableaux de bord, vignettes, jeux de données ou modèles sémantiques Power BI à vos pages et publications Umbraco, permettant ainsi aux utilisateurs de visualiser des artefacts Power BI interactifs directement depuis le site Umbraco. Vous pouvez également activer la sécurité au niveau des lignes (RLS) pour une vue précise et personnalisée des graphiques Power BI dans Umbraco.

Télécharger

Plans de tarification

Pré-requis : Téléchargement Et Installation

L'intégrateur miniOrange Umbraco nécessite :

Une application Umbraco exécutée sur la version 9 à 15 ans, qui.

L'application doit être connectée à un MS SQL Server. (Sinon, nous pouvons vous suggérer la version appropriée en fonction de votre base de données.)

Si votre application n'utilise pas de base de données, nous pouvons également fournir une version qui fonctionne sans base de données.

A Microsoft Power BI compte.

Ajout de miniOrange à l'application Umbraco

Installez l' Package NuGet miniOrange PowerBI Integrator en utilisant le gestionnaire de packages Nuget ou la CLI.

Package NuGet

CLI .NET

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

Une fois installé, il suffit de créer l'application pour l'ajouter vues et fichiers statiques miniOrange.

Ajoutez les détails suivants dans votre programme.cs fichier.

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

Créez et exécutez l'application.

Configurer Azure AD pour l'intégration PowerBI

Nous allons effectuer quelques configurations PowerBI dans le tableau de bord miniOrange

1. Configurez l'enregistrement de l'application Azure AD

Se connecter à Entra ID portail en tant qu'administrateur.

L’écran d’accueil d’Azure Active Directory vous sera présenté.

Dans la section Services Azure, sélectionnez ID d'entrée Microsoft.

Azure Active Directory - Écran d'accueil

Dans l'onglet de gauche, sous la section Gérer, sélectionnez Inscriptions d'applications.

Azure Active Directory – Enregistrements d'applications

Cliquez sur nouvelle inscription.

Azure Active Directory – Nouvelles inscriptions

Attribuez le Nom du profil dans le champ du nom et choisissez le Type de compte.

Dans l' URI de redirection champ, indiquez l'URL de base de votre Site d'Umbraco et cliquez sur le S'enregistrer .

Azure Active Directory - Enregistrer une application

Après l'enregistrement d'une application, Azure AD attribue un identifiant unique ID d'application à votre application.

Accédez à la Onglet Présentation, dans le volet de gauche.

Copiez le ID d'application et la ID de répertoire, ce sera votre identité du client et ID du locataire.

Azure Active Directory - ID d'application unique

Dans le volet de navigation de gauche, accédez à Certificats et secrets languette.

Cliquez sur un nouveau secret client. Entrez la description et l'heure d'expiration et cliquez sur le ADD option.

Azure Active Directory – Certificats et secrets

Copiez la valeur de Clef secrète. Ce sera votre Clé secrète client.

2. Ajoutez des autorisations API à votre application Azure AD :

Allez dans Autorisations d'API dans le volet de navigation de gauche et cliquez sur ajouter une autorisation option.

Azure Active Directory – Autorisations API

Choisir Microsoft Graph sous le API Microsoft languette.

Choisir Autorisations d'application et recherchez le L'Utilisateur.

Sous L'Utilisateur Sélectionner Utilisateur.Lire et Utilisateur.Lire.Tout autorisations et cliquez sur le Ajouter des autorisations bouton. (graphique Microsoft)

Autorisations de lecture de l'utilisateur

Cliquez sur ajouter une autorisation, faites défiler vers le bas et sélectionnez Service Power BI sous l'option d'autorisation de l'API demandée.

Choisir Autorisation du délégué et recherchez le Rapport.

Sous Rapports Sélectionner Rapport.Lire.Tout autorisation et cliquez sur le Ajouter une autorisation bouton. (Power BI)

Vous pouvez maintenant voir toutes les autorisations dans le autorisation de l'API

Cliquez sur accorder le consentement de l'administrateur pour le répertoire par défaut et cliquez sur Oui lors de l'octroi de la confirmation du consentement de l'administrateur.

Accorder le consentement de l'administrateur

Vous avez configuré avec succès l'application Azure AD.

3. Configurer les paramètres du groupe de sécurité Azure AD

Dans la page d’accueil d’Azure Active Directory, accédez au Groupes Du panneau de gauche.

Cliquez sur Nouveau groupe pour ajouter un nouveau groupe de sécurité.

Sélectionnez le Type de groupe as Sécurité dans la liste déroulante et entrez le Nom du groupe as Autoriser les API d'administration Power BI.

Une fois que vous avez entré les détails, cliquez sur le Bouton Créer pour créer un nouveau groupe de sécurité.

Recherchez et sélectionnez les groupes de sécurité nouvellement créés (Autoriser les API d’administration Power BI).

Azure Active Directory – Nouveaux groupes de sécurité créés

Accédez à la Membres dans le volet de gauche et cliquez sur Ajouter des membres.

Azure Active Directory – Ajouter des membres

Recherchez maintenant le nom de l'application que vous avez précédemment configuré et cliquez sur le Sélectionner .

Vous avez configuré avec succès le Application Azure AD pour réaliser la synchronisation des utilisateurs et l'intégration de Power BI dans votre application Umbraco.

Configurer PowerBI pour l’intégration.

Rendez-vous dans la section Power BI tableau de bord et connectez-vous en tant qu'administrateur.

Vous serez représenté avec l’écran d’accueil de Power BI.

Dans le coin supérieur droit, cliquez sur icône des paramètres comme indiqué ci-dessous.

En vertu des Normes sur l’information et les communications, les organismes doivent rendre leurs sites et applications Web accessibles. Ils y parviennent en conformant leurs sites Web au niveau AA des Web Content Accessibility Guidelines (WCAG). gouvernance et perspectives cliquez sur le portail administrateur option.

Dans l' Portail d'administration section, sous la paramètres du locataire, faites défiler jusqu'au paramètres du développeur.

Cliquez sur Autoriser les principaux de service à créer et à utiliser des profils.

Activez la basculer puis cliquez sur Appliquer.

PowerBI - Paramètres du locataire du portail d'administration

Faites défiler jusqu'à la Paramètres de l'API d'administration, activez la bascule, puis choisissez l'option de groupes de sécurité spécifiques.

Recherchez Groupe d'utilisateurs Umbraco Power BI puis cliquez sur Appliquer.

Revenez à la page d'accueil. Sélectionnez le Espaces de travail dans le volet de gauche, puis sélectionnez votre espace de travail dans la liste.

Accédez à la Gérer l'accès languette.

Dans l' Gérer l'accès section, cliquez sur le bouton Ajouter Ajouter des personnes ou des groupes.

PowerBI - Ajouter des personnes ou des groupes

Recherchez l'application que vous avez précédemment configurée. Dans la liste déroulante, sélectionnez le Viewer et cliquez sur Ajouter bouton pour attribuer cette application Azure AD à votre Espace de travail Power BI.

Sélectionnez le rapport que vous souhaitez intégrer dans le Page ou article Umbraco.

Copiez ensuite le ID_espace de travail et ID_rapport à partir de l'URL comme indiqué dans l'image ci-dessous et conservez-la à portée de main car vous en aurez besoin ultérieurement.

Configurer le plugin miniOrange avec les paramètres PowerBI

Visitez l'application Umbraco.

Sur l'URL de base de votre application, ajoutez le /?action=config paramètre de requête.(/?action=config)

On vous montrera avec le Formulaire d'inscription, remplissez et cliquez sur le Bouton d'inscription.

Une fois inscrit, le tableau de bord d'administration de miniOrange s'affichera.

Rendez-vous dans la section Paramètres d'authentification onglet et entrez ID client, secret client et ID locataire de votre application Azure AD puis cliquez sur Enregistrer.

Maintenant, allez à la Paramètres Power BI onglet et entrez le Nom du rapport, Workspace_ID et ID_rapport de votre rapport.

Le script sera généré qui montre ID_espace de travail et ID_rapport de votre Rapport Power BI.

Connectez-vous à votre compte Umbraco BackOffice.

Dans l’onglet Contenu -> Cliquez sur l’option Rapports PowerBI.

Dans la version d'essai de miniOrange, vous ne pourrez accéder au rapport qu'après vous être connecté avec votre compte Entra ID. Cliquez sur le bouton « Connexion » et connectez-vous avec votre compte Entra ID.

Le rapport PowerBI vous sera présenté dès votre connexion.

Contactez-nous

Veuillez nous contacter à umbracosupport@xecurify.comNotre équipe vous accompagnera dans la mise en place de l'intégration Power BI dans Umbraco. Nous vous aiderons également à choisir la solution ou l'offre la plus adaptée à vos besoins.

Table des matières