Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Встроенная аналитика Power BI позволяет внедрять содержимое Power BI, например отчеты, панели мониторинга и плитки, в приложение.
Из этого руководства вы узнаете, как выполнять следующие задачи:
- Настройте внедренную среду.
- Настройте внедрение для вашей организации (также известное как данные, принадлежащие пользователям) пример приложения.
Чтобы использовать приложение, пользователям потребуется войти в Power BI.
Встраивание решения для вашей организации обычно используется предприятиями и крупными организациями и предназначено для внутренних пользователей.
Внимание
Если вы внедряете содержимое для национального или регионального облака, первые несколько шагов этого руководства отличаются. Дополнительные сведения см. в разделе "Внедрение содержимого" для национальных и региональных облаков .
Спецификации примеров кода
В этом руководстве содержатся инструкции по настройке внедрения примера приложения для вашей организации в одном из следующих фреймворков:
- Платформа .NET Framework
- .NET Core
- React TypeScript
Примечание.
Примеры .NET Core и .NET Framework позволяют пользователю просматривать любую панель мониторинга, плитку или отчет Power BI, к ней есть доступ в службе Power BI. Пример React TypeScript позволяет внедрить только один отчет, к которому у конечного пользователя уже есть доступ в службе Power BI.
Примеры кода поддерживают следующие браузеры:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Предварительные требования
Перед началом работы с этим руководством убедитесь, что у вас есть следующие зависимости Power BI и кода:
Зависимости Power BI
Собственный клиент Microsoft Entra.
Одна из следующих лицензий:
Microsoft Fabric
Примечание.
Чтобы переместить внедренное приложение в рабочую среду, вам потребуется одна из следующих конфигураций:
- Все пользователи с лицензиями Pro.
- Все пользователи с лицензиями PPU.
- Номер SKU, эквивалентный или более высокому номеру SKU F64. Эта конфигурация позволяет всем пользователям иметь бесплатные лицензии.
Зависимости кода
Пакет SDK для .NET Core 3.1 (или более поздней версии)
Интегрированная среда разработки (IDE). Рекомендуется использовать одну из следующих сред разработки:
Способ
Чтобы создать встраивание для образца приложения вашей организации, выполните следующие действия.
- Зарегистрируйте приложение Microsoft Entra.
- Создайте рабочую область Power BI.
- Создание и публикация отчета Power BI.
- Получение значений параметров внедрения.
- Внедрение содержимого.
Шаг 1. Регистрация приложения Microsoft Entra
Регистрация вашего приложения в Microsoft Entra ID позволяет установить его идентификацию.
Чтобы зарегистрировать приложение с помощью идентификатора Microsoft Entra, следуйте инструкциям в разделе "Регистрация приложения".
Шаг 2. Создание рабочей области Power BI
Microsoft Fabric хранит отчеты, панели мониторинга и плитки в рабочей области. Чтобы внедрить эти элементы, нужно создать их и загрузить в рабочую область.
Совет
Если у вас уже есть рабочая область, можно пропустить этот шаг.
Чтобы создать рабочую область, сделайте следующее:
- Войдите в Fabric.
- Выберите Workspaces.
- Выберите +Создать рабочую область.
- Назовите рабочую область и нажмите кнопку "Применить".
Шаг 3. Создание и публикация отчета Power BI
Следующий шаг — создать отчет и загрузить его в рабочую область. Вы можете создать собственный отчет с помощью Power BI Desktop, а затем опубликовать его в рабочей области. Вы можете загрузить образец отчета в рабочую область.
Совет
Если у вас уже есть рабочая область с отчетом, можно пропустить этот шаг.
Чтобы скачать пример отчета (не с поддержкой Direct Lake) и опубликовать его в рабочей области, выполните следующие действия.
Откройте папку Power BI Desktop samples на GitHub.
Выберите "Код" и выберите "Скачать ZIP- файл".
Извлеките скачанный ZIP-файл и перейдите в папку "Примеры отчетов ".
Выберите отчет для встраивания и опубликуйте его в своей рабочей области.
Шаг 4. Получение значений параметров внедрения
Чтобы внедрить содержимое, необходимо получить несколько значений параметров. Значения параметров зависят от языка примера приложения, которое вы хотите использовать. В таблице ниже перечислены значения параметров, необходимые для каждого примера.
| Параметр | .NET Core | Платформа .NET Framework | React TypeScript |
|---|---|---|---|
| Идентификатор клиента | 
|
|
|
| Секрет клиента |
|
|
|
| Идентификатор рабочей области |
|
|
|
| Идентификатор отчета |
|
|
|
Идентификатор клиента
Совет
Область применения:.NET Core платформа .NET Framework React TypeScript
Чтобы получить GUID идентификатора клиента (также известный как идентификатор приложения), выполните следующие действия:
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
Из раздела «Обзор» скопируйте GUID ИД приложения (клиента).
Секрет клиента
Совет
Область применения:.NET Core платформа .NET Framework React TypeScript
Чтобы получить секрет клиента, выполните приведенные ниже действия.
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
В разделе Управление выберите Сертификаты и секреты.
В разделе Секреты клиента выберите Новый секрет клиента.
Во всплывающем окне "Добавление секрета клиента" укажите описание секрета приложения, выберите, когда срок действия секрета приложения истекает, и нажмите кнопку "Добавить".
Из раздела секретов клиента скопируйте строку в столбце Value созданного секрета приложения. Значение секрета клиента — это ваш идентификатор клиента.
Примечание.
Убедитесь, что вы копируете значение секретного ключа клиента, когда оно появляется впервые. После перехода от этой страницы секрет клиента будет скрыт, и вы не сможете получить его значение.
Идентификатор рабочей области
Совет
Область применения:.NET Core платформа .NET Framework React TypeScript
Чтобы получить GUID идентификатора рабочей области, выполните следующие действия.
Выполните вход в службу Power BI.
Откройте отчет, который требуется внедрить.
Скопируйте GUID из URL. GUID — это число между /groups/ и /reports/.
Идентификатор отчета
Совет
Область применения:.NET Core платформа .NET Framework React TypeScript
Чтобы получить GUID идентификатора отчета, выполните следующие действия.
Выполните вход в службу Power BI.
Откройте отчет, который требуется внедрить.
Скопируйте GUID из URL. GUID — это число между /reports/ и /ReportSection.
Шаг 5. Внедрение содержимого
Пример встроенного приложения Power BI позволяет создать встраивание для приложения Power BI вашей организации.
Выполните следующие действия, чтобы изменить встраивание образца приложения для вашей организации и встроить отчет Power BI.
Откройте папку примеров разработчика Power BI.
Выберите "Код" и выберите "Скачать ZIP- файл".
Извлеките скачанный ZIP-файл и перейдите в папку PowerBI-Developer-Samples-master .
Откройте одну из следующих папок в зависимости от языка, который будет использоваться приложением:
- .NET Core
- Платформа .NET Framework
- React-TS
Примечание.
Встраивание образцов приложений для вашей организации поддерживает только ранее перечисленные фреймворки. Примеры приложений Java, Node JS и Python поддерживают только решение по встраиванию для ваших клиентов.
Настройка приложения Microsoft Entra
- Войдите на портал Azure.
- Щелкните Регистрация приложений. Если этот параметр не отображается, найдите его.
- Откройте приложение Microsoft Entra, созданное на шаге 1. Зарегистрируйте приложение Microsoft Entra.
- В меню "Управление" выберите "Проверка подлинности".
В конфигурациях платформы откройте веб-платформу и в разделе URI перенаправления добавьте
https://localhost:5000/signin-oidc.Примечание.
Если у вас нет веб-платформы , нажмите кнопку "Добавить платформу". Затем в окне "Настройка платформ" выберите "Интернет".
Сохраните изменения.
Настройка примера приложения внедрения
Откройте папку Внедрения для вашей организации .
Откройте приложение встраивания примера приложения вашей организации с помощью одного из следующих методов:
Если вы используете Visual Studio, откройте файл UserOwnsData.sln .
Если вы используете Visual Studio Code, откройте папку UserOwnsData .
Откройте appsettings.json и заполните следующие значения параметров:
ClientId- используйте GUID идентификатора клиентаClientSecret— использование секрета клиента
Запуск примера приложения
Запустите проект, выбрав соответствующий параметр:
Если вы используете Visual Studio, выберите IIS Express (воспроизведение).
Если вы используете Visual Studio Code, выберите "Запустить > отладку".
Войдите в образец приложения для встраивания.
Примечание.
Во время первого входа вам будет предложено предоставить доступ Microsoft Entra для приложения.
При загрузке примера приложения выберите содержимое Power BI, которое вы хотите внедрить, а затем выберите "Внедрить".
Разработка приложения
После настройки и запуска внедряемого для ваших клиентов приложения-примера, вы можете начать разрабатывать собственное приложение.
Обновление разрешений пользователя
Пользователям требуется разрешение на доступ к папке Power BI, в ней находится отчет. При предоставлении пользователю разрешения на доступ к папке изменение обычно вступает в силу только после входа пользователя на портал Power BI. Чтобы новые разрешения вступают в силу немедленно, в сценарии Embedded выполните явный вызов REST API обновления разрешений пользователей при запуске. Этот вызов API обновляет разрешения и избегает сбоев авторизации для пользователей с новыми предоставленными разрешениями.