Kolonnas modeļu vadītās lietotnēs (Klienta API atsauce)

Kolonnas satur datus modeļa vadītu programmu veidlapā vai režģos. Izmantojiet formContext.data.entity.attributes kolekciju vai formContext.getAttribute saīsnes metodi, lai piekļūtu kolonnu kolekcijai. Papildinformāciju par kolekcijām skatiet sadaļā Kolekcijas (klienta API atsauce).

Lai piekļūtu kolonnai kolekcijā, ievadiet vai nu kolonnas nosaukumu (virkni), vai indeksa vērtību (skaitli) kā argumentu metodei. Piemēram, formContext.getAttribute(arg). Ja nenorādāt argumentu, metode atgriež visu atribūtu kolekciju formā.

Kolonnas ir iedalītas kategorijās pēc tipa. Izmantojiet getAttributeType metodi, lai noteiktu kolonnas tipu. Noteiktas kolonnu metodes ir pieejamas tikai noteiktiem kolonnu tipiem.

Šis raksts sniedz informāciju par metodēm, kas pieejamas katram kolonnas tipam.

Visi kolonnu veidi

Kontroles īpašība nodrošina kontroli kopumu, kas saistīts ar kolonnu.

Visām kolonnu kategorijām ir pieejamas šādas metodes:

Metode Apraksts
addOnChange Pievieno funkciju, kas darbojas, kad kolonnas OnChange notikums notiek.
fireOnChange Izsauc kolonnas OnChange notikumu.
getAttributeType Atgriež kolonnas tipu.
getFormat Atgriež kolonnas formātu.
getIsDirty Atgriež, vai kolonnā ir nesaglabātas izmaiņas.
getName Atgriež kolonnas loģisko nosaukumu.
iegūt vecāku Atgriež vecāku formContext.data.entity objektu.
getRequiredLevel Atgriež neatkarīgi no tā, vai ir nepieciešama vai ieteicama kolonnas vērtība.
getSubmitMode Atgriežas, kad kolonnas dati tiek iesniegti saglabāšanā.
getUserPrivilege Atgriež lietotāja tiesības izveidot, lasīt vai atjaunināt kolonnas vērtību.
iegūt vērtību Atgriež kolonnas datu vērtību.
ir derīgs Atgriež, vai kolonnas vērtība ir derīga.
removeOnChange Noņem funkciju no kolonnas OnChange notikumu apstrādātājiem.
setIsValid Iestata kolonnas derīgumu un kļūdas ziņojumu.
setRequiredLevel Iestata, vai kolonnas vērtība ir nepieciešama vai ieteicama pirms saglabāšanas.
setSubmitMode Nosaka, vai kolonnas dati tiek iesniegti saglabāšanā.
setValue Iestata kolonnas datu vērtību.

Būla kolonnas tips

Papildus metodēm, kas pieejamas visiem kolonnu tipiem, boole kolonnas tips nodrošina šādu metodi:

Metode Apraksts
getInitialValue Atgriež kolonnas vērtību, kad forma tika atvērta.

Uzmeklēšanas kolonnas tips

Papildus metodēm, kas pieejamas visiem kolonnu tipiem, meklēšanas kolonnas tips nodrošina šādu metodi:

Metode Apraksts
getIsPartyList Atgriež, vai meklēšana ļauj vairākus ierakstus kā partijas saraksta meklēšana.

Izvēles un izvēles kolonnu tipi

Papildus metodēm, kas pieejamas visiem kolonnu tipiem, izvēles un izvēles kolonnu tipi nodrošina šādas metodes:

Metode Apraksts
getInitialValue Atgriež kolonnas vērtību, kad forma tika atvērta.
getOption Atgriež opciju, kas atbilst norādītai etiķetei vai vērtībai.
getOptions Atgriež kolonnas derīgās opcijas.
getSelectedOption Atgriež izvēlēto opciju vai opcijas.
getText Atgriež izvēlētās opcijas vai opciju tekstu.

Skaitļu kolonnas tips (decimāldaļa, dubultā, vesels skaitlis, nauda)

Tālāk norādītās metodes ir pieejamas tikai decimāldaļskaitļa, dubultā un vesela skaitļa kolonnām:

Metode Apraksts
getMax Atgriež kolonnas maksimālo atļauto vērtību.
getMin Atgriež kolonnas minimālo atļauto vērtību.
getPrecision Atgriež atļauto ciparu skaitu pēc decimāldaļas.
setPrecizitāte Nosaka atļauto ciparu skaitu pēc decimāldaļas.

Virknes kolonnas tips

Papildus metodēm, kas pieejamas visiem kolonnu tipiem, kā paskaidrots iepriekš, tālāk norādītā metode ir pieejama tikai virknes kolonnai:

Metode Apraksts
getMaxLength Atgriež kolonnas maksimālo virknes garumu.

Izpratne par Xrm objekta modeli
Vadīklas (klienta API atsauce)