Partilhar via


Propriedades e ações do controlo ModelDrivenFormIntegration

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.

Este tópico explica as propriedades e as ações disponíveis no controlo ModelDrivenFormIntegration.

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.

Consulte também

Incorporar uma aplicação de tela num formulário orientado por modelo
Adicionar uma aplicação de tela num formulário orientado por modelos
Editar uma aplicação de tela incorporada num formulário orientado por modelos
Personalizar o tamanho e a orientação de ecrã de 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
Partilhar uma aplicação de tela incorporada
Diretrizes sobre como trabalhar com aplicações de tela incorporada
Migrar aplicações de tela incorporadas em formulários orientados por modelos criados através da versão de pré-visualização pública para a mais recente

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).