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

Руководство по внедрению содержимого 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 ID аутентифицировать ваше встроенное приложение для работы с Power BI. Приложение Microsoft Entra использует учетные данные (имя пользователя и пароль) пользователя Power BI для проверки подлинности в Power BI.
Безопасность Субъект-служба — это рекомендуемый метод авторизации идентификатора Microsoft Entra. Если вы используете сервисный принципал, вы можете пройти проверку подлинности с помощью секрета приложения или сертификата.

В этом руководстве описывается только использование сервисного принципала с секретом приложения. Чтобы внедрить с использованием учетной записи службы и сертификата, обратитесь к статье про учетную запись службы с сертификатом.		 Этот метод проверки подлинности менее безопасен, чем служебный принципал. Необходимо быть бдительным с учетными данными главного пользователя (имя пользователя и пароль). Например, не отображайте их во встраиваемом приложении и часто меняйте пароль.
Делегированные разрешения Microsoft Entra ID Необязательно. Основной пользователь или администратор должен предоставить согласие на доступ к разрешениям Power BI REST API (также известные как области). Например, Report.ReadWrite.All.
доступ к службе Power BI Доступ к службе Power BI с учетной записью службы невозможен. Вы можете получить доступ к служба Power BI с учетными данными главного пользователя.
Лицензия Не требуется лицензия Pro. Вы можете использовать содержимое из любой рабочей области, в которую вы являетесь членом или администратором. Требуется лицензия Power BI Pro или лицензия Premium Per User (PPU).

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

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

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

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

Примечание.

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

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

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

Совет

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

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

  1. Войдите в Fabric.
  2. Выберите Рабочие пространства.
  3. Выберите +Создать рабочую область.
  4. Назовите рабочую область и нажмите кнопку "Сохранить".

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

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

Совет

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

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

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

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

    Снимок экрана, показывающий опцию загрузки ZIP на GitHub в примерах Power BI Desktop

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

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

Примечание.

Если в отчете используется семантическая модель Direct Lake, убедитесь, что вы проверили эти ограничения ,.

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

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

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

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

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

Совет

Область применения:Применимо к.служебного принципала. Применимо к.главный пользователь.

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

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

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

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

  4. Из раздела «Обзор» скопируйте GUID идентификатор приложения (клиента).

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

Совет

Область применения:Применимо к.принципал службы Применимо к.главный пользователь

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

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

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

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

    Снимок экрана с идентификатором рабочей области GUID в URL-адресе службы Power BI

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

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

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

Совет

Область применения:Применимо к.основной субъект службы Применимо к.Master user

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

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

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

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

    Снимок экрана, показывающий идентификатор отчета GUID в URL-адресе службы Power BI

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

Совет

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

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

  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. Войдите в Fabric.

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

    Снимок экрана, показывающий, как кнопка доступа к рабочей области находится в меню 'Ещё' рабочей области Power BI.

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

    Примечание.

    Если вы используете учетную запись службы, её название — это название, которое вы предоставили приложению Microsoft Entra.

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

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

Пример приложения встроенного Power BI позволяет вам создавать вставку 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 Неприменимо Ваше имя пользователя основного пользователя, см. Имя пользователя и пароль Power BI
    PbiPassword Неприменимо Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI"
    ClientSecret Идентификационный номер клиента Microsoft Entra Неприменимо
    WorkspaceId Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области" Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области"
    ReportId Идентификатор внедренного отчета см. в разделе "Идентификатор отчета" Идентификатор внедренного отчета см. в разделе "Идентификатор отчета"

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

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

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

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

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

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

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

Внимание

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

Рекомендации и ограничения

Следующие ограничения применяются к режиму Direct Lake:

  • Требуется токен внедрения V2.
  • Если вы используете учетную запись службы, вам потребуется подключение устойчивой личности (No-SSO).
  • В настоящее время настройка субъекта-службы в качестве метода проверки подлинности для подключения Фиксированной Идентичности является единственным вариантом, поддерживаемым автоматизацией. Другие методы поддерживаются вручную через портал.

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

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