Colunas em aplicativos controlados por modelos (referência à API do Cliente)

As colunas contêm dados no formulário ou grades de aplicativos controlados por modelos. 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 de API do Cliente).

Para acessar uma coluna dentro da coleção, passe o nome (cadeia de caracteres) ou o valor de índice (número) da coluna como um argumento para o método. Por exemplo: formContext.getAttribute(arg). Se você não especificar um argumento, o método retornará uma coleção de todos os atributos no formulário.

As colunas são categorizadas por tipo. Use o método getAttributeType para determinar o tipo da coluna. Determinados 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 controls fornece uma coleção de controles associados à coluna.

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

Method Description
addOnChange Adiciona uma função a ser executada quando o evento da OnChange coluna ocorre.
fireOnChange Dispara o evento da OnChange coluna.
getAttributeType Retorna o tipo da coluna.
getFormat Retorna o formato da coluna.
getIsDirty Retorna se a coluna tem alterações não salvas.
getName Retorna o nome lógico da coluna.
getParent Retorna o objeto pai formContext.data.entity .
getRequiredLevel Retorna se um valor de coluna é necessário ou recomendado.
getSubmitMode Retorna quando os dados da coluna são enviados ao salvar.
getUserPrivilege Retorna os privilégios do usuário para criar, ler ou atualizar o valor da coluna.
getValue Retorna o valor de dados da coluna.
isValid Retorna se o valor da coluna é válido.
removeOnChange Remove uma função dos manipuladores 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 salvar.
setSubmitMode Define se os dados da coluna são enviados ao salvar.
setValue Define o valor de dados da coluna.

Tipo de coluna booliana

Além dos métodos disponíveis para todos os tipos de coluna, o tipo de coluna booliana fornece o seguinte método:

Method Description
getInitialValue Retorna o valor da coluna quando o formulário é aberto.

Tipo de coluna de pesquisa

Além dos métodos disponíveis para todos os tipos de coluna, o tipo de coluna de pesquisa fornece o seguinte método:

Method Description
getIsPartyList Retorna se a pesquisa permite vários registros como uma pesquisa de lista de partes.

Opções e tipos de coluna de escolha

Além dos métodos disponíveis para todos os tipos de coluna, as opções e os tipos de coluna de escolha fornecem os seguintes métodos:

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

Tipo de coluna numérica (decimal, duplo, inteiro, dinheiro)

Os métodos a seguir estão disponíveis apenas para as colunas decimais, duplas e inteiros :

Method Description
getMax Retorna o valor máximo permitido da coluna.
getMin Retorna o valor mínimo permitido da coluna.
getPrecision Retorna o número de dígitos permitido após o ponto decimal.
setPrecision Define o número de dígitos permitido após o ponto 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 de cadeia de caracteres :

Method Description
getMaxLength Retorna o comprimento máximo da cadeia de caracteres da coluna.

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