Partilhar via

Executar ações predefinidas no formulário controlado por modelo de host a partir de um aplicativo de tela incorporado

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

O objeto ModelDrivenFormIntegration agora inclui os novos métodos a seguir para permitir que os criadores executem ações no formulário controlado por modelo de host.

Navega o formulário controlado por modelo de host para um formulário principal e exibe a linha especificada.

  • entityName - Um parâmetro de cadeia de caracteres obrigatório que especifica a tabela pai do formulário principal.
  • formName - Um parâmetro de cadeia de caracteres obrigatório que especifica o nome do formulário principal para o qual navegar.
  • recordId - Um parâmetro de cadeia de caracteres obrigatório, que especifica a ID da linha a ser exibida no formulário principal.

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

Mensagem de erro Guia de resolução de problemas
Tabela não encontrada: [EntityName] Verifique o valor do parâmetro entityName e verifique se é um nome de tabela válido e se o usuário tem acesso a ele.
Formulário não encontrado: [FormName] Verifique o valor do parâmetro mainFormName e verifique se é um nome de formulário principal válido e se o usuário tem acesso a ele.
Houve 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 usuário tem acesso a ele.

Navega no formulário controlado por modelo de host para uma exibição.

  • entityName - Um parâmetro de cadeia de caracteres obrigatório que especifica a tabela pai do modo de exibição.
  • viewName - Um parâmetro de cadeia de caracteres obrigatório que especifica o nome do formulário principal para o qual navegar.

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

Mensagem de erro Guia de resolução de problemas
Tabela não encontrada: [EntityName] Verifique o valor do parâmetro entityName e verifique se é um nome de tabela válido e se o usuário tem acesso a ele.
Ver não encontrado: [ViewName] Verifique o valor do parâmetro viewName e verifique se é um nome de exibição válido e se o usuário tem 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 obrigatório que especifica a tabela pai do formulário de criação rápida.

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

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

RefreshForm(showPrompt)

Atualiza os dados no formulário controlado por modelo de host.

  • showPrompt - Um parâmetro booleano necessário que indica se um prompt de confirmação deve ser exibido ao usuário antes de salvar quaisquer dados não salvos no formulário controlado por modelo de host. Os valores devem ser "true" ou "false".

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

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

SaveForm()

Salva os dados no formulário controlado por modelo de host.

Observação

Se você não vir o IntelliSense para os métodos para executar ações predefinidas em aplicativos de tela incorporados que foram criados antes da funcionalidade ser disponibilizada; Guarde, feche e reabra a aplicação.

Consulte também

Incorporar uma aplicação canvas em um formulário baseado em modelo
Adicionar um aplicativo de tela incorporado em um formulário controlado por modelo
Editar um aplicativo de tela incorporado em um formulário controlado por modelo
Personalizar o tamanho e a orientação de um aplicativo de ecrã incorporado num formulário baseado em modelo
Propriedades e ações do controle ModelDrivenFormIntegration
Partilhe uma aplicação de canvas incorporada
Diretrizes sobre como trabalhar com aplicativos de tela incorporados
Migrar aplicações de tela incorporadas em formulários dirigidos por modelo criados utilizando a versão de pré-visualização pública para a versão mais recente

  • Last updated on