Kolommen in modelgestuurde apps (client-API-verwijzing)

Kolommen bevatten gegevens in het formulier of raster van modelgestuurde apps. Gebruik de formContext.data.entity.attributes verzameling of de formContext.getAttribute snelkoppelingsmethode voor toegang tot een verzameling kolommen. Zie Verzamelingen (client-API-verwijzing) voor meer informatie over verzamelingen.

Als u toegang wilt krijgen tot een kolom in de verzameling, geeft u de naam (tekenreeks) of het indexwaarde (getal) van de kolom als argument door aan de methode. Voorbeeld: formContext.getAttribute(arg). Als u geen argument opgeeft, retourneert de methode een verzameling van alle kenmerken in het formulier.

Kolommen worden gecategoriseerd op type. Gebruik de methode getAttributeType om het type kolom te bepalen. Bepaalde kolommethoden zijn alleen beschikbaar voor specifieke typen kolommen.

Dit artikel bevat informatie over de methoden die beschikbaar zijn voor elk kolomtype.

Alle kolomtypen

De eigenschap Besturingselementen biedt een verzameling besturingselementen die aan de kolom zijn gekoppeld.

De volgende methoden zijn beschikbaar voor alle kolomtypen:

Method Description
addOnChange Voegt een functie toe die moet worden uitgevoerd wanneer de gebeurtenis van OnChange de kolom plaatsvindt.
fireOnChange Activeert de gebeurtenis van OnChange de kolom.
getAttributeType Retourneert het type van de kolom.
getFormat Retourneert de indeling van de kolom.
getIsDirty Retourneert of de kolom niet-opgeslagen wijzigingen heeft.
getName Retourneert de logische naam van de kolom.
getParent Retourneert het bovenliggende formContext.data.entity object.
getRequiredLevel Retourneert of een kolomwaarde vereist of aanbevolen is.
getSubmitMode Retourneert wanneer de gegevens van de kolom worden verzonden bij opslaan.
getUserPrivilege Retourneert de bevoegdheden van de gebruiker om de waarde van de kolom te maken, lezen of bij te werken.
getValue Retourneert de gegevenswaarde van de kolom.
isValid Geeft als resultaat of de waarde van de kolom geldig is.
removeOnChange Hiermee verwijdert u een functie uit de gebeurtenis-handlers van de kolom OnChange .
setIsValid Hiermee stelt u de geldigheid van de kolom en een foutbericht in.
setRequiredLevel Hiermee stelt u in of een kolomwaarde vereist is of wordt aanbevolen voordat u opslaat.
setSubmitMode Hiermee stelt u in of de gegevens van de kolom worden verzonden bij opslaan.
setValue Hiermee stelt u de gegevenswaarde van de kolom in.

Booleaanse kolomtype

Naast de methoden die beschikbaar zijn voor alle kolomtypen, biedt het booleaanse kolomtype de volgende methode:

Method Description
getInitialValue Retourneert de waarde van de kolom wanneer het formulier wordt geopend.

Opzoekkolomtype

Naast de methoden die beschikbaar zijn voor alle kolomtypen, biedt het opzoekkolomtype de volgende methode:

Method Description
getIsPartyList Retourneert of de zoekopdracht meerdere records toestaat als een lijstzoekactie van derden.

Opties en keuzekolomtypen

Naast de methoden die beschikbaar zijn voor alle kolomtypen, bieden de opties en keuzekolomtypen de volgende methoden:

Method Description
getInitialValue Retourneert de waarde van de kolom wanneer het formulier wordt geopend.
getOption Retourneert de optie die overeenkomt met een opgegeven label of waarde.
getOptions Retourneert de geldige opties van de kolom.
getSelectedOption Retourneert de geselecteerde optie of opties.
getText Retourneert de tekst van de geselecteerde optie of opties.

Getalkolomtype (decimaal, dubbel, geheel getal, geld)

De volgende methoden zijn alleen beschikbaar voor de kolommen decimal, double en integer :

Method Description
getMax Retourneert de maximaal toegestane waarde van de kolom.
getMin Retourneert de minimaal toegestane waarde van de kolom.
getPrecision Retourneert het aantal cijfers dat is toegestaan na het decimaalteken.
setPrecision Hiermee stelt u het aantal cijfers in dat is toegestaan na het decimaalteken.

Kolomtype tekenreeks

Naast de methoden die beschikbaar zijn voor alle kolomtypen zoals eerder is uitgelegd, is de volgende methode alleen beschikbaar voor de tekenreekskolom :

Method Description
getMaxLength Retourneert de maximale tekenreekslengte van de kolom.

Inzicht in Xrm-objectmodel
Besturingselementen (client-API-verwijzing)