Valores de moeda padrão em scripts
Você pode usar campos de moeda em scripts.
Esses métodos estão disponíveis em objetos GlideElement.
Para exibir valores de moeda, use ObDisplayValue() API de exibição. Para trabalhar com valores de moeda de qualquer forma que não seja exibição, use as APIs que retornam/aceitam números não formatados.
Nota:
Antes de executar cálculos no valor, não use ObDisplayValue() e, em seguida, processar a cadeia de caracteres para remover informações de formatação.
Métodos como GetValue() e. ValorDeCurrencyValue() retorna números não formatados como cadeias de caracteres. Para obter o valor de ponto flutuante, use a função JavaScript ParseFloat() e use o valor resultante para executar cálculos. Para obter a moeda associada a esses valores, use as APIs que retornam o código da moeda. Você também pode usar GetCurrencyCode() métodos para determinar a moeda de um campo.
var rate = parseFloat(current.base_rate);
var currencyCode = current.base_rate.getCurrencyCode();
Use Valor() método para definir o valor de um campo de moeda. Se esta moeda for a moeda da sessão do usuário, use um número simples ou o número de ponto flutuante de uma cadeia de caracteres que o contenha. Caso contrário, prefixe o valor com o código da moeda ISO de 3 letras.
var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);
Você está trabalhando com o valor da moeda de referência ao usar GlideAggregate em campos de moeda ou preço. Certifique-se de converter os valores agregados para a moeda da sessão do usuário para exibição. O valor resultante pode não ser o esperado. A taxa de conversão usada para o valor do campo de moeda ou preço e para sua moeda de referência, que é usada para a agregação, pode ter mudado.
Quando você exclui um registro que contém um valor de moeda, a plataforma exclui todos os registros de moeda associados.
Nota:
Não use DeleteMultiple() em tabelas com campos de moeda. Sempre exclua cada registro individualmente.
Os valores da moeda contêm quatro casas decimais.
- APIs que retornam valores como GetValue() retorne até quatro casas decimais. Os zeros à direita são sempre removidos.
- As APIs que retornam valores de exibição como ObDisplayValue() ter pelo menos duas casas decimais e até quatro casas decimais.
- GlideAggregate retorna quatro casas decimais.
O sistema pode usar duas casas decimais. Quando você o define como duas casas decimais, os valores numéricos retornados pela API contêm duas casas decimais. Embora as taxas de conversão de moeda possam ter mais casas decimais, os campos de moeda armazenam apenas duas casas decimais. As APIs que aceitam valores numéricos arredondam casas decimais para duas casas.
- APIs que retornam valores como GetValue() retorne até duas casas decimais. Os zeros à direita são removidos para valores lidos do banco de dados, mas se um valor como 00 for definido posteriormente, 1,00 poderá ser retornado. O número de zeros à direita retornados não é consistente.
- As APIs que retornam valores de exibição, como getDisplayValue(), contêm até duas casas decimais. Às vezes, ele pode retornar dois lugares, mesmo para valores como 7,10, mas pode remover zeros à direita em outros momentos. O número de zeros à direita retornados não é consistente.
- GlideAggregate retorna duas casas decimais.
Nota:
Para saber como mudar o número de casas decimais usadas pelo sistema, consulte Altere as casas decimais da moeda padrão.
No exemplo a seguir, a localidade do usuário é definida como alemão (de.DE) e a moeda de referência definida como USD. Os valores usam um valor de moeda de 21345,67 em ienes japoneses, 1563,72 em euros e 1152,48 em dólares americanos.
| Nome do método | Descrição | Exemplo |
|---|---|---|
| getValue() | Retorna o valor da moeda na moeda da sessão do usuário como um número não formatado. | 1563.72 |
| GetReferenceValue() | Retorna o valor da moeda na moeda de referência como um número não formatado. | 1152.48 |
| GetSessionValue() | Retorna o valor da moeda na moeda da sessão do usuário como um número não formatado. | 1563,72 |
| ValorDeCurrencyValue() | Retorna o valor da moeda conforme inserido como um número não formatado. | 21345.67 |
| getDisplayValue() | Retorna o valor da moeda na moeda da sessão do usuário, formatado na localidade do usuário com um símbolo de moeda. | €1.563,72 |
| DisplayValue() | Retorna o valor da moeda na moeda da sessão do usuário, formatado na localidade do usuário com um símbolo de moeda. | €1.563,72 |
| DisplayValue() | Retorna o valor da moeda na moeda de referência, formatado na localidade do usuário com um símbolo de moeda. | USD 1.152,48 |
| ValorDeExibição() | Retorna o valor da moeda conforme inserido formatado na localidade do usuário com um símbolo de moeda. | ¥21.345,67 |
| Cadeia de caracteres() | Retorna o valor da moeda conforme inserido como um número não formatado, prefixado pelo código de moeda ISO de 3 letras, separado por um ponto-e-vírgula. | JPY 21345,67 |
| GetCurrencyCode() | Retorna o código da moeda ISO de 3 letras para o valor da moeda conforme inserido. | JPY |
| GetSessionCurrencyCode() | Retorna o código da moeda ISO de 3 letras para a moeda da sessão do usuário. | EUR |
| GetReferenceCurrencyCode() | Retorna o código da moeda ISO de 3 letras para a moeda de referência. | USD |
| setValue() | Define o valor da moeda como:
|
4369,21 ou JPY 4369,21 |
| setDisplayValue() | Define o valor da moeda como:
|
4369,21 ou JPY 4369,21 |