Руководство. Внедрение содержимого Power BI в приложение для национальных и региональных облаков

  • Статья

Узнайте, как внедрить аналитическое содержимое в приложения бизнес-процессов для национального или регионального облака. Используйте пакет SDK для Power BI .NET с API JavaScript Power BI для внедрения отчета, панели мониторинга или плитки в веб-приложения.

Power BI поддерживает следующие национальные и региональные облака:

  • Облако сообщества государственных организаций США (GCC)

  • Облако сообщества государственных организаций США (GCC High)

  • Американские военные подрядчики (DoDCON)

  • Американские военные (DoD)

  • Power BI для облака Для Китая

Screenshot showing the Embed a dashboard feature.

Чтобы приступить к работе с этим пошаговом руководстве , вам нужна учетная запись Power BI. Если у вас нет учетной записи, в зависимости от типа правительства или страны или региона, вы можете выбрать подходящее национальное или региональное облако. Зарегистрируйтесь для учетной записи Power BI для государственных организаций США или учетной записи Power BI для Китая в облаке.

Примечание.

Вы хотите внедрить панель мониторинга для вашей организации? См . статью "Интеграция панели мониторинга" в приложение для вашей организации.

Чтобы интегрировать панель мониторинга в веб-приложение, используйте API Power BI и маркер доступа к авторизации Microsoft Entra для получения панели мониторинга. Загрузите панель мониторинга с помощью маркера внедрения. API Power BI предоставляет программный доступ к определенным ресурсам Power BI. Дополнительные сведения см. в статье REST API Power BI, пакет SDK для .NET Power BI и API JavaScript Power BI.

Скачивание примера приложения

В этой статье показано код для примера данных собственных приложений на GitHub. Чтобы следовать этому пошаговому руководству, скачайте пример. Мы используем .NET Framework/Embed for your customers каталог.

Важно!

Вы можете внедрить только содержимое Power BI из облака сообщества для государственных организаций (GCC) с помощью SKU Microsoft 365. Другие клиенты национального или регионального облака могут использовать номера SKU Microsoft 365 или Azure.

A screenshot that shows downloading the App Owns Data sample.

A screenshot that shows the App Owns Data directory.

  • Облако сообщества для государственных организаций (GCC):

    1. В файле конфигурации Web.config обновите applicationId (собственное приложениеapplicationId), workspaceIdимя пользователя (главный пользователь) и пароль.

    2. Затем добавьте параметры GCC следующим образом.

      <add key="authorityUrl" value="https://login.microsoftonline.com/organizations/" />
<add key="scopeBase" value="https://analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbigov.us/" />

  • Военные подрядчики (DoDCON):

    1. В файле конфигурации Web.config обновите applicationId (собственное приложениеapplicationId), workspaceIdимя пользователя (главный пользователь) и пароль.

    2. Затем добавьте параметры DoDCON следующим образом.

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://high.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.high.powerbigov.us/" />

  • Военные (DoD):

    1. В файле конфигурации Web.config обновите applicationId (собственное приложениеapplicationId), workspaceIdимя пользователя (главный пользователь) и пароль.

    2. Затем добавьте параметры DoDCON следующим образом.

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://mil.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.mil.powerbigov.us/" />

  • Параметры облака Power BI для Китая

    1. В файле конфигурации Web.config обновите applicationId (собственное приложениеapplicationId), workspaceIdимя пользователя (главный пользователь) и пароль.

    2. Затем добавьте параметры Облака Power BI для Китая следующим образом.

      <add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
<add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />

Шаг 1. Регистрация приложения в идентификаторе Microsoft Entra

Зарегистрируйте приложение с помощью идентификатора Microsoft Entra, чтобы выполнить вызовы REST API. Дополнительные сведения см. в статье "Регистрация приложения Microsoft Entra" для внедрения содержимого Power BI. Так как существуют различные национальные или региональные облачные принадлежности, существуют различные URL-адреса для регистрации приложения.

  • Облако сообщества государственных организаций (GCC) — https://app.powerbigov.us/apps

  • Военные подрядчики (DoDCON) - https://app.high.powerbigov.us/apps

  • Военные (DoD) - https://app.mil.powerbigov.us/apps

  • Power BI для облака Для Китая — https://app.powerbi.cn/apps

Если вы скачали внедрение для примера клиента, вы будете использовать applicationId его, чтобы этот пример можно было пройти проверку подлинности в идентификаторе Microsoft Entra. Чтобы настроить пример, измените applicationIdфайл web.config .

Шаг 2. Получение маркера доступа из идентификатора Microsoft Entra

В приложении необходимо получить маркер доступа из идентификатора Microsoft Entra, прежде чем выполнять вызовы к REST API Power BI. Дополнительные сведения см. в статье "Проверка подлинности пользователей" и получение маркера доступа Microsoft Entra для приложения Power BI. Так как существуют различные национальные и региональные облачные принадлежности, существуют различные URL-адреса для получения маркера доступа для вашего приложения.

  • Облако сообщества государственных организаций (GCC) — https://login.microsoftonline.com

  • Военные подрядчики (DoDCON) - https://login.microsoftonline.us

  • Военные (DoD) - https://login.microsoftonline.us

  • Power BI для облака Для Китая — https://login.chinacloudapi.cn

Примеры этих маркеров доступа можно просмотреть в каждой задаче элемента содержимого в файле Controllers\HomeController.cs .

Шаг 3. Внедрение содержимого

Теперь, когда у вас есть маркер доступа, вы можете продолжить внедрение, как и на любой другой платформе.

Связанный контент

Внедрение примера для клиентов

Power BI JavaScript API

Есть еще вопросы? Спросите Сообщество Power BI