Как встроить отчеты Microsoft Power BI в приложения Umbraco?

Обзор

Руководство по встраиванию отчетов и панелей мониторинга Power BI в UmbracoИнтегрируйте Microsoft Power BI с Umbraco, используя... miniOrange Power BI Integrator Этот плагин. Данное руководство по настройке шаг за шагом покажет вам, как встроить отчеты, панели мониторинга, плитки, наборы данных или семантические модели Power BI в ваши страницы и публикации Umbraco, позволяя пользователям просматривать интерактивные артефакты Power BI непосредственно с сайта Umbraco. Вы также можете включить безопасность на уровне строк (RLS) для более детального и персонализированного просмотра диаграмм Power BI в Umbraco.

Скачать

Тарифный план

Предварительные условия: загрузка и установка

Для работы miniOrange Umbraco Integrator требуется:

Приложение Umbraco, работающее на версии 9 - 15.

Приложение должно быть подключено к MS SQL Server(В противном случае мы можем предложить подходящую версию, исходя из вашей базы данных.)

Если ваше приложение не использует базу данных, мы также можем предоставить работающую версию. без базы данных.

A Microsoft Power BI счет.

Добавление miniOrange в приложение Umbraco

Установить Пакет NuGet miniOrange PowerBI Integrator используя менеджер пакетов Nuget или интерфейс командной строки.

Пакет NuGet

.NET интерфейс командной строки

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

После установки просто соберите приложение, чтобы добавить его. Представления miniOrange и статические файлы.

Добавьте следующие данные в свой файл программа.cs .

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

Соберите и запустите приложение.

Настройка Azure AD для интеграции с PowerBI

Мы выполним некоторые настройки PowerBI внутри панели мониторинга miniOrange.

1. Настройте регистрацию приложения Azure AD.

Войти в Azure AD портал в качестве администратора.

Вам будет показан главный экран Azure Active Directory.

В разделе «Службы Azure» выберите Идентификатор Майкрософт Энтра.

На левой вкладке, в разделе «Управление», выберите Регистрация приложений.

Azure Active Directory — регистрация приложений

Нажмите на новая регистрация.

Azure Active Directory — регистрация новых пользователей

Назначьте Display Name в поле имени и выберите тип аккаунта.

В URI перенаправления в поле укажите базовый URL-адрес вашего Сайт Umbraco и нажмите на Зарегистрировать филиал .

Azure Active Directory — регистрация приложения

После регистрации приложения Azure AD присваивает уникальный идентификатор. ID приложения к вашему приложению.

Перейдите в Обзорная вкладка, на левой панели.

Скопируйте ID приложения и Идентификатор каталога, это будет ваш идентификатор клиента и Идентификатор арендатора.

Azure Active Directory — уникальный идентификатор приложения.

В левой панели навигации перейдите к Сертификаты и секреты меню.

Нажмите на секрет нового клиентаВведите описание и срок действия, затем нажмите кнопку. ДОБАВИТЬ опцию.

Azure Active Directory — Сертификаты и секреты

Скопируйте значение Secret Key. Это будет твой Секретный ключ клиента.

2. Добавьте разрешения API в ваше приложение Azure AD:

Перейдите на Разрешения API в левой панели навигации нажмите на добавить разрешение опцию.

Выберите График Microsoft под API Microsoft меню.

Выберите Разрешения приложения и поиск Информация о пользователе.

Под Информация о пользователе выберите Пользователь.Чтение и Пользователь.Читать.Все разрешения и нажмите на Добавить разрешения кнопка (Microsoft Graph)

Пользователь имеет доступ ко всем данным.

Нажмите «Добавить разрешение», прокрутите вниз и выберите Служба PowerBI в разделе «Параметры разрешений API для запросов».

Выберите Разрешение делегата и поиск Отчет.

Под Согласно отчетам выберите Отчет.Прочитать.Все разрешение и нажмите на Добавить разрешение кнопка. (Power BI)

Теперь вы можете увидеть все разрешения в разрешение API .

Нажмите на Предоставить администратору согласие на доступ к каталогу по умолчанию и нажмите на Да при подтверждении согласия администратора гранта.

