Saiba mais sobre as etapas necessárias para inserir o conteúdo do Power BI em seu aplicativo.

A Microsoft recentemente anunciou 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. A oferta também oferece desempenho e escalabilidade adicional para o serviço do Power BI.

Com a introdução do Power BI Premium, o Power BI Embedded e o serviço do Power BI estão convergindo para avançar na maneira como o conteúdo do Power BI é inserido em aplicativos. Isso significa que você terá uma superfície de API, um conjunto consistente de recursos e o acesso aos recursos mais recentes do Power BI, tais como dashboards, gateways e espaços de trabalho de aplicativo, ao inserir seu conteúdo. Mais adiante você poderá iniciar com o Power BI Desktop e mudar para a implantação com o Power BI Premium, que estará disponível no final do segundo trimestre de 2017.

Este artigo examinará a inserção do conteúdo do Power BI para usuários do Power BI e que não são do Power BI. As etapas dos dois são semelhantes. Serão exibidos textos explicativos quando uma etapa for específica à inserção para usuários que não são do Power BI.

Há algumas etapas que você precisa realizar com seu aplicativo para tornar isso possível. Vamos percorrer as etapas necessárias para permitir que você crie e use o conteúdo inserido em de seu aplicativo.

Observação:

As APIs do Power BI ainda se referem aos espaços de trabalho do aplicativo como grupos. As referências a grupos significam que você está trabalhando com espaços de trabalho do aplicativo.

Etapa 1: configurar seu ambiente de desenvolvimento de análise inserido

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. Como parte da instalação, será necessário fazer o seguinte.

Observação:

O Power BI Premium não é necessário para o desenvolvimento de seu aplicativo. Os desenvolvedores do aplicativo precisarão ter uma licença Power BI Pro.

Locatário do Azure Active Directory

Será necessário um locatário do Azure Active Directory (Azure AD) para inserir os itens para Power BI. Esse locatário deve ter pelo menos um usuário Power BI Pro. Também será necessário definir um aplicativo do Azure AD dentro do locatário. É possível usar um locatário do Azure AD existente ou criar um novo especificamente para fins de inserção.

Será necessário determinar qual configuração de locatário usar.

  • Usar seu locatário corporativo existente do Power BI?
  • Usar um locatário separado para o seu aplicativo?
  • Usar um locatário separado para cada cliente?

Se você decidir criar um novo locatário para seu aplicativo ou um para cada cliente, consulte Create an Azure Active Directory tenant (Criar um locatário do Azure Active Directory) ou Como obter um locatário do Azure Active Directory.

Observação:

Será recomendável criar um novo locatário do Azure AD se você estiver inserindo para usuários que não são do Power BI.

Criar uma conta de usuário do Power BI Pro

Só é necessário ter uma única conta do Power BI Pro para inserir conteúdo. No entanto, convém ter alguns usuários diferentes que têm acesso específico a itens. Veja usuários possíveis a serem considerados em seu locatário.

As contas a seguir precisarão existir dentro do seu locatário e ter uma licença Power BI Pro atribuída a elas.

Observação:

Essas contas precisarão ter as licenças Power BI Pro para usar os espaços de trabalho do aplicativo.

Um usuário administrador de locatário/organização

É recomendável que o usuário Administrador Global do locatário/organização não seja usado como a conta que seu aplicativo usa. Isso é para minimizar o acesso que a conta de aplicativo tem dentro da sua organização. É 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.

Contas para analistas que criarão conteúdo

Você pode ter vários usuários que criam conteúdo para o Power BI. Será necessária uma conta do Power BI Pro para cada analista que está criando e implantando conteúdo no Power BI.

Uma conta de usuário mestre do aplicativo para usuários que não são do Power BI

Essa é a conta usada pelo seu aplicativo ao inserir conteúdo para usuários que não são do Power BI. Essa é realmente a única conta necessária em sua organização. Ela também pode ser usada como a conta de administrador e de analista, mas isso não é recomendável. 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. Essa conta será usada para gerar um token de inserção para o aplicativo usar para usuários que não são do Power BI.

Essa conta deverá ser administrador do espaço de trabalho do aplicativo que está sendo usado para inserção.

Registro e permissões do aplicativo

Você precisará registrar seu aplicativo no Azure AD para fazer chamadas à API REST. Para obter mais informações, consulte Registrar um aplicativo do Azure AD para inserir o conteúdo do Power BI.

Criar espaços de trabalho do aplicativo

Se você estiver inserindo dashboards e relatórios para usuários que não têm o Power BI (o aplicativo tem dados), esses dashboards e relatórios precisarão ser colocados em um espaço de trabalho de aplicativo. Para obter informações sobre como criar um espaço de trabalho de aplicativo, consulte Criar um espaço de trabalho de aplicativo.

Importante:

A conta mestre, mencionada acima, precisa ser um administrador do espaço de trabalho do aplicativo.

