Notikums Kolonna OnChange (klienta API atsauce)

Notikums OnChange notiek šādās situācijās:

  • Dati veidlapas kolonnā ir mainījušies, un fokuss ir zaudēts. Šai darbībai ir izņēmums, kas attiecas uz kolonnām Jā/Nē, kas ir formatētas, lai izmantotu radiopogas vai izvēles rūtiņas. Šādos gadījumos notikums notiek nekavējoties.
  • Datu izmaiņas serverī tiek izgūtas, lai atjauninātu kolonnu, kad veidlapa tiek atsvaidzināta, piemēram, pēc ieraksta saglabāšanas.
  • Tiek izmantota metode attribute.fireOnchange .

Visas kolonnas atbalsta OnChange pasākumu. Kolonnā esošie dati tiek validēti pirms un pēc OnChange notikuma.

Notikums OnChange nenotiek, ja kolonna tiek mainīta programmiski , izmantojot attribute.setValue metodi. Ja vēlaties, OnChange lai notikumu apdarinātāji notikumam tiktu izpildīti pēc vērtības iestatīšanas, kodā jāizmanto formContext.data.entity attribute. metode fireOnchange. Notikums OnChange nenotiek arī tad, ja kolonna tiek mainīta programmātiski, atmetot izmaiņas, ja lietotājs pārvietojas prom no netīras veidlapas.

Piezīmes

Lai gan kolonna Statuss atbalsta notikumu,OnChange kolonna veidlapā ir tikai lasāma, tāpēc notikums nevar notikt, mijiedarbojoties ar lietotāju. Cits skripts var izraisīt šo notikumu, kolonnā izmantojot fireOnchange metodi.

Piezīmes

OnChange notikumi ir sinhroni. Nevajadzētu izmantot asinhronu kodu OnChange notikumu apdarinātājā, kuram jāveic vai jāapstrādā asinhronā koda izšķirtspēja. Tas rada problēmas, ja risinājuma apdarinātājs sagaida, ka programmas konteksts paliks tāds pats kā asinhronā koda startēšanas laikā. Tāpat nevajadzētu veikt sinhronus tīkla pieprasījumus OnChange notikumu apdarinātājā. Tas var izraisīt nereaģējošu programmu.

Šim pasākumam atbalstītās metodes

Ir trīs metodes, ko var izmantot, lai strādātu ar kolonnas OnChange notikumu:

Kolonnas (klienta API atsauce)
Notikumi (klienta API atsauce)
Notikumi veidlapās un režģos modeļa vadītās programmās