Ereignisargumente speichern (clientseitige Referenz)

Artikel
03/04/2017

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Im Speichern-Ereignis können Sie die getEventArgs-Methode Ausführungskontextobjekt verwenden, um ein Objekt abzurufen, das Methoden enthält, die Sie verwenden können, um das Speichern-Ereignis zu verwalten.

Speichern- Ereignis-Argument-Methoden

getSaveMode
Gibt einen Wert zurück, der angibt, wie das Speichern-Ereignis vom Benutzer initiiert wurde.
isDefaultPrevented
Gibt einen Wert an, der angibt, ob das Speichern-Ereignis abgebrochen wurde, weil Sie die preventDefault-Methode in diesem Ereignishandler oder einem früheren Ereignishandler verwendet wurde.
preventDefault
Bricht das Speichern-Ereignis ab, aber alle verbleibenden Handler für das Ereignis werden weiterhin ausgeführt.

getSaveMode

Gibt einen Wert zurück, der angibt, wie das Speichern-Ereignis vom Benutzer initiiert wurde.

execObj.getEventArgs().getSaveMode()

Rückgabewert
Typ: Anzahl

Die folgende Tabelle beschreibt die unterstützten Werte, die zurückgegeben werden, um unterschiedliche Arten zu ermitteln, die vom Benutzer gespeichert werden können.

Entität	Ereignismodus	Wert
Alle	Speichern	1
Alle	Speichern und schließen	2
Alle	Speichern und neu	59
Alle	AutoSave	70
Aktivitäten	Als abgeschlossen speichern	58
Alle	Deaktivieren	5
Alle	Erneut aktivieren	6
Entitäten im Besitz von Benutzern oder Teams.	Zuweisen	47
E-Mail (E-Mail)	Senden	7
Lead	Qualifizieren	16
Lead	Nicht qualifizieren	15

Anmerkungen
Diese Methode ist wichtig, wenn Sie automatische Speicherung für die meisten Formulare aktivieren möchten, sie jedoch für bestimmte für Formulare deaktivieren möchten. Der folgende Code, der für das Ereignis onSave mit dem übergebenen Ausführungskontext registriert ist, verhindert Speicherungen, die durch eine automatische Speicherung initiiert werden, lässt jedoch andere zu.. Wenn automatische Speicherung aktiviert ist, ist das Wegnavigieren gleichbedeutend mit Speichern und Schließen. Dieser Code verhindert, dass Speicherungen durch den 30 Sekunden-Timer initiiert werden, oder wenn die Mitarbeiter von einem Formular nicht mit nichtgespeicherten Daten wegnavigieren.
```
function preventAutoSave(econtext) {
    var eventArgs = econtext.getEventArgs();
    if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
        eventArgs.preventDefault();
    }
}
```
Um einen Datensatz zu speichern, muss der Benutzer auf das Symbol Speichern unten im Formular klicken oder ein benutzerdefinierter Speichern-Befehl muss der Befehlsleiste hinzugefügt werden.

isDefaultPrevented

Gibt einen Wert an, der angibt, ob das Speichern-Ereignis abgebrochen wurde, weil Sie die preventDefault-Methode in diesem Ereignishandler oder einem früheren Ereignishandler verwendet wurde.

execObj.getEventArgs().isDefaultPrevented()

Rückgabewert
Typ: Boolesch.

preventDefault

Bricht das Speichern-Ereignis ab, aber alle verbleibenden Handler für das Ereignis werden weiterhin ausgeführt.

execObj.getEventArgs().preventDefault()

Siehe auch

Cclientseitige Programmierreferenz
Sammlungen (clíentseitige Referenz)
Kurzübersicht zum Formularskripting
Ausführungskontext (clientseitige Referenz)
getEventArgs
Schreiben von Code für Microsoft Dynamics 365-Formulare
Verwenden des Xrm.Page-Objektmodells

Microsoft Dynamics 365

Freigeben über