Gemme hændelsesargumenter (klientsidereference)

Artikel
03/04/2017

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

I lagringshændelsen kan du bruge kørselskontekstobjekt getEventArgs-metoden til at hente et objekt, der indeholder metoder, du kan bruge til at administrere lagringshændelsen.

Metoder til at gemme lagringshændelsesargumenter

getSaveMode
Returnerer en værdi, der angiver, hvordan lagringshændelsen blev startet af brugeren.
isDefaultPrevented
Returnerer en værdi, der angiver om lagringshændelsen er blevet annulleret, fordi metoden preventDefault blev brugt i denne hændelseshandler eller en tidligere hændelseshandler.
preventDefault
Annullerer lagringshandlingen, men alle resterende handlere for hændelsen udføres.

getSaveMode

Returnerer en værdi, der angiver, hvordan lagringshændelsen blev startet af brugeren.

execObj.getEventArgs().getSaveMode()

Returværdi
Type: Tal

I følgende tabel beskrives de understøttede værdier, der returneres for at registrere forskellige måder, objektposter kan gemmes på af brugeren.

Objekt	Hændelsestilstand	Værdi
Alle	Gem	1
Alle	Gem og luk	2
Alle	Gem og ny(t)	59
Alle	AutoSave	70
Aktiviteter	Gem som fuldført	58
Alle	Deaktiver	5
Alle	Genaktiver	6
Bruger- eller teamejede objekter	Tildel	47
Email (E-mail)	Send	7
Kundeemne	Kvalificer	16
Kundeemne	Diskvalificer	15

Bemærkninger
Denne metode er af afgørende betydning, hvis du vil aktivere automatisk lagring for de fleste formularer i en organisation, men deaktivere funktionen for bestemte formularer. Følgende kode, der er registreret for hændelsen onSave med kørselskonteksten overført, forhindrer lagringer, der initieres af en automatisk lagring, men tillader alle andre. Med automatisk lagring svarer at navigere væk til at gemme og lukke. Denne kode vil forhindre enhver lagring, der er initieres af 30 sekunders-timeren, eller når brugere navigerer væk fra en formular med ikke-gemte data.
```
function preventAutoSave(econtext) {
    var eventArgs = econtext.getEventArgs();
    if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
        eventArgs.preventDefault();
    }
}
```
For at gemme en post skal brugeren klikke på ikonet Gem nederst i en formular, eller der skal tilføjes en brugerdefineret Gem-kommando på kommandolinjen.

isDefaultPrevented

Returnerer en værdi, der angiver om lagringshændelsen er blevet annulleret, fordi metoden preventDefault blev brugt i denne hændelseshandler eller en tidligere hændelseshandler.

execObj.getEventArgs().isDefaultPrevented()

Returværdi
Type: Boolesk

preventDefault

Annullerer lagringshandlingen, men alle resterende handlere for hændelsen udføres.

execObj.getEventArgs().preventDefault()

Se også

Programmeringsreference på klientsiden
Grupper (klientsidereference)
Formularscripter - hurtig henvisning
Kontekst for udførelse (klientsidereference)
getEventArgs
Skriv kode til Microsoft Dynamics 365-formularer
Bruge Xrm.Page-objektmodel

Microsoft Dynamics 365

Del via