Os aplicativos que você cria costumam ser mais úteis quando estão disponíveis exatamente no local em que as pessoas estão trabalhando. O PowerApps permite inserir aplicativos em um IFrame, de forma que você possa integrá-los em sites e painéis do Power BI.

Neste tópico, mostraremos como definir parâmetros para a inserção de aplicativos; em seguida, inseriremos nosso aplicativo Asset Ordering em um site e um painel.

Painel do Power BI com o aplicativo inserido

Observação: somente os usuários do PowerApps no mesmo locatário podem acessar o aplicativo inserido.

Também é possível integrar o PowerApps no SharePoint Online (sem o uso de um IFrame). Para obter mais informações, consulte Gerar um aplicativo no SharePoint usando o PowerApps.

Definir parâmetros do URI para o aplicativo

Caso você tenha um aplicativo que deseja inserir, a primeira etapa é definir os parâmetros do URI (Uniform Resource Identifier), de forma que o IFrame saiba onde encontrar o aplicativo. O URI está no seguinte formato:

https://web.powerapps.com/webplayer/iframeapp?source=iframe
&appId=/providers/Microsoft.PowerApps/apps/[AppID]

Observação: adicionamos uma quebra de linha para que o URI seja melhor exibido na página.

Basta substituir a ID do aplicativo por [AppID] no URI (incluindo '[' e ']'). Mostraremos como obter esse valor daqui a pouco, mas primeiro, aqui estão todos os parâmetros disponíveis no URI:

  • [appID] – está no formato /providers/Microsoft.PowerApps/apps/[AppID]. Fornece a ID do aplicativo a ser executado.
  • screenColor – é usado para fornecer uma melhor experiência de upload do aplicativo para os usuários. Esse parâmetro está no formato RGBA (valor de vermelho, valor de verde, valor de azul, alfa) e controla a cor da tela enquanto o aplicativo é carregado. É melhor defini-lo com a mesma cor do ícone do aplicativo.
  • source – não afeta o aplicativo, mas sugerimos que você adicione um nome descritivo para se referir à fonte da inserção.
  • Por fim, você pode adicionar todos os parâmetros personalizados que desejar usando a função Param() e esses valores podem ser consumidos pelo aplicativo. Eles são adicionados ao final do URI, como [AppID]&param1=value1. Esses parâmetros são lidos apenas durante a inicialização do aplicativo; se você precisar alterá-los, precisará reiniciar o aplicativo.

Obter a ID do Aplicativo

A ID do aplicativo está disponível em powerapps.com. Para o aplicativo que você deseja inserir:

  1. Em powerapps.com, na guia Aplicativos, clique ou toque nas reticências (... ) e, em seguida, em Detalhes.

    Acessar os detalhes do aplicativo

  2. Copie a ID do Aplicativo.

    Copiar a ID do aplicativo em Detalhes

  3. Substitua o valor [AppID] no URI. Em nosso aplicativo Asset Ordering, o URI é parecido com este:

    https://web.powerapps.com/webplayer/iframeapp?hideNavBar=true&
    source=iframe&appId=/providers/Microsoft.PowerApps/apps/76897698-91a8-b2de-756e-fe2774f114f2
    

Inserir seu aplicativo em um site

Agora, inserir seu aplicativo é tão simples quanto adicionar o IFrame ao código HTML do site:

<iframe width="[W]" height="[H]" src="https://web.powerapps.com/webplayer/iframeapp?hideNavBar=true&
source=website&screenColor=rgba(165,34,55,1)&appId=/providers/Microsoft.PowerApps/apps/[AppID]"/>

Especifique valores para a largura e altura do IFrame e substitua a ID do aplicativo por [AppID].

A imagem a seguir mostra o aplicativo Asset Ordering inserido em um site de exemplo da Contoso.

Site da Contoso com o aplicativo inserido

Tenha os seguintes pontos em mente para autenticar usuários de seu aplicativo:

  • Caso seu site use a autenticação baseada no AAD (Azure Active Directory), nenhuma entrada adicional será necessária.
  • Caso seu site use outro mecanismo de entrada ou não seja autenticado, os usuários verão um prompt de entrada no IFrame. Depois que eles entrarem, poderão executar o aplicativo, desde que o autor do aplicativo tenha o compartilhado com eles.

Inserir seu aplicativo em um painel do Power BI

Em harmonia com nossa visão de medir, agir e automatizar, acreditamos que o melhor lugar para usar um aplicativo é, em geral, no contexto dos dados medidos e dos relatórios monitorados.

Neste exemplo, criamos um painel do Power BI para monitorar as vendas de produtos de nossa empresa. Observamos as tendências de vendas de hardware de computador nesse painel e solicitamos um novo inventário de hardware diretamente no painel, por meio do aplicativo inserido. A inserção do aplicativo permite que nossos especialistas em inventário acessem um único local para realizar seu trabalho e eles estão satisfeitos em permanecer no painel do Power BI com o qual estão acostumados.

Na imagem a seguir, você vê o aplicativo Asset Ordering inserido diretamente no painel, juntamente com os valores de vendas que fornecem o contexto para o processo de pedidos de hardware.

Painel do Power BI com o aplicativo inserido

Para inserir um aplicativo em um painel do Power BI, siga estas etapas:

  1. Crie o URI, conforme mostrado anteriormente:

    https://web.powerapps.com/webplayer/iframeapp?hideNavBar=true&
    source=powerbi&appId=/providers/Microsoft.PowerApps/apps/76897698-91a8-b2de-756e-fe2774f114f2
    
  2. Adicione o URI a um IFrame. Nesse caso, definimos a largura e altura como 98% para evitar o uso de barras de rolagem em nosso bloco:

    <iframe width="98%" height="98%" src="https://web.powerapps.com/webplayer/iframeapp?hideNavBar=true&
    source=powerbi&appId=/providers/Microsoft.PowerApps/apps/76897698-91a8-b2de-756e-fe2774f114f2"/>
    
  3. Acesse o painel do Power BI em que você deseja inserir o aplicativo.

  4. No painel, na barra de menus superior, clique ou toque em Adicionar Bloco. Dependendo das limitações de espaço, você poderá ver apenas o sinal de adição (+).

    Adicionar um bloco ao painel do Power BI

  5. Clique ou toque em CONTEÚDO DA WEB e em Avançar.

    Adicionar um conteúdo da Web a um painel

  6. Cole o código do IFrame no campo Código de inserção e, em seguida, clique ou toque em Aplicar.

    Código de inserção para o conteúdo da Web

  7. Agora, o bloco deverá ser exibido no painel e você poderá movê-lo para o local desejado, assim como outros blocos. Para obter mais informações sobre como adicionar blocos a um painel, consulte Adicionar imagem, texto, vídeo e muito mais ao seu painel.

Como você pode ver, a inserção de aplicativos é simples e eficaz. A inserção permite que você leve os aplicativos diretamente para os locais em que você e seus clientes trabalham – em sites e em painéis do Power BI.