Руководство по внедрению содержимого Power BI с помощью примера внедрения для приложения клиентов

ОБЛАСТЬ ПРИМЕНЕНИЯ: Приложение владеет данными, принадлежащими пользователю данных

Внедренная аналитика и Power BI Embedded (предложение Azure) позволяют внедрять содержимое Power BI, например отчеты, панели мониторинга и плитки, в приложение.

В этом руководстве описано следующее:

• Настройте внедренную среду.
• Настройте внедрение для клиентов (также известных как данные, принадлежащие приложению) пример приложения.

Чтобы использовать приложение, пользователям не нужно входить в Power BI или иметь лицензию Power BI.

Мы рекомендуем использовать внедрение для клиентов для внедрения содержимого Power BI, если вы являетесь независимым поставщиком программного обеспечения (ISV) или разработчиком, который хочет создать приложения для третьих сторон.

Внимание

Если вы внедряете содержимое для национального или регионального облака, первые несколько шагов этого руководства отличаются. Дополнительные сведения см. в разделе "Внедрение содержимого" для национальных и региональных облаков .

Спецификации примеров кода

В этом руководстве содержатся инструкции по настройке внедрения для примера приложения для клиентов в одной из следующих платформ:

• .NET Framework
• .NET Core
• Java
• Node.js
• Python

Примеры кода поддерживают следующие браузеры:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Необходимые компоненты

Перед началом работы с этим руководством убедитесь, что у вас есть следующие зависимости Power BI и кода:

• Зависимости Power BI

  • Собственный клиент Microsoft Entra.

  • Чтобы выполнить проверку подлинности приложения в Power BI, необходимо выполнить одно из следующих действий.

    • Субъект-служба — объект субъекта-службы Microsoft Entra, позволяющий идентификатору Microsoft Entra пройти проверку подлинности приложения.

    • Лицензия Power BI Pro — это главный пользователь , и приложение использует его для проверки подлинности в Power BI.

    • Лицензия Power BI Premium на пользователя (PPU) — это главный пользователь , и приложение использует его для проверки подлинности в Power BI.

    Примечание.

    Для перехода в рабочую среду потребуется емкость.

• Зависимости кода

.NET Core

• Пакет SDK для .NET Core 3.1 (или более поздней версии)

• Интегрированная среда разработки (IDE). Рекомендуется использовать одну из следующих сред:

  • Visual Studio

  • Visual Studio Code

.NET Framework

• .NET Framework 4.8

• Visual Studio

Java

• JDK (или JRE)

• Интегрированная среда разработки Eclipse— убедитесь, что у вас есть Eclipse для разработчиков Java EE (корпоративный выпуск)

• Двоичные дистрибутивы Apache Tomcat

Node.js

• Node.js

• Интегрированная среда разработки (IDE). Рекомендуется использовать одну из следующих сред:

  • Visual Studio

  • Visual Studio Code

Python

• Python 3 (или более поздней версии)

  Примечание.

  • Если вы впервые устанавливаете Python, выберите параметр "Добавить Python в PATH", чтобы добавить установку в PATH переменную.
  • Если вы уже установили Python , убедитесь, что PATH переменная содержит путь установки. Дополнительные сведения см. в статье Excursus: настройка документации по переменным среды Python (эта ссылка относится к Python 3).

• Интегрированная среда разработки (IDE). Рекомендуется использовать одну из следующих сред:

  • Visual Studio

  • Visual Studio Code

Способ

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

1. Выберите метод проверки подлинности.

2. Зарегистрируйте приложение Microsoft Entra.

3. Создайте рабочую область Power BI.

4. Создание и публикация отчета Power BI.

5. Получение значений параметров внедрения.

6. Доступ к API субъекта-службы

7. Включите доступ к рабочей области.

8. Внедрение содержимого.

Шаг 1. Выбор метода проверки подлинности

Встроенное решение зависит от выбранного метода проверки подлинности. Поэтому важно понять различия между методами проверки подлинности и решить, какой из них лучше всего подходит для вашего решения.

В следующей таблице описано несколько ключевых различий между субъектом-службой и основными методами проверки подлинности пользователей.

Фактор	Субъект-служба	Главный пользователь
Механизм	Объект субъекта-службы приложения 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).

