Partilhar via

setValue (referência da API do cliente)

Define o valor de dados para uma coluna.

Tipos de coluna suportados

Todos

Sintaxe

formContext.getAttribute(arg).setValue(value)

Parâmetros

Depende do tipo de coluna.

Tipo de coluna Tipo de parâmetros
Booleano Booleano
datetime Date

Na Interface Unificada, os valores de data são assumidos como UTC.
No cliente Web herdado, os valores de data são assumidos como estando no fuso horário do usuário.
decimal Número
duplo Número
Número inteiro Número
procura Matriz Uma matriz de objetos de pesquisa.

Determinadas pesquisas, conhecidas como pesquisas de "lista de partidos", permitem que vários registros sejam associados em uma pesquisa, como a coluna Para: para um registro de tabela de e-mail. Portanto, todos os valores de dados de pesquisa usam uma matriz de objetos de pesquisa – mesmo quando a coluna de pesquisa não suporta mais de uma referência de registro a ser adicionada.

Cada pesquisa tem as seguintes propriedades:
- entityType: String. O nome da tabela exibida na pesquisa.
- id: String: A representação da cadeia de caracteres do valor GUID para o registro exibido na pesquisa. O valor deve corresponder ao seguinte formato: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
- name: String: O texto que representa o registro a ser exibido na pesquisa.
memorando String
dinheiro Número
choice Número
cadeia (de caracteres) String
memorando String
dinheiro Número
escolha, escolhas Número

O método getOptions retorna valores de opção como strings. Você deve usar parseInt para convertê-los em números antes de poder usar esses valores para definir o valor de uma coluna de escolha. As opções válidas de statuscode (Status Reason) dependem do statecode atual do registro. A coluna statecode (Status) não pode ser definida em scripts de formulário. Para entender quais valores statecode são válidos, consulte as definições de coluna. Para tabelas personalizadas, use o navegador de definições de tabela. Por fim, considere também todas as transições de estado personalizadas que foram aplicadas à coluna. Para obter mais informações: Defina transições de motivo de status para as tabelas Case ou personalizadas.
String String

Uma coluna String com o formato de email requer que a string represente um endereço de e-mail válido.

Observação

A atualização de uma coluna usando setValue não fará com que os manipuladores de eventos OnChange sejam executados. Se desejar que os manipuladores de eventos OnChange sejam executados, use fireOnChange além de setValue.

Artigo relacionado

getValue (referência da API do cliente)

  • Last updated on