Compartilhar via


setValue (referência da API do cliente)

Define o valor dos dados de uma coluna.

Tipos de coluna com suporte

All

Sintaxe

formContext.getAttribute(arg).setValue(value)

Parâmetros

Depende do tipo de coluna.

Tipo de Coluna Tipo de parâmetros
boolean Booleano
datetime Data

Na Interface Unificada, os valores de data são considerados UTC.
No cliente Web herdado, presume-se que os valores de data estejam no fuso horário do usuário.
decimal Número
duplo Número
Integer Número
pesquisa Array Uma matriz de objetos de pesquisa.

Determinadas pesquisas, conhecidas como pesquisas 'partylist', permitem que vários registros sejam associados em uma pesquisa, como a coluna Para: para um registro de tabela de email. Portanto, todos os valores de dados de pesquisa usam uma matriz de objetos de pesquisa , mesmo quando a coluna de pesquisa não dá suporte a 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: Cadeia de caracteres: a representação de cadeia de caracteres do valor GUID do registro exibido na pesquisa. O valor deve corresponder ao seguinte formato: {XXXXXXXX-XXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
- nome: Cadeia de caracteres: o texto que representa o registro a ser exibido na pesquisa.
Memorando Cadeia de caracteres
dinheiro Número
escolha Número
cadeia Cadeia de caracteres
Memorando Cadeia de caracteres
dinheiro Número
escolha, opções Número

O método getOptions retorna valores de opção como cadeias de caracteres. 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 código de status (Motivo do Status) dependem do código de estado atual do registro. A coluna statecode (Status) não pode ser definida em scripts de formulário. Para entender quais valores de código de estado 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 quaisquer transições de estado personalizadas que tenham sido aplicadas à coluna. Mais informações: definir transições de motivo de status para as tabelas Case ou personalizadas.
String Cadeia de caracteres

Uma coluna String com o formato de email requer que a cadeia de caracteres represente um endereço de email válido.

Observação

Atualizar uma coluna usando setValue não fará com que os manipuladores de eventos OnChange sejam executados. Se você quiser que os manipuladores de eventos OnChange executem , use fireOnChange além de setValue.

Artigo relacionado

getValue (referência da API do cliente)