Поделиться через


Руководство по внедрению содержимого 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-файл".

    Снимок экрана: параметр скачивания ZIP в примерах Power B Desktop GitHub

  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 идентификатора рабочей области в службе Power B I U R L

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

Снимок экрана: поиск идентификатора рабочей области из параметров администратора.

Код отчета

Совет

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

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

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

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

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

    Снимок экрана: идентификатор отчета GUID в службе Power B I U R L

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

Совет

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

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

  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 выберите портал Параметры> Параметры> Администратор.

    Снимок экрана: пункт меню параметров администратора в меню параметров службы Power B I.

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

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

    Снимок экрана: включение параметра параметров разработчика в меню параметров клиента в службе Power B I.

Примечание.

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

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

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

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

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

    Снимок экрана: кнопка доступа к рабочей области в дополнительном меню рабочей области Power B I.

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

    Примечание.

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

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

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

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

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

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

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

    Снимок экрана: параметр скачивания ZIP в примерах разработчика Power B I 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.