Argumentos do evento salvar (referência do cliente)

Artigo
03/04/2017

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

No evento salvar, você pode usar o método getEventArgs objeto do contexto de execução para recuperar um objeto que contenha métodos que podem ser usados para gerenciar o evento salvar.

Métodos para salvar argumento do evento

getSaveMode
Retorna um valor que indica como o evento salvar foi iniciado pelo usuário.
isDefaultPrevented
Retorna um valor que indica se o evento salvar foi cancelado porque o método preventDefault foi usado neste manipulador de eventos ou um manipulador de eventos anterior.
preventDefault
Cancela a operação de salvar, mas todos os manipuladores restantes do evento ainda serão executados.

getSaveMode

Retorna um valor que indica como o evento salvar foi iniciado pelo usuário.

execObj.getEventArgs().getSaveMode()

Valor de Retorno
Tipo: Número

A tabela a seguir descreve os valores suportados retornados para detectar diferentes formas dos registros de entidade serem salvos pelo usuário.

Entidade	Modo do Evento	Valor
Tudo	Salvar	1
Tudo	Salvar e Fechar	2
Tudo	Salvar e Novo	59
Tudo	AutoSave	70
Atividades	Salvar como Concluída	58
Tudo	Desativar	5
Tudo	Reativar	6
Entidades do usuário ou da equipe	Atribuir	47
Email (E-mail)	Enviar	7
Cliente Potencial	Qualificar	16
Cliente Potencial	Desqualificar	15

Comentários
Este método é fundamental se você deseja habilitar o salvamento automático para a maioria dos formulários em vez de desabilitar para formulários específicos. O seguinte código registrado para o evento onSave com o contexto de execução transmitido a ele evitará qualquer salvamento que inicia de uma lista de salvamento automático, mas permite todos os outros. Com o salvamento automático habilitado, sair é equivalente a salvar e fechar. Este código evitará qualquer salvamento iniciado pelo temporizador de 30 segundos e quando pessoas saem de um formulário com dados não salvos.
```
function preventAutoSave(econtext) {
    var eventArgs = econtext.getEventArgs();
    if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
        eventArgs.preventDefault();
    }
}
```
Para salvar um registro, o usuário deve clicar no ícone Salvar na parte inferior do formulário ou será necessário adicionar um comando personalizado Salvar à barra de comandos.

isDefaultPrevented

Retorna um valor que indica se o evento salvar foi cancelado porque o método preventDefault foi usado neste manipulador de eventos ou um manipulador de eventos anterior.

execObj.getEventArgs().isDefaultPrevented()

Valor de Retorno
Tipo: Booleano

preventDefault

Cancela a operação de salvar, mas todos os manipuladores restantes do evento ainda serão executados.

execObj.getEventArgs().preventDefault()

Confira Também

Referência de programação do cliente
Coleções (referência do cliente)
Referência rápida do script de formulário
Contexto de execução (referência do cliente)
getEventArgs
Crie códigos para os formulários do Microsoft Dynamics 365
Use o modelo de objeto Xrm.Page

Microsoft Dynamics 365