Adicionar uma aplicação de tela num formulário condicionado por modelo

Este artigo explica como incorporar uma aplicação de tela num formulário condicionado por modelo. As aplicações de tela podem ser ligadas a uma ampla gama de origens de dados e oferecem aos estruturadores um maior controlo sobre a experiência do utilizador geral.

Neste artigo são descritos dois métodos de integração. Primeiro, utilizando a experiência da Interface Unificada moderna e, em segundo lugar, utilizando a experiência clássica.

Nota

Existe um terceiro e mais recente método de incorporação de aplicações de tela dentro de uma aplicação moderna, a qual utiliza páginas personalizadas para uma melhor integração com aplicações de tela. Descrição geral das páginas personalizadas para aplicações condicionadas por modelo.

Incorporar uma aplicação de tela utilizando a experiência moderna

Para incorporar uma aplicação de tela num formulário principal de aplicação condicionada por modelo, como o formulário principal para a tabela Contas, siga estes passos:

1. Inicie sessão no Power Apps.

2. Escolha o ambiente e, em seguida, selecione Soluções a partir do painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.

3. Abra a solução que tem a tabela onde pretende adicionar uma aplicação de tela a um formulário principal.

4. Abra a tabela, selecione Formulários e, em seguida, abra o formulário Principal que pretende.

   Sugestão

   Por predefinição, a etiqueta do componente da aplicação de tela é Nova aplicação de tela. Pode querer alterar o nome da etiqueta da aplicação de tela para algo mais significativo, como o nome da aplicação de tela ou uma breve descrição da aplicação de tela que está a incorporar no formulário.

5. Selecione a área no formulário onde pretende que a aplicação de tela seja apresentada ou crie um novo separador para apresentar a aplicação de tela.

6. No painel de navegação esquerdo, selecione Componentes, expanda Apresentação e, em seguida, selecione o componente de Aplicação de tela.

7. As propriedades que se seguem podem ser configuradas para o controlo.

   • A área Nome da entidade permite-lhe especificar as seguintes propriedades:

     • Vincular à coluna de tabela: quando Vincular à coluna de tabela está selecionado, a propriedade de Valor estático muda para que possa selecionar a coluna de tabela a que vincular. Quando optar por vincular a uma coluna de tabela, a coluna será definida pelo valor da coluna de tabela. Por exemplo, quando Vincular à coluna de tabela está selecionado para o Nome da entidade, no runtime da aplicação, o valor do nome da tabela tem o valor da Coluna da tabela especificada.

     • Valor estático: utilize isto para adicionar um nome para se referir à aplicação de tela. Note que este valor não tem qualquer efeito na aplicação de tela incorporada. Pretende servir apenas como ponto de referência.

   • A área Nome da aplicação especifica o nome exclusivo da aplicação de tela.

     • Vincular à coluna de tabela: quando seleciona Vincular à coluna de tabela, a propriedade de Valor estático muda para que possa selecionar a coluna de tabela a que vincular. Quando optar por vincular a uma coluna de tabela, a coluna será definida pelo valor da coluna de tabela. Por exemplo, quando seleciona Vincular à coluna de tabela para o Nome da Aplicação, no runtime da aplicação o valor do nome da aplicação tem o valor da Coluna de tabela, tal como o valor de uma coluna de texto personalizada.

     • Valor estático: especifica o nome exclusivo da aplicação de tela a incorporar. Introduza o nome exclusivo da aplicação de tela para uma aplicação de tela existente. Mais informações: Como encontrar o nome exclusivo e o ID da aplicação para uma aplicação de tela

   • A área ID da Aplicação obrigatória especifica o ID da aplicação de tela.

     • Vincular à coluna de tabela: quando selecionar Vincular à coluna de tabela, a lista muda para que possa selecionar a coluna de tabela a que se vincula. Quando optar por vincular a uma coluna de tabela, a coluna será definida pelo valor da coluna de tabela. Por exemplo, quando seleciona Vincular à coluna de tabela para o Nome da Aplicação, no runtime da aplicação o valor do nome da aplicação tem o valor da coluna, tal como o valor de uma coluna de texto personalizada.

     Importante

     Para a maioria das situações, não recomendamos a utilização da opção Vincular à coluna de tabela para o ID da Aplicação, pois isso exigiria que o ID da aplicação correto fosse mostrado num campo dentro do registo.

     • Valor estático: introduza o ID da aplicação para uma aplicação de tela existente. Mais informações: Como encontrar o nome exclusivo e o ID da aplicação para uma aplicação de tela

   • Mostrar componente em. Especifica o tipo de cliente a apresentar a aplicação de tela incorporada. Escolha entre Web, Telemóvel e Tablet.

8. Selecionar Concluído. Em seguida, para publicar a sua aplicação para a disponibilizar para os utilizadores, selecione Publicar.

Depois de publicar uma aplicação de tela incorporada ao formulário orientado por modelos, partilhe a aplicação de tela incorporada com outros utilizadores. Mais informações: Partilhar uma aplicação de tela incorporada.

