Cenários de uso do Power BI: inserir para a organização

Observação

Este artigo faz parte da série de artigos sobre o Planejamento de implantação do Power BI. Esta série se concentra principalmente na carga de trabalho do Power BI dentro do Microsoft Fabric. Para ter uma introdução a essa série, confira Planejamento de implementação do Power BI.

Este cenário de uso se concentra em como um desenvolvedor pode inserir conteúdo do Power BI programaticamente em um aplicativo personalizado para a organização. (O desenvolvedor não é necessariamente responsável por criar o conteúdo do Power BI.) O cenário Inserir para a organização se aplica quando o público do aplicativo é composto por usuários que têm permissão e as licenças apropriadas para acessar o conteúdo do Power BI na organização. Esses usuários devem ter contas organizacionais (incluindo contas de convidado) que se autenticam com o Microsoft Entra ID (conhecido anteriormente como Azure Active Directory).

Observação

Nesse cenário, o Power BI é SaaS (software como serviço). Às vezes, o cenário de inserção é chamado de O usuário possui dados.

Diagrama do cenário

O diagrama a seguir ilustra uma visão geral de alto nível das ações mais comuns do usuário e dos componentes do Power BI que dão suporte à inserção para a organização.

Dica

Recomendamos que você baixe o diagrama de cenário, caso deseje inseri-lo em sua apresentação, documentação ou postagem no blog, ou imprima-o como um pôster de parede. Por ser uma imagem de Gráfico Vetorial Escalonável (SVG), você pode redimensioná-la para cima ou para baixo sem perda de qualidade.

O diagrama acima ilustra as seguintes ações, ferramentas e recursos do usuário:

Item	Descrição
	O criador de conteúdo do Power BI desenvolve uma solução de BI usando o Power BI Desktop.
	Quando está tudo pronto, o criador de conteúdo publica o arquivo do Power BI Desktop (.pbix) ou o arquivo de projeto do Power BI (.pbip) no serviço do Power BI.
	Algumas fontes de dados podem exigir um gateway de dados local ou um gateway de VNet para atualização de dados, como aquelas que estão em uma rede organizacional particular.
	Um workspace do Power BI contém itens do Power BI prontos para inserção. Para workspaces não pessoais, os usuários do aplicativo personalizado têm permissão para exibir (ou criar ou modificar) conteúdo do Power BI porque pertencem a uma função de workspace ou têm permissões de direção.
	O aplicativo personalizado solicita que o usuário do aplicativo se autentique com o Microsoft Entra ID. Quando a autenticação é bem-sucedida, o aplicativo personalizado armazena em cache um token de acesso do Microsoft Entra.
	O aplicativo personalizado usa o token de acesso do Microsoft Entra para fazer chamadas à API REST do Power BI em nome do usuário do aplicativo. Especificamente, o aplicativo usa o token de acesso para recuperar metadados sobre itens de workspace. Os metadados incluem propriedades necessárias para inserir conteúdo no aplicativo personalizado.
	O aplicativo personalizado insere um item específico do Power BI em um elemento HTML iframe. O aplicativo pode dar suporte à criação e à edição de relatórios do Power BI, desde que o usuário tenha permissão para fazer isso.
	Os administradores do Power BI supervisionam e monitoram a atividade no serviço do Power BI.

Pontos-chave

Veja a seguir alguns pontos importantes a serem enfatizados sobre a inserção programática de conteúdo do Power BI em um aplicativo personalizado para a organização.

Casos de uso

Há vários motivos pelos quais você pode inserir conteúdo do Power BI para sua organização.

• Portal de business intelligence interno: talvez você queira criar um portal de BI (business intelligence) interno para substituir o serviço do Power BI. Dessa forma, você pode criar um aplicativo personalizado que integra conteúdo do Power BI e de outras ferramentas de BI.
• Aplicativo interno: talvez você queira desenvolver um aplicativo de intranet que mostre visualizações de dados. Por exemplo, um site de intranet de um departamento de fabricação pode mostrar visuais em tempo real que fornecem informações atualizadas sobre a linha de produção.
• Registro em log personalizado: talvez você queira registrar eventos personalizados para registrar o acesso e o uso de conteúdo do Power BI, além do que o log de atividades registra.

Dica

Se você estiver procurando criar um portal de BI com estilo para sua organização, poderá conseguir isso simplesmente adicionando uma identidade visual personalizada ao serviço do Power BI.

Inserção sem código

O desenvolvimento de uma solução programática requer habilidade, tempo e esforço. Considere que há técnicas de inserção conhecidas como inserção sem código que pessoas que não são desenvolvedores podem usar para inserir conteúdo em um portal interno ou site simples.

• Use a web part de relatório do Power BI para integrar relatórios do Power BI no SharePoint Online.
• Use um código de inserção seguro (ou HTML) gerado pelo Power BI para integrar relatórios do Power BI em portais da Web internos.
• Insira relatórios ou dashboards do Power BI no Power Pages.
• Inserir relatórios em um canal ou chat do Microsoft Teams.

