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.

Liittyvät artikkelit

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