Spalte OnChange-Ereignis (Client-API-Referenz)

  • Artikel

Das OnChange-Ereignis tritt in den folgenden Fällen 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.
  • Die attribute.fireOnchange-Methode wird verwendet.

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

Das OnChange-Ereignis tritt nicht auf, wenn die Spalte programmgesteuert mit der attribute.setValue-Methode geändert wurde. Wenn Sie Ereignishandler für das Ereignis OnChange nach dem Einstellen des Werts ausführen möchten, müssen Sie die formContext.data.entity attribute.fireOnchange-Methode in Ihrem Code verwenden. Das Ereignis OnChange tritt auch nicht auf, wenn die Spalte programmgesteuert geändert wird, wenn Änderungen verworfen werden, wenn der Benutzer von einem geänderten Formular weg navigiert.

Hinweis

Obwohl die Status Spalte dasOnChange Ereignis unterstützt, ist die Spalte im Formular schreibgeschützt, sodass das Ereignis nicht durch Benutzerinteraktion auftreten kann. Ein anderes Skript kann dazu führen, dass dieses Ereignis mithilfe der fireOnchange Methode in der Spalte auftritt.

Hinweis

OnChange-Ereignisse sind synchron. Verwenden Sie keinen asynchronen Code in einem OnChange-Ereignishandler, für den eine Aktion zur Auflösung des asynchronen Codes durchgeführt werden muss. Dies führt zu Problemen, wenn der Auflösungshandler erwartet, dass der App-Kontext derselbe bleibt, der beim Starten des asynchronen Codes vorhanden war. Ebenfalls sollten Sie 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

Es gibt drei Methoden, mit denen Sie mit dem OnChange Ereignis für eine Spalte arbeiten können:

Spalten (Client-API-Referenz)

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).