Mallipohjaisten sovellusten sarakkeet (asiakasohjelman ohjelmointirajapintaviittaus)

Sarakkeet sisältävät tietoja mallipohjaisten sovellusten lomakkeessa tai ruudukoissa. formContext.data.entity.attributes Voit käyttää sarakekokoelmaa kokoelman formContext.getAttribute tai pikakuvakemenetelmän avulla. Katso lisätietoja kokoelmista kohdasta Kokoelmat (asiakasohjelman ohjelmointirajapintaviittaus).

Voit käyttää kokoelmassa olevaa saraketta välittämällä joko sarakkeen nimen (merkkijonon) tai indeksiarvon (numeron) argumenttina menetelmään. Esimerkki: formContext.getAttribute(arg). Jos et määritä argumenttia, -menetelmä palauttaa kokoelman lomakkeen kaikista määritteistä.

Sarakkeet luokitellaan tyypin mukaan. Määritä sarakkeen tyyppi getAttributeType-menetelmällä . Tietyt sarakemenetelmät ovat käytettävissä vain tietyntyyppisille sarakkeille.

Tässä artikkelissa on tietoja eri saraketyypeille käytettävissä olevista menetelmistä.

Kaikki saraketyypit

Ohjausobjektit-ominaisuus tarjoaa kokoelman sarakkeeseen liittyviä ohjausobjekteja.

Seuraavat menetelmät ovat käytettävissä kaikille saraketyypeille:

Menetelmä Kuvaus
addOnChange Lisää funktion suoritettavaksi, kun sarakkeen OnChange tapahtuma ilmenee.
fireOnChange Käynnistää sarakkeen OnChange tapahtuman.
getAttributeType Palauttaa sarakkeen tyypin.
getFormat Palauttaa sarakkeen muodon.
getIsDirty Palauttaa tiedon siitä, onko sarakkeessa tallentamattomia muutoksia.
getName Palauttaa sarakkeen loogisen nimen.
getParent Palauttaa pääobjektin formContext.data.entity .
getRequiredLevel Palauttaa tiedon siitä, onko sarakkeen arvo pakollinen vai suositeltu.
getSubmitMode Palauttaa arvon, kun sarakkeen tiedot lähetetään tallennettaessa.
getUserPrivilege Palauttaa käyttäjän oikeudet luoda, lukea tai päivittää sarakkeen arvon.
getValue Palauttaa sarakkeen tietoarvon.
onValid Palauttaa tiedon siitä, onko sarakkeen arvo kelvollinen.
removeOnChange Poistaa funktion sarakkeen OnChange tapahtumakäsittelijöistä.
setIsValid Määrittää sarakkeen kelpoisuusilmoituksen ja virhesanoman.
setRequiredLevel Määrittää ennen tallentamista, vaaditaanko sarakkeen arvo vai suositellaanko sitä.
setSubmitMode Määrittää, lähetetäänkö sarakkeen tiedot tallennuksen aikana.
setValue Määrittää sarakkeen tietoarvon.

Totuusarvosarakkeen tyyppi

Kaikille saraketyypeille käytettävissä olevien menetelmien lisäksi totuusarvosaraketyyppi tarjoaa seuraavan menetelmän:

Menetelmä Kuvaus
getInitialValue Palauttaa sarakkeen arvon, kun lomake avattiin.

Hakusarakkeen tyyppi

Kaikille saraketyypeille käytettävissä olevien menetelmien lisäksi hakusaraketyyppi tarjoaa seuraavan menetelmän:

Menetelmä Kuvaus
getIsPartyList Palauttaa tiedon siitä, salliiko haku useita tietueita osapuoliluettelon hauksi.

Valinnat ja vaihtoehdot -saraketyypit

Kaikille saraketyypeille käytettävissä olevien menetelmien lisäksi valinnat ja valintasaraketyypit tarjoavat seuraavat menetelmät:

Menetelmä Kuvaus
getInitialValue Palauttaa sarakkeen arvon, kun lomake avattiin.
getOption Palauttaa määritettyä otsikkoa tai arvoa vastaavan asetuksen.
getOptions Palauttaa sarakkeen kelvolliset asetukset.
getSelectedOption Palauttaa valitun vaihtoehdon tai asetukset.
getText Palauttaa valitun vaihtoehdon tai asetusten tekstin.

Luku-saraketyyppi (desimaali, kaksinkertainen, kokonaisluku, raha)

Seuraavat menetelmät ovat käytettävissä vain desimaali-, kaksois- ja kokonaislukusarakkeille :

Menetelmä Kuvaus
getMax Palauttaa sarakkeen suurimman sallitun arvon.
getMin Palauttaa sarakkeen pienimmän sallitun arvon.
getPrecision Palauttaa desimaalipilkun jälkeen sallittujen numeroiden määrän.
setPrecision Määrittää desimaalipilkun jälkeen sallittujen numeroiden määrän.

Merkkijonon saraketyyppi

Aiemmin selitettyjen kaikkien saraketyyppien käytettävissä olevien menetelmien lisäksi seuraava menetelmä on käytettävissä vain merkkijonosarakkeessa:

Menetelmä Kuvaus
getMaxLength Palauttaa sarakkeen suurimman merkkijonon pituuden.

Xrm-objektimallin ymmärtäminen
Ohjausobjektit (asiakasohjelman ohjelmointirajapintaviittaus)