Inserir os dashboards, relatórios e blocos do Power BIEmbed your Power BI dashboards, reports and tiles

Saiba mais sobre as etapas necessárias para inserir o conteúdo do Power BI em seu aplicativo.Learn about the steps you need to take to embed Power BI content within your application.

A Microsoft anunciou o Power BI Premium, um novo modelo de licenciamento com base em capacidade que aumenta a flexibilidade de como os usuários acessam, compartilham e distribuem conteúdo.Microsoft announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. A oferta também oferece desempenho e escalabilidade adicional para o serviço do Power BI.The offering also delivers additional scalability and performance to the Power BI service. Também foi anunciado o Power BI Embedded, que permite a criação de capacidade dentro do Microsoft Azure.Power BI Embedded was also announced that allows for creating capacity within Microsoft Azure. O Power BI Embedded é focado no aplicativo e nos clientes.Power BI Embedded is focused on your application and your customers.

Este artigo examinará a inserção do conteúdo do Power BI tanto para a organização quanto para os clientes.This article will look at embedding your Power BI content for both your organization and your customers. As etapas são similares entre os dois cenários.The steps are similar between the two scenarios. Serão exibidos textos explicativos quando uma etapa for específica à inserção para o cliente.Callouts will be made when a step is specific to embedding for your customer.

Há algumas etapas que você precisa realizar com seu aplicativo para tornar isso possível.There are a few steps you have to do with your application to make this possible. Vamos percorrer as etapas necessárias para permitir que você crie e use o conteúdo inserido em de seu aplicativo.We will go through the steps needed to allow you to create and use embedded content within your application.

Observação

As APIs do Power BI ainda se referem aos espaços de trabalho do aplicativo como grupos.The Power BI APIs still refer to app workspaces as groups. As referências a grupos significam que você está trabalhando com espaços de trabalho do aplicativo.Any references to groups mean that you are working with app workspaces.

Etapa 1: configurar seu ambiente de desenvolvimento de análise inseridoStep 1: Setup your embedded analytics development environment

Antes de começar a inserir dashboards e relatórios em seu aplicativo, é necessário certificar-se de que seu ambiente está configurado para permitir a inserção.Before you start embedding dashboards and reports into your application, you need to make sure your environment is setup to allow for embedding. Como parte da instalação, será necessário fazer o seguinte.As part of the setup, you will need to do the following.

Observação

A capacidade do Power BI não é necessária para o desenvolvimento do aplicativo.Power BI capacity is not required for development of your application. Os desenvolvedores do aplicativo precisarão ter uma licença Power BI Pro.The developers of the application will need to have a Power BI Pro license.

Locatário do Azure Active DirectoryAzure Active Directory tenant

Será necessário um locatário do Azure Active Directory (Azure AD) para inserir os itens para Power BI.You will need an Azure Active Directory (Azure AD) tenant in order to embed items from Power BI. Esse locatário deve ter pelo menos um usuário Power BI Pro.This tenant must have at least one Power BI Pro user. Também será necessário definir um aplicativo do Azure AD dentro do locatário.You will also need to define an Azure AD app within the tenant. É possível usar um locatário do Azure AD existente ou criar um novo especificamente para fins de inserção.You can make use of an existing Azure AD tenant or create a new one specifically for embedding purposes.

Você precisará determinar qual configuração de locatário usar se você estiver inserindo para os clientes.You will need to determine what tenant setup to use if you are embedding for your customers.

  • Usar seu locatário corporativo existente do Power BI?Use your existing corporate Power BI tenant?
  • Usar um locatário separado para o seu aplicativo?Use a separate tenant for your application?
  • Usar um locatário separado para cada cliente?Use a separate tenant for each customer?

Se você não desejar usar um locatário existente, poderá optar por criar um novo locatário para o aplicativo ou um para cada cliente. Consulte Criar um locatário do Azure Active Directory ou Como obter um locatário do 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.

Criar uma conta de usuário do Power BI ProCreate a Power BI Pro user account

Só é necessário ter uma única conta do Power BI Pro para inserir conteúdo.You only need a single Power BI Pro account to embed content. No entanto, convém ter alguns usuários diferentes que têm acesso específico a itens.However, you may want to have a few different users that have specific access to items. Veja usuários possíveis a serem considerados em seu locatário.Here is a look at possible users to consider within your tenant.

As contas a seguir precisarão existir dentro do seu locatário e ter uma licença Power BI Pro atribuída a elas.The following accounts will need to exist within your tenant and have a Power BI Pro license assigned to them. É necessária uma licença do Power BI Pro para trabalhar com espaços de trabalho de aplicativo no Power BI.A Power BI Pro license is required to work with app workspaces within Power BI.

Um usuário administrador de locatário/organizaçãoAn organization/tenant admin user

É recomendável que o usuário Administrador Global do locatário/organização não seja usado como a conta que seu aplicativo usa ao inserir para os clientes.It is recommended that your organization/tenant Global Admin user should not be used as account your application uses if embedding for your customers. Isso é para minimizar o acesso que a conta de aplicativo tem dentro do locatário.This is to minimize access that the application account has within your tenant. É recomendável que o usuário administrador seja um administrador de todos os espaços de trabalho de aplicativo criados com a finalidade de inserção.It is recommended that the admin user be an admin of all app workspaces created for the purpose of embedding.

Contas para analistas que criarão conteúdoAccounts for analysts that will create content

Você pode ter vários usuários que criam conteúdo para o Power BI.You may have multiple users that create content for Power BI. Será necessária uma conta do Power BI Pro para cada analista que está criando e implantando conteúdo no Power BI.You will need a Power BI Pro account for each analyst that is creating and deploying content to Power BI.

Uma conta de usuário mestre de aplicativo para inserir para os clientesAn application master user account for embedding for your customers

A conta mestre é a conta usada pelo aplicativo ao inserir conteúdo para os clientes.The master account is the account your application will use when embedding content for your customers. O cenário normalmente é para os aplicativos ISV.The scenario is typically for ISV applications. A conta mestre é realmente a única conta necessária em sua organização.The master account is really the only required account you need within your organization. Ela também pode ser usada como a conta de administrador e de analista, mas isso não é recomendável.It can also be used as the admin and analyst account, but it is not recommended. O back-end dos seus aplicativos armazenará as credenciais dessa conta e a usará para adquirir um token de autenticação do Azure AD para usar com as APIs do 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. Essa conta será usada para gerar um token de inserção para o aplicativo usar para os clientes.This account will be used to generate an embed token for the application to use for your customers.

A conta mestre é apenas um usuário normal com uma licença do Power BI Pro que você usa com o aplicativo.The master account is just a regular user with a Power BI Pro license that you use with your application. A conta deverá ser administrador do espaço de trabalho do aplicativo que está sendo usado para inserção.The account must be an admin of the app workspace that is being used for embedding.

Registro e permissões do aplicativoApp registration and permissions

Você precisará registrar seu aplicativo no Azure AD para fazer chamadas à API REST.You will need to register your application with Azure AD in order to make REST API calls. Para obter mais informações, consulte Registrar um aplicativo do Azure AD para inserir o conteúdo do Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Criar espaços de trabalho do aplicativoCreate app workspaces

Se você estiver inserindo dashboards e relatórios para os clientes, esses dashboards e relatórios precisarão ser colocados em um espaço de trabalho do aplicativo.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed within an app workspace. A conta mestre mencionada acima precisa ser um administrador do espaço de trabalho do aplicativo.The master account, that was mentioned above, must be an admin of the app workspace.

  1. Comece criando o espaço de trabalho.Start by creating the workspace. Selecione Espaços de trabalho > Criar espaço de trabalho do aplicativo.Select Workspaces > Create app workspace.

    Criar espaço de trabalho do aplicativo

    Esse será o local para colocar o conteúdo no qual você e seus colegas colaboram.This will be the place to put content that you and your colleagues collaborate on.

  2. Nomeie o espaço de trabalho.Give the workspace a name. Se a ID do Espaço de Trabalho correspondente não estiver disponível, edite-a para criar uma ID exclusiva.If the corresponding Workspace ID isn't available, edit it to come up with a unique ID.

    Esse também será o nome do aplicativo.This will be the name of the app, too.

    Nomear o espaço de trabalho

  3. Você tem algumas opções para definir.You have a few options to set. Se você escolher Público, qualquer pessoa na sua organização poderá ver o que está no espaço de trabalho.If you choose Public, anyone in your organization can see what’s in the workspace. Particular, por outro lado, significará que somente os membros do espaço de trabalho poderão ver o conteúdo.Private, on the other hand, means only members of the workspace can see its contents.

    Definir como particular ou público

    Não é possível alterar a configuração Público/Particular depois de criar o grupo.You can't change the Public/Private setting after you've created the group.

  4. Também é possível escolher se os membros podem editar ou se terão acesso somente exibição.You can also choose if members can edit or have view-only access.

    Definir como edição ou somente exibição

    Somente adicione pessoas ao espaço de trabalho do aplicativo para que elas possam editar o conteúdo.Only add people to the app workspace so they can edit the content. Caso a pessoa só precise exibir o conteúdo, não adicione-a ao espaço de trabalho.If they're only going to view the content, don't add them to the workspace. Você pode incluí-la quando publicar o aplicativo.You can include them when you publish the app.

  5. Adicione os endereços de email das pessoas que você deseja que tenham acesso ao espaço de trabalho e selecione Adicionar.Add email addresses of people you want to have access to the workspace, and select Add. Você não pode adicionar aliases de grupos, apenas indivíduos.You can’t add group aliases, just individuals.

  6. Decida se cada pessoa será um membro ou um administrador.Decide whether each person is a member or an admin.

    Definir como Administrador ou Membro

    Os administradores podem editar o espaço de trabalho, incluindo a adição de outros membros.Admins can edit the workspace itself, including adding other members. Os membros podem editar o conteúdo no espaço de trabalho, a menos que tenham acesso somente exibição.Members can edit the content in the workspace, unless they have view-only access. Os membros e os administradores podem publicar o aplicativo.Both admins and members can publish the app.

  7. Selecione Salvar.Select Save.

O Power BI cria o espaço de trabalho e o abre.Power BI creates the workspace and opens it. Ele aparece na lista de espaços de trabalho dos quais você é um membro.It appears in the list of workspaces you’re a member of. Como você é um administrador, você pode selecionar as reticências (...) para voltar e fazer alterações, adicionar novos membros ou alterar as permissões deles.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.

Editar espaço de trabalho

Criar e carregar seus relatóriosCreate and upload your reports

É possível criar seus relatórios e conjuntos de dados usando o Power BI Desktop e, em seguida, publicar esses relatórios em um espaço de trabalho do aplicativo.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. O usuário final que publicar os relatórios precisará ter uma licença Power BI Pro para publicar em um espaço de trabalho do aplicativo.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Etapa 2: inserir seu conteúdoStep 2: Embed your content

Dentro de seu aplicativo, será necessário autenticar com o Power BI.Within your application, you will need to authenticate with Power BI. Se você estiver inserindo conteúdo para os clientes, você armazenará as credenciais da conta mestre dentro de seu aplicativo.If you are embedding content for your customers, you will store the credentials for the master account within your application. Para obter mais informações, consulte Autenticar usuários e obter um token de acesso do Azure AD para o aplicativo do Power BI.For more information, see Authenticate users and get an Azure AD access token for your Power BI app.

Depois de ser autenticar, no aplicativo, use as APIs JavaScript e as APIs REST do Power BI para inserir dashboards e relatórios no aplicativo.Once authenticated, within your application, use the Power BI REST APIs and JavaScript APIs to embed dashboards and reports into your application.

Para inserir para a organização, consulte os seguintes guias passo a passo:For embedding for your organization, see the following walkthroughs:

