Partilhar via


Migrar aplicações de canvas incorporadas em formulários baseados em modelo criados utilizando a versão de pré-visualização pública

Importante

Com a versão mais recente, as aplicações de tela incorporada em formulários orientados por modelos estão geralmente disponíveis. Todos os aplicativos de tela incorporados em formulários controlados por modelo criados usando a versão de visualização pública devem ser migrados para novos aplicativos de tela incorporados criados usando a versão mais recente. O suporte para aplicações canvas incorporadas em formulários orientados por modelos criados usando a versão de pré-visualização pública será preterido em breve.

Para fazer a migração de uma aplicação de canvas incorporada num formulário orientado por modelo, criada com a versão de pré-visualização pública, para a versão mais recente, os criadores devem primeiro criar uma nova aplicação de canvas incorporada usando a versão mais recente. Os criadores podem então copiar os controlos da aplicação canvas incorporada existente para a nova, adicionar as fontes de dados necessárias e atualizar referências incorretas, se houver. As etapas detalhadas são fornecidas abaixo.

  1. Inicie sessão no Power Apps.
  2. Abra a aplicação de tela embebida criada usando a versão de pré-visualização pública para ser editada no Power Apps Studio. Para conhecer as etapas de edição de um aplicativo de tela, consulte: Editar um aplicativo de tela.
  3. Num novo separador de browser, siga os passos para adicionar uma nova aplicação de tela incorporada num formulário orientado por modelos.
  4. Copie os controles do aplicativo de tela incorporado criado usando a versão de visualização pública para o novo aplicativo de tela incorporado, uma tela de cada vez, usando as etapas abaixo.
    1. Selecione o separador de browser no Passo 2 que tem a aplicação de tela integrada, criada com a versão de pré-visualização pública, aberto no Power Apps Studio.
    2. Selecione uma tela da qual copiar os controles.
    3. Use Ctrl + A para selecionar todos os controles na tela.
    4. Use Ctrl + C para copiar todos os controles selecionados.
    5. Selecione o separador de browser no Passo 3 que tem a nova aplicação de tela integrada, criada 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 concluir a cópia de todos os ecrã, selecione o separador de browser no Passo 3 que tem a nova aplicação de tela integrada, criada com a versão mais recente.
  6. Atualize todos os locais de onde a linha do formulário condicionado por modelo de anfitrião está a ser acedido. Substitua First(ModelDrivenFormIntegration.Data) por ModelDrivenFormIntegration.Item.
  7. Adicione quaisquer fontes de dados ausentes no novo aplicativo de tela incorporado.
  8. Atualize todas as referências quebradas na nova aplicação de tela incorporada.
  9. Quando terminar de fazer alterações, selecione a guia Arquivo e, em seguida, selecione Salvar.
  10. Para disponibilizar as alterações aos utilizadores finais, selecione Publicar e, em seguida, selecione Publicar esta versão.

Na versão de pré-visualização, para incorporar uma aplicação de tela num formulário orientado por modelos, os criadores tiveram de decidir antecipadamente se queriam transmitir a linha atual (formulário principal) como contexto de dados ou uma lista de linhas relacionadas com a linha atual (formulário principal). Em seguida, tiveram de adicionar o controlo de aplicação de tela à coluna ou ao controlo de subgrelha.

Com a versão mais recente, a adição de uma aplicação de tela incorporada num formulário orientado por modelos é simplificada e otimizada apenas para a coluna. Os criadores ainda podem aceder facilmente à lista de linhas relacionadas diretamente na aplicação canvas usando o conector Common Data Service.

Para migrar um aplicativo de tela incorporado 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 os passos na secção acima para migrar as aplicações de tela incorporadas em formulários orientados por modelos criadas através da versão de pré-visualização pública para a mais recente.
  2. Usando o conector 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 aquelas relacionadas à linha atual (formulário principal). A linha atual (formulário principal) está disponível via ModelDrivenFormIntegration.Item.

    Observação

    A aplicação de tela incorporada tem acesso total à linha do formulário condicionado por modelo de anfitrião através do 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 atualizações recentes, o Microsoft Dataverse agora também oferece suporte para usar exibições de tabela como filtro. Consulte esta postagem no blog para obter detalhes: Seleção aprimorada da fonte de dados e exibições do Dataverso.

Consulte também

Incorporar uma aplicação canvas em um formulário baseado em modelo
Adicionar um aplicativo de tela incorporado em um formulário controlado por modelo
Editar um aplicativo de tela incorporado em um formulário controlado por modelo
Personalizar o tamanho e a orientação de um aplicativo de ecrã incorporado num formulário baseado em modelo
Executar ações predefinidas no formulário anfitrião a partir de um aplicativo de tela incorporado
Propriedades e ações do controle ModelDrivenFormIntegration
Partilhe uma aplicação de canvas incorporada
Diretrizes sobre como trabalhar com aplicativos de tela incorporados