Comentários

Transmitir o registro atual 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 de visualização pública de aplicativos de tela incorporados em formulários orientados a modelo. Para obter a lista atualizada de etapas da última versão, consulte: Adicionar um aplicativo de tela incorporado em um formulário orientado a modelo

Este tópico explica como adicionar um aplicativo de tela incorporado e transmitir o atual registro (do formulário principal) como um contexto de dados para esse aplicativo.

Imagine que você queira adicionar um aplicativo de tela incorporado ao formulário principal de uma conta e transmitir o atual registro da conta para esse aplicativo. 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. Usando o painel do gerenciador de colunas, adicione uma coluna obrigatória, como Nome da Conta.

    Importante

    Sempre use uma coluna obrigatória que certamente terá um valor. Se a coluna não tiver um valor, o aplicativo de tela inserido não atualizará em resposta a nenhuma alteração de dados no formulário controlado por modelos de host.

  4. Com a coluna selecionada, na guia Página Inicial, no grupo Editar, selecione Alterar Propriedades.
  5. Na caixa de diálogo Propriedades da Coluna, selecione a guia Controles.
  6. Na guia Controles, 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 Propriedades da Coluna, 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, a lista de propriedades disponíveis para o controle do aplicativo de tela é exibida.
    • A propriedade Nome da tabela especifica a tabela que fornecerá os dados ao seu aplicativo de tela inserido. A tabela será aquela que contiver a coluna que você adicionou em uma etapa anterior.
      • Observe que, 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 ID do Aplicativo especifica a ID do aplicativo de tela incorporado. Ela será automaticamente gerada e preenchida para você quando o aplicativo de tela for 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 Personalizar para criar ou editar o aplicativo de tela. Isso abrirá o Power Apps Studio em uma nova guia.

    Observação

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

    Observação

    ModelDrivenFormIntegration.Data é uma lista de registros. Nesse exemplo, ela tem apenas um registro. Para fazer referência direta ao registro, você pode usar a função First. Por exemplo, First(ModelDrivenFormIntegration.Data).Name.

  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 Nome 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. No menu, selecione Voltar e, em seguida, selecione a guia do navegador onde o editor de formulários está aberto. 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 é enviada ao editor de formulários quando o aplicativo é salvo.
  21. Na caixa de diálogo Propriedades da Coluna, selecione a guia Exibir.
  22. 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 da linha exibida no formulário principal altera o contexto de dados que é transmitido ao formulário e o aplicativo inserido atualiza para mostrar os dados relevantes.

Este tópico apresentou uma introdução à incorporação de um aplicativo de tela em um formulário controlado por modelos. É 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).