Приложение Azure AD успешно настроено.

3. Настройте параметры группы безопасности Azure AD.

На главной странице Azure Active Directory перейдите по следующему пути: Группы с левой панели.

Нажмите на Новая группа добавить новую группу безопасности.

Выберите Тип группы as Безопасность. из раскрывающегося списка и введите Название группы as Разрешить доступ к API администратора Power BI.

После ввода данных нажмите на кнопку Создать кнопку создать новую группу безопасности.

Найдите и выберите недавно созданные группы безопасности (Разрешить доступ к API администратора Power BI).

Azure Active Directory — Новые созданные группы безопасности

Перейдите в Участники В левой панели выберите вкладку и нажмите на Добавить участников.

Azure Active Directory — Добавление участников

Теперь найдите ранее настроенное вами название приложения и нажмите на него. выберите .

Вы успешно настроили Приложение Azure AD для синхронизации пользователей и интеграции Power BI с вашим приложением Umbraco.

Настройте PowerBI для интеграции.

Перейдите на сайт Power BI Войдите в панель управления и войдите как администратор.

На экране отобразится главный экран Power BI.

В правом верхнем углу нажмите на значок настроек как показано ниже.

Под управление и аналитика нажмите на административный портал опцию.

В Административный портал раздел под настройки арендатора, прокрутите вниз до настройки разработчика.

Нажмите на Разрешите субъектам служб создавать и использовать профили.

Включите тумблер а затем нажмите Применить.

PowerBI — Настройки клиента на административном портале

Прокрутите вниз до Настройки административного APIВключите переключатель, а затем выберите соответствующий вариант. конкретные группы безопасности.

Найдите Группа пользователей Umbraco Power BI затем нажмите Применить.

Вернитесь на главную страницу. Выберите Workspaces Откройте вкладку в левой панели, затем выберите свою рабочую область из списка.

Перейдите в Управление доступом меню.

В Управление доступом в разделе нажмите «Добавить» Добавить людей или группы.

PowerBI — добавление пользователей или групп

Найдите приложение, которое вы ранее настроили. В выпадающем списке выберите его. программа просмотра и нажмите на Добавить кнопка для назначения этого приложения Azure AD вашему Рабочее пространство Power BI.

Выберите докладе то, что вы хотите встроить в Страница или сообщение в Umbraco.

Затем скопируйте Идентификатор_рабочей_области и Report_ID Перейдите по указанной ниже ссылке и сохраните её, так как она вам понадобится в дальнейшем.

Настройка плагина miniOrange с параметрами PowerBI

Откройте приложение Umbraco.

В базовый URL-адрес вашего приложения добавьте следующее: /?action=config параметр запроса.(/?action=config)

Вам будет показано следующее: Регистрационная формаЗаполните форму и нажмите на нее. Кнопка регистрации.

После регистрации вам будет показана панель администратора miniOrange.

Перейдите на сайт Настройки аутентификации Нажмите клавишу Tab и введите Идентификатор клиента, секретный ключ клиента и идентификатор арендатора. Затем в вашем приложении Azure AD нажмите «Сохранить».

Теперь перейдите к Настройки Power BI вкладка и введите Название отчета, Идентификатор рабочей области и Report_ID вашего отчета.

Будет сгенерирован скрипт, который покажет... Идентификатор_рабочей_области и Report_ID вашей Отчет Power BI.

Войдите в свою учетную запись Umbraco BackOffice.

На вкладке «Содержимое» -> нажмите на опцию «Отчеты PowerBI».

В пробной версии miniOrange доступ к отчету возможен только после входа в систему с помощью учетной записи Entra ID. Нажмите кнопку «Войти» и войдите в систему, используя учетную запись Entra ID.

Отчет PowerBI будет отображен сразу после входа в систему.

Контакт

Пожалуйста, свяжитесь с нами по адресу umbracosupport@xecurify.comНаша команда поможет вам настроить интеграцию Power BI с Umbraco. Мы также поможем вам выбрать наиболее подходящее решение или тарифный план в зависимости от ваших потребностей.

Содержание: