Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. |
Artigos relacionados
Entender o modelo de objeto Xrm
Controles (referência da API do cliente)