Executar ações predefinidas no formulário controlado pelo modelo de host de dentro de um aplicativo de tela inserido

Os aplicativos de tela inseridas fornecem a capacidade de executar ações predefinidas no formulário controlado pelo modelo do host. Essas ações permitem que os criadores naveguem, atualizem e salvem o formulário baseado em modelo de host. Usando essas ações, um aplicativo de tela inserida pode atuar como uma parte mais integral do formulário controlado por modelos e do aplicativo controlado por modelos.

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

NavigateToMainForm(entityName, mainFormName, recordId)

Navega pelo formulário controlado pelo modelo do host até um formulário principal e exibe a linha especificada.

• entityName – Um parâmetro de cadeia de caracteres necessário que especifica a tabela pai do formulário principal.
• formName – um parâmetro de cadeia de caracteres necessário que especifica o nome do formulário principal para 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 seguintes mensagens de erro.

NavigateToView(entityName, viewName)

Navega o formulário controlado pelo modelo de host para um modo de exibição.

• entityName – Um parâmetro de cadeia de caracteres necessário que especifica a tabela pai da exibição.
• viewName – Um parâmetro de cadeia de caracteres necessá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.

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

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

RefreshForm(showPrompt)

Atualiza os dados no formulário controlado pelo modelo de 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 quaisquer dados não salvos no formulário controlado pelo modelo do host. Os valores devem ser "true" ou "false".

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

SaveForm()

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

Consulte também

Inserir um aplicativo canvas em um formulário controlado por modelo
Adicionar um aplicativo de canvas embutido em um formulário baseado em modelo
Editar um aplicativo de tela incorporado em um formulário baseado em modelo
Personalizar o tamanho da tela e a orientação de um aplicativo canvas inserido em um formulário controlado por modelo
Propriedades e ações do controle ModelDrivenFormIntegration
Compartilhar um aplicativo de canvas embutido
Diretrizes sobre como trabalhar com aplicativos de tela embarcados
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