Criar e carregar seus relatórios

É 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. 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.

Etapa 2: inserir seu conteúdo

Dentro de seu aplicativo, será necessário autenticar com o Power BI. Se você estiver inserindo conteúdo para usuários que não são do Power BI, será necessário armazenar as credenciais da conta mestre dentro de seu aplicativo. Para obter mais informações, consulte Autenticar usuários e obter um token de acesso do Azure AD para o aplicativo do Power BI.

Depois de ser autenticar, no aplicativo, use as APIs JavaScript e as APIs do Power BI para inserir dashboards e relatórios no aplicativo.

Para inserir com usuários do Power BI (os usuários possuem dados), consulte o seguinte:

Para a inserção com usuários que não têm o Power BI (o aplicativo possui dados), que é típico para cenários de ISV, consulte o seguinte:

Ao inserir para usuários que não têm o Power BI (o aplicativo possui dados), é necessário um token de inserção. Para saber mais, consulte GenerateToken.

Etapa 3: promover sua solução para produção

Quando estiver pronto para passar para a produção, você precisará fazer o seguinte.

Usuários do Power BI (o usuário possui dados)

Se você estiver inserindo para usuários do Power BI, só será necessário explicar para as pessoas como acessar o seu aplicativo.

Os usuários Gratuitos poderão consumir o conteúdo inserido em um grupo (espaço de trabalho de aplicativo) se esse espaço de trabalho tiver o suporte de uma capacidade Premium. O usuário Gratuito precisa ser listado como membro do grupo (espaço de trabalho de aplicativo); caso contrário, você receberá um erro não autorizado 401.

Usuários que não têm o Power BI (o aplicativo possui dados)

Se você estiver inserindo para usuários que não são do Power BI, convém fazer o seguinte.

  • Embora você possa usar o locatário de produção da sua organização, é recomendável criar um novo ambiente de análise inserido para produção. Para mais informações, consulte a Etapa 1 acima.

  • Se você estiver usando um locatário separado para desenvolvimento, então será preciso certificar-se de que seus espaços de trabalho do aplicativo, juntamente com dashboards e relatórios, estão disponíveis em seu ambiente de produção. Também será preciso certificar-se de ter criado o aplicativo no Azure AD para seu locatário de produção e ter atribuído as permissões de aplicativo adequadas conforme indicado na Etapa 1.

  • Adquira uma capacidade que atenda às suas necessidades. É possível usar a tabela abaixo para entender de qual SKU de capacidade Premium você pode precisar. Para obter mais detalhes, consulte Embedded analytics capacity planning whitepaper (White paper de planejamento de capacidade de análise inserida). Quando você estiver pronto para a compra, será possível fazê-la dentro do Centro de administração do Office 365.

Nó de capacidade Total de núcleos
(Back-end + front-end)
Núcleos de back-end Núcleos de front-end Limites de conexão dinâmica/DirectQuery Máx. de renderizações de página no horário de pico Disponibilidade
EM1 1 v-cores 0,5 núcleo, 3 GB de RAM 0,5 núcleo 1-300 Julho de 2017
EM2 2 núcleos virtuais 1 núcleo, 5 GB de RAM 1 núcleo 301-600 Julho de 2017
EM3 4 núcleos virtuais 2 núcleos, 10 GB de RAM 2 núcleos 601-1.200 Julho de 2017
P1 8 v-cores 4 núcleos, 25 GB de RAM 4 núcleos 30 por segundo 1.201-2.400 Disponível
P2 16 v-cores 8 núcleos, 50 GB de RAM 8 núcleos 60 por segundo 2.401-4.800 Disponível
P3 32 v-cores 16 núcleos, 100 GB de RAM 16 núcleos 120 por segundo 4.801-9.600 Disponível
Observação:

É necessário ser um Administrador global ou de cobrança, dentro do seu locatário, para adquirir o 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).

  • Edite o espaço de trabalho do aplicativo e atribua-o a uma capacidade Premium em avançado.

  • Implante seu aplicativo atualizado para a produção e comece a inserir relatórios do serviço do Power BI.

Configurações de administração

Os Administradores Globais ou administradores do serviço do Power BI, podem ativar ou desativar a capacidade de usar as APIs REST. Os administradores podem definir essa configuração para toda a organização ou para grupos de segurança individuais. Isso é habilitado para toda a organização por padrão. Isso é feito por meio do portal de administração do Power BI.

Próximas etapas

Inserindo com o Power BI
Como migrar o conteúdo da coleção do espaço de trabalho do Power BI Embedded para o Power BI
Power BI Premium – o que é?
Como comprar o Power BI Premium
Repositório Git de API do JavaScript
Repositório Git de C# do Power BI
Exemplo inserido do JavaScript
White paper de planejamento de capacidade de análise inserida
White paper do Power BI Premium

Mais perguntas? Experimente perguntar à Comunidade do Power BI