Freigeben über

Spalte OnChange-Ereignis (Client-API-Referenz)

  • Artikel

Das OnChange Ereignis tritt in den folgenden Situationen auf:

  • Die Daten in einer Formularspalte haben sich geändert und der Fokus geht verloren. Es gibt eine Ausnahme von diesem Verhalten, die für Ja/Nein-Spalten gilt, die für die Verwendung von Optionsfeldern oder Kontrollkästchen formatiert sind. In einem solchen Fall tritt das Ereignis sofort auf.
  • Datenänderungen auf dem Server werden abgerufen, um eine Spalte zu aktualisieren, wenn das Formular aktualisiert wird, z. B. nachdem ein Datensatz gespeichert wurde.
  • Es wird die Methode attribute.fireOnchange verwendet.

Alle Spalten unterstützen das OnChange Ereignis. Die Daten in der Spalte werden vor und nach dem OnChange Ereignis validiert.

Das OnChange Ereignis tritt nicht auf, wenn die Spalte programmgesteuert mit der Methode attribute.setValue geändert wird. Wenn Sie möchten, dass Ereignishandler für das OnChange Ereignis ausgeführt werden, nachdem Sie den Wert festgelegt haben, müssen Sie in Ihrem Code die Methode formContext.data.entity attribute.fireOnchange verwenden. Das OnChange Ereignis tritt auch nicht auf, wenn die Spalte programmgesteuert geändert wird und Änderungen verworfen werden, wenn der Benutzer von einem fehlerhaften Formular weg navigiert.

Anmerkung

Obwohl die Spalte Status das EreignisOnChange unterstützt, ist die Spalte im Formular schreibgeschützt, sodass das Ereignis nicht durch Benutzerinteraktion auftreten kann. Ein anderes Skript könnte dieses Ereignis auslösen, indem es die Methode fireOnchange auf die Spalte anwendet.

Anmerkung

OnChange Ereignisse sind synchron. Sie sollten keinen asynchronen Code in einem OnChange Ereignishandler verwenden, der eine auszuführende oder zu verarbeitende Aktion zur Auflösung des asynchronen Codes erfordert. Dies führt zu Problemen, wenn der Auflösungshandler erwartet, dass der App-Kontext derselbe bleibt, der beim Starten des asynchronen Codes vorhanden war. Sie sollten außerdem keine synchronen Netzwerkanforderungen in einem OnChange-Ereignishandler stellen. Dies kann dazu führen, dass die App nicht mehr reagiert.

Unterstütze Möglichkeiten für das Ereignis

Zum Arbeiten mit dem OnChange Ereignis für eine Spalte stehen Ihnen drei Methoden zur Verfügung:

Spalten (Client-API-Referenz)
Ereignisse (Client-API-Referenz)
Ereignisse in Formularen und Rastern in modellgesteuerten Apps