Comentários

Transmitir uma lista de registros relacionados como contexto de dados a um aplicativo de tela incorporado

  • Artigo
  • 6 minutos para o fim da leitura

Importante

Os aplicativos de tela incorporados em formulários orientados a modelo agora estão fora de visualização e geralmente disponíveis. As etapas listadas abaixo estão desatualizadas e são aplicáveis somente à versão preliminar pública de aplicativos de tela incorporados em formulários baseados em modelo. Para obter a lista atualizada de etapas da última versão, acesse: Adicionar um aplicativo de tela incorporado em um formulário baseado em modelo

Visão geral

Este artigo explica como adicionar um aplicativo de tela incorporado e transmitir uma lista de registros relacionados ao atual registro (formulário principal) como um contexto de dados para o aplicativo de tela incorporado.

Procedimento

Vamos supor que você queira adicionar um aplicativo de tela incorporado ao formulário principal de uma conta e transmitir uma lista de contatos relacionados ao atual registro da conta para o aplicativo de tela incorporado. Para fazer isso, siga estas etapas:

  1. Entre no Power Apps e abra o editor de formulários para acessar o formulário principal de uma tabela, como a tabela de conta.

  2. Selecione a seção do formulário onde você quer que o aplicativo de tela incorporado apareça.

  3. Com a seção selecionada, na guia Inserir, no grupo Controle, selecione Subgrade.

  4. Na caixa de diálogo Definir Propriedades, selecione a guia Exibir e, na caixa Nome, insira um nome para o controle de grade.

  5. Na seção Fonte de Dados, selecione uma Tabela e uma Exibição Padrão que correspondam à lista de registros que você deseja transmitir como contexto de dados para o aplicativo de tela incorporado.

  6. Selecione a guia Controles e, em seguida, selecione Adicionar Controle...

  7. Na caixa de diálogo Adicionar Controle, na lista de controles disponíveis, selecione Aplicativo de tela e, em seguida, selecione Adicionar.

  8. Na caixa de diálogo Definir Propriedades, na lista de controles, selecione Aplicativo de tela e, em seguida, selecione a opção Web.

  9. Na seção abaixo da lista de controles, veja a lista de propriedades correspondentes ao controle do aplicativo de Tela e observe o seguinte:

    • A propriedade Nome da tabela especifica a tabela que fornecerá os dados ao seu aplicativo de tela inserido. A tabela será aquela que você selecionou anteriormente.
      • Embora essa propriedade pareça mutável, sua alteração não tem impacto no aplicativo de tela incorporado. Ela serve somente como referência para você.
    • A propriedade Nome da exibição especifica a exibição da tabela que será usada para filtrar os dados fornecidos ao seu aplicativo de tela inserido. Ela será a Exibição Padrão que você selecionou anteriormente.
      • Os dados (campos e valores) enviados ao aplicativo de tela incorporado no tempo de execução são determinados por essa exibição. Use somente as colunas do aplicativo de tela que estiverem incluídos na exibição ou adicione-as a ela, se necessário. As colunas que não forem incluídas na exibição serão exibidas como valores vazios no runtime.
      • Os critérios de filtragem de uma exibição não serão usados no momento da criação. Portanto, os dados que você vê ao criar aplicativos de tela incorporados não são filtrados, são simplesmente uma lista de alguns dos principais registros aos quais tem acesso. No tempo de execução, os critérios de filtragem da exibição são aplicados conforme o esperado, portanto, os usuários veem somente os dados relevantes.
    • A propriedade ID do Aplicativo especifica a ID do aplicativo de tela incorporado. Ela é automaticamente gerada e preenchida para você quando o aplicativo de tela é criado.
      • Observe que qualquer alteração no valor da ID do Aplicativo desfaz o vínculo entre o formulário controlado por modelos e o aplicativo de tela incorporado.

  10. Selecione o botão Personalizar para criar ou editar o aplicativo de tela. Isso abrirá o Power Apps Studio em uma guia do navegador.

    Importante

    • A opção Personalizar está atualmente disponível apenas usando o designer de formulários clássico.
    • Se a abertura do Power Apps Studio for bloqueada por um bloqueador de pop-ups do navegador da web, você deve habilitar o site make.powerapps.com ou desabilitar temporariamente o bloqueador de pop-ups e selecionar Personalizar novamente.

  11. No Power Apps Studio, observe que há um controle ModelDrivenFormIntegration localizado no painel esquerdo. Esse controle é responsável por levar dados contextuais do formulário controlado por modelos de host ao aplicativo de tela incorporado.

  12. Selecione o controle Gallery1 e observe que a propriedade Itens está definida como ModelDrivenFormIntegration.Data.

  13. No painel de propriedades à direita, ao lado de Colunas, selecione Editar.

  14. No painel de dados, altere a coluna mapeada para o controle Título1 para NomeCompleto ou outra coluna que contenha dados.

  15. Observe que a galeria exibe os dados que estão sendo transmitidos a ela do formulário controlado por modelos de host por meio do controle ModelDrivenFormIntegration. Feche o painel de dados.

  16. Selecione a guia Arquivo e, em seguida, selecione Configurações.

  17. Na guia Recursos futuros, na seção Recursos experimentais, defina Otimizar a aparência de incorporação como Ativado.

  18. Selecione a guia Geral. Forneça um nome exclusivo para o aplicativo e selecione Salvar. Observe o seguinte:

    • Quando você salva um aplicativo pela primeira vez, ele é publicado automaticamente.
    • Nos salvamentos subsequentes, selecione Publicar e, em seguida, selecione Publicar esta versão para disponibilizar suas alterações.

  19. Feche a caixa de diálogo Configurações.

  20. Selecione Voltar e, em seguida, selecione a guia do navegador onde o editor de formulários está aberto.

  21. Observe que a propriedade ID do Aplicativo do controle do Aplicativo de tela agora tem o valor automaticamente preenchido. Observe o seguinte:

    • O editor de formulários tem um link direto com o Power Apps Studio que foi aberto em outra guia do navegador em uma etapa anterior.
    • O editor de formulários aguarda o envio da ID do Aplicativo para ele.
    • A ID do Aplicativo foi enviada para ele quando o aplicativo foi salvo.

  22. Na caixa de diálogo Definir Propriedades, selecione a guia Exibir, desmarque Exibir rótulo no formulário e, em seguida, selecione OK.

  23. Na guia Início, selecione Salvar e, em seguida, selecione Publicar.

