GlideElementCurrency2 - com escopo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • A API GlideElementCurrency2 fornece métodos para executar operações em campos de moeda de câmbio estrangeiro (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 de FX, conforme inserido pelo usuário.
    • Obtenha o valor de exibição de um campo de Moeda de FX.
    • Obtenha o valor da moeda de referência de um campo de moeda de FX.
    • Obtenha o valor da moeda da sessão de um campo de Moeda de FX.
    • Defina o valor de exibição de um campo de Moeda de FX.

    A classe GlideElementCurrency2 não tem construtor.

    GlideElementCurrency2 – getAsEnteredDisplayValue()

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

    Para obter informações adicionais sobre campos de Moeda de FX, consulte Configuração e operação de campos de Moeda de 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 inserido 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 de moeda de FX no GlideRecord associado.

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

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Cadeia de caracteres Exibir valor da moeda

    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 de moeda de 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 existir um registro de instância, o método usará o valor no campo reference_currency da tabela FX Currency [fx_currency2_instance].
    • Se não existir um registro de instância, 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 de FX [fx_configuration].
      • Se definido, o reference_currency_source na tabela Configuração de moeda de 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 de FX [fx_configuration], consulte Configuração e operação de campos de moeda de 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 de 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 de 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 se baseia na localidade do usuário atual.

    Este exemplo pressupõe que a localidade da sessão é o código do 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 de 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 de Moeda de FX com o valor de moeda especificado.

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

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    displayValue Cadeia de caracteres Valor a ser definido no campo Moeda de 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

    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();