Argomenti dell'evento di salvataggio (riferimento sul lato client)

Articolo
03/04/2017

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In caso di salvataggio è possibile utilizzare il metodo getEventArgs dell'oggetto di contesto di esecuzione per recuperare un oggetto che contiene i metodi utilizzabili per gestire l'evento di salvataggio.

Metodi degli argomenti per l'evento di salvataggio

getSaveMode
Restituisce un valore che indica come è stato inizializzato l'evento di salvataggio da parte dell'utente.
isDefaultPrevented
Restituisce un valore che indica se l'evento di salvataggio è stato annullato perché il metodo preventDefault è stato utilizzato in questo gestore eventi o in un gestore eventi precedente.
preventDefault
Annulla l'operazione di salvataggio, ma tutti i gestori rimanenti per l'evento verranno ancora eseguiti.

getSaveMode

Restituisce un valore che indica come è stato inizializzato l'evento di salvataggio da parte dell'utente.

execObj.getEventArgs().getSaveMode()

Valore restituito
Tipo: numero

Nella seguente tabella vengono descritti i valori supportati restituiti per rilevare i modi diversi in cui è possibile salvare i record di entità che possono essere salvati dall'utente.

Entità	Modalità evento	Valore
Tutti	Salva	1
Tutti	Salva e chiudi	2
Tutti	Salva e nuovo	59
Tutti	Salvataggio automatico	70
Impegni	Salva come elemento completato	58
Tutti	Disattivazione	5
Tutti	Riattiva	6
Entità di proprietà dell'utente o del team	Assegna	47
Messaggio di posta elettronica (E-mail)	Invia	7
Lead	Imposta come qualificato	16
Lead	Impostazione come non qualificato	15

Note
Questo metodo è essenziale se si desidera abilitare il salvataggio automatico per la maggior parte dei moduli in un'organizzazione ma disabilitarlo per moduli specifici. Il codice seguente registrato per l'evento onSave con il contesto di esecuzione passato impedirà il salvataggio che inizia da un salvataggio automatico ma consentirà tutti gli altri. Con il salvataggio automatico abilitato, l'uscita è equivalente a Salva e chiudi. Questo codice impedirà salvataggi iniziati dal timer di 30 secondi o quando gli utenti escono da un modulo con i dati non salvati.
```
function preventAutoSave(econtext) {
    var eventArgs = econtext.getEventArgs();
    if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
        eventArgs.preventDefault();
    }
}
```
Per salvare un record è necessario fare clic sull'icona Salva nella parte inferiore del modulo o è necessario aggiungere un comando Salva personalizzato alla barra dei comandi.

isDefaultPrevented

Restituisce un valore che indica se l'evento di salvataggio è stato annullato perché il metodo preventDefault è stato utilizzato in questo gestore eventi o in un gestore eventi precedente.

execObj.getEventArgs().isDefaultPrevented()

Valore restituito
Tipo: booleano

preventDefault

Annulla l'operazione di salvataggio, ma tutti i gestori rimanenti per l'evento verranno ancora eseguiti.

execObj.getEventArgs().preventDefault()

Vedere anche

Riferimento programmazione sul lato client
Raccolte (riferimento lato client)
Riferimento rapido dello scripting dei moduli
Contesto di esecuzione (riferimento sul lato client)
getEventArgs
Creare il codice per moduli di Microsoft Dynamics 365
Utilizzare il modello a oggetti Xrm.Page

Microsoft Dynamics 365

Condividi tramite