Guardar argumentos de evento (referencia del lado del cliente)

Artículo
07/06/2017

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

En el evento guardar puede usar el método 279ca720-e304-4e51-b99f-91722431c2c8#BKMK_GetEventArgs del objeto de contexto de ejecución para recuperar un objeto que contenga métodos que puede usar para administrar el evento guardar.

Métodos del argumento del evento guardar

getSaveMode
Devuelve un valor que indica cómo el evento guardar se ha iniciado por el usuario.
isDefaultPrevented
Devuelve un valor que indica si el evento guardar se ha cancelado porque el método preventDefault se usó en este controlador de eventos o un controlador de eventos anterior.
preventDefault
Cancela la operación de guardar, pero seguirán ejecutándose todos los controladores restantes del evento.

getSaveMode

Devuelve un valor que indica cómo el evento guardar se ha iniciado por el usuario.

execObj.getEventArgs().getSaveMode()

Valor de retorno
Tipo: Número

La siguiente tabla describe los valores admitidos devueltos para detectar las distintas formas en que el usuario puede guardar los registros de entidad.

Entidad	Modo de evento	Valor
Todo	Guardar	1
Todo	Guardar y cerrar	2
Todo	Guardar y nuevo	59
Todo	AutoSave	70
Actividades	Guardar como completado	58
Todo	Desactivar	5
Todo	Reactivar	6
Entidades propiedad del usuario o el equipo	Asignar	47
Correo electrónico (email)	Enviar	7
Cliente potencial	Calificar	16
Cliente potencial	No calificar	15

Comentarios
Este método es esencial si desea habilitar el autoguardado para la mayoría de los formularios en una organización pero deshabilitarlo para formularios específicos. El siguiente código registrado para el evento onSave con el contexto de ejecución que se le ha pasado evitará las operaciones de guardar que se inicien en un autoguardado, pero permitirá todas las demás. Con se habilitada autoguardado, navegar fuera es equivalente a Guardar y cerrar. Este código evitará las operaciones de guardado que inicia el temporizador de 30 segundos o cuando el usuario navega fuera de un formulario con datos sin guardar.
```
function preventAutoSave(econtext) {
    var eventArgs = econtext.getEventArgs();
    if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
        eventArgs.preventDefault();
    }
}
```
Para guardar un registro, el usuario debe hacer clic en el icono Guardar en la parte inferior del formulario o un comando Guardar personalizado se debe agregar a la barra de comandos.

isDefaultPrevented

Devuelve un valor que indica si el evento guardar se ha cancelado porque el método preventDefault se usó en este controlador de eventos o un controlador de eventos anterior.

execObj.getEventArgs().isDefaultPrevented()

Valor de retorno
Tipo: Booleano

preventDefault

Cancela la operación de guardar, pero seguirán ejecutándose todos los controladores restantes del evento.

execObj.getEventArgs().preventDefault()

Ver también

Referencia de programación del lado del cliente
Colecciones (referencia del lado del cliente)
Referencia de scripting de formularios
Contexto de ejecución (referencia del lado del cliente)
279ca720-e304-4e51-b99f-91722431c2c8#BKMK_GetEventArgs
Escriba código para formularios de Microsoft Dynamics CRM 2015
Use el modelo de objeto Xrm.Page

Compartir a través de