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

 

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 SalvaPulsante di salvataggio automatico 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

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright