GlideElementCurrency2 - Com escopo

. GlideElementCurrency2 A API fornece métodos para executar operações em campos de moeda de câmbio (FX) (também conhecidos como Currency2) no GlideRecord atual.

Esta API fornece métodos que permitem executar o seguinte:

• Obtenha a cadeia de caracteres de exibição do campo Moeda FX, conforme inserido pelo usuário.
• Obtenha o valor de exibição de um campo Moeda FX.
• Obtenha o valor da moeda de referência de um campo Moeda FX.
• Obtenha o valor da moeda da sessão de um campo Moeda FX.
• Defina o valor de exibição de um campo Moeda FX.

. GlideElementCurrency2 a classe não tem construtor.

GlideElementCurrency2 - getAsEnteredDisplayValue()

Retorna uma cadeia de caracteres de exibição do campo Moeda FX, conforme inserido pelo usuário, do GlideRecord associado.

Para obter informações adicionais sobre campos Moeda FX, consulte Configurar e operar campos Moeda FX .

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 2. Retorna

Tipo	Descrição
Cadeia de caracteres	Exiba a cadeia de caracteres da moeda conforme inserida pelo usuário.

Este exemplo mostra como chamar o método.

var tablename = 'my_currency2_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('As entered display value: ' + setcur2.currency_2_field.getAsEnteredDisplayValue());

Saída:

As entered display value: ¥999,999.12

GlideElementCurrency2 - getDisplayValue()

Retorna o valor de exibição de um campo Moeda FX no GlideRecord associado.

Dependendo de como display_value é definido na tabela Configuração de moeda FX [fx_configuration], o valor retornado pode ser:

• Valor da moeda conforme inserido pelo usuário
• Valor da moeda convertido para a moeda da sessão (com base na localidade do usuário)
• Valor da moeda convertido para a moeda de referência

Para obter informações adicionais sobre Moeda FX e a tabela de configuração, consulte Definir as configurações globais de Moeda FX .

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor da moeda de exibição

Este exemplo mostra como chamar o método.

var tablename = 'my_FXcurrency_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('Display Value: ' + setcur2.currency_2_field.getDisplayValue());

Saída:

Display Value: ¥999,999.12

GlideElementCurrency2 - getReferenceDisplayValue()

Retorna o valor da moeda de referência de um campo Moeda FX no GlideRecord associado.

A moeda de referência é a moeda comum na qual todos os valores de moeda em um campo são convertidos. O código da moeda ObterReferenceDisplayValue() o método usado para derivar a moeda de referência é baseado no seguinte:

• Se existir um registro de instância, o método usará o valor no campo reference_currency da tabela Moeda FX [fx_currency2_instance].
• Se um registro de instância não existir, o método usará a moeda de referência que seria definida no registro de instância quando o registro de instância for criado (na seguinte ordem):
  • . reference_currencyNa tabela Configuração da moeda FX [fx_configuration].
  • . reference_currency_sourceNa tabela Configuração da moeda FX [fx_configuration].
  • Padrão do sistema, moeda de referência do sistema.

Para obter informações adicionais sobre os valores na tabela Configuração da moeda FX [fx_configuration], consulte Configurar e operar campos Moeda FX .

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor da moeda de referência para o valor de exibição da Moeda de FX associada.

Este exemplo pressupõe que o código da moeda de referência é USD e usa a taxa de conversão padrão especificada na tabela Configuração da moeda FX [fx_configuration]. A saída mudará com base na localidade.

var tablename = 'my_currency2_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('Reference display value: ' + setcur2.currency_2_field.getReferenceDisplayValue());

Saída:

Reference display value: $8,677.99

GlideElementCurrency2 - getSessionDisplayValue()

Retorna o valor da moeda da sessão do campo Moeda de FX associado no GlideRecord atual.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor da moeda convertido para a moeda da sessão, que é baseada na localidade do usuário atual.

Este exemplo presume que a localidade da sessão seja o código de idioma: Eng e o código do país: EUA e use a taxa de conversão padrão especificada na tabela Configuração da moeda FX [fx_configuration]. A saída mudará com base na localidade.

var tablename = 'my_currency2_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('Session display value: ' + setcur2.currency_2_field.getSessionDisplayValue());

Saída:

Session display value: $8,677.99

GlideElementCurrency2 - setDisplayValue(cadeia de caracteres displayValue)

Define o valor de exibição de um campo Moeda FX com o valor da moeda especificado.

Para obter informações adicionais sobre campos Moeda FX, consulte Configurar e operar campos Moeda FX .

Tabela 9. Parâmetros

Nome	Tipo	Descrição
displayValue	Cadeia de caracteres	Valor a ser definido no campo Moeda FX no formato <currency code>;<currency amount> . Você deve formatar <currency amount> campo na localidade do usuário. Por exemplo, se a localidade do usuário for EUA/eng, será passado <currency amount> seria 123,45. Se o local do usuário for fra/fr, o será passado <currency amount> seria 123,45.

Tabela 10. Retornos

Tipo	Descrição
vazio

Este exemplo mostra como chamar o método.

var tablename = 'my_FXcurrency_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999,999.1234');
setcur2.insert();