Para inserir para os clientes, o que é típico para ISVs, consulte o seguinte:For embeding with your customers, which is typical for ISVs, see the following:

Ao inserir para os clientes, é necessário um token de inserção.When embedding for your customers, an embed token is required. Para saber mais, consulte GenerateToken.To learn more see, GenerateToken.

Etapa 3: promover sua solução para produçãoStep 3: Promote your solution to production

Passar para a produção requer algumas etapas adicionais.Moving to production requires a few extra steps.

Inserção para a organizaçãoEmbedding for your organization

Se você estiver inserindo para a organização, só será necessário explicar para as pessoas como acessar o seu aplicativo.If you are embedding for your organization, you only need to let people know how to get to your application.

Os usuários Gratuitos poderão consumir o conteúdo inserido de um espaço de trabalho de aplicativo (grupo) se esse espaço de trabalho tiver o suporte de uma capacidade.Free users can consume content that is embedded from an app workspace (group), if that workspace is backed by capacity. Liste o usuário Gratuito como um membro do grupo (espaço de trabalho de aplicativo); caso contrário, você receberá um erro não autorizado 401.List the Free user as a member of app workspace (group), otherwise you receive a 401 unauthorized error. A tabela a seguir lista os SKUs do Power BI Premium disponíveis no Office 365.The following table lists the available Power BI Premium SKUs available within Office 365.

Nó de capacidadeCapacity Node Total de núcleosTotal cores
(Back-end + front-end)(Backend + frontend)
Núcleos de back-endBackend Cores Núcleos de front-endFrontend Cores Limites de conexão dinâmica/DirectQueryDirectQuery/live connection limits Máx. de renderizações de página no horário de picoMax page renders at peak hour
EM3EM3 4 núcleos virtuais4 v-cores 2 núcleos, 10 GB de RAM2 cores, 10GB RAM 2 núcleos2 cores 601-1.200601-1,200
P1P1 8 v-cores8 v-cores 4 núcleos, 25 GB de RAM4 cores, 25GB RAM 4 núcleos4 cores 30 por segundo30 per second 1.201-2.4001,201-2,400
P2P2 16 v-cores16 v-cores 8 núcleos, 50 GB de RAM8 cores, 50GB RAM 8 núcleos8 cores 60 por segundo60 per second 2.401-4.8002,401-4,800
P3P3 32 v-cores32 v-cores 16 núcleos, 100 GB de RAM16 cores, 100GB RAM 16 núcleos16 cores 120 por segundo120 per second 4.801-9.6004,801-9600

Observação

É necessário ser um Administrador global ou de cobrança, dentro do seu locatário, para adquirir o Power BI Premium.You must be a Global or Billing Admin, within your tenant, in order to purchase Power BI Premium. Para obter informações sobre como adquirir o Power BI Premium, consulte How to purchase Power BI Premium (Como comprar o Power BI Premium).For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

Inserção para os clientesEmbedding for your customers

Se você estiver integrando para os clientes, faça o seguinte.If you are embedding for your customers, do the following.

  • Se você estiver usando um locatário separado para desenvolvimento, então será preciso verificar se os espaços de trabalho do aplicativo, juntamente com os dashboards e os relatórios, estão disponíveis no ambiente de produção.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. Verifique se você criou o aplicativo no Azure AD para seu locatário de produção e atribuiu as permissões de aplicativo adequadas conforme indicado na Etapa 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.
  • Adquira uma capacidade que atenda às suas necessidades.Purchase a capacity that fits your needs. É possível usar a tabela abaixo para entender de qual SKU de capacidade do Power BI Embedded você pode precisar.You can use the table below to understand which Power BI Embedded capacity SKU you may need. Para obter mais detalhes, consulte Embedded analytics capacity planning whitepaper (White paper de planejamento de capacidade de análise inserida).For more details, see Embedded analytics capacity planning whitepaper. Quando você estiver pronto para a compra, será possível fazê-la dentro do Portal do Microsoft Azure.When you are ready to purchase, you can do so within the Microsoft Azure portal. Para obter detalhes sobre como criar a capacidade do Power BI Embedded, consulte Criar capacidade do Power BI Embedded no Portal do Azure.For details on how to create Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Importante