Quando os utilizadores abrem uma aplicação condicionada por modelo que inclui o formulário que modificou, veem a aplicação de tela incorporada no formulário. Alterar o registo de apresentado no formulário principal altera o contexto de dados que é transmitido ao formulário e a aplicação incorporada é atualizada para mostrar os dados relevantes.

Este artigo mostrou como começar a incorporar uma aplicação de tela num formulário condicionado por modelo. Pode continuar a personalizar a aplicação de tela incorporada para ligar e obter dados a partir de várias origens de dados. Utilize as funções Filtrar, Procurar e Pesquisar, e o contexto transmitido do formulário anfitrião orientado por modelos, para filtrar ou localizar registos específicos nessas origens de dados. Utilize o editor de aplicações de tela WYSIWYG para conceber facilmente a interface à medida dos seus requisitos.

Como encontrar o nome exclusivo e o ID da aplicação para uma aplicação de tela

O controlo canvas app procura primeiro pela aplicação de tela utilizando o nome exclusivo encontrado no campo Nome da aplicação. Se uma aplicação de tela com esse nome exclusivo não puder ser encontrada no ambiente, o controlo canvas app usará em seguida o valor especificado no campo ID da Aplicação para carregar a aplicação de tela. Embora tenha de introduzir valores nos campos Nome da aplicação e ID da Aplicação, apenas um dos valores tem de ser exato para que a aplicação de tela incorporada seja carregada no controlo. Note que a aplicação de tela tem de estar no ambiente atual.

• O campo Nome da aplicação é o nome exclusivo da aplicação de tela. Para encontrar o nome exclusivo, adicione a aplicação de tela a uma solução. O nome exclusivo da aplicação de tela é apresentado na coluna Nome e aparece no formulário solutionpublisherprefix_appnamenospaces_appendix. Por exemplo, contoso_canvasappwithsharepointlist_5ee16.
• A propriedade ID da Aplicação especifica o ID da aplicação de tela incorporada. Introduza o ID da Aplicação para uma aplicação de tela existente. O ID da Aplicação de tela pode ser encontrado no Power Apps, vá a Aplicações, selecione a aplicação de tela e, em seguida, selecione Detalhes na barra de comando.

Incorporar uma aplicação de tela utilizando a experiência clássica

1. Inicie sessão no Power Apps.

2. Criar ou editar o formulário principal de uma tabela, a tabela Contas no nosso exemplo.

3. Na barra de comando, selecione Mudar para clássico para abrir o formulário no estruturador de formulários clássico.

4. No estruturador de formulários clássico, selecione a secção no formulário onde pretende que a aplicação de tela incorporada apareça.

5. Utilizar o painel de colunas, adicionar uma coluna obrigatória, tal como Nome da Conta.

   Importante

   Utilize sempre uma coluna obrigatória que tenha sempre garantido um valor. Se a coluna não tiver um valor, a aplicação de tela incorporada não atualiza em resposta a quaisquer alterações nos dados no formulário anfitrião orientado por modelos.

6. Com a coluna selecionada, no separador Base no grupo Editar, selecione Alterar Propriedades.

7. Na caixa de diálogo Propriedades da Coluna, selecione o separador Controlos.

8. No separador Controlos, selecione Adicionar Controlo.

9. Na caixa de diálogo Adicionar Controlo, na lista de controlos disponíveis, selecione Aplicação de tela e, em seguida, selecione Adicionar.

10. Na caixa de diálogo Propriedades da Coluna, na lista de controlos, selecione Aplicação de tela e, em seguida, selecione a opção Web.

11. Na secção abaixo da lista de controlos, são apresentadas as listas de propriedades disponíveis para o controlo de aplicação de tela.

    • A propriedade Nome da tabela especifica a tabela que fornecerá os dados à sua aplicação de tela incorporada. Será definida para a tabela que contém a coluna adicionada num passo anterior.
      • Tenha em atenção que, apesar de esta propriedade aparecer alterável, alterá-la não tem qualquer efeito na aplicação de tela incorporada. Pretende servir apenas como referência para si.
    • A propriedade Nome da Aplicação especifica o nome da aplicação de tela a incorporar. O formulário condicionado por modelo procura a aplicação de tela com o nome especificado no ambiente atual. Se uma aplicação de tela com esse nome não puder ser encontrada no ambiente, o controlo da aplicação de tela usará o ID da aplicação para carregar a aplicação de tela. Introduza o Nome da Aplicação para uma aplicação de tela existente.
    • A propriedade ID da Aplicação especifica o ID da aplicação de tela incorporada. Pode introduzir um ID da Aplicação para uma aplicação de tela existente ou um ID da Aplicação será automaticamente gerado e preenchido para si quando criar ou editar uma aplicação de tela selecionando Personalizar. O ID da Aplicação de tela pode ser encontrado no Power Apps, vá a Aplicações, selecione a aplicação de tela e, em seguida, selecione Detalhes na barra de comando.

    Nota

    Tenha em atenção que qualquer alteração ao valor do ID da Aplicação quebra a ligação entre o formulário orientado por modelos e a aplicação de tela incorporada.

    Se nem o Nome da Aplicação ou o ID da Aplicação corresponderem a uma aplicação de tela existente, o formulário exibe a mensagem "Lamentamos, mas não encontrámos essa aplicação."

