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

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

Из этого руководства вы узнаете, как выполнять следующие задачи:

  • Настройте внедренную среду.
  • Настройте пример приложения внедрения для организации (также известный как User Owns Data).

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

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

Важно!

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

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

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

  • .NET Framework
  • .NET Core
  • React TypeScript

Примечание

Примеры для .NET Core и .NET Framework позволяют конечному пользователю просматривать любую панель мониторинга, отчет или плитку Power BI , к которым у него есть доступ в службе Power BI. Пример для React TypeScript позволяет внедрить только один отчет, к которому у пользователя уже есть доступ в службе Power BI.

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

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox;

Предварительные условия

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


Метод

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

  1. Зарегистрируйте приложение Azure AD.

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

  3. Создание отчет Power BI и опубликуйте его.

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

  5. Внедрите свое содержимое.

Шаг 1. Регистрация приложения в Azure AD

Регистрация приложения в Azure AD позволяет создать для него удостоверение.

Чтобы зарегистрировать приложение в Azure AD, следуйте инструкциям в разделе Регистрация приложения.

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

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

Совет

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

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

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

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

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

  4. Присвойте рабочей области имя и нажмите Сохранить.

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

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

Совет

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

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

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

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

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

  3. Извлеките содержимое скачанного ZIP-файла и перейдите к папке Samples Reports.

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

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

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

Параметр .NET Core .NET Framework React TypeScript
Идентификатор клиента Applies to. Applies to. Applies to.
Секрет клиента Applies to. Applies to. Does not apply to.
Идентификатор рабочей области Does not apply to. Does not apply to. Applies to.
Идентификатор отчета Does not apply to. Does not apply to. Applies to.

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

Совет

Применимо к:Applies to.. Net Core Applies to..NET Framework Applies to.React TypeScript

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

  1. Выполните вход в Microsoft Azure.

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

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

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

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

Совет

Применимо к:Applies to.. Net Core Applies to..NET Framework Does not apply to.React TypeScript

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

  1. Выполните вход в Microsoft Azure.

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

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

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

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

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

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

Примечание

Не забудьте скопировать значение секрета клиента при его первом отображении. Когда вы перейдете на другую страницу, секрет клиента будет скрыт и вы не сможете просмотреть это значение.

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

Совет

Применимо к:Does not apply to.. Net Core Does not apply to..NET Framework Applies to.React TypeScript

Чтобы получить идентификатор 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

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

Совет

Применимо к:Does not apply to.. NET Core Does not apply to..NET Framework Applies to.ReactTypeScript

Чтобы получить идентификатор 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

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

Пример приложения внедрения Power BI позволяет создать приложение 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
    • React-TS

    Примечание

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

Настройка приложения Azure AD

  1. Войдите на портал Azure.

  2. Щелкните Регистрация приложений. Если этот параметр не отображается, найдите его.

  3. Откройте приложение Azure AD, созданное в разделе Шаг 1. Регистрация приложения в Azure AD.

  4. В меню Управление выберите пункт Проверка подлинности.

  1. В разделе Конфигурации платформы откройте платформу Веб и в разделе URI перенаправления добавьте https://localhost:5000/signin-oidc.

    Примечание

    Если у вас нет платформы Веб, выберите Добавить платформу и в окне Настройка платформ выберите Веб.

  2. Сохраните изменения.

Screenshot showing the Azure AD app authentication configurations including the web redirect U R I for the .NET core app sample.

Настройка примера приложения для внедрения

  1. Откройте папку Внедрение для организации.

  2. Откройте пример приложения внедрения для организации одним из приведенных ниже методов.

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

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

  3. Откройте файл appsettings.json и введите следующие значения параметров:

Запуск примера приложения

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

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

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

  1. Войдите в пример приложения для внедрения.

    Примечание

    При первом входе вам будет предложено предоставить приложению разрешения Azure AD.

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

    Screenshot showing the Power BI embedding sample app.

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

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

Дальнейшие действия