Executar ações predefinidas no formulário orientado por modelos de anfitrião a partir de dentro de uma aplicação de tela incorporada

As aplicações de tela incorporadas fornecem a capacidade de executar ações predefinidas no formulário orientado por modelos de anfitrião. Estas ações permitem que os criadores naveguem, atualizem e guardem o formulário orientado por modelos de anfitrião. Utilizando estas ações, uma aplicação de tela incorporada pode agir como uma parte mais intrínseca do formulário orientado por modelos e a aplicação orientada por modelos.

O objeto ModelDrivenFormIntegration inclui agora os seguintes métodos novos para permitir que os criadores executem ações no formulário orientado por modelos de anfitrião.

NavigateToMainForm(entityName, mainFormName, recordId)

Navega o formulário orientado por modelos de anfitrião para um formulário principal e apresenta a linha especificada.

• entityName – um parâmetro de cadeia de caracteres necessário que especifica a tabela principal do formulário principal.
• formName – um parâmetro de cadeia de caracteres necessário que especifica o nome do formulário principal para onde navegar.
• recordId – um parâmetro de cadeia de caracteres necessário que especifica o ID da linha a apresentar no formulário principal.

Invocar o método NavigateToMainForm pode mostrar as mensagens de erro seguintes.

Mensagem de erro	Guia de resolução de problemas
Tabela não encontrada: [EntityName]	Verifique o valor do parâmetro entityName e certifique-se de que é um nome de tabela válido e que o utilizador tem acesso a ele.
Formulário não encontrado: [FormName]	Verifique o valor do parâmetro mainFormName e certifique-se de que é um nome de formulário principal válido e que o utilizador tem acesso a ele.
Ocorreu um problema ao carregar a linha.	Verifique o valor do parâmetro recordId e certifique-se de que é um ID de linha válido e que o utilizador tem acesso a ele.

NavigateToView(entityName, viewName)

Navega o formulário orientado por modelos de anfitrião para uma vista.

• entityName – um parâmetro de cadeia de caracteres necessário que especifica a tabela principal da vista.
• viewName – um parâmetro de cadeia de caracteres necessário que especifica o nome do formulário principal para onde navegar.

Invocar o método NavigateToView pode mostrar as mensagens de erro seguintes.

Mensagem de erro	Guia de resolução de problemas
Tabela não encontrada: [EntityName]	Verifique o valor do parâmetro entityName e certifique-se de que é um nome de tabela válido e que o utilizador tem acesso a ele.
Vista não encontrada: [ViewName]	Verifique o valor do parâmetro viewName e certifique-se de que é um nome de vista válido e que o utilizador tem acesso a ele.

OpenQuickCreateForm(entityName)

Abre o formulário de criação rápida predefinido para uma tabela.

• entityName – um parâmetro de cadeia de caracteres necessário que especifica a tabela principal do formulário de criação rápida.

Invocar o método OpenQuickCreateForm pode mostrar as mensagens de erro seguintes.

Mensagem de erro	Guia de resolução de problemas
Tabela não encontrada: [EntityName]	Verifique o valor do parâmetro entityName e certifique-se de que é um nome de tabela válido e que o utilizador tem acesso a ele.

RefreshForm(showPrompt)

Atualiza os dados no formulário orientado por modelos de anfitrião.

• showPrompt – um parâmetro booleano necessário que indica se uma mensagem de confirmação deve ser apresentada ao utilizador antes de guardar quaisquer dados não guardados no formulário orientado por modelos de anfitrião. Os valores devem ser "true" ou "false".

Invocar o método RefreshForm pode mostrar as mensagens de erro seguintes.

Mensagem de Erro	Guia de resolução de problemas
Utilize "true" ou "false" como valor do parâmetro.	Verifique o valor do parâmetro showPrompt e certifique-se de que é "true" ou "false".

SaveForm()

Guardar os dados no formulário orientado por modelos de anfitrião.

Nota

Se não visualizar o IntelliSense para os métodos para executar ações predefinidas em aplicações de tela incorporada que foram criadas antes da funcionalidade ser disponibilizada; guarde, feche e reabra a aplicação.

Consultar também

Incorporar uma aplicação de tela num formulário orientado por modelos
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
Propriedades e ações do controlo ModelDrivenFormIntegration
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).