Настройка Power BI Embedded
ОБЛАСТЬ ПРИМЕНЕНИЯ:
Приложение владеет данными, принадлежащими пользователю данных
Если вы хотите начать использовать Power BI Embedded для совместного использования отчетов с другими пользователями, используйте средство настройки встроенной аналитики Power BI для начала работы. В этой статье показано, как это сделать.
Чтобы использовать встроенную аналитику Power BI, необходимо зарегистрировать приложение Microsoft Entra в Azure. Приложение Microsoft Entra устанавливает разрешения для ресурсов REST Power BI и разрешает доступ к REST API Power BI.
Необходимые условия
Чтобы настроить среду встроенной аналитики Power BI, необходимо выполнить одно из следующих действий.
- Клиент Microsoft Entra и пользователь организации (master)
- Учетная запись Power BI Pro
Подготовка к работе
Прежде чем зарегистрировать приложение, определите, какие из следующих решений лучше всего подходят для ваших потребностей:
Внедрить для клиентов
Используйте решение внедрения для клиентов, которое также называется данными приложения, если вы создаете приложение, предназначенное для ваших клиентов. Пользователям не нужно входить в Power BI или иметь лицензию Power BI для использования приложения. Приложение проходит проверку подлинности в Power BI с помощью основной учетной записи пользователя (лицензии Power BI Pro, используемой для входа в Power BI) или субъекта-службы.
Решение внедрения для клиентов обычно используется независимыми поставщиками программного обеспечения (ISV) и разработчиками, которые создают приложения для стороннего производителя.
Внедрить для организации
Используйте решение внедрения для организации, которое также называется данными пользователей, если вы создаете приложение, которое требует от пользователей использовать свои учетные данные для проверки подлинности в Power BI.
Решение внедрения для вашей организации обычно используется предприятиями и крупными организациями и предназначено для внутренних пользователей.
Дополнительные сведения о двух решениях см. в статье "Что такое решения встроенной аналитики Power BI?".
Настройка среды
После понимания двух вариантов внедрения можно использовать средство установки для создания среды Power BI Embedded.
Если вы предпочитаете вручную настроить среду, пропустите действия, описанные в следующих разделах. Вместо этого выполните действия, описанные в руководстве по регистрации вручную, далее в этой статье.
Важно!
Если вы внедряете GCC, следуйте инструкциям в разделе "Регистрация вручную".
Чтобы использовать средство для настройки среды, перейдите в средство установки встроенной аналитики Power BI. Выберите нужный параметр внедрения.
Шаг 1. Вход в Power BI
В разделе "Шаг 1" в средстве установки выберите "Войти". На этом шаге вы входите в Power BI. Если вам будет предложено выбрать учетную запись, войдите с помощью пользователя, который принадлежит клиенту Power BI. Приложение Microsoft Entra регистрируется в этом пользователе.
Примечание.
Если вы уже вошли в систему, убедитесь, что вы вошли в систему с пользователем, который вы хотите использовать для создания приложения Microsoft Entra. Чтобы изменить пользователей, выберите выход. После перезапуска средства войдите с правильным пользователем.
Нажмите кнопку "Далее ", чтобы перейти к следующему шагу.
Шаг 2. Регистрация приложения
На этом шаге вы регистрируете приложение Microsoft Entra в Azure. Приложение Microsoft Entra устанавливает разрешения для ресурсов REST Power BI и разрешает доступ к REST API Power BI. Эти параметры всегда можно изменить позже.
Чтобы зарегистрировать приложение для клиентов, заполните следующие поля:
Имя приложения— присвойте приложению имя.
Доступ к API— выберите API Power BI (также известные как область), необходимые приложению. Вы можете выбрать все, чтобы выбрать все API. Дополнительные сведения о разрешениях доступа Power BI см. в разделе "Разрешения" и согласие в конечной точке платформа удостоверений Майкрософт.
Выберите Зарегистрировать.
Идентификатор приложения Microsoft Entra отображается в поле "Сводка". Скопируйте это значение для последующего использования.
Шаг 3. Создание рабочей области (необязательно)
Создайте рабочую область в служба Power BI:
Если у вас уже есть рабочая область Power BI, нажмите кнопку "Пропустить".
Чтобы создать рабочую область, введите имя рабочей области и нажмите кнопку "Создать рабочую область". Имя и идентификатор рабочей области отображаются в поле "Сводка ". Скопируйте эти значения для последующего использования.
Совет
Чтобы приложение встроенной аналитики работало должным образом, необходимо использовать средство для создания рабочей области.
Шаг 4. Импорт содержимого (необязательно)
Выберите один из следующих параметров.
Если у вас есть собственное приложение Power BI, можно выбрать "Пропустить".
Если вы хотите создать пример приложения Power BI с помощью примера отчета, выберите пример отчета Power BI и нажмите кнопку "Импорт".
Если вы хотите создать пример приложения Power BI с помощью собственного отчета, выберите "Отправить PBIX-файл", найдите файл и нажмите кнопку "Импорт".
Шаг 5. Предоставление разрешений (только внедрение для клиентов )
Выберите "Предоставить разрешения " и в диалоговом окне нажмите кнопку "Принять". Этот шаг позволяет приложению Microsoft Entra получить доступ к выбранным API (также называемым область) пользователем, вошедшего в систему. Этот пользователь также называется главным пользователем.
Скачивание примера приложения (необязательно)
Если вы создали рабочую область Power BI и добавили в нее содержимое с помощью этого средства, теперь можно выбрать "Скачать пример приложения".
Примечание.
Если вы пропустили необязательные этапы, вы по-прежнему можете скачать пример приложения Power BI. Однако код в скачанном приложении не имеет свойств, которые заполняются во время регистрации. Например, если вы не создаете рабочую область, пример приложения не включает идентификатор рабочей области.
Скопируйте все сведения в поле "Сводка ". Среда внедрения Power BI готова к использованию.
Регистрация вручную
Если вы не использовали средство установки встроенной аналитики Power BI, используйте процедуру в этом разделе, чтобы вручную зарегистрировать приложение Microsoft Entra. Но выполните следующие действия, только если вы создаете одно из следующих решений:
- Приложение embed-for-your-organization
- Приложение внедрения для клиентов с субъектом-службой
Дополнительные сведения о регистрации приложений в идентификаторе Microsoft Entra см. в разделе "Регистрация приложения с помощью платформа удостоверений Майкрософт".
Войдите на портал Azure.
Выберите клиент Microsoft Entra, выбрав свою учетную запись в правом верхнем углу страницы.
Щелкните Регистрация приложений. Если этот параметр не отображается, найдите его.
В Регистрация приложений выберите "Создать регистрацию".
Заполните следующие поля:
Имя — присвойте приложению имя.
Поддерживаемый тип учетной записи. Выберите, кто может использовать приложение.
(Необязательно) В поле URI перенаправления добавьте URL-адрес перенаправления.
Выберите Зарегистрировать. После регистрации приложения вы будете перенаправлены на страницу обзора приложения, где можно получить идентификатор приложения.
Связанный контент
Есть еще вопросы? Попробуйте попросить Сообщество Power BI.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по