12. Vá para o passo 20 se estiver a adicionar uma aplicação de tela completa. Se estiver a criar uma nova ou a editar uma aplicação de tela existente, continue a seguir estes passos. Selecione Personalizar para criar ou editar uma aplicação de tela. É aberto o Power Apps Studio num novo separador.

    Nota

    Se a abertura do Power Apps Studio for bloqueada devido a um bloqueador de janelas de pop-up do browser, tem de ativar o site make.powerapps.com ou desativar temporariamente o bloqueador de janelas de pop-up e, em seguida, selecionar Personalizar novamente.

13. Observe o seguinte:

    • No Power Apps Studio, tenha em atenção que existe um controlo ModelDrivenFormIntegration especial no painel esquerdo. Este controlo é responsável por trazer dados contextuais do formulário orientado por modelos para a aplicação de tela incorporada.
    • Note que um controlo de formulário de aplicação de tela foi adicionado automaticamente à sua aplicação de tela incorporada e apresenta os dados que lhe são transmitidos a partir do formulário orientado por modelos através do controlo ModelDrivenFormIntegration.
    • Selecione o separador Ver e selecione Origens de dados. Note que uma origem de dados para a tabela principal do seu formulário orientado por modelos de anfitrião, neste caso Contas, foi adicionada automaticamente à sua aplicação de tela incorporada. - Selecione o controlo Form1 e observe se a propriedade DataSource está definida como Contas.
    • Com o controlo Form1 ainda selecionado, observe se a propriedade Item está definida como ModelDrivenFormIntegration.Item.

    Nota

    A aplicação de tela incorporada tem acesso total ao ler a partir do formulário condicionado por modelo de anfitrião através do ModelDrivenFormIntegration.Item. Como exemplo, para obter o valor de uma coluna com o nome accountnumber e nome a apresentar Número de Conta, pode utilizar ModelDrivenFormIntegration.Item.accountnumber ou ModelDrivenFormIntegration.Item.'Account Number'.

14. No painel de propriedades à direita, junto a Colunas, selecione Editar colunas.

15. Selecione + Adicionar coluna para adicionar outra coluna ao formulário de aplicação de tela ou reordenar as colunas existentes através da funcionalidade de arrastar e largar. Feche o painel de dados depois de concluir a adição e a reordenação das colunas.

16. Selecione o separador Ficheiro e selecione Guardar.

17. Selecione o separador A cloud. Atribua um nome exclusivo à aplicação e, em seguida, selecione Guardar localizado no canto inferior direito. Tenha em atenção o seguinte comportamento:

    • Guardar uma aplicação pela primeira vez publica automaticamente a aplicação.
    • Numa operação guardar subsequente, selecione Publicar e, em seguida, selecione Publicar esta versão para disponibilizar as suas alterações.

18. No menu, selecione Anterior.

19. Selecione o separador do browser que tem o estruturador de formulários clássico aberto. Note que as propriedades ID da Aplicação e Nome da Aplicação do controlo da aplicação de tela têm agora um valor preenchido automaticamente.

    Importante

    • O estruturador de formulários tem uma ligação direta ao Power Apps Studio que foi aberto noutro separador de browser num passo anterior.
    • Certifique-se de que o nome da Aplicação tem um valor semelhante ao da captura de ecrã abaixo. A propriedade Nome da aplicação especifica o nome exclusivo que será utilizado para referenciar a aplicação de tela em runtime. Se este nome não for definido, a propriedade ID da Aplicação será utilizada para referenciar a aplicação de tela, o que poderá causar problemas ao importar a aplicação de tela como parte de uma solução. Recomendamos que defina este nome para assegurar a adequada referência da aplicação de tela entre ambientes. Para defini-la, volte ao passo 12 e siga os passos para criar a aplicação de tela a incorporar.
    

20. Na caixa de diálogo Propriedades da Coluna, selecione o separador Apresentar.

21. Desmarque Apresentar etiqueta no formulário e selecione OK.

    • Se já tiver uma aplicação de tela incorporada neste formulário, é apresentada uma mensagem a indicar que "Só é possível ativar uma aplicação de tela num formulário". Para adicionar uma nova aplicação de tela, primeiro tem de desativar a atual aplicação de tela incorporada. Em seguida, ative a nova aplicação de tela incorporada.

22. No separador Base, selecione Guardar e, em seguida, selecione Publicar.

Consulte também

Editar uma aplicação de tela incorporada num formulário orientado por modelos
Executar ações predefinidas no formulário de anfitrião a partir de dentro de uma aplicação de tela incorporada
Propriedades e ações do controlo ModelDrivenFormIntegration
Diretrizes sobre como trabalhar com aplicações de tela incorporada