Como os tokens inseridos destinam-se apenas para teste de desenvolvimento, o número de tokens inseridos que uma conta mestre do Power BI pode gerar é limitado.Because embed tokens are intended for development testing only, the number of embed tokens a Power BI master account can generate is limited. Uma capacidade deve ser adquirida para cenários de integração de produção.A capacity must be purchased for production embedding scenarios. Não há nenhum limite para a geração de tokens inseridos quando uma capacidade é adquirida.There is no limit to embed token generation when a capacity is purchased.

Nó de capacidadeCapacity Node Total de núcleosTotal cores
(Back-end + front-end)(Backend + frontend)
Núcleos de back-endBackend Cores Núcleos de front-endFrontend Cores Limites de conexão dinâmica/DirectQueryDirectQuery/live connection limits Máx. de renderizações de página no horário de picoMax page renders at peak hour
A1A1 1 v-cores1 v-cores 0,5 núcleo, 3 GB de RAM.5 cores, 3GB RAM 0,5 núcleo.5 cores 5 por segundo5 per second 1-3001-300
A2A2 2 núcleos virtuais2 v-cores 1 núcleo, 5 GB de RAM1 core, 5GB RAM 1 núcleo1 core 10 por segundo10 per second 301-600301-600
A3A3 4 núcleos virtuais4 v-cores 2 núcleos, 10 GB de RAM2 cores, 10GB RAM 2 núcleos2 cores 15 por segundo15 per second 601-1.200601-1,200
A4A4 8 v-cores8 v-cores 4 núcleos, 25 GB de RAM4 cores, 25GB RAM 4 núcleos4 cores 30 por segundo30 per second 1.201-2.4001,201-2,400
A5A5 16 v-cores16 v-cores 8 núcleos, 50 GB de RAM8 cores, 50GB RAM 8 núcleos8 cores 60 por segundo60 per second 2.401-4.8002,401-4,800
A6A6 32 v-cores32 v-cores 16 núcleos, 100 GB de RAM16 cores, 100GB RAM 16 núcleos16 cores 120 por segundo120 per second 4.801-9.6004,801-9600
  • Edite o espaço de trabalho do aplicativo e atribua-o a uma capacidade em avançado.Edit the app workspace and assign it to a capacity under advanced.

    Atribuir um espaço de trabalho de aplicativo a uma capacidade

  • Implante seu aplicativo atualizado para a produção e comece a inserir relatórios e dashboards do Power BI.Deploy your updated application to production and begin embedding Power BI dashboards and reports.

Configurações de administraçãoAdmin settings

Os Administradores Globais ou administradores do serviço do Power BI, podem ativar ou desativar a capacidade de usar as APIs REST para um locatário.Global Admins, or Power BI service administrators, can turn the ability to use the REST APIs, on or off for a tenant. Administradores do Power BI podem definir essa configuração para toda a organização ou para grupos de segurança individuais.Power BI admins can set this setting for the entire organization, or for individual security groups. Isso é habilitado para toda a organização por padrão.It is enabled for the entire organization by default. Isso é feito por meio do portal de administração do Power BI.This is done through the Power BI admin portal.

Próximas etapasNext steps

Inserindo com o Power BIEmbedding with Power BI
Como migrar o conteúdo da coleção do espaço de trabalho do Power BI Embedded para o Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Power BI Premium – o que é?Power BI Premium - what is it?
Como comprar o Power BI PremiumHow to purchase Power BI Premium
Repositório Git de API do JavaScriptJavaScript API Git repo
Repositório Git de C# do Power BIPower BI C# Git repo
Exemplo inserido do JavaScriptJavaScript embed sample
White paper de planejamento de capacidade de análise inseridaEmbedded analytics capacity planning whitepaper
White paper do Power BI PremiumPower BI Premium whitepaper

Mais perguntas?More questions? Experimente perguntar à Comunidade do Power BITry asking the Power BI Community