Essas técnicas exigem que os consumidores de relatório pertençam à organização, sejam autenticados e tenham permissão para acessar os relatórios. O Power BI garante que todas as permissões e a segurança de dados sejam impostas quando os consumidores exibirem os relatórios. Às vezes, os usuários podem ser desafiados a autenticar entrando no Power BI.

Conteúdo inserível

Você pode inserir os seguintes tipos de conteúdo do Power BI para a organização:

• Relatórios do Power BI
• Visuais de relatórios específicos do Power BI
• Relatórios paginados
• Experiência de P e R
• Painéis
• Blocos de dashboard específicos

Não há nenhuma limitação sobre onde o conteúdo reside. O conteúdo pode residir em um workspace pessoal ou em um workspace normal. O que importa é que o usuário do aplicativo tenha permissão para exibir (ou criar ou editar) o conteúdo. Por exemplo, é possível inserir conteúdo do workspace pessoal do usuário do aplicativo.

Qualquer conteúdo que o usuário possa ver no serviço do Power BI pode ser inserido em um aplicativo personalizado. Se o usuário tem permissão para criar ou editar conteúdo, é possível que um aplicativo personalizado dê suporte a essa funcionalidade (somente para relatórios do Power BI).

Autenticação

O fluxo de autenticação é a autenticação interativa com o Microsoft Entra ID. Autenticação interativa significa que o usuário do aplicativo será desafiado a autenticar. Quando autenticado, o Microsoft Entra ID retorna um token de acesso. É responsabilidade do aplicativo personalizado armazenar em cache o token de acesso para que ele possa ser usado para fazer chamadas à API REST do Power BI e inserir conteúdo dentro de um elemento HTML iframe. Essas chamadas podem recuperar metadados sobre o conteúdo do Power BI em nome do usuário do aplicativo, incluindo as propriedades necessárias para inserção no aplicativo personalizado.

Licenciamento

Não há nenhum requisito de licenciamento específico para inserir para sua organização. O que importa é que o usuário do aplicativo tenha permissão e uma licença apropriada do Power BI para exibir (ou criar ou editar) o conteúdo. É possível até mesmo inserir conteúdo de um workspace pessoal quando o usuário do aplicativo tem apenas uma licença do Fabric (gratuito).

APIs de cliente do Power BI

As APIs de cliente do Power BI permitem que um desenvolvedor obtenha uma integração estreita entre o aplicativo personalizado e o conteúdo do Power BI. Ele desenvolve o aplicativo escrevendo lógica personalizada com JavaScript ou TypeScript que é executado no navegador.

O aplicativo pode configurar e automatizar operações, podendo também responder às ações iniciadas pelo usuário. Além disso, você pode integrar recursos do Power BI, incluindo navegação, filtros e segmentações, operações de menu, layout e indicadores.

Dica

O Playground de Análise do Power BI Embedded é um site que ajuda você a aprender, explorar e experimentar a análise integrada do Power BI. Inclui uma área restrita para desenvolvedores para experiências práticas que usam as APIs de cliente com conteúdo de amostra do Power BI ou seu próprio conteúdo. Snippets de código e demonstrações também estão disponíveis para você explorar.

Para obter mais informações, confira O que é o playground de análise integrada do Power BI?

Instalação do gateway

Normalmente, um gateway de dados é necessário ao acessar fontes de dados que residem na rede organizacional particular ou em uma rede virtual. As duas finalidades de um gateway são atualizarde dados importados ou exibir um relatório que consulta uma conexão dinâmica ou modelo semântico DirectQuery (anteriormente conhecido como um conjunto de dados).

Observação

Um gateway de dados centralizado no modo padrão é altamente recomendado, em vez de gateways no modo pessoal. No modo padrão, o gateway de dados dá suporte a operações de conexão dinâmica e do DirectQuery (além das operações de atualização de dados agendadas).

Supervisão do sistema

O log de atividades registra as atividades do usuário que ocorrem no serviço do Power BI. Os administradores do Power BI podem usar os dados de log de atividades coletados para executar a auditoria, a fim de ajudar a entender os padrões de uso e a adoção. Os eventos registrados descreverão o método de consumo como Inserção para a organização. Atualmente, não há como determinar se o conteúdo foi exibido em uma experiência de inserção sem código em um aplicativo personalizado.

Conteúdo relacionado

Para saber mais sobre a análise integrada do Power BI, trabalhe no roteiro de aprendizagem Inserir análise do Power BI.

Você também pode trabalhar no curso Desenvolvedor do Power BI em um Dia. Ele inclui um kit autodidático que orienta você por meio do desenvolvimento de um aplicativo MVC ASP.NET Core.

Para outros cenários úteis para ajudar com decisões de implementação do Power BI, confira o artigo Cenários de uso do Power BI.