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 outros serviços, como Power BI ou SharePoint.

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

Painel do Power BI com o aplicativo inserido

Lembre-se as seguintes restrições:

  • Somente os usuários do PowerApps no mesmo locatário podem acessar o aplicativo inserido.
  • Para acessar o PowerApps usando o Internet Explorer 11, desligue o modo de exibição de compatibilidade.

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

Inserir seu aplicativo agora é tão simples quanto adicionar iframe no código HTML para seu site (ou qualquer outro serviço que dá suporte a iframes, como o Power BI ou o SharePoint):

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

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 – sites e em dashboards do Power BI, páginas do SharePoint e mais.