Kolonner i modeldrevne apps (klient-API-reference)

Kolonner indeholder data i formularen eller gitrene til modeldrevne apps. Brug samlingen formContext.data.entity.attributes eller formContext.getAttribute genvejsmetoden til at få adgang til en samling af kolonner. Du kan få flere oplysninger om samlinger under Samlinger (klient-API-reference).

Hvis du vil have adgang til en kolonne i samlingen, skal du overføre enten navnet (strengen) eller indeksværdien (tallet) for kolonnen som et argument til metoden . Eksempel: formContext.getAttribute(arg). Hvis du ikke angiver et argument, returnerer metoden en samling af alle attributter i formularen.

Kolonner er kategoriseret efter type. Brug metoden getAttributeType til at bestemme kolonnens type. Visse kolonnemetoder er kun tilgængelige for bestemte typer kolonner.

Denne artikel indeholder oplysninger om de metoder, der er tilgængelige for hver kolonnetype.

Alle kolonnetyper

Egenskaben controls indeholder en samling kontrolelementer , der er knyttet til kolonnen.

Følgende metoder er tilgængelige for alle kolonnetyper:

Metode Beskrivende tekst
addOnChange Tilføjer en funktion, der skal køres, når kolonnens OnChange hændelse opstår.
fireOnChange Udløser kolonnens OnChange hændelse.
getAttributeType Returnerer kolonnens type.
getFormat Returnerer kolonnens format.
getIsDirty Returnerer, om kolonnen indeholder ændringer, der ikke er gemt.
getName Returnerer kolonnens logiske navn.
getParent Returnerer det overordnede formContext.data.entity objekt.
getRequiredLevel Returnerer, om en kolonneværdi er påkrævet eller anbefalet.
getSubmitMode Returnerer, når kolonnens data sendes, når der gemmes.
getUserPrivilege Returnerer brugerens rettigheder til at oprette, læse eller opdatere kolonnens værdi.
getValue Returnerer kolonnens dataværdi.
isValid Returnerer, om kolonnens værdi er gyldig.
removeOnChange Fjerner en funktion fra kolonnens hændelseshandlere OnChange .
setIsValid Angiver kolonnens gyldighed og en fejlmeddelelse.
setRequiredLevel Angiver, om en kolonneværdi er påkrævet eller anbefalet, før der gemmes.
setSubmitMode Angiver, om kolonnens data sendes, når der gemmes.
setValue Angiver kolonnens dataværdi.

Boolesk kolonnetype

Ud over de metoder, der er tilgængelige for alle kolonnetyper, indeholder den booleske kolonnetype følgende metode:

Metode Beskrivende tekst
getInitialValue Returnerer kolonnens værdi, når formularen åbnes.

Opslagskolonnetype

Ud over de metoder, der er tilgængelige for alle kolonnetyper, indeholder opslagskolonnetypen følgende metode:

Metode Beskrivende tekst
getIsPartyList Returnerer, om opslaget tillader flere poster som et opslag på en partliste.

Valg og valgkolonnetyper

Ud over de metoder, der er tilgængelige for alle kolonnetyper, indeholder valg - og valgkolonnetyperne følgende metoder:

Metode Beskrivende tekst
getInitialValue Returnerer kolonnens værdi, når formularen åbnes.
getOption Returnerer den indstilling, der svarer til en angivet etiket eller værdi.
getOptions Returnerer kolonnens gyldige indstillinger.
getSelectedOption Returnerer den eller de valgte indstillinger.
hent tekst Returnerer teksten til den eller de markerede indstillinger.

Talkolonnetype (decimal, dobbelt, heltal, penge)

Følgende metoder er kun tilgængelige for kolonnerne decimal, dobbelt og heltal :

Metode Beskrivende tekst
getMax Returnerer kolonnens maksimalt tilladte værdi.
getMin Returnerer kolonnens minimumværdi.
getPrecision Returnerer det antal cifre, der er tilladt efter decimaltegnet.
setPrecision Angiver antallet af tilladte cifre efter decimaltegnet.

Strengkolonnetype

Ud over de metoder, der er tilgængelige for alle kolonnetyper, som forklaret tidligere, er følgende metode kun tilgængelig for strengkolonnen :

Metode Beskrivende tekst
getMaxLength Returnerer kolonnens maksimale strenglængde.

Om Xrm-objektmodel
Kontrolelementer (klient-API-reference)