Шаг 2. Регистрация приложения Microsoft Entra

Регистрация приложения с помощью идентификатора Microsoft Entra позволяет:

• Установка удостоверения для приложения
• Предоставление приложению доступа к REST API Power BI
• Если вы используете основного пользователя . Укажите разрешения REST приложения Power BI

Чтобы зарегистрировать приложение с помощью идентификатора Microsoft Entra, следуйте инструкциям в разделе "Регистрация приложения".

Примечание.

Перед регистрацией приложения необходимо решить, какой метод проверки подлинности будет использоваться, субъект-служба или главный пользователь.

Шаг 3. Создание рабочей области Power BI

Power BI сохраняет отчеты, панели мониторинга и плитки в рабочей области. Чтобы внедрить эти элементы, необходимо создать их и отправить их в рабочую область.

Совет

Если у вас уже есть рабочая область, можно пропустить этот шаг.

Чтобы создать рабочую область, сделайте следующее:

1. Войдите в Power BI.

2. Выберите рабочие области.

3. Выберите Создать рабочую область.

4. Назовите рабочую область и нажмите кнопку "Сохранить".

Шаг 4. Создание и публикация отчета Power BI

Следующий шаг — создать отчет и отправить его в рабочую область. Вы можете создать собственный отчет с помощью Power BI Desktop, а затем опубликовать его в рабочей области. Кроме того, вы можете отправить пример отчета в рабочую область.

Совет

Если у вас уже есть рабочая область с отчетом, можно пропустить этот шаг.

Чтобы скачать пример отчета и опубликовать его в рабочей области, выполните следующие действия:

1. Откройте папку примеров GitHub Power BI Desktop.

2. Выберите "Код" и выберите "Скачать ZIP-файл".

   

3. Извлеките скачанный ZIP-файл и перейдите в папку "Отчеты примеров ".

4. Выберите отчет для внедрения и публикации в рабочей области.

Шаг 5. Получение значений параметров внедрения

Чтобы внедрить содержимое, необходимо получить определенные значения параметров. В следующей таблице показаны необходимые значения и указываются, применимы ли они к методу проверки подлинности субъекта-службы , методу проверки подлинности главного пользователя или обоим.

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

Параметр	Субъект-служба	Главный пользователь
Идентификатор клиента
Идентификатор рабочей области
Идентификатор отчета
Секрет клиента
Идентификатор клиента		требуется только для JS узла
Имя пользователя Power BI
Пароль Power BI

Client ID

Совет

Применимо к:главному пользователю субъекта-службы

Чтобы получить ИДЕНТИФИКАТОР клиента (также известный как идентификатор приложения), выполните следующие действия:

1. Войдите в Microsoft Azure.

2. Найдите Регистрация приложений и выберите ссылку Регистрация приложений.

3. Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.

4. Из раздела "Обзор" скопируйте ИДЕНТИФИКАТОР идентификатора приложения (клиента).

Идентификатор рабочей области

Совет

Применимо к:главному пользователю субъекта-службы

Чтобы получить GUID идентификатора рабочей области, выполните следующие действия.

1. Выполните вход в службу Power BI.

2. Откройте отчет, который требуется внедрить.

3. Скопируйте GUID из URL-адреса. GUID — это число между /groups/ и /reports/.

   

Кроме того, можно найти идентификатор рабочей области в параметрах портала Администратор, выбрав "Сведения" рядом с именем рабочей области.

Код отчета

Совет

Применимо к:главному пользователю субъекта-службы

Чтобы получить guid идентификатора отчета, выполните следующие действия.

1. Выполните вход в службу Power BI.

2. Откройте отчет, который требуется внедрить.

3. Скопируйте GUID из URL-адреса. GUID — это число между /reports/ и /ReportSection.

   

Секрет клиента

Совет

Применимо к:главному пользователю субъекта-службы

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

1. Войдите в Microsoft Azure.

2. Найдите Регистрация приложений и выберите ссылку Регистрация приложений.

3. Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.

4. В разделе Управление выберите Сертификаты и секреты.

5. В разделе Секреты клиента выберите Новый секрет клиента.

6. Во всплывающем окне "Добавление секрета клиента" укажите описание секрета приложения, выберите, когда срок действия секрета приложения истекает, и нажмите кнопку "Добавить".

