Compartilhar via

Executar ações predefinidas no formulário orientado a modelo do host dentro de um aplicativo de tela incorporado

  • Artigo

Os aplicativos de tela incorporados fornecem a capacidade de executar ações predefinidas no formulário orientado a modelo do host. Essas ações permitem que os criadores naveguem, atualizem e salvem o formulário orientado a modelo do host. Usando essas ações, um aplicativo de tela incorporado pode atuar como uma parte mais integrante do formulário orientado a modelo e do aplicativo orientado a modelo.

O objeto ModelDrivenFormIntegration agora inclui os seguintes métodos novos para permitir que os criadores executem ações no formulário orientado a modelo do host.

Navega o formulário baseado em modelo do host para um formulário principal e exibe 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 até o qual navegar.
  • recordId – um parâmetro de cadeia de caracteres necessário que especifica a ID da linha a ser exibida no formulário principal.

Chamar o método NavigateToMainForm pode mostrar as mensagens de erro a seguir.

Mensagem de erro Orientação de solução de problemas
Tabela não encontrada: [EntityName] Verifique o valor do parâmetro entityName e certifique-se de que seja um nome de tabela válido e que o usuário tenha acesso a ele.
Formulário não encontrado: [FormName] Verifique o valor do parâmetro mainFormName e certifique-se de que seja um nome de formulário principal válido e que o usuário tenha acesso a ele.
Houve um problema ao carregar a linha. Verifique o valor do parâmetro recordId e certifique-se de que seja uma ID de linha válida e que o usuário tenha acesso a ela.

Navega o formulário orientado a modelo do host para uma exibição.

  • entityName – um parâmetro de cadeia de caracteres necessário que especifica a tabela principal da exibição.
  • viewName – um parâmetro de cadeia de caracteres necessário que especifica o nome do formulário principal até o qual navegar.

Chamar o método NavigateToView pode mostrar as mensagens de erro a seguir.

Mensagem de erro Orientação de solução de problemas
Tabela não encontrada: [EntityName] Verifique o valor do parâmetro entityName e certifique-se de que seja um nome de tabela válido e que o usuário tenha acesso a ele.
Exibição não encontrada: [ViewName] Verifique o valor do parâmetro viewName e certifique-se de que seja um nome de exibição válido e que o usuário tenha acesso a ele.

OpenQuickCreateForm(entityName)

Abre o formulário de criação rápida padrão 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.

Chamar o método OpenQuickCreateForm pode mostrar as mensagens de erro a seguir.

Mensagem de erro Orientação de solução de problemas
Tabela não encontrada: [EntityName] Verifique o valor do parâmetro entityName e certifique-se de que seja um nome de tabela válido e que o usuário tenha acesso a ele.

RefreshForm(showPrompt)

Atualiza os dados no formulário orientado a modelo do host.

  • showPrompt – um parâmetro booliano necessário que indica se um prompt de confirmação deve ser exibido para o usuário antes de salvar qualquer dado não salvo no formulário orientado a modelo do host. Os valores devem ser "true" ou "false".

Chamar o método RefreshForm pode mostrar as mensagens de erro a seguir.

Mensagem de erro Orientação de solução de problemas
Use "true" ou "false" como valor do parâmetro. Verifique o valor do parâmetro showPrompt e certifique-se de que seja "true" ou "false".

SaveForm()

Salva os dados no formulário orientado a modelo do host.

Observação

Se você não visualizar o IntelliSense dos métodos para executar ações predefinidas em aplicativos de tela incorporados que foram criados antes da funcionalidade se tornar disponível, salve, feche e reabra o aplicativo.

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
Editar um aplicativo de tela incorporado em um formulário orientado a modelo
Personalizar o tamanho da tela e a orientação de um aplicativo de tela incorporado em um formulário orientado a modelo
Propriedades e ações do controle ModelDrivenFormIntegration
Compartilhar um aplicativo de tela incorporado
Diretrizes sobre como trabalhar com aplicativos de tela incorporados
Migrar aplicativos de tela incorporados em formulários orientados a modelo criados usando a versão de visualização pública para a mais recente

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).