Compartilhar via


Argumentos do evento salvar (referência do cliente)

 

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 SalvarBotão para salvar automaticamente 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

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais