Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
As aplicações de tela incorporadas em formulários orientados por modelos contêm um controlo especial denominado ModelDrivenFormIntegration. Este controlo é responsável por trazer dados contextuais do formulário orientado por modelos para a aplicação de tela incorporada.
Importante
Para poder interagir com o controlo ModelDrivenFormIntegration, a aplicação de tela tem de ser criada selecionando Personalizar nas propriedades de controlo da Aplicação de tela para o formulário condicionado por modelo, utilizando o estruturador de formulários clássico. Mais informações: Incorporar uma aplicação de tela utilizando a experiência clássica
Este artigo explica as propriedades e ações disponíveis no ModelDrivenFormIntegration controle. Este controlo está disponível para personalização no Power Apps Studio quando cria a aplicação de tela utilizando a IU das propriedades de controlo da aplicação de tela no estruturador de formulários clássico.
mod
| Propriedade ou ação | Descrição |
|---|---|
| DataSource | Deve ser definido como a origem de dados ligada à tabela principal do formulário condicionado por modelo de anfitrião. Definido automaticamente ao incorporar uma nova aplicação de tela. Ao incorporar uma aplicação de tela existente, a origem de dados ModelDrivenFormIntegration pode ser configurada a partir da vista de árvore da aplicação de tela. O valor de DataSource deve sempre referir-se à tabela do formulário em que a aplicação está incorporada. O valor não deve ser filtrado ou modificado de forma alguma. |
| Item | Propriedade só de leitura que permite à aplicação de tela incorporada aceder à linha do formulário condicionado por modelo de anfitrião. 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'. |
| OnDataRefresh | A fórmula nesta propriedade é avaliada quando o formulário orientado por modelos de anfitrião guarda dados. Utilize-a para atualizar a origem de dados ligada à tabela principal do formulário orientado por modelos de anfitrião e para efetuar outras ações, como definir ou atualizar variáveis. Como exemplo, defini-la com a fórmula abaixo irá atualizar a origem de dados Contas e definir uma variável denominada CurrentAccountNumber com o valor da coluna Número da Conta da linha atual. Refresh(Contas); Set(CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Número de Conta') Aa ação OnDataRefresh só deve ser utilizada para atualizar dados dentro da aplicação de tela incorporada. Não recomendamos que utilize a ação OnDataRefresh para guardar alterações dentro da aplicação de tela incorporada. Mais informações: Guardar dados numa aplicação de tela incorporada |
| RefreshForm | Atualiza os dados no formulário orientado por modelos de anfitrião. Consulte Executar ações predefinidas no formulário de anfitrião para obter mais detalhes. |
| SaveForm | Guardar os dados no formulário orientado por modelos de anfitrião. Consulte Executar ações predefinidas no formulário de anfitrião para obter mais detalhes. |
| NavigateToMainForm | Navega o formulário orientado por modelos de anfitrião para um formulário principal e apresenta a linha especificada. Consulte Executar ações predefinidas no formulário de anfitrião para obter mais detalhes. |
| NavigateToView | Navega o formulário orientado por modelos de anfitrião para uma vista. Consulte Executar ações predefinidas no formulário de anfitrião para obter mais detalhes. |
| OpenQuickCreateForm | Abre o formulário de criação rápida predefinido para uma tabela. Consulte Executar ações predefinidas no formulário de anfitrião para obter mais detalhes. |
| Dados | Propriedade só de leitura utilizada pela arquitetura para enviar alguns dados-chave a partir do formulário orientado por modelos de anfitrião para a aplicação de tela incorporada. Não utilize esta propriedade. Utilize Item para aceder à linha a partir do formulário orientado por modelos de anfitrião. |
Os dados de controlo do ModelDrivenFormIntegration não estão disponíveis no início da aplicação
A ModelDrivenFormIntegration.Item propriedade não garante que esteja preenchida com dados quando a aplicação inicia. A aplicação deve ser desenhada para esperar por estes dados usando uma expressão como !IsBlank(ModelDrivenFormIntegration.Item), ou deve recuperar explicitamente o registo usando uma expressão como LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId)).
Consultar também
Incorporar uma aplicação de tela num formulário condicionado por modelo
Adicionar uma aplicação de tela incorporada num formulário condicionado por modelo
Executar ações predefinidas no formulário anfitrião a partir de uma aplicação de tela incorporada
Partilhar uma aplicação de tela incorporada
Diretrizes sobre como trabalhar com aplicações de tela incorporadas