Внедрение панелей мониторинга, отчетов и плиток Power BIEmbed your Power BI dashboards, reports and tiles

Узнайте, какие действия необходимо выполнить для внедрения содержимого Power BI в приложение.Learn about the steps you need to take to embed Power BI content within your application.

Корпорация Майкрософт объявила о выпуске Power BI Premium — новой модели лицензирования на основе емкости, которая расширяет возможности получения доступа к содержимому, а также его совместного использования и распространения.Microsoft announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. Это предложение также обеспечивает дополнительные возможности масштабирования и повышает производительность службы Power BI.The offering also delivers additional scalability and performance to the Power BI service. Кроме того, представлена служба Power BI Embedded, которая позволяет создавать емкость в Microsoft Azure.Power BI Embedded was also announced that allows for creating capacity within Microsoft Azure. Служба Power BI Embedded ориентирована на приложение и клиентов.Power BI Embedded is focused on your application and your customers.

В этой статье рассматривается внедрение содержимого Power BI для организации и клиентов.This article will look at embedding your Power BI content for both your organization and your customers. Процедура в обоих случаях аналогична.The steps are similar between the two scenarios. Инструкции, которые относятся только к внедрению для клиентов, сопровождаются соответствующими указаниями.Callouts will be made when a step is specific to embedding for your customer.

Ниже приведены действия, которые позволяют реализовать эту возможность.There are a few steps you have to do with your application to make this possible. Мы рассмотрим, что необходимо сделать, чтобы создать и использовать внедренное содержимое в приложение.We will go through the steps needed to allow you to create and use embedded content within your application.

Примечание

В интерфейсах API Power BI рабочие области приложения по-прежнему называются группами.The Power BI APIs still refer to app workspaces as groups. Если упоминаются группы, это означает, что вы работаете с рабочими областями приложения.Any references to groups mean that you are working with app workspaces.

Шаг 1. Настройка среды разработки внедренной аналитикиStep 1: Setup your embedded analytics development environment

Прежде чем начать внедрение панелей мониторинга и отчетов в приложение, необходимо убедиться, что ваша среда настроена для внедрения.Before you start embedding dashboards and reports into your application, you need to make sure your environment is setup to allow for embedding. В процессе настройки необходимо будет сделать следующее.As part of the setup, you will need to do the following.

Примечание

Наличие емкости Power BI не является обязательным условием для разработки приложения.Power BI capacity is not required for development of your application. Разработчикам приложения потребуется лицензия Power BI Pro.The developers of the application will need to have a Power BI Pro license.

Клиент Azure Active DirectoryAzure Active Directory tenant

Чтобы внедрить элементы из Power BI, потребуется клиент Azure Active Directory (Azure AD).You will need an Azure Active Directory (Azure AD) tenant in order to embed items from Power BI. У этого клиента должен быть по крайней мере один пользователь Power BI Pro.This tenant must have at least one Power BI Pro user. Также будет необходимо определить приложение Azure AD в данном клиенте.You will also need to define an Azure AD app within the tenant. Можно использовать существующий клиент Azure AD или создать новый клиент специально для внедрения.You can make use of an existing Azure AD tenant or create a new one specifically for embedding purposes.

Необходимо определить, какие настройки клиента будут использоваться при внедрении для клиентов.You will need to determine what tenant setup to use if you are embedding for your customers.

  • Использовать существующий корпоративной клиент Power BI?Use your existing corporate Power BI tenant?
  • Использовать отдельный клиент для приложения?Use a separate tenant for your application?
  • Использовать отдельный клиент для каждого пользователя?Use a separate tenant for each customer?

Если вы не хотите использовать существующий клиент, вы можете создать клиент для приложения или для каждого пользователя. См. дополнительные сведения о создании клиента Azure Active Directory и получении клиента Azure Active Directory.If you do not want to use an existing tenant, you can decide to create a new tenant for your application, or one for each customer, see Create an Azure Active Directory tenant or How to get an Azure Active Directory tenant.

Создание учетной записи Power BI ProCreate a Power BI Pro user account