Depois de adicionar um aplicativo de tela incorporado ao seu formulário controlado por modelos, compartilhe-o com outros usuários. Mais informações: Compartilhar um aplicativo de tela incorporado.

Quando os usuários abrem um aplicativo controlado por modelos (somente Interface Unificada) que inclui o formulário que você modificou, eles veem o aplicativo de tela incorporado no formulário. A alteração do registro exibido no formulário principal altera o contexto de dados que é transmitido ao formulário e o aplicativo incorporado atualiza para mostrar os dados relevantes.

Este artigo apresentou uma introdução à incorporação de um aplicativo de tela em um formulário baseado em modelo. É possível personalizar ainda mais o aplicativo de tela incorporado para se conectar e receber dados de várias fontes. Use as funções Filtrar, Pesquisar e LookUp, além do contexto transmitido do formulário controlado por modelos do host para filtrar ou encontrar registros específicos nessas fontes de dados. Use o editor de aplicativo de tela WYSIWYG para projetar facilmente a interface a fim de corresponder aos seus requisitos.

Consulte também

Incorporar um aplicativo de tela em um formulário controlado por modelos
Adicionar um aplicativo de tela incorporado em um formulário orientado a modelo
Editar um aplicativo de tela incorporado em um formulário orientado a modelo
Personalizar o tamanho da tela e a orientação de um aplicativo de tela incorporado em um formulário orientado a modelo
Executar ações predefinidas no formulário do host dentro de um aplicativo de tela incorporado
Propriedades e ações do controle ModelDrivenFormIntegration
Compartilhar um aplicativo de tela incorporado
Diretrizes sobre como trabalhar com aplicativos de tela incorporados
Migrar aplicativos de tela incorporados em formulários orientados a modelo criados usando a versão de visualização pública para a mais recente

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).