Columnas en aplicaciones controladas por modelos (referencia de API de cliente)

Las columnas contienen datos en el formulario o las cuadrículas de aplicaciones basadas en modelos. Use la colección de formContext.data.entity.attributes o el método de acceso directo formContext.getAttribute para acceder a una colección de columnas. Para obtener más información acerca de las colecciones, vea Colecciones (referencia de la API de cliente).

Para tener acceso a una columna dentro de la colección, pase el nombre (cadena) o el valor de índice (número) de la columna como argumento al método . Por ejemplo: formContext.getAttribute(arg). Si no especifica un argumento, el método devuelve una colección de todos los atributos del formulario.

Las columnas se clasifican por tipo. Use el método getAttributeType para determinar el tipo de la columna. Algunos métodos de columna solo están disponibles para tipos específicos de columnas.

En este artículo se proporciona información sobre los métodos disponibles para cada tipo de columna.

Todos los tipos de columna

La propiedad controls proporciona una colección de controles asociados a la columna.

Los métodos siguientes están disponibles para todos los tipos de columna:

Method Description
addOnChange Agrega una función para ejecutarse cuando se produce el evento de OnChange la columna.
fireOnChange Desencadena el evento de OnChange la columna.
getAttributeType Devuelve el tipo de la columna.
getFormat Devuelve el formato de la columna.
getIsDirty Devuelve si la columna tiene cambios no guardados.
getName Devuelve el nombre lógico de la columna.
getParent Devuelve el objeto padre formContext.data.entity .
getRequiredLevel Devuelve si se requiere o recomienda un valor de columna.
getSubmitMode Devuelve cuando se envían los datos de la columna al guardar.
getUserPrivilege Devuelve los privilegios del usuario para crear, leer o actualizar el valor de la columna.
getValue Devuelve el valor de datos de la columna.
isValid Devuelve si el valor de la columna es válido.
removeOnChange Quita una función de los controladores de eventos de OnChange la columna.
setIsValid Establece la validez de la columna y un mensaje de error.
setRequiredLevel Establece si se requiere o se recomienda un valor de columna antes de guardarlo.
setSubmitMode Establece si los datos de la columna se envían al guardar.
setValue Establece el valor de datos de la columna.

Tipo de columna booleano

Además de los métodos disponibles para todos los tipos de columna, el tipo de columna booleano proporciona el método siguiente:

Method Description
getInitialValue Devuelve el valor de la columna cuando se abre el formulario.

Tipo de columna de búsqueda

Además de los métodos disponibles para todos los tipos de columna, el tipo de columna de búsqueda proporciona el método siguiente:

Method Description
getIsPartyList Devuelve si la búsqueda permite varios registros como una búsqueda de lista de partes.

Opciones y tipos de columnas de opción

Además de los métodos disponibles para todos los tipos de columna, las opciones y los tipos de columna de elección proporcionan los métodos siguientes:

Method Description
getInitialValue Devuelve el valor de la columna cuando se abre el formulario.
getOption Devuelve la opción que coincide con una etiqueta o un valor especificados.
getOptions Devuelve las opciones válidas de la columna.
getSelectedOption Devuelve la opción o opciones seleccionadas.
getText Devuelve el texto de la opción o opciones seleccionadas.

Tipo de columna Number (decimal, doble, entero, dinero)

Los siguientes métodos están disponibles para las columnas decimal, double e integer:

Method Description
getMax Devuelve el valor máximo permitido de la columna.
getMin Devuelve el valor mínimo permitido de la columna.
getPrecision Devuelve el número de dígitos permitidos después del separador decimal.
setPrecision Establece el número de dígitos permitidos después del separador decimal.

Tipo de columna String

Además de los métodos disponibles para todos los tipos de columnas tal como se explicó anteriormente, el método siguiente está disponible solo para la columna string:

Method Description
getMaxLength Devuelve la longitud máxima de cadena de la columna.

Comprender el modelo de objetos XRM
Controles (referencia de la API de cliente)

  • Se actualizó por última vez el