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

Evenimentele din formulare și grile 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) pentru a fi 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 utilizând interfața utilizator. Pentru evenimentele pe care nu le puteți asocia prin interfața de utilizator, API-ul client oferă metode pe care le puteți utiliza pentru a atașa rutine de tratare a evenimentelor.

Adăugarea sau eliminarea funcțiilor rutinei de tratare a evenimentelor în formulare utilizând interfața utilizator

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 în care doriți să adăugați rutina de tratare a evenimentelor.

    Captură de ecran a filei Formulare afișând lista de formulare pentru un tabel în Power Apps.

  5. Selectați fila Evenimente . Vedeți ambele rutine de tratare a evenimentelor La Salvare și Încărcare .

    Captură de ecran a filei Evenimente afișând rutinele de tratare eveniment La Salvare și La Încărcare.

  6. Pentru a adăuga o rutină de tratare eveniment pentru evenimentul de modificare, selectați coloana, apoi selectați fila Eveniment .

    Captură de ecran a filei Evenimente din coloană care afișează setările rutinei de tratare eveniment La Modificare eveniment.

Editarea masivă a formularelor

În mod implicit, rutinele de tratare a evenimentelor nu rulează 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 sau setând atributul BehaviorInBulkEditForm la Enabled. În prezent, acest comportament este acceptat doar pentru evenimentele OnLoad.

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

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

Adăugarea sau eliminarea funcțiilor rutinei de tratare a evenimentelor utilizând codul API client

Utilizați următoarele metode pentru a adăuga și a elimina rutine de tratare a evenimentelor pentru evenimentele pe care nu le puteți asocia prin interfața de utilizator:

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 pe care le setați utilizând codul. Pentru mai multe informații, consultați 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. Secțiunea Rutine de tratare evenimente din fila Evenimente din caseta de dialog Proprietăți formular afișează ordinea rutinelor de tratare a evenimentelor și fiecare rutină de tratare eveniment rulează în această ordine.

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 înțelege secvența de execuție a rutinei de tratare eveniment relativ la alte rutine de tratare a evenimentelor.

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