Partajați prin

Configurarea rutinelor de tratare a evenimentelor pentru un formular

  • Articol

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

  1. În editorul de formulare, selectați elementul cu evenimentul pentru care doriți să configurați o rutină.

  2. În fila Acasă, în grupul Editare , selectați Modificați proprietăți sau pur și simplu faceți dublu clic pe element.

  3. În caseta de dialog cu proprietățile elementului, selectați fila Evenimente .

  4. 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.

  5. Pentru a adăuga o bibliotecă de formulare la o rutină de tratare a evenimentelor:

    1. În secțiunea Biblioteci de formulare secțiunea Lista de evenimente, selectați Adăugați.

    2. 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.

    3. Pentru a crea o resursă web JavaScript:

      1. Î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.

      2. 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 să selectați butonul Editor de text și să lipiți sau să tastați conținutul scriptului în Editați conținutul 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.

      3. Selectați Salvați și închideți dialogul de resurse web.

      4. 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.

  6. În secțiunea Manetari de evenimente , selectați evenimentul pentru care doriți să setați un handler de evenimente.

  7. Selectați Adăugați pentru a deschide caseta de dialog Proprietăți handler .

  8. În fila Detalii alegeți biblioteca corespunzătoare și introduceți numele funcției care ar trebui să fie executată pentru eveniment.

  9. Î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.

  10. În fila Dependențe , adăugați toate câmpurile de care depinde scriptul în zona Câmpuri dependente .

  11. Selectați OK pentru a închide caseta de dialog Proprietăți handler .

  12. 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.

  13. Selectați OK pentru a închide dialogul cu proprietățile elementului.

  14. 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.

Consultați și

Utilizați formularul principal și componentele sale