Compartilhar via


Migrar aplicativos de tela incorporados em formulários orientados a modelo criados usando a versão preliminar pública

Importante

Com a versão mais recente, os aplicativos de tela incorporados em formulários orientados a modelo geralmente estão disponíveis. Todos os aplicativos de tela inseridos em formulários baseados em modelos criados usando a versão de visualização pública devem ser migrados para novos aplicativos de tela inseridos criados usando a versão mais recente. O suporte para aplicativos canvas incorporados em formulários baseadas em modelo criados usando a versão de visualização pública será preterido em breve.

Para migrar um aplicativo de tela incorporado em um formulário orientado a modelo criado usando a versão preliminar pública para a mais recente, os fabricantes primeiro precisam criar um aplicativo de tela incorporado usando a versão mais recente. Os criadores podem copiar os controles do aplicativo de tela embutida existente para o novo, adicionar as fontes de dados necessárias e atualizar as referências quebradas, se houver. Etapas detalhadas são fornecidas abaixo.

  1. Entre no Power Apps.
  2. Abra o aplicativo canvas embutido criado usando a versão preliminar pública para edição no Power Apps Studio. Para obter etapas sobre como editar um aplicativo de tela, consulte: Editar um aplicativo de tela.
  3. Em uma nova guia do navegador, siga as etapas para adicionar um novo aplicativo de canvas incorporado em um formulário baseado em modelo.
  4. Copie os controles do aplicativo de tela inserida criado usando a versão de visualização pública para o novo aplicativo de tela inserida, uma tela de cada vez usando as etapas abaixo.
    1. Selecione a guia do navegador da Etapa 2, que tem o aplicativo de tela incorporado, criado com a versão preliminar pública, aberta no Power Apps Studio.
    2. Selecione uma tela da qual copiar controles.
    3. Use Ctrl + A para selecionar todos os controles na tela.
    4. Use Ctrl + C para copiar todos os controles selecionados.
    5. Selecione a guia do navegador da Etapa 3, que tem o novo aplicativo de tela incorporado criado com a versão mais recente.
    6. Selecione uma tela ou adicione uma nova.
    7. Use Ctrl + V para colar os controles na tela selecionada.
    8. Repita as etapas para copiar cada tela.
  5. Quando terminar de copiar todas as telas, selecione a guia do navegador na Etapa 3, que tem o novo aplicativo de tela incorporado criado com a versão mais recente.
  6. Atualize todos os locais em que a linha do formulário baseado em modelo modelo de host está sendo acessada. Substitua First(ModelDrivenFormIntegration.Data) por ModelDrivenFormIntegration.Item.
  7. Adicione as fontes de dados ausentes no novo aplicativo de canvas incorporado.
  8. Atualize todas as referências quebradas no novo aplicativo de tela incorporado.
  9. Quando terminar de fazer alterações, selecione a guia Arquivo e, em seguida, selecione Salvar.
  10. Para disponibilizar suas alterações aos usuários finais, selecione Publicar e, em seguida, selecione Publicar esta versão.

Na versão de visualização, para incorporar um aplicativo de tela em um formulário baseado em modelo, os criadores tinham que decidir antecipadamente se queriam transmitir a linha atual (formulário principal) como contexto de dados ou uma lista de linhas relacionadas à linha atual (formulário principal). Eles então tiveram que adicionar o controle de aplicativo de tela ao controle de coluna ou subgrade.

Com a versão mais recente, a adição de um aplicativo de tela inserido em um formulário baseado em modelo é simplificada e otimizada apenas para a coluna. Os criadores ainda podem acessar facilmente a lista de linhas relacionadas diretamente no aplicativo de tela usando o conector do Common Data Service.

Para migrar um aplicativo de tela inserido em um formulário controlado por modelo que usa uma lista de linhas relacionadas à linha atual (formulário principal), siga as etapas abaixo.

  1. Siga as etapas na seção acima para migrar aplicativos de tela incorporados em formulários orientados a modelo criados usando a versão preliminar pública para a mais recente.
  2. Usando o conector do Common Data Service, adicione uma fonte de dados para a tabela relacionada ao aplicativo. Para saber como adicionar uma fonte de dados em um aplicativo de tela, consulte Adicionar uma conexão de dados a um aplicativo de tela no Power Apps.
  3. Ao usar a fonte de dados da tabela relacionada para um controle como Galeria ou tabela de dados, use a função Filtro para filtrar as linhas para as que estão relacionadas à linha atual (formulário principal). A linha atual (formulário principal) está disponível por meio de ModelDrivenFormIntegration.Item.

    Observação

    O aplicativo de tela inserido tem acesso total à linha do formulário baseado em modelo do host por meio de ModelDrivenFormIntegration.Item. Por exemplo, para obter o valor de uma coluna com o nome accountnumber e o nome de exibição Account Number, você pode usar ModelDrivenFormIntegration.Item.accountnumber ou ModelDrivenFormIntegration.Item.'Account Number'.

  4. Com as atualizações recentes, o Microsoft Dataverse agora também oferece suporte para usar exibições de tabela como um filtro. Confira esta postagem no blog para obter detalhes: Melhor seleção da fonte de dados e exibições do Dataverse.

Consulte também

Inserir um aplicativo canvas em um formulário controlado por modelo
Adicionar um aplicativo de canvas embutido em um formulário baseado em modelo
Editar um aplicativo de tela incorporado em um formulário baseado em modelo
Personalizar o tamanho da tela e a orientação de um aplicativo canvas inserido em um formulário controlado por 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 canvas embutido
Diretrizes sobre como trabalhar com aplicativos de tela embarcados