GlideElementCurrency2 - com escopo

A API GlideElementCurrency2 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 que você execute o seguinte:

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

A classe GlideElementCurrency2 não tem construtor.

GlideElementCurrency2 com escopo – getAsEnteredDisplayValue()

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

Para obter informações adicionais sobre os campos de moeda FX, consulte Configuração e operação dos campos de moeda FX.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 2. Retorna

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

Exemplo

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 com escopo – getDisplayValue()

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

Dependendo de como display_value está 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 a moeda FX e a tabela de configuração, consulte Definir configurações globais da moeda FX.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
Cadeia de caracteres	Exibir valor da moeda

Exemplo

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 com escopo – getReferenceDisplayValue()

Retorna o valor da moeda de referência de um campo de 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 que o método getReferenceDisplayValue() usa para derivar a moeda de referência é baseado no seguinte:

• Se houver um registro de instância, o método usará o valor no campo reference_currency da tabela FX Currency [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):
  • Se definido, o reference_currency na tabela Configuração de moeda FX [fx_configuration].
  • Se definido, o reference_currency_source na tabela Configuração de 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 de moeda FX [fx_configuration], consulte Configuração e operação de campos de 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 FX associada.

Este exemplo pressupõe que o código da moeda de referência seja USD e usa a taxa de conversão padrão especificada na tabela Configuração de 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 com escopo – getSessionDisplayValue()

Retorna o valor da moeda da sessão do campo Moeda 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 pressupõe que a localidade da sessão seja o código de idioma = eng e o código do país = EUA e usa a taxa de conversão padrão especificada na tabela Configuração de 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 com escopo - setDisplayValue(cadeia de caracteres displayValue)

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

Para obter informações adicionais sobre os campos de moeda FX, consulte Configuração e operação dos campos de 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 o<currency amount> campo na localidade do usuário. Por exemplo, se a localidade do usuário for EUA/eng, o passado em<currency amount> seria 123,45. Se o local do usuário for FRA/fre, o passado em<currency amount> seria 123,45.

Tabela 10. Retorna

Tipo	Descrição
vazio

Exemplo

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