Lomakkeen tapahtumakäsittelijöiden määrittäminen
Tässä ohjeaiheessa käsitellään Dynamics 365 Customer Engagement (on-premises) -sovellusta. Ohjeaiheen Power Apps -versio on täällä: Mallipohjaisen sovelluksen lomakkeen tapahtumakäsittelijöiden määrittäminen
Dynamics 365 Customer Engagement (on-premises)-lomakkeiden tapahtumakäsittelijät voidaan määrittää seuraavilla lomakkeen alueilla:
Elementti | Tapahtuma | Kuvaus |
---|---|---|
Lomake | OnLoad |
Tapahtuu, kun lomake latautuu. |
OnSave |
Tapahtuu, kun tiedot tallennetaan. | |
Välilehti | TabStateChange |
Tapahtuu, kun välilehti laajennetaan tai tiivistetään. |
Kenttä | OnChange |
Tapahtuu, kun kentän tiedot muuttuvat eikä ohjausobjekti ole enää aktiivinen. |
IFRAME | OnReadyStateComplete |
Tapahtuu, kun IFRAME-kehyksen sisältö latautuu. |
Tapahtumakäsittelijä sisältää viittauksen JavaScript-WWW-resurssiin ja toimintoon, joka on määritetty kyseisessä verkkoresurssissa ja joka suoritetaan tapahtuman tapahtuessa. Kussakin elementissä voi olla määritettynä enintään 50 tapahtumakäsittelijää.
Tärkeä
Tapahtumakäsittelijän virheellinen määritys voi johtaa komentosarjavirheisiin, jotka voivat aiheuttaa lomakkeen latausvirheen tai virheellisen toiminnan. Jos et ole komentosarjan kehittäjä, varmista, että tiedät täsmälleen, miten komentosarjan asetukset on määritettävä.
Älä määritä komentosarjan tapahtumakäsittelijää kirjastolla, joka ei ole peräisin luotettavasta lähteestä. Komentosarjoilla voidaan suorittaa mikä tahansa toiminto, jonka käyttäjä voi suorittaa. Niinpä huonosti laadittu komentosarja voi heikentää merkittävästi lomakkeen toimintaa.
Varmista aina tapahtumakäsittelijän asianmukainen toiminta testaamalla se määrittämisen jälkeen.
Valitse lomake-editorissa elementti, jonka tapahtumalle haluat määrittää käsittelijän.
Valitse ensin Koti-välilehti, sitten Muokkaa-ryhmä ja lopuksi Muuta ominaisuuksia tai vain kaksoisnapsauta elementtiä.
Valitse elementin ominaisuuksien valintaikkunassa Tapahtumat-välilehti.
Laajenna Lomakekirjastot-alue. Jos kirjasto, jonka toiminnon haluat määrittää tapahtumakäsittelijäksi, ei ole vielä luettelossa, lisää se.
Lomakekirjaston lisääminen tapahtumakäsittelijään:
Valitse Tapahtumaluettelo-kohdan Lomakekirjastot-osassa Lisää.
Etsi JavaScript-WWW-resurssi käytettävissä olevien verkkoresurssien luettelosta. Valitse ensin se ja sitten Lisää.
Jos tarvitsemaasi JavaScript-WWW-resurssia ei ole olemassa, avaa uusi verkkoresurssilomake valitsemalla Uusi ja luo lomake.
JavaScript-verkkoresurssin luominen:
Määritä verkkoresurssilomakkeessa seuraavat ominaisuudet:
Ominaisuus Arvo Nimi Pakollinen. Kirjoita verkkoresurssin nimi. Näyttönimi Pakollinen. Kirjoita verkkoresurssiluettelossa näkyvä nimi. Kuvaus Valinnainen. Kirjoita verkkoresurssin kuvaus. Tyyppi Pakollinen. Valitse Komentosarja (JScript). Kieli Valinnainen. Valitse jokin organisaatiossa käytettävissä olevista kielistä. Jos sinulle on toimitettu komentosarja, on suositeltavaa etsiä se Selaa-painikkeella ja ladata se.
Voit vaihtoehtoisesti valita Tekstieditori-painikkeen ja liittää tai kirjoittaa Muokkaa sisältöä -valintaikkunan komentosarjan sisällön.
Huomautus
Koska yksinkertaisessa tekstieditorissa ei ole ominaisuuksia, joilla komentosarjan oikeellisuuden voi tarkistaa, komentosarjojen muokkaamiseen on yleensä syytä käyttää erillistä sovellusta, kuten Visual Studiota, jonka jälkeen voit ladata ne.
Valitse Tallenna ja sulje verkkoresurssin valintaikkuna.
Luomasi verkkoresurssi on nyt valittuna Valitse tietue -valintaikkunassa. Sulje valintaikkuna valitsemalla Lisää.
Valitse Tapahtumakäsittelijät-osassa tapahtuma, jolle haluat määrittää tapahtumakäsittelijän.
Avaa Käsittelijän ominaisuudet -valintaikkuna valitsemalla Lisää.
Valitse Tiedot-välilehdessä sopiva kirjasto ja kirjoita sen funktio nimi, joka tapahtumalle on suoritettava.
Tapahtumakäsittelijä on oletusarvoisesti otettu käyttöön. Poista Käytössä-valintaruudun valinta, jos et halua ottaa käyttöön tätä tapahtumaa.
Jotkin funktiot edellyttävät, että funktiolle välitetään suorituskonteksti. Valitse tarvittaessa Välitä suorituskonteksti ensimmäisenä parametrina.
Jotkin funktiot voivat hyväksyä parametrijoukon hallitsemaan funktion toimintaa. Jos niitä tarvitaan, kirjoita ne Luetteloerottimella erotettujen parametrien luettelo, joka siirretään funktioon -vaihtoehtoon.
Lisää Riippuvuudet-välilehdessä komentosarjalle välttämättömät kentät Alisteiset kentät -alueella.
Sulje Käsittelijän ominaisuudet -valintaikkuna valitsemalla OK.
Kun tapahtumakäsittelijä on lisätty, voit muokata funktion suoritusjärjestystä suhteessa muihin funktioihin siirtämällä sitä ylös- tai alaspäin vihreillä nuolilla.
Sulje elementin ominaisuusikkuna valitsemalla OK.
Tallenna muutokset valitsemalla Tallenna. Julkaise lomake valitsemalla Julkaise.
Huomautus
Vaikka voit muokata käyttöliittymässä komentosarjojen latausjärjestystä vihreiden ylä- ja alanuolten avulla, komentosarjoja ei tosiasiassa ladata peräkkäisessä järjestyksessä.