Руководство. Внедрение содержимого 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, так и указанные ниже зависимости кода.

• Зависимости Power BI

  • Собственный клиент Azure Active Directory.

  • Одна из следующих лицензий:

    • Power BI Pro

    • Premium на пользователя (PPU)

  Примечание

  Для переноса в рабочую среду потребуется одна из следующих конфигураций:

  • все пользователи с лицензией Pro;
  • все пользователи с лицензией PPU;
  • P илиemcapacity. Эта конфигурация позволяет всем пользователям иметь бесплатные лицензии.

• Зависимости кода

  .NET Core

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

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

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Текстовый редактор

  • Терминал командной строки (или PowerShell)

---

Метод

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

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

   

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

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

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

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

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

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

Совет

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

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

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

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

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

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

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

Совет

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

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

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

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

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

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

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

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

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

Примечание

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

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

Совет

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

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

1. Войдите в службу Power BI.

2. Откройте отчет, который необходимо внедрить.

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

   

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

Совет

Применимо к:. NET Core .NET Framework ReactTypeScript

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

1. Войдите в службу Power BI.

2. Откройте отчет, который необходимо внедрить.

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

   

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

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

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

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

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

   

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

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

   • .NET Core
   • .NET Framework
   • React-TS

   Примечание

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

.NET Core

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

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

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

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

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

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

   Примечание

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

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

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

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

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

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

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

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

   • ClientId — используйте идентификатор клиента;

   • ClientSecret — используйте секрет клиента.

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

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

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

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

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

   Примечание

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

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

   

.NET Framework

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

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

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

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

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

5. В разделе Конфигурации платформы настройте указанные ниже параметры.

   1. Для платформы Веб в разделе URI перенаправления добавьте https://localhost:44300/.

      Примечание

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

   2. В разделе Неявное предоставление разрешения и гибридные потоки включите параметр Токен идентификатора.

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

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

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

2. В Visual Studio откройте файл UserOwnsData.sln.

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

   • clientId — используйте идентификатор клиента;

   • clientSecret — используйте секрет клиента.

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

1. Запустите проект, выбрав IIS Express (воспроизвести).

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

   Примечание

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

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

   

React TypeScript

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

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

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

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

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

5. В разделе Конфигурации платформы настройте платформу Веб указанным ниже образом.

   1. В разделе URI перенаправления добавьте https://localhost:3000 и нажмите Настроить.

      Примечание

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

   2. В разделе Неявное предоставление разрешения и гибридные потоки включите оба параметра:

      • Маркеры доступа в Azure Active Directory
      • Маркеры идентификации

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

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

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

2. В текстовом редакторе откройте файл Config.ts и введите следующие значения параметров:

   • clientId — используйте идентификатор клиента;

   • workspaceId — используйте идентификатор рабочей области;

   • reportId — используйте идентификатор отчета.

3. Сохраните файл.

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

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

2. Выполните следующую команду, чтобы установить необходимые зависимости:

   npm install

3. Запустите приложение с помощью следующей команды:

   npm run start

   Примечание

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

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

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

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

Внедрение для клиентов

Встраивать отчеты с разбивкой на страницы

Спросить в сообществе Power BI