События
Чемпионат мира Power BI DataViz
14 февр., 16 - 31 мар., 16
С 4 шансами войти, вы можете выиграть пакет конференции и сделать его в LIVE Grand Finale в Лас-Вегасе
ПодробнееЭтот браузер больше не поддерживается.
Выполните обновление до Microsoft Edge, чтобы воспользоваться новейшими функциями, обновлениями для системы безопасности и технической поддержкой.
ОБЛАСТЬ ПРИМЕНЕНИЯ: Приложение владеет данными, принадлежащими пользователю данных
Внедренная аналитика и Power BI Embedded (предложение Azure) позволяют внедрять содержимое Power BI, например отчеты, панели мониторинга и плитки, в приложение.
В этом руководстве описано следующее:
Чтобы использовать приложение, пользователям не нужно входить в Power BI или иметь лицензию Power BI.
Мы рекомендуем использовать внедрение для клиентов для внедрения содержимого Power BI, если вы являетесь независимым поставщиком программного обеспечения (ISV) или разработчиком, который хочет создать приложения для третьих сторон.
Важно!
Если вы внедряете содержимое для национального или регионального облака, первые несколько шагов этого руководства отличаются. Дополнительные сведения см. в разделе "Внедрение содержимого" для национальных и региональных облаков .
В этом руководстве содержатся инструкции по настройке внедрения для примера приложения для клиентов в одной из следующих платформ:
Примеры кода поддерживают следующие браузеры:
Перед началом работы с этим руководством убедитесь, что у вас есть следующие зависимости Power BI и кода:
Зависимости Power BI
Собственный клиент Microsoft Entra.
Чтобы выполнить проверку подлинности приложения в Power BI, необходимо выполнить одно из следующих действий.
Субъект-служба — объект субъекта-службы Microsoft Entra, позволяющий идентификатору Microsoft Entra пройти проверку подлинности приложения.
Лицензия Power BI Pro — это главный пользователь , и приложение использует его для проверки подлинности в Power BI.
Лицензия Power BI Premium на пользователя (PPU) — это главный пользователь , и приложение использует его для проверки подлинности в Power BI.
Примечание
Для перехода в рабочую среду потребуется емкость.
Зависимости кода
Пакет SDK для .NET Core 3.1 (или более поздней версии)
Интегрированная среда разработки (IDE). Рекомендуется использовать одну из следующих сред:
Чтобы создать внедрение для примера приложения для клиентов , выполните следующие действия.
Выберите метод проверки подлинности.
Зарегистрируйте приложение Microsoft Entra.
Создайте рабочую область Power BI.
Создание и публикация отчета Power BI.
Получение значений параметров внедрения.
Включите доступ к рабочей области.
Встроенное решение зависит от выбранного метода проверки подлинности. Поэтому важно понять различия между методами проверки подлинности и решить, какой из них лучше всего подходит для вашего решения.
В следующей таблице описано несколько ключевых различий между субъектом-службой и основными методами проверки подлинности пользователей.
Фактор | Субъект-служба | Главный пользователь |
---|---|---|
Механизм | Объект субъекта-службы приложения Microsoft Entra позволяет Идентификатору Microsoft Entra пройти проверку подлинности внедренного приложения решения в Power BI. | Приложение Microsoft Entra использует учетные данные (имя пользователя и пароль) пользователя Power BI для проверки подлинности в Power BI. |
Безопасность |
Субъект-служба — это рекомендуемый метод авторизации идентификатора Microsoft Entra. Если вы используете субъект-службу, вы можете пройти проверку подлинности с помощью секрета приложения или В этом руководстве описывается только использование субъекта-службы с секретом приложения. Чтобы внедрить субъект-службу и сертификат, обратитесь к субъекту-службе с помощью статьи сертификата. |
Этот метод проверки подлинности не является таким безопасным, как субъект-служба. Необходимо быть бдительным с учетными данными главного пользователя (имя пользователя и пароль). Например, не предоставляйте их в приложении внедрения и часто изменяйте пароль. |
Делегированные разрешения идентификатора Microsoft Entra | Необязательно. | Главный пользователь или администратор должен предоставить свое согласие на доступ к разрешениям REST API Power BI (также известным как области). Например, Report.ReadWrite.All. |
доступ служба Power BI | Доступ к служба Power BI с помощью субъекта-службы невозможно. | Вы можете получить доступ к служба Power BI с учетными данными главного пользователя. |
Лицензия | Не требуется лицензия Pro. Вы можете использовать содержимое из любой рабочей области, в которую вы являетесь членом или администратором. | Требуется лицензия Power BI Pro или Premium на пользователя (PPU). |
Регистрация приложения с помощью идентификатора Microsoft Entra позволяет:
Чтобы зарегистрировать приложение с помощью идентификатора Microsoft Entra, следуйте инструкциям в разделе "Регистрация приложения".
Примечание
Перед регистрацией приложения необходимо решить, какой метод проверки подлинности будет использоваться, субъект-служба или главный пользователь.
Microsoft Fabric хранит отчеты, панели мониторинга и плитки в рабочей области. Чтобы внедрить эти элементы, необходимо создать их и отправить их в рабочую область.
Совет
Если у вас уже есть рабочая область, можно пропустить этот шаг.
Чтобы создать рабочую область, сделайте следующее:
Следующий шаг — создать отчет и отправить его в рабочую область. Вы можете создать собственный отчет с помощью Power BI Desktop, а затем опубликовать его в рабочей области. Кроме того, вы можете отправить пример отчета в рабочую область.
Совет
Если у вас уже есть рабочая область с отчетом, можно пропустить этот шаг.
Чтобы скачать пример отчета (не включено Direct Lake) и опубликовать его в рабочей области, выполните следующие действия.
Откройте папку примеров GitHub Power BI Desktop.
Выберите "Код" и выберите "Скачать ZIP-файл".
Извлеките скачанный ZIP-файл и перейдите в папку "Отчеты примеров ".
Выберите отчет для внедрения и публикации в рабочей области.
Примечание
Если в отчете используется семантическая модель Direct Lake, убедитесь, что вы проверили эти ограничения ,.
Чтобы внедрить содержимое, необходимо получить определенные значения параметров. В следующей таблице показаны необходимые значения и указываются, применимы ли они к методу проверки подлинности субъекта-службы , методу проверки подлинности главного пользователя или обоим.
Перед внедрением содержимого убедитесь, что у вас есть все значения, перечисленные ниже. Некоторые значения могут отличаться в зависимости от используемого метода проверки подлинности.
Параметр | Субъект-служба | Главный пользователь |
---|---|---|
Идентификатор клиента |
![]() |
![]() |
Идентификатор рабочей области |
![]() |
![]() |
Идентификатор отчета |
![]() |
![]() |
Секрет клиента |
![]() |
![]() |
Идентификатор клиента |
![]() |
требуется только для JS узла |
Имя пользователя Power BI |
![]() |
![]() |
Пароль Power BI |
![]() |
![]() |
Совет
Область применения:главный пользователь субъекта-службы
Чтобы получить ИДЕНТИФИКАТОР клиента (также известный как идентификатор приложения), выполните следующие действия:
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
Из раздела "Обзор" скопируйте ИДЕНТИФИКАТОР идентификатора приложения (клиента).
Совет
Область применения:главный пользователь субъекта-службы
Чтобы получить GUID идентификатора рабочей области, выполните следующие действия.
Выполните вход в службу Power BI.
Откройте отчет, который требуется внедрить.
Скопируйте GUID из URL-адреса. GUID — это число между /groups/ и /reports/.
Кроме того, можно найти идентификатор рабочей области в параметрах портала администрирования, выбрав "Сведения" рядом с именем рабочей области.
Совет
Область применения:главный пользователь субъекта-службы
Чтобы получить guid идентификатора отчета, выполните следующие действия.
Выполните вход в службу Power BI.
Откройте отчет, который требуется внедрить.
Скопируйте GUID из URL-адреса. GUID — это число между /reports/ и /ReportSection.
Совет
Область применения:главный пользователь субъекта-службы
Чтобы получить секрет клиента, выполните приведенные ниже действия.
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
В разделе Управление выберите Сертификаты и секреты.
В разделе Секреты клиента выберите Новый секрет клиента.
Во всплывающем окне "Добавление секрета клиента" укажите описание секрета приложения, выберите, когда срок действия секрета приложения истекает, и нажмите кнопку "Добавить".
Из раздела секретов клиента скопируйте строку в столбце Value созданного секрета приложения. Значение секрета клиента — это идентификатор клиента.
Примечание
Скопируйте значение секрета клиента при первом появлении. После перехода от этой страницы секрет клиента будет скрыт, и вы не сможете получить его значение.
Совет
Область применения:главный пользователь субъекта-службы
Чтобы получить GUID идентификатора клиента, выполните следующие действия.
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
В разделе "Обзор" скопируйте GUID идентификатора каталога (клиента).
Совет
Область применения:главный пользователь субъекта-службы
Получите имя пользователя и пароль пользователя Power BI, который вы используете в качестве главного пользователя. Это тот же пользователь, который использовался для создания рабочей области и отправки отчета в служба Power BI.
Совет
Область применения:главный пользователь субъекта-службы
Этот шаг относится только к использованию метода проверки подлинности субъекта-службы . Если вы используете основного пользователя, пропустите этот шаг и перейдите к шагу 7. Включите доступ к рабочей области.
Чтобы приложение Microsoft Entra могло получить доступ к содержимому и API Power BI, администратор Power BI должен включить доступ к субъекту-службе на портале администрирования Power BI. Если вы не являетесь администратором клиента, получите администратора клиента, чтобы включить параметры клиента.
В служба Power BI выберите портал администрирования параметров>
Выберите параметры клиента и прокрутите вниз до раздела "Параметры разработчика".
Разверните субъекты-службы, чтобы использовать API Fabric и включить этот параметр.
Примечание
При использовании субъекта-службы рекомендуется ограничить доступ к параметрам клиента с помощью группы безопасности. Дополнительные сведения об этой функции см. в следующих разделах статьи субъекта-службы :
Чтобы включить объекты доступа к приложению Microsoft Entra, такие как отчеты, панели мониторинга и семантические модели в служба Power BI, добавьте субъекта-службы или основного пользователя в качестве члена или администратора в рабочую область.
Войдите в Fabric.
Прокрутите страницу до рабочей области, для которой требуется включить доступ, и выберите пункт "Управление доступом".
В области Access в зависимости от используемого метода проверки подлинности скопируйте субъект-службу или основного пользователя в текстовое поле "Ввод адреса электронной почты".
Примечание
Если вы используете субъект-службу, его имя — это имя, которое вы предоставили приложению Microsoft Entra.
Выберите Добавить.
Пример приложения Power BI embedded позволяет создавать внедрение приложения Power BI для клиентов .
Выполните следующие действия, чтобы изменить внедрение примера приложения для клиентов , чтобы внедрить отчет Power BI.
Откройте папку примеров разработчика Power BI.
Выберите "Код" и выберите "Скачать ZIP-файл".
Извлеките скачанный ZIP-файл и перейдите в папку PowerBI-Developer-Samples-master .
В зависимости от языка, который вы хотите использовать приложение, откройте одну из следующих папок:
Примечание
Внедрение примеров приложений для клиентов поддерживает только платформы, перечисленные выше. Пример приложения React поддерживает только внедрение решения организации .
Откройте папку Внедрения для клиентов .
Откройте пример приложения для клиентов, используя один из следующих методов:
Если вы используете Visual Studio, откройте файл AppOwnsData.sln .
Если вы используете Visual Studio Code, откройте папку AppOwnsData .
Откройте appsettings.json.
В зависимости от метода проверки подлинности заполните следующие значения параметров:
Параметр | Субъект-служба | Главный пользователь |
---|---|---|
AuthenticationMode |
ServicePrincipal | MasterUser |
ClientId |
Идентификатор клиента приложения Microsoft Entra | Идентификатор клиента приложения Microsoft Entra |
TenantId |
Идентификатор клиента Microsoft Entra | Неприменимо |
PbiUsername |
Неприменимо | Имя пользователя master, см. в разделе "Имя пользователя и пароль Power BI" |
PbiPassword |
Неприменимо | Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI" |
ClientSecret |
Секрет клиента идентификатора Microsoft Entra | Неприменимо |
WorkspaceId |
Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области" | Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области" |
ReportId |
Идентификатор внедренного отчета см. в разделе "Идентификатор отчета" | Идентификатор внедренного отчета см. в разделе "Идентификатор отчета" |
Запустите проект, выбрав соответствующий параметр:
Если вы используете Visual Studio, выберите IIS Express (воспроизведение).
Если вы используете Visual Studio Code, выберите "Запустить > отладку".
После настройки и запуска внедрения для клиентов примера приложения можно начать разработку собственного приложения.
Попробуйте воспользоваться игровой площадкой встроенной аналитики Power BI, чтобы приступить к разработке и следить за всеми новыми функциями и обновлениями Power BI Embedded.
Когда вы будете готовы, просмотрите требования к рабочей среде . Вам также потребуется емкость и ознакомьтесь со статьей по планированию емкости, чтобы установить, какой номер SKU лучше подходит для ваших потребностей.
Важно!
Если вы использовали бесплатные маркеры пробной версии для разработки, необходимо приобрести емкость для рабочей среды. Пока емкость не будет приобретена, баннер бесплатной пробной версии будет по-прежнему отображаться в верхней части внедренного отчета.
Следующие ограничения применяются к режиму Direct Lake:
Есть еще вопросы? Спросите Сообщество Power BI.
События
Чемпионат мира Power BI DataViz
14 февр., 16 - 31 мар., 16
С 4 шансами войти, вы можете выиграть пакет конференции и сделать его в LIVE Grand Finale в Лас-Вегасе
ПодробнееОбучение
Схема обучения
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Сертификация
Демонстрация методов и рекомендаций, которые соответствуют бизнес-и техническим требованиям для моделирования, визуализации и анализа данных с помощью Microsoft Power BI.
Документация
Внедрение отчета Power BI в приложение встроенной аналитики Power BI для клиентов - Power BI
Узнайте, как внедрить отчет Power BI в приложение встроенной аналитики Power BI для клиентов с помощью этого руководства.
Внедрение содержимого в приложение встроенной аналитики Power BI для вашей организации - Power BI
Узнайте, как интегрировать Power BI в приложение для предоставления аналитических сведений для вашей организации с помощью встроенного программного обеспечения и средств аналитики.
Маркеры разрешений, необходимые для внедрения приложения Power BI - Power BI
Узнайте, какие маркеры приложения Power BI должны пройти проверку подлинности в Azure и служба Power BI.