Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplicativos de tela incorporados em formulários orientados a modelo contêm um controle especial chamado ModelDrivenFormIntegration. Esse controle é responsável por levar dados contextuais do formulário controlado por modelos de host ao aplicativo de tela incorporado.
Importante
Para poder interagir com o controle ModelDrivenFormIntegration, o aplicativo de tela deve ser criado selecionando Personalizar nas propriedades de controle Aplicativo de tela para o formulário baseado em modelo usando o designer de formulários clássico. Mais informações: Inserir um aplicativo de tela usando a experiência clássica
Este artigo explica as propriedades e as ações disponíveis no ModelDrivenFormIntegration controle. Este controle está disponível para personalização no Power Apps Studio durante a criação do aplicativo de tela usando a interface do usuário das propriedades de controle do aplicativo de tela no designer de formulários clássico.
mod
| Propriedade ou ação | Descrição |
|---|---|
| DataSource | Deve ser definido como a fonte de dados conectada à tabela pai do formulário baseado em modelo do host. Definir automaticamente ao incorporar um novo aplicativo de tela. Ao incorporar um aplicativo de tela existente, a origem de dados ModelDrivenFormIntegration pode ser configurada a partir da exibição em árvore do aplicativo de tela. O valor de DataSource deve sempre se referir à tabela do formulário no qual o aplicativo está incorporado. O valor não deve ser filtrado ou modificado de forma alguma. |
| Item | Propriedade somente leitura que permite que o aplicativo de tela inserido acesse a linha do formulário baseado em modelo do host. Como exemplo, para obter o valor de uma coluna com o nome accountnumber e nome para exibição Account Number, é possível usar ModelDrivenFormIntegration.Item.accountnumber ou ModelDrivenFormIntegration.Item.'Account Number'. |
| OnDataRefresh | A fórmula nessa propriedade é avaliada quando o formulário orientado a modelo do host salva dados. Use-a para atualizar a fonte de dados conectada à tabela pai do formulário baseado em modelo do host e para executar outras ações, como configurar ou atualizar variáveis. Como exemplo, a definição dela como a fórmula abaixo atualizará a fonte de dados de Contas e definirá uma variável denominada CurrentAccountNumber como o valor da coluna Número da Conta da linha atual. Refresh(Accounts); Set(CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Account Number') A ação OnDataRefresh só deverá ser usada para atualizar dados no aplicativo de tela inserido. Não recomendamos que você use a ação OnDataRefresh para salvar as alterações no aplicativo de tela inserido. Mais informações: Como salvar dados em um aplicativo de tela inserido. |
| RefreshForm | Atualiza os dados no formulário orientado a modelo do host. Consulte Executar ações predefinidas no formulário do host para obter detalhes. |
| SaveForm | Salva os dados no formulário orientado a modelo do host. Consulte Executar ações predefinidas no formulário do host para obter detalhes. |
| NavigateToMainForm | Navega o formulário baseado em modelo do host para um formulário principal e exibe a linha especificada. Consulte Executar ações predefinidas no formulário do host para obter detalhes. |
| NavigateToView | Navega o formulário orientado a modelo do host para uma exibição. Consulte Executar ações predefinidas no formulário do host para obter detalhes. |
| OpenQuickCreateForm | Abre o formulário de criação rápida padrão para uma tabela. Consulte Executar ações predefinidas no formulário do host para obter detalhes. |
| Data | Propriedade somente leitura usada pela estrutura para enviar alguns dados importantes do formulário orientado a modelo do host para o aplicativo de tela incorporado. Não use essa propriedade. Use Item para acessar a linha do formulário baseado em modelo do host. |
Os dados de controle ModelDrivenFormIntegration não estão disponíveis no início do aplicativo
Não há garantia de que a propriedade ModelDrivenFormIntegration.Item seja preenchida com dados quando o aplicativo for iniciado. O aplicativo deve ser projetado para aguardar esses dados usando uma expressão como !IsBlank(ModelDrivenFormIntegration.Item), ou o aplicativo deve recuperar explicitamente o registro usando uma expressão como LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId)).
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
Executar ações predefinidas no formulário do host dentro de um aplicativo de tela incorporado
Compartilhar um aplicativo de tela incorporado
Diretrizes sobre como trabalhar com aplicativos de tela incorporados