Для внедрения содержимого требуется только одна учетная запись Power BI Pro.You only need a single Power BI Pro account to embed content. Тем не менее можно использовать несколько различных пользователей с особым доступом к элементам.However, you may want to have a few different users that have specific access to items. Давайте рассмотрим возможных пользователей в клиенте.Here is a look at possible users to consider within your tenant.

Ниже приведены учетные записи, которые должны существовать в клиенте и иметь лицензию Power BI Pro.The following accounts will need to exist within your tenant and have a Power BI Pro license assigned to them. Для работы с рабочими областями приложения в Power BI требуется лицензия Power BI Pro.A Power BI Pro license is required to work with app workspaces within Power BI.

Администратор организации или клиентаAn organization/tenant admin user

Не советуем использовать для приложения учетную запись глобального администратора организации или клиента, если выполняется внедрение для клиентов.It is recommended that your organization/tenant Global Admin user should not be used as account your application uses if embedding for your customers. Так вы ограничите доступ для учетной записи приложения в клиенте.This is to minimize access that the application account has within your tenant. Рекомендуется, чтобы администратор управлял всеми рабочими областями приложений, созданными для внедрения.It is recommended that the admin user be an admin of all app workspaces created for the purpose of embedding.

Учетные записи аналитиков, создающих содержимое.Accounts for analysts that will create content

У вас может быть несколько пользователей, которые создают содержимое для Power BI.You may have multiple users that create content for Power BI. Вам потребуется учетная запись Power BI Pro для каждого аналитика, который создает и развертывает содержимое в Power BI.You will need a Power BI Pro account for each analyst that is creating and deploying content to Power BI.

Главная учетная запись приложения для внедрения для клиентовAn application master user account for embedding for your customers

При внедрении содержимого для клиентов ваше приложение будет использовать главную учетную запись.The master account is the account your application will use when embedding content for your customers. Такой сценарий обычно используется для приложений независимых поставщиков программного обеспечения.The scenario is typically for ISV applications. Это единственная учетная запись, необходимая в организации.The master account is really the only required account you need within your organization. Ее также можно использовать как учетную запись администратора и аналитика, но мы не советуем это делать.It can also be used as the admin and analyst account, but it is not recommended. Учетные данные этой учетной записи хранятся в серверной части приложения. Эта учетная запись используется для получения токена аутентификации Azure AD, используемого в интерфейсах API Power BI,Your application's backend will store the credentials for this account and use it for acquiring an Azure AD auth token for use with the Power BI APIs. и создания токена внедрения для приложения, предназначенного для клиентов.This account will be used to generate an embed token for the application to use for your customers.

Главная учетная запись — это обычная учетная запись пользователя с лицензией Power BI Pro, которая используется с приложением.The master account is just a regular user with a Power BI Pro license that you use with your application. Это должна быть учетная запись администратора рабочей области, используемой для внедрения.The account must be an admin of the app workspace that is being used for embedding.

Регистрация приложения и разрешенияApp registration and permissions

Необходимо зарегистрировать приложение в Azure AD, чтобы осуществлять вызовы REST API.You will need to register your application with Azure AD in order to make REST API calls. Дополнительные сведения см. в статье Регистрация приложения Azure AD для внедрения содержимого Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Создание рабочих областей приложенийCreate app workspaces

