Evenimente în formulare și grile în aplicațiile bazate pe modele

Evenimentele inițiază toate codurile pe partea client. În aplicațiile bazate pe modele, asociați o anumită funcție într-o bibliotecă JavaScript (resursă web script) care să fie executată atunci când are loc un eveniment. Această funcție se numește rutină de tratare eveniment. Fiecare rutină de tratare a evenimentelor specifică o singură funcție dintr-o bibliotecă JavaScript și orice parametri care pot fi transmiși funcției.

Puteți asocia rutinele de tratare a evenimentelor doar la unele evenimente care utilizează interfața de utilizator. Pentru evenimentele care nu sunt disponibile pentru a fi asociate prin interfața de utilizator, API client oferă metode care pot fi utilizate pentru a atașa rutine de tratare evenimente la astfel de evenimente.

Adăugarea sau eliminarea funcției rutinei de tratare a evenimentelor la eveniment utilizând interfața utilizator

Moștenire

Utilizați secțiunea Rutine de tratare evenimente din caseta de dialog Proprietăți formular pentru a asocia scriptul cu un eveniment pentru formulare și coloane.

Interfață unificată

Pentru a adăuga sau a elimina funcții de rutină de tratare a evenimentelor în noua interfață unificată:

1. Accesați Power Apps.

2. În panoul de navigare din stânga, selectați Date , apoi selectați Tabele.

3. Din lista de tabele, selectați tabelul în care doriți să adăugați rutinele de tratare a evenimentelor.

4. Selectați fila Formulare din bara de comenzi, apoi selectați formularul pe care doriți să-l adăugați.

   

5. Selectați fila Evenimente . Observați atât rutinele de tratare a evenimentelor La Salvare , cât și Pe Încărcare .

   

6. Dacă doriți să adăugați rutina de tratare a evenimentelor pentru evenimentul de modificare, selectați coloana, apoi selectați fila Eveniment .

   

Editarea masivă a formularelor

În mod implicit, rutinele de tratare a evenimentelor nu sunt apelate atunci când un formular este în modul de editare în masă.

Pentru a activa o rutină de tratare a evenimentelor în modul de editare masivă, modificați XML-ul formular găsind elementul relevant event și creând/setând atributul BehaviorInBulkEditForm la Enabled. În prezent, acest lucru este acceptat doar pentru evenimentele OnLoad.

Pentru mai multe informații despre particularizarea XML a formularului, consultați Când să editați fișierul de particularizări, Particularizarea formularelor și schema XML a formularului.

Pentru a determina când se apelează o rutină de tratare a evenimentelor într-un formular în modul de editare în masă, utilizați metoda de utilizare getFormType .

Adăugarea sau eliminarea funcției rutinei de tratare a evenimentelor la eveniment utilizând codul

Utilizați următoarele metode pentru a adăuga și a elimina rutina de tratare a evenimentelor pentru evenimentele care nu pot fi asociate prin IU:

Evenimente	Rutină de tratare eveniment
Atribut OnChange	addOnChange și metode removeOnChange
Încărcare formular	formContext.ui addOnLoad și metode removeOnLoad
Formular încărcat	formContext.ui addLoaded și removeLoaded methods
Încărcare date formular	formContext.data addOnLoad și removeOnLoad metode
Formular OnSave	addOnSave și removeOnSave methods
Căutare control PreSearch	addPreSearch and removePreSearch methods
kbsearch control OnResultOpened	addOnResultOpened și removeOnResultOpened metode
kbsearch control OnSelection	addOnSelection și metode removeOnSelection
kbsearch control PostSearch	addOnPostSearch și removeOnPostSearch methods

Important

Contextul de execuție este transmis automat ca prim parametru pentru funcțiile setate utilizând codul. Mai multe informații: Contextul de executare a API-ului client

Canal de evenimente de formular

Puteți defini până la 50 de rutine de tratare a evenimentelor pentru fiecare eveniment. Fiecare rutină de tratare eveniment este executată în ordinea în care se afișează în secțiunea Rutine de tratare evenimente din fila Evenimente din caseta de dialog Proprietăți formular .

Utilizați metodele setSharedVariable și getSharedVariable pentru a transmite o variabilă comună între rutinele de tratare a evenimentelor (funcții). Utilizați metoda getDepth pentru contextul de execuție pentru a cunoaște secvența în care se execută o rutină de tratare eveniment în raport cu alți rutine de tratare a evenimentelor.

Articole asociate

Înțelegerea modelului obiect API client
Context execuție API client
Evenimente (Referință API client)