7. Из раздела секретов клиента скопируйте строку в столбце Value созданного секрета приложения. Значение секрета клиента — это идентификатор клиента.

Примечание.

Скопируйте значение секрета клиента при первом появлении. После перехода от этой страницы секрет клиента будет скрыт, и вы не сможете получить его значение.

Идентификатор клиента

Совет

Применимо к:главному пользователю субъекта-службы

Чтобы получить GUID идентификатора клиента, выполните следующие действия.

1. Войдите в Microsoft Azure.

2. Найдите Регистрация приложений и выберите ссылку Регистрация приложений.

3. Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.

4. В разделе "Обзор" скопируйте GUID идентификатора каталога (клиента).

Имя пользователя и пароль Power BI

Совет

Применимо к:главному пользователю субъекта-службы

Получите имя пользователя и пароль пользователя Power BI, который вы используете в качестве главного пользователя. Это тот же пользователь, который использовался для создания рабочей области и отправки отчета в служба Power BI.

Шаг 6. Доступ к API субъекта-службы

Совет

Применимо к:главному пользователю субъекта-службы

Этот шаг относится только к использованию метода проверки подлинности субъекта-службы . Если вы используете основного пользователя, пропустите этот шаг и перейдите к шагу 7. Включите доступ к рабочей области.

Чтобы приложение Microsoft Entra могло получить доступ к содержимому и API Power BI, администратор Power BI должен включить доступ к субъекту-службе на портале администрирования Power BI. Если вы не являетесь администратором клиента, получите администратора клиента, чтобы включить параметры клиента.

1. В служба Power BI выберите портал Параметры> Параметры> Администратор.

   

2. Выберите параметры клиента и прокрутите вниз до раздела "Параметры разработчика".

3. Разверните субъекты-службы, чтобы использовать API Fabric и включить этот параметр.

   

Примечание.

При использовании субъекта-службы рекомендуется ограничить доступ к параметрам клиента с помощью группы безопасности. Дополнительные сведения об этой функции см. в следующих разделах статьи субъекта-службы :

• Создание группы безопасности Microsoft Entra
• Включение параметров администратора служба Power BI

Шаг 7. Включение доступа к рабочей области

Чтобы включить объекты доступа к приложению Microsoft Entra, такие как отчеты, панели мониторинга и семантические модели в служба Power BI, добавьте субъекта-службы или основного пользователя в качестве члена или администратора в рабочую область.

1. Выполните вход в службу Power BI.

2. Прокрутите страницу до рабочей области, для которой требуется включить доступ, и в меню "Дополнительно " выберите "Доступ к рабочей области".

   

3. В области Access в зависимости от используемого метода проверки подлинности скопируйте субъект-службу или основного пользователя в текстовое поле "Ввод адреса электронной почты".

   Примечание.

   Если вы используете субъект-службу, его имя — это имя, которое вы предоставили приложению Microsoft Entra.

4. Выберите Добавить.

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

Пример приложения Power BI embedded позволяет создавать внедрение приложения Power BI для клиентов .

Выполните следующие действия, чтобы изменить внедрение примера приложения для клиентов , чтобы внедрить отчет Power BI.

1. Откройте папку примеров разработчика Power BI.

2. Выберите "Код" и выберите "Скачать ZIP-файл".

   

3. Извлеките скачанный ZIP-файл и перейдите в папку PowerBI-Developer-Samples-master .

4. В зависимости от языка, который вы хотите использовать приложение, откройте одну из следующих папок:

   • .NET Core
   • .NET Framework
   • Java
   • Node.js
   • Python

   Примечание.

   Внедрение примеров приложений для клиентов поддерживает только платформы, перечисленные выше. Пример приложения React поддерживает только внедрение решения организации .

5. Откройте папку Внедрения для клиентов .

.NET Core

6. Откройте пример приложения для клиентов, используя один из следующих методов:

   • Если вы используете Visual Studio, откройте файл AppOwnsData.sln .

   • Если вы используете Visual Studio Code, откройте папку AppOwnsData .

7. Откройте appsettings.json.

8. В зависимости от метода проверки подлинности заполните следующие значения параметров:

   Параметр	Субъект-служба	Главный пользователь
   AuthenticationMode	ServicePrincipal	MasterUser
   ClientId	Идентификатор клиента приложения Microsoft Entra	Идентификатор клиента приложения Microsoft Entra
   TenantId	Идентификатор клиента Microsoft Entra	Неприменимо
   PbiUsername	Неприменимо	Имя пользователя master, см. в разделе "Имя пользователя и пароль Power BI"
   PbiPassword	Н/П	Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI"
   ClientSecret	Секрет клиента идентификатора Microsoft Entra	Н/П
   WorkspaceId	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"
   ReportId	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"

9. Запустите проект, выбрав соответствующий параметр:

   • Если вы используете Visual Studio, выберите IIS Express (воспроизведение).

   • Если вы используете Visual Studio Code, выберите "Запустить > отладку".

.NET Framework

6. С помощью Visual Studio откройте файл AppOwnsData.sln .

7. Откройте web.config.

8. В зависимости от метода проверки подлинности заполните следующие значения параметров:

   Параметр	Субъект-служба	Главный пользователь
   authenticationType	ServicePrincipal	MasterUser
   applicationId	Идентификатор клиента приложения Microsoft Entra	Идентификатор клиента приложения Microsoft Entra
   workspaceId	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"
   reportId	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"
   pbiUsername	Н/П	Имя пользователя master, см. в разделе "Имя пользователя и пароль Power BI"
   pbiPassword	Н/П	Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI"
   applicationSecret	Секрет клиента идентификатора Microsoft Entra	Н/П
   tenant	Идентификатор клиента Microsoft Entra	Н/П

9. Запустите проект, выбрав IIS Express (play).

Java

6. Откройте Eclipse и следуйте инструкциям, описанным ниже.

   Примечание.

   Инструкции по внедрению Java для клиентов пример приложения см. в интегрированной среде разработки Eclipse для разработчиков Java EE (корпоративный выпуск). Если вы используете другое приложение, вам придется настроить его самостоятельно.

7. Добавьте сервер Tomcat в Eclipse:

   a. Выберите окно>"Показать серверы представления".>

   b. На вкладке "Серверы" выберите "Нет серверов". Щелкните эту ссылку, чтобы создать новый сервер.

   c. В окне "Определение нового сервера" разверните Apache и выберите сервер Tomcat, который вы используете на компьютере. Например, сервер Tomcat версии 9.0.

   d. Выберите Далее.

   д) В окне сервера Tomcat выберите "Обзор" и перейдите в папку, содержащую сервер Tomcat.

   f. В окне сервера Tomcat выберите "Установленные JREs".

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

   h. В окне сервера Tomcat нажмите кнопку "Готово". Сервер Tomcat можно увидеть на вкладке "Серверы ".

8. Откройте проект в Eclipse:

   Внимание

   Eclipse может столкнуться с проблемами, если имя пути слишком длинное. Чтобы избежать этой проблемы, убедитесь, что папка примера приложения не вложена слишком глубоко в структуру папок компьютера.

   a. Выберите файл и выберите " Открыть проекты" из файловой системы.

   b. В окне импорта проектов из файловой системы или архива выберите каталог и откройте папку AppOwnsData.

   c. Выберите Готово.

9. Добавьте сервер Tomcat в проект:

   a. В области "Пакет Обозреватель" щелкните правой кнопкой мыши AppOwnsData и выберите "Свойства".

   b. В окне "Свойства для AppOwnsData" выберите целевые среды выполнения и выберите Apache Tomcat. Этот выбор включает версию Apache Tomcat, которую вы используете, например Apache Tomcat версии 9.0.

   c. Нажмите кнопку "Применить" и "Закрыть".

10. Заполнение обязательных параметров

    a. В обозревателе пакетов разверните проект AppOwnsData.

    b. Разверните ресурсы Java.

    c. Разверните src.

    d. Разверните файл com.embedsample.appoensdata.config.

    д) Откройте Config.java.

    f. В зависимости от метода проверки подлинности заполните следующие значения параметров:

    Параметр	Субъект-служба	Главный пользователь
    authenticationType	ServicePrincipal	MasterUser
    workspaceId	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"
    reportId	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"
    clientId	Идентификатор клиента приложения Microsoft Entra	Идентификатор клиента приложения Microsoft Entra
    pbiUsername	Н/П	Имя пользователя master, см. в разделе "Имя пользователя и пароль Power BI"
    pbiPassword	Н/П	Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI"
    tenantId	Идентификатор клиента Microsoft Entra	Н/П
    appSecret	Секрет клиента идентификатора Microsoft Entra	Н/П

11. Запуск проекта

    a. В Обозреватель пакета щелкните правой кнопкой мыши AppOwnesData.

    b. Выберите запуск от имени>на сервере.

    c. В окне "Запуск на сервере" выберите "Выбрать существующий сервер" и выберите сервер Tomcat.

    d. Выберите Готово.

Node.js

6. Откройте папку данных app Owns Data с помощью предпочтительной интегрированной среды разработки. Рекомендуется использовать одно из следующих вариантов:

   • Visual Studio

   • Visual Studio Code

7. Откройте терминал и установите необходимые зависимости, выполнив: npm install

8. Разверните папку Config и откройте config.json.

9. В зависимости от метода проверки подлинности заполните следующие значения параметров:

   Параметр	Субъект-служба	Главный пользователь
   authenticationMode	ServicePrincipal	MasterUser
   clientId	Идентификатор клиента приложения Microsoft Entra	Идентификатор клиента приложения Microsoft Entra
   workspaceId	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"
   reportId	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"
   pbiUsername	Н/П	Имя пользователя master, см. в разделе "Имя пользователя и пароль Power BI"
   pbiPassword	Н/П	Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI"
   clientSecret	Секрет клиента идентификатора Microsoft Entra	Н/П
   tenantId	Идентификатор клиента Microsoft Entra	Идентификатор клиента Microsoft Entra

10. Запустите проект, выполнив следующие действия:

    a. В терминале интегрированной среды разработки выполните команду npm start.

    b. Откройте новую вкладку в браузере и перейдите к http://localhost:5300.

Python

6. Откройте PowerShell или командную строку.

7. Убедитесь, что вы находитесь в папке Python>Embed для клиентов, а файл requirements.txt находится в папке и запустите.pip3 install -r requirements.txt

8. Откройте папку данных app Owns Data с помощью предпочтительной интегрированной среды разработки. Рекомендуется использовать одну из следующих сред:

   • Visual Studio

   • Visual Studio Code

9. Откройте config.py.

10. В зависимости от метода проверки подлинности заполните следующие значения параметров:

    Параметр	Субъект-служба	Главный пользователь
    AUTHENTICATION_MODE	ServicePrincipal	MasterUser
    WORKSPACE_ID	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"	Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"
    REPORT_ID	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"	Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"
    TENANT_ID	Идентификатор клиента Microsoft Entra	Н/П
    CLIENT_ID	Идентификатор клиента приложения Microsoft Entra	Идентификатор клиента приложения Microsoft Entra
    CLIENT_SECRET	Секрет клиента идентификатора Microsoft Entra	Неприменимо
    POWER_BI_USER	Неприменимо	Имя пользователя master, см. в разделе "Имя пользователя и пароль Power BI"
    POWER_BI_PASS	Н/П	Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI"

11. Сохраните файл.

12. Запустите проект, выполнив следующие действия.

    a. В PowerShell или командной строке перейдите в папку Python>Embed для клиентов>AppOwnesData и выполните команду.flask run

    b. Откройте новую вкладку в браузере и перейдите к http://localhost:5000.

Разработка приложения

После настройки и запуска внедрения для клиентов примера приложения можно начать разработку собственного приложения.

Попробуйте воспользоваться игровой площадкой встроенной аналитики Power BI, чтобы приступить к разработке и следить за всеми новыми функциями и обновлениями Power BI Embedded.

Когда вы будете готовы, просмотрите требования к рабочей среде . Вам также потребуется емкость и ознакомьтесь со статьей по планированию емкости, чтобы установить, какой номер SKU лучше подходит для ваших потребностей.

Внимание

Если вы использовали бесплатные маркеры пробной версии для разработки, необходимо приобрести емкость для рабочей среды. Пока емкость не будет приобретена, баннер бесплатной пробной версии будет по-прежнему отображаться в верхней части внедренного отчета.

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

• Перенос в рабочую среду
• Внедрение для организации
• Внедрение отчетов с разбивкой на страницы

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