Cenários de utilização do Power BI: Incorporar para a sua organização
Nota
Este artigo faz parte da série de artigos de planejamento de implementação do Power BI. Esta série se concentra principalmente na experiência do Power BI no Microsoft Fabric. Para obter uma introdução à série, consulte Planejamento de implementação do Power BI.
Este cenário de uso se concentra em como um desenvolvedor pode incorporar programaticamente o conteúdo do Power BI em um aplicativo personalizado para sua organização. (O desenvolvedor não é necessariamente responsável pela criação do conteúdo do Power BI.) O cenário Incorporar para sua organização se aplica quando o público do aplicativo é composto por usuários que têm permissão e 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.
Nota
Nesse cenário, o Power BI é software como serviço (SaaS). O cenário de incorporação às vezes é chamado de dados de propriedade do usuário.
Diagrama de cenário
O diagrama a seguir mostra uma visão geral de alto nível das ações mais comuns do usuário e dos componentes do Power BI que oferecem suporte à incorporação para sua organização.
Gorjeta
Recomendamos que você baixe o diagrama de cenário se quiser incorporá-lo em sua apresentação, documentação ou postagem de blog, ou imprimi-lo como um pôster de parede. Como é uma imagem SVG (Scalable Vetor Graphics), você pode dimensioná-la para cima ou para baixo sem perda de qualidade.
O diagrama acima descreve 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 estiver 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 VNet para atualização de dados, como aqueles que residem em uma rede organizacional privada. |
 |
Um espaço de trabalho do Power BI contém itens do Power BI prontos para incorporação. Para espaços de trabalho 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 espaço de trabalho ou têm permissões de direção. |
 |
O aplicativo personalizado solicita que o usuário do aplicativo se autentique com o ID do Microsoft Entra. 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 de 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 do espaço de trabalho. Os metadados incluem propriedades necessárias para incorporar conteúdo no aplicativo personalizado. |
 |
O aplicativo personalizado incorpora um item específico do Power BI em um iframe elemento HTML. 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 fazê-lo. |
 |
Os administradores do Power BI supervisionam e monitoram a atividade no serviço do Power BI. |
Pontos principais
A seguir estão alguns pontos-chave a serem enfatizados sobre a incorporação programática de conteúdo do Power BI em um aplicativo personalizado para sua organização.
Casos de utilização
Há vários motivos pelos quais você pode incorporar conteúdo do Power BI para sua organização.
- Portal interno de business intelligence: talvez você queira criar um portal interno de business intelligence (BI) como um substituto para o serviço do Power BI. Dessa forma, você pode criar um aplicativo personalizado que integra conteúdo do Power BI e 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 para 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 do conteúdo do Power BI, além do que o log de atividades registra.
Gorjeta
Se você estiver procurando criar um portal de BI com estilo para sua organização, poderá conseguir isso simplesmente adicionando identidade visual personalizada ao serviço do Power BI.
Incorporação sem código
Desenvolver uma solução programática requer habilidade, tempo e esforço. Considere que existem técnicas de incorporação conhecidas como incorporação sem código que não desenvolvedores podem usar para incorporar conteúdo em um portal interno simples ou site.
- Use a Web Part de relatório do Power BI para incorporar relatórios do Power BI no SharePoint Online.
- Use um código de incorporação seguro (ou HTML) gerado pelo Power BI para incorporar relatórios do Power BI em portais da Web internos.
- Incorpore relatórios ou dashboards do Power BI no Power Pages.
- Incorpore relatórios em um canal ou bate-papo 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 segurança de dados sejam aplicadas quando os consumidores visualizam os relatórios. Às vezes, os usuários podem ser desafiados a autenticar entrando no Power BI.
Conteúdo incorporável
Ao incorporar para sua organização, você pode incorporar os seguintes tipos de conteúdo do Power BI:
- Relatórios do Power BI
- Visuais de relatório específicos do Power BI
- Relatórios paginados
- Experiência de P&R
- Dashboards
- Blocos específicos do painel
Não há limitação de onde o conteúdo reside. O conteúdo pode residir em um espaço de trabalho pessoal ou regular. O que importa é que o usuário do aplicativo tenha permissão para visualizar (ou criar ou editar) o conteúdo. Por exemplo, é possível incorporar conteúdo do espaço de trabalho pessoal do usuário do aplicativo.
Qualquer conteúdo que o usuário possa ver no serviço do Power BI pode ser incorporado em um aplicativo personalizado. Se o usuário tiver permissão para criar ou editar conteúdo, é possível que um aplicativo personalizado ofereça 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. A 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 de API REST do Power BI e incorporar conteúdo dentro de um iframe elemento HTML. 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 incorporá-lo no aplicativo personalizado.
Licenciamento
Não há nenhum requisito de licenciamento específico para incorporar à 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. É até possível incorporar conteúdo de um espaço de trabalho pessoal quando o usuário do aplicativo tem apenas uma licença Fabric (gratuita).
APIs de cliente do Power BI
As APIs de cliente do Power BI permitem que um desenvolvedor obtenha uma integração total entre o aplicativo personalizado e o conteúdo do Power BI. Eles desenvolvem o aplicativo escrevendo lógica personalizada com JavaScript ou TypeScript que é executado no navegador.
O aplicativo pode configurar e automatizar operações, e pode responder a ações iniciadas pelo usuário. Além disso, você pode integrar recursos do Power BI, incluindo navegação, filtros e segmentações de dados, operações de menu, layout e marcadores.
Gorjeta
O Power BI Embedded Analytics Playground é um site que ajuda você a aprender, explorar e experimentar análises incorporadas do Power BI. Ele inclui uma área restrita do desenvolvedor para experiências práticas que usam as APIs do cliente com conteúdo de exemplo do Power BI ou seu próprio conteúdo. Trechos de código e vitrines também estão disponíveis para você explorar.
Para obter mais informações, consulte O que é o playground de análise incorporada do Power BI?
Configuração do gateway
Normalmente, um gateway de dados é necessário ao acessar fontes de dados que residem na rede organizacional privada ou em uma rede virtual. As duas finalidades de um gateway são atualizar dados importados ou exibir um relatório que consulta uma conexão em tempo real ou um modelo semântico DirectQuery .
Nota
Um gateway de dados centralizado no modo padrão é altamente recomendado em relação aos gateways no modo pessoal. No modo padrão, o gateway de dados suporta conexão ao vivo e operações DirectQuery (além de 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 do log de atividades coletados para executar auditorias para ajudá-los a entender os padrões de uso e a adoção. Os eventos registrados descreverão o método de consumo como Incorporação para sua organização. Atualmente, não há como determinar se o conteúdo foi exibido em uma experiência de incorporação sem código em um aplicativo personalizado.
Conteúdos relacionados
Para saber mais sobre a análise incorporada do Power BI, trabalhe no caminho de aprendizagem Incorporar análise do Power BI.
Você também pode trabalhar através do curso Power BI Developer in a Day. Ele inclui um kit de autoestudo que o orienta pelo processo de desenvolvimento de um aplicativo MVC ASP.NET Core.
Para obter outros cenários úteis para ajudá-lo com decisões de implementação do Power BI, consulte o artigo Cenários de uso do Power BI.