Columnes en aplicacions basades en models (Referència a l'API del client)

Les columnes contenen dades al formulari o a les quadrícules d'aplicacions basades en models. Utilitzeu la formContext.data.entity.attributes col·lecció o el mètode de formContext.getAttribute drecera per accedir a una col·lecció de columnes. Per obtenir més informació sobre les col·leccions, vegeu Col·leccions (referència de l'API de client).

Per accedir a una columna dins la col·lecció, passa el nom (cadena) o el valor d'índex (nombre) de la columna com a argument al mètode. Per exemple: formContext.getAttribute(arg). Si no especifiques cap argument, el mètode retorna una col·lecció de tots els atributs del formulari.

Les columnes es classifiquen per tipus. Utilitza el mètode getAttributeType per determinar el tipus de columna. Alguns mètodes de columna només estan disponibles per a tipus específics de columnes.

Aquest article proporciona informació sobre els mètodes disponibles per a cada tipus de columna.

Tots els tipus de columnes

La propietat controls proporciona un conjunt de controls associats a la columna.

Els següents mètodes estan disponibles per a tots els tipus de columna:

Mètode Descripció
addOnChange Afegeix una funció per executar quan es produeix l'esdeveniment de OnChange la columna.
fireOnChange Desencadena l'esdeveniment de OnChange la columna.
getAttributeType Retorna el tipus de la columna.
getFormat Retorna el format de la columna.
getIsDirty Retorna si la columna té canvis no desats.
getName Retorna el nom lògic de la columna.
getParent Retorna l'objecte pare formContext.data.entity .
getRequiredLevel Retorna tant si un valor de columna és necessari com recomanat.
getSubmitMode Retorna quan les dades de la columna s'envien en la partida.
getUserPrivilege Retorna els privilegis de l'usuari per crear, llegir o actualitzar el valor de la columna.
getValue Retorna el valor de dades de la columna.
ésVàlid Retorna si el valor de la columna és vàlid.
removeOnChange Elimina una funció dels gestors d'esdeveniments OnChange de la columna.
setIsValid Estableix la validesa de la columna i un missatge d'error.
setRequiredLevel Estableix si un valor de columna és necessari o recomanat abans de desar.
setSubmitMode Estableix si les dades de la columna s'envien en la partida.
setValue Estableix el valor de dades de la columna.

Tipus de columna booleana

A més dels mètodes disponibles per a tots els tipus de columna, el tipus de columna booleà proporciona el següent mètode:

Mètode Descripció
getInitialValue Retorna el valor de la columna quan s'obre el formulari.

Tipus de columna de cerca

A més dels mètodes disponibles per a tots els tipus de columna, el tipus de columna de cerca proporciona el següent mètode:

Mètode Descripció
getIsPartyList Retorna si la consulta permet múltiples registres com a consulta de llista de parts.

Opcions i tipus de columna d'elecció

A més dels mètodes disponibles per a tots els tipus de columna, les opcions i els tipus de columna d'elecció proporcionen els següents mètodes:

Mètode Descripció
getInitialValue Retorna el valor de la columna quan s'obre el formulari.
getOption Retorna l'opció que coincideixi amb una etiqueta o valor especificat.
getOptions Retorna les opcions vàlides de la columna.
getSelectedOption Retorna l'opció o opcions seleccionades.
getText Retorna el text de l'opció o opcions seleccionades.

Tipus de columna numèrica (decimal, doble, enter, diners)

Els mètodes següents només estan disponibles per a les columnes decimal, doble i entera :

Mètode Descripció
getMax Retorna el valor màxim permès de la columna.
getMin Retorna el valor mínim permès a la columna.
getPrecision Retorna el nombre de dígits permesos després del punt decimal.
setPrecision Estableix el nombre de dígits permesos després del punt decimal.

Tipus de columna de cadena

A més dels mètodes disponibles per a tots els tipus de columnes com s'ha explicat anteriorment, el mètode següent només està disponible per a la columna de cadena :

Mètode Descripció
getMaxLength Retorna la longitud màxima de la cadena de la columna.

Entendre el model d'objectes Xrm
Controls (referència de l'API del client)

  • Darrera actualització el