Если вы внедряете панели мониторинга и отчеты для клиентов, эти компоненты должны быть размещены в рабочей области приложения.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed within an app workspace. Главная учетная запись, которая упоминалась выше, должна быть учетной записью администратора рабочей области приложения.The master account, that was mentioned above, must be an admin of the app workspace.

  1. Начнем с создания рабочей области.Start by creating the workspace. Выберите Рабочие области > Создать рабочую область приложения.Select Workspaces > Create app workspace.

    Создание рабочей области приложения

    В эту рабочую область будет сохраняться содержимое, над которым работали вы и ваши коллеги.This will be the place to put content that you and your colleagues collaborate on.

  2. Присвойте рабочей области имя.Give the workspace a name. Если соответствующее поле Workspace ID (Идентификатор рабочей области) недоступно, измените это имя, чтобы указать уникальный идентификатор.If the corresponding Workspace ID isn't available, edit it to come up with a unique ID.

    Он также станет именем приложения.This will be the name of the app, too.

    Имя рабочей области

  3. Вы можете выбрать один из доступных вариантов.You have a few options to set. Если вы выбрали Общедоступный, все пользователи организации смогут просматривать содержимое рабочей области.If you choose Public, anyone in your organization can see what’s in the workspace. С другой стороны, если выбрать Частный, только члены рабочей области смогут просматривать ее содержимое.Private, on the other hand, means only members of the workspace can see its contents.

    Общедоступная или частная рабочая область

    После создания группы изменить параметр открытого или закрытого доступа нельзя.You can't change the Public/Private setting after you've created the group.

  4. Вы также можете задать права для членов рабочей области: разрешить изменение содержимого или предоставить доступ только для просмотра.You can also choose if members can edit or have view-only access.

    Разрешения на изменение или только просмотр

    Добавляйте пользователей в рабочую область приложения в том случае, если им нужно изменять содержимое.Only add people to the app workspace so they can edit the content. Если им нужно только просматривать содержимое, не добавляйте их в рабочую область.If they're only going to view the content, don't add them to the workspace. Их можно будет указать при публикации приложения.You can include them when you publish the app.

  5. Добавьте адреса электронной почты сотрудников, которым необходимо предоставить доступ к рабочей области, и нажмите кнопку Добавить.Add email addresses of people you want to have access to the workspace, and select Add. Вы не можете добавлять псевдонимы групп, а только отдельных пользователей.You can’t add group aliases, just individuals.

  6. Предоставьте каждому пользователю либо права участника, либо администратора.Decide whether each person is a member or an admin.

    Роль участника или администратора

    Администраторы могут самостоятельно изменять рабочую область, в том числе добавлять других участников.Admins can edit the workspace itself, including adding other members. Участники могут изменять содержимое рабочей области (за исключением тех случаев, когда они имеют доступ только на просмотр).Members can edit the content in the workspace, unless they have view-only access. Публиковать приложения могут и администраторы, и участники.Both admins and members can publish the app.

  7. Нажмите кнопку Сохранить.Select Save.

После этого служба Power BI создаст рабочую область и откроет ее.Power BI creates the workspace and opens it. Она отображается в списке рабочих областей, в которые вы входите.It appears in the list of workspaces you’re a member of. Администратор может щелкнуть многоточие (…), чтобы вернуться и внести изменения в рабочую область, например добавить новых участников или изменить разрешения.Because you’re an admin, you can select the ellipsis (…) to go back and make changes to it, adding new members or changing their permissions.

Изменение рабочей области

Создание и передача отчетовCreate and upload your reports

Вы можете создавать отчеты и наборы данных с помощью Power BI Desktop, а затем публиковать эти отчеты в рабочей области приложения.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. У пользователя, публикующего отчеты в рабочей области приложения, должна быть лицензия Power BI Pro.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Шаг 2. Внедрение содержимогоStep 2: Embed your content

В приложении потребуется пройти аутентификацию в Power BI.Within your application, you will need to authenticate with Power BI. Если вы внедряете содержимое для клиентов, учетные данные главной учетной записи сохраняются в приложении.If you are embedding content for your customers, you will store the credentials for the master account within your application. Дополнительные сведения см. в статье Authenticate users and get an Azure AD access token for your Power BI app (Проверка подлинности для пользователей и получение маркера доступа Azure AD для приложения Power BI).For more information, see Authenticate users and get an Azure AD access token for your Power BI app.

После аутентификации используйте в приложении интерфейсы REST API Power BI и API JavaScript, чтобы внедрить панели мониторинга и отчеты в это приложение.Once authenticated, within your application, use the Power BI REST APIs and JavaScript APIs to embed dashboards and reports into your application.

Сведения о внедрении для организации см. в следующих руководствах:For embedding for your organization, see the following walkthroughs:

При внедрении для клиентов, используемом, как правило, для независимых поставщиков программного обеспечения, см. следующие статьи:For embeding with your customers, which is typical for ISVs, see the following:

При внедрении содержимого для клиентов требуется токен внедрения.When embedding for your customers, an embed token is required. Чтобы узнать больше, ознакомьтесь с разделом GenerateToken.To learn more see, GenerateToken.

Шаг 3. Перенос решения в рабочую средуStep 3: Promote your solution to production

Для перемещения в рабочую среду требуется ряд дополнительных действий.Moving to production requires a few extra steps.

Внедрение для организацииEmbedding for your organization

Если вы внедряете содержимое для организации, достаточно уведомить пользователей о том, как получить доступ к приложению.If you are embedding for your organization, you only need to let people know how to get to your application.

Пользователи бесплатной службы могут использовать содержимое, которое внедрено из рабочей области приложения (группы), если эта рабочая область поддерживается емкостью.Free users can consume content that is embedded from an app workspace (group), if that workspace is backed by capacity. Укажите пользователя бесплатной службы как участника рабочей области приложения (группы). Иначе вы получите сообщение об ошибке авторизации 401.List the Free user as a member of app workspace (group), otherwise you receive a 401 unauthorized error. В таблице ниже перечислены доступные номера SKU Power BI Premium в Office 365.The following table lists the available Power BI Premium SKUs available within Office 365.

Узел емкостиCapacity Node Общее число ядерTotal cores
(серверная часть и интерфейс)(Backend + frontend)
Внутренние ядраBackend Cores Интерфейсные ядраFrontend Cores Ограничения для подключений DirectQuery и активных подключенийDirectQuery/live connection limits Максимальное число страниц, отображаемых в часы максимальной нагрузкиMax page renders at peak hour
EM3EM3 4 виртуальных ядра4 v-cores 2 ядра, 10 ГБ ОЗУ2 cores, 10GB RAM 2 ядра2 cores 601–1200601-1,200
P1P1 8 виртуальных ядер8 v-cores 4 ядра, 25 ГБ ОЗУ4 cores, 25GB RAM 4 ядра4 cores 30 в секунду30 per second 1201–24001,201-2,400
P2P2 16 виртуальных ядер16 v-cores 8 ядер, 50 ГБ ОЗУ8 cores, 50GB RAM 8 ядер8 cores 60 в секунду60 per second 2401–48002,401-4,800
P3P3 32 виртуальных ядра32 v-cores 16 ядер, 100 ГБ ОЗУ16 cores, 100GB RAM 16 ядер16 cores 120 в секунду120 per second 4801–96004,801-9600

Примечание

Чтобы приобрести Power BI Premium, необходимо быть глобальным администратором или администратором выставления счетов в своем клиенте.You must be a Global or Billing Admin, within your tenant, in order to purchase Power BI Premium. Сведения о том, как приобрести Power BI Premium, см. в разделе Как купить Power BI Premium.For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

Внедрение для клиентовEmbedding for your customers

Если вы внедряете содержимое для клиентов, выполните следующие действия.If you are embedding for your customers, do the following.

  • Если вы используете отдельный клиент для разработки, убедитесь, что рабочие области приложений, панели мониторинга и отчеты доступны в вашей рабочей среде.If you are using a separate tenant for development, then you must make sure your app workspaces, along with dashboards and reports, are available in your production environment. Убедитесь, что приложение создано в Azure AD для рабочего клиента и для этого приложения назначены соответствующие разрешения, как описано в шаге 1.Make sure that you create the application in Azure AD for your production tenant and assign the proper app permissions as indicated in Step 1.
  • Приобретите необходимый размер емкости.Purchase a capacity that fits your needs. Ниже приведена таблица, с помощью которой можно определить, какой номер SKU емкости Power BI Embedded может потребоваться.You can use the table below to understand which Power BI Embedded capacity SKU you may need. Дополнительные сведения приведены в техническом документе по планированию емкости для внедренной аналитики.For more details, see Embedded analytics capacity planning whitepaper. Когда вы будете готовы к покупке, перейдите на портал Microsoft Azure.When you are ready to purchase, you can do so within the Microsoft Azure portal. Дополнительные сведения о создании емкости Power BI Embedded см. в статье Create Power BI Embedded capacity in the Azure portal (Создание емкости Power BI Embedded на портале Azure).For details on how to create Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Важно!

Так как токены внедрения предназначены только для тестирования при разработке, количество таких токенов, создаваемых основной учетной записью Power BI, ограничено.Because embed tokens are intended for development testing only, the number of embed tokens a Power BI master account can generate is limited. Для сценариев внедрения в рабочей среде необходимо приобрести емкость.A capacity must be purchased for production embedding scenarios. В этом случае количество создаваемых токенов внедрения не ограничено.There is no limit to embed token generation when a capacity is purchased.

Узел емкостиCapacity Node Общее число ядерTotal cores
(серверная часть и интерфейс)(Backend + frontend)
Внутренние ядраBackend Cores Интерфейсные ядраFrontend Cores Ограничения для подключений DirectQuery и активных подключенийDirectQuery/live connection limits Максимальное число страниц, отображаемых в часы максимальной нагрузкиMax page renders at peak hour
A1A1 1 виртуальное ядро1 v-cores 0,5 ядра, 3 ГБ ОЗУ.5 cores, 3GB RAM 0,5 ядра.5 cores 5 в секунду5 per second 1–3001-300
A2A2 2 виртуальных ядра2 v-cores 1 ядро, 5 ГБ ОЗУ1 core, 5GB RAM 1 ядро1 core 10 в секунду10 per second 301–600301-600
A3A3 4 виртуальных ядра4 v-cores 2 ядра, 10 ГБ ОЗУ2 cores, 10GB RAM 2 ядра2 cores 15 в секунду15 per second 601–1200601-1,200
A4A4 8 виртуальных ядер8 v-cores 4 ядра, 25 ГБ ОЗУ4 cores, 25GB RAM 4 ядра4 cores 30 в секунду30 per second 1201–24001,201-2,400
A5A5 16 виртуальных ядер16 v-cores 8 ядер, 50 ГБ ОЗУ8 cores, 50GB RAM 8 ядер8 cores 60 в секунду60 per second 2401–48002,401-4,800
A6A6 32 виртуальных ядра32 v-cores 16 ядер, 100 ГБ ОЗУ16 cores, 100GB RAM 16 ядер16 cores 120 в секунду120 per second 4801–96004,801-9600
  • Измените рабочую область приложения и назначьте для нее емкость в диалоговом окне "Дополнительно".Edit the app workspace and assign it to a capacity under advanced.

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

  • Разверните обновленное приложение в рабочей среде и приступите к внедрению панелей мониторинга и отчетов Power BI.Deploy your updated application to production and begin embedding Power BI dashboards and reports.

Параметры администрированияAdmin settings

Глобальные администраторы или администраторы служб Power BI могут включать и отключать возможность использования REST API для клиента.Global Admins, or Power BI service administrators, can turn the ability to use the REST APIs, on or off for a tenant. Администраторы Power BI могут задать этот параметр для всей организации или отдельных групп безопасности.Power BI admins can set this setting for the entire organization, or for individual security groups. По умолчанию установлено состояние "Включено для всей организации".It is enabled for the entire organization by default. Параметр задается на портале администрирования Power BI.This is done through the Power BI admin portal.

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

Внедрение в Power BIEmbedding with Power BI
Как перенести содержимое коллекции рабочих областей Power BI Embedded в Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Что такое Power BI Premium?Power BI Premium - what is it?
Как купить Power BI PremiumHow to purchase Power BI Premium
Репозиторий Git JavaScript APIJavaScript API Git repo
Репозиторий Git Power BI C#Power BI C# Git repo
Пример внедрения JavaScriptJavaScript embed sample
Технический документ по планированию емкости для внедренной аналитикиEmbedded analytics capacity planning whitepaper
Техническая документация по Power BI PremiumPower BI Premium whitepaper

Появились дополнительные вопросы?More questions? Попробуйте задать вопрос в сообществе Power BI.Try asking the Power BI Community