Colunas em aplicações orientadas a modelos (Referência à API do cliente)

As colunas contêm dados no formulário ou grades de aplicativos controlados por modelo. Use a formContext.data.entity.attributes coleção ou o formContext.getAttribute método de atalho para acessar uma coleção de colunas. Para obter mais informações sobre coleções, consulte Coleções (referência da API do cliente).

Para aceder a uma coluna dentro da coleção, passe o nome (string) ou o valor do índice (número) da coluna como argumento ao método. Por exemplo: formContext.getAttribute(arg). Se não especificar um argumento, o método devolve uma coleção de todos os atributos do formulário.

As colunas são categorizadas por tipo. Use o método getAttributeType para determinar o tipo da coluna. Certos métodos de coluna só estão disponíveis para tipos específicos de colunas.

Este artigo fornece informações sobre os métodos disponíveis para cada tipo de coluna.

Todos os tipos de coluna

A propriedade de controlos fornece um conjunto de controlos associados à coluna.

Os seguintes métodos estão disponíveis para todos os tipos de coluna:

Method	Description
addOnChange	Adiciona uma função para executar quando ocorre o evento da OnChange coluna.
fireOnAlterar	Desencadeia o evento da OnChange coluna.
getAttributeType	Devolve o tipo da coluna.
getFormat	Devolve o formato da coluna.
getIsDirty	Devolve se a coluna tem alterações não guardadas.
getName	Devolve o nome lógico da coluna.
getParent	Devolve o objeto pai formContext.data.entity .
getRequiredLevel	Devolve se o valor de uma coluna é necessário ou recomendado.
getSubmitMode	Retorna quando os dados da coluna são submetidos no save.
getUserPrivilege	Devolve os privilégios do utilizador para criar, ler ou atualizar o valor da coluna.
getValue	Devolve o valor de dados da coluna.
isValid	Devolve se o valor da coluna é válido.
removeOnChange	Remove uma função dos gestores de eventos da OnChange coluna.
setIsValid	Define a validade da coluna e uma mensagem de erro.
setRequiredLevel	Define se um valor de coluna é necessário ou recomendado antes de guardar.
setSubmitMode	Define se os dados da coluna são submetidos no save.
setValue	Define o valor dos dados da coluna.

Tipo de coluna booleana

Para além dos métodos disponíveis para todos os tipos de coluna, o tipo de coluna booleano fornece o seguinte método:

Method	Description
getInitialValue	Devolve o valor da coluna quando o formulário foi aberto.

Tipo de coluna de pesquisa

Para além dos métodos disponíveis para todos os tipos de coluna, o tipo de coluna de consulta fornece o seguinte método:

Method	Description
getIsPartyList	Devolve se a consulta permite múltiplos registos como consulta de listas de partes.

Opções e tipos de coluna de escolha

Para além dos métodos disponíveis para todos os tipos de colunas, as escolhas e os tipos de coluna de escolha fornecem os seguintes métodos:

Method	Description
getInitialValue	Devolve o valor da coluna quando o formulário foi aberto.
getOpção	Devolve a opção que corresponde a um rótulo ou valor especificado.
getOptions	Devolve as opções válidas da coluna.
getSelectedOption	Devolve a opção ou opções selecionadas.
getText	Devolve o texto da opção ou opções selecionadas.

Tipo de coluna numérica (decimal, dupla, inteira, monetária)

Os seguintes métodos estão disponíveis apenas para as colunas decimal, dupla e inteira :

Method	Description
getMax	Devolve o valor máximo permitido da coluna.
getMin	Devolve o valor mínimo permitido da coluna.
getPrecision	Devolve o número de dígitos permitidos após o ponto decimal.
setPrecision	Define o número de dígitos permitidos após a vírgula decimal.

Tipo de coluna de cadeia de caracteres

Além dos métodos disponíveis para todos os tipos de coluna, conforme explicado anteriormente, o seguinte método está disponível apenas para a coluna string :

Method	Description
getMaxLength	Devolve o comprimento máximo da linha da coluna.

Artigos relacionados

Compreender o modelo de objeto Xrm
Controles (referência da API do cliente)