Руководство по внедрению содержимого 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 и код, перечисленные ниже:

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

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

Способ

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

  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-файл".

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

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

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

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

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

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

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

Client ID

Совет

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

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

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

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

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

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

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

Совет

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

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

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

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

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

    A screenshot showing workspace ID GUID in the Power B I service U R L

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

A screenshot showing how to find the workspace I D from the admin settings.

Код отчета

Совет

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

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

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

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

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

    A screenshot showing report ID GUID in the Power B I service U R L

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

Совет

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

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

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

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

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

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

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

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

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

Примечание.

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

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

Совет

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

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

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

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

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

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

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

Совет

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

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

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

Совет

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

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

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

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

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

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

  3. Разверните узел "Разрешить субъектам-службам использовать API Power BI" и включите этот параметр.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Примечание.

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

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

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

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

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

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

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

    Примечание.

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

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

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

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

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

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

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

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

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

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

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

    Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Важно!

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

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