Configurarea rutinelor de tratare a evenimentelor pentru un formular
Acest subiect se aplică la Dynamics 365 Customer Engagement (on-premises). Pentru versiunea Power Apps a acestui subiect, consultați: Configurați handlere de evenimente pentru formulare de aplicații bazate pe model
Rutinele de tratare a evenimentelor pentru formularele Dynamics 365 Customer Engagement (on-premises) pot fi configurate pentru următoarele zone dintr-un formular:
| Element | Eveniment | Descriere |
|---|---|---|
| Formular | OnLoad |
Apare la încărcarea formularului. |
OnSave |
Apare la salvarea datelor. | |
| Tabulator | TabStateChange |
Apare la extinderea sau restrângerea filei. |
| Câmp | OnChange |
Apare la modificarea datelor din câmp și la pierderea focalizării de către control. |
| IFRAME | OnReadyStateComplete |
Apare la încărcarea conținutului unui IFRAME. |
O rutină de tratare a evenimentelor constă într-o trimitere la o resursă web JavaScript și o funcție definită în acea resursă web, care va fi executată la apariția evenimentului. Fiecare element poate avea configurate până la 50 de rutine separate de tratare a evenimentelor.
Important
Configurarea incorectă a unei rutine de tratare a evenimentelor poate duce la erori de script, care pot determina eșecul încărcării formularului sau funcționarea incorectă a acestuia. Dacă nu sunteți dezvoltator de script, asigurați-vă că înțelegeți exact ce opțiuni de configurare sunt necesare pentru script.
Nu configurați o rutină de tratare a evenimentelor scriptului folosind o bibliotecă ce nu provine dintr-o sursă de încredere. Scripturile pot fi utilizate pentru a efectua orice acțiune ce poate fi efectuată de un utilizator, iar un script slab poate deteriora semnificativ performanța unui formular.
După ce configurați o rutină de tratare a evenimentelor, verificați-o întotdeauna pentru a vedea dacă funcționează corect.
Pentru configurarea unei rutine de tratare a evenimentelor
În editorul de formulare, selectați elementul cu evenimentul pentru care doriți să configurați o rutină.
În fila Acasă, în grupul Editare , selectați Modificați proprietăți sau pur și simplu faceți dublu clic pe element.
În caseta de dialog cu proprietățile elementului, selectați fila Evenimente .
Extindeți zona Biblioteci de formulare . Dacă biblioteca ce conține funcția pe care doriți să o setați ca rutină de tratare a evenimentelor nu este listată deja, adăugați biblioteca.
Pentru a adăuga o bibliotecă de formulare la o rutină de tratare a evenimentelor:
În secțiunea Biblioteci de formulare secțiunea Lista de evenimente, selectați Adăugați.
Localizați resursa web JavaScript din lista de resurse web disponibile. Selectați-l și apoi selectați Adăugați.
Dacă resursa web JavaScript de care aveți nevoie nu există, selectați Nou pentru a deschide un nou formular de resurse web și a crea unul.
Pentru a crea o resursă web JavaScript:
În formularul resursei web setați proprietățile următoare:
Proprietate Valoare Nume Necesar. Tastați numele resursei web. Nume afișat Necesar. Tastați numele care trebuie afișat în lista de resurse web. Descriere Opțional. Tastați o descriere a resursei web. Tip Necesar. Selectați Script (JScript). Limbă Opțional. Alegeți una dintre limbile disponibile pentru organizația dvs. Dacă vi s-a furnizat un script, vă recomandăm să utilizați butonul Răsfoiți pentru a localiza fișierul și a-l încărca.
Alternativ, puteți selecta butonul Editor de text și lipi sau introduce conținutul scriptului în Editare conținut dialog.
Notă
Deoarece acest editor simplu de text nu oferă caracteristici pentru a verifica corectitudinea scriptului, în general, ar trebui să încercați să utilizați o aplicație separată, ca Visual Studio pentru a edita scripturi și pentru ca, mai apoi, să le încărcați.
Selectați Salvați și închideți dialogul de resurse web.
Resursa web pe care ați creat-o este acum selectată în caseta de dialog Căutați înregistrarea . Selectați Adăugați pentru a închide caseta de dialog.
În secțiunea Manetari de evenimente , selectați evenimentul pentru care doriți să setați un handler de evenimente.
Selectați Adăugați pentru a deschide caseta de dialog Proprietăți handler .
În fila Detalii alegeți biblioteca corespunzătoare și introduceți numele funcției care ar trebui să fie executată pentru eveniment.
În mod implicit este activată rutina de tratare a evenimentelor. Debifați caseta de selectare Activat dacă nu doriți să activați acest eveniment.
Unele funcții necesită un context de execuție pentru a fi transmis funcției. Selectați Trimite contextul de execuție ca prim parametru dacă este necesar.
Unele funcții pot accepta un set de parametri pentru a controla comportamentul unei funcții. Dacă acestea sunt necesare, introduceți-le în lista de parametri separați prin virgulă care vor fi transferați funcției.
În fila Dependențe , adăugați toate câmpurile de care depinde scriptul în zona Câmpuri dependente .
Selectați OK pentru a închide caseta de dialog Proprietăți handler .
Când este introdusă o rutină de tratare a evenimentelor, puteți ajusta ordinea în care va fi executată funcția, în raport cu orice alte funcții, utilizând săgețile verzi pentru a o muta în sus sau în jos.
Selectați OK pentru a închide dialogul cu proprietățile elementului.
Selectați Salvare pentru a vă salva modificările. Selectați Publicare pentru a publica formularul.
Notă
În timp ce interfața cu utilizatorul (IU) vă permite să ajustați ordinea în care script-urile sunt încărcate folosind săgețile verzi în sus și în jos, script-urile nu sunt de fapt încărcate secvențial.