Konfigurujte obslužné rutiny udalostí pre formulár
Táto téma sa vzťahuje na Dynamics 365 Customer Engagement (on-premises). Informácie o verzii Power Apps v rámci tejto témy nájdete v článku: Nakonfigurujte obslužné programy udalostí formulára aplikácií riadené modelom
Nástroje na spracovanie udalostí pre formuláre Dynamics 365 Customer Engagement (on-premises) možno nakonfigurovať pre nasledujúce oblasti vo formulári:
| Element | Udalosť | Popis |
|---|---|---|
| Formulár | OnLoad |
Objavuje sa pri načítaní formulára. |
OnSave |
Objavuje sa pri uložení údajov. | |
| Karta | TabStateChange |
Objavuje sa, keď sa karta rozbalí alebo zbalí. |
| Pole | OnChange |
Objavuje sa, keď sa údaje v poli zmenia a ovládací prvok stratí zameranie. |
| IFRAME | OnReadyStateComplete |
Objavuje sa pri načítaní obsahu objektu IFRAME. |
Obsluha udalostí pozostáva z odkazu na webový prostriedok JavaScript a funkcie definovanej v danom webovom prostriedku, ktorá sa vykoná, keď daná udalosť nastane. Každý prvok môže mať nakonfigurovaných až 50 obslúh udalostí.
Dôležité
Nesprávne nakonfigurovanie obsluhy udalosti môže spôsobiť chyby skriptu, ktoré môžu vyvolať zlyhanie načítania formulára alebo jeho nesprávnu funkciu. Ak nie ste vývojárom skriptu, uistite sa, že presne rozumiete, aké možnosti konfigurácie skript požaduje.
Nekonfigurujte obsluhu udalostí skriptu pomocou knižnice, ktorá nepochádza zo zdroja, ktorému veríte. Skripty sa môžu použiť na vykoananie akejkoľvek akcie, ktorú môže vykonať používateľ, a zle napísané skripty môžu významne uškodiť výkonnosti formulára.
Po konfigurácii obsluhy udalostí ju vždy otestujte, aby ste overili, že pracuje správne.
Konfigurácia obsluhy udalostí
V editore formulárov vyberte prvok s udalosťou, pre ktorú chcete nakonfigurovať obsluhu.
Na karte Domov v skupine Upraviť vyberte Zmeniť vlastnosti alebo jednoducho dvakrát kliknite na prvok.
V dialógovom okne vlastností prvku vyberte kartu Udalosti .
Rozbaľte oblasť Knižnice formulárov . Ak knižnica obsahujúca funkciu, ktorú chcete nastaviť ako obsluhu udalosti, ešte nie je v zozname uvedená, pridajte danú knižnicu.
Pre pridanie knižnice formulára k obsluhe udalosti:
V sekcii Knižnice formulárov v Zoznamu udalostí vyberte Pridať.
Vyhľadajte webový prostriedok JavaScript v zozname dostupných webových prostriedkov. Vyberte ho a potom vyberte Pridať.
Ak webový zdroj JavaScript, ktorý potrebujete, neexistuje, výberom možnosti Nový otvorte nový formulár webového zdroja a vytvorte ho.
Vytvorenie webového prostriedku JavaScript:
Vo formulári webového zdroja nastavte nasledujúce vlastnosti:
Vlastnosť Hodnota Meno Povinné. Zadajte názov webového prostriedku. Názov zobrazenia Povinné. Zadajte názov, ktorý sa zobrazí v zozname webových prostriedkov. Popis Voliteľné. Zadajte popis webového prostriedku. Typ Povinné. Vyberte Skript (JScript). Jazyk Voliteľné. Vyberte jeden z dostupných jazykov vo vašej organizácii. Ak vám bol poskytnutý skript, dôrazne vám odporúčame použiť tlačidlo Prehľadávať na vyhľadanie súboru a jeho nahranie.
Prípadne môžete vybrať tlačidlo Textový editor a prilepiť alebo napísať obsah skriptu do Upraviť obsah dialóg.
Poznámka
Pretože tento jednoduchý textový editor neposkytuje žiadne funkcie na kontrolu správnosti skriptu, vo všeobecnosti by ste sa vždy mali snažiť používať samostatnú aplikáciu, ako napríklad Visual Studio, na úpravu skriptov, a potom ich odovzdali.
Vyberte Uložiť a zatvorte dialógové okno webového zdroja.
Webový zdroj, ktorý ste vytvorili, je teraz vybratý v dialógovom okne Vyhľadať záznam . Výberom možnosti Pridať zatvorte dialógové okno.
V sekcii Správcovia udalostí vyberte udalosť, pre ktorú chcete nastaviť obsluhu udalosti.
Výberom možnosti Pridať otvoríte dialógové okno Vlastnosti obslužného programu .
Na karte Podrobnosti vyberte príslušnú knižnicu a zadajte názov funkcie, ktorá sa má pre udalosť vykonať.
Obsluha udalostí je predvolene zapnutá. Ak túto udalosť nechcete povoliť, zrušte začiarknutie políčka Povolené .
Niektoré funkcie požadajú uplynutie kontextu výkonu, aby fungovali. Vyberte Prejsť kontext vykonávania ako prvý parameter , ak je to potrebné.
Niektoré funkcie môžu akceptovať súbor parametrov na ovládanie správania funkcie. Ak sú potrebné, zadajte ich do zoznamu parametrov oddelených čiarkami, ktoré budú odovzdané funkcii.
Na karte Závislosti pridajte všetky polia, na ktorých závisí skript, do oblasti Závislé polia .
Výberom možnosti OK zatvorte dialógové okno Vlastnosti obslužného programu .
Keď je obsluha udalostí zadaná, môžete upraviť poradie, v ktorom sa funkcia vykoná vo vzťahu k akýmkoľvek iným funkciám, a to pomocou jeho posunu nahor alebo nadol zelenými šípkami.
Výberom možnosti OK zatvoríte dialógové okno vlastností prvku.
Zmeny vykonajte výberom položky Uložiť. Výberom možnosti Zverejniť zverejníte formulár.
Poznámka
Hoci užívateľské rozhranie (UI) umožňuje nastaviť poradie, v ktorom sa skripty načítavajú použitím zelených šípok hore a dole, skripty sa v skutočnosti nenahrávajú za sebou.