---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideCurrencyExchangeValue - com escopo

# GlideCurrencyExchangeValue - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API GlideCurrencyExchangeValue fornece métodos para acessar informações relacionadas a conversões de moeda FX.

Consulte a API [GlideCurrencyConverter()](https://servicenow-prod.fluidtopics.net/YC6EnUMYUXQ9swZo_BrnXQ#GlideCurrencyConverterScopedAPI "A API GlideCurrencyConverter fornece métodos para converter um valor de moeda em outro, como converter dólares norte-americanos em reais.") para métodos que retornam um objeto GlideCurrencyExchangeValue.

Esta classe é executada no namespace `sn_currency`.  
Nota:  
Não há nenhum construtor para esta classe.

## GlideCurrencyExchangeValue -- getAmount() {#ariaid-title2}

Retorna o valor da moeda após a conversão.
{#Scoped-GCEV-getAmount__table_bly_wqt_2y__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#Scoped-GCEV-getAmount__table_bly_wqt_2y} {#Scoped-GCEV-getAmount__table_cly_wqt_2y__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Valor da moeda após a conversão. |
[Tabela 2. Retorna]

{#Scoped-GCEV-getAmount__table_cly_wqt_2y}  
Este exemplo pressupõe uma taxa de conversão de 1 Euro = 0,92 Dólar americano.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    conv.setAmount(100);
    var convertValues = conv.convert();
    gs.info('Exchanged Amount: ' + convertValues.getAmount());

Saída:

    Exchanged Amount: $92.00

## GlideCurrencyExchangeValue -- getCurrency() {#ariaid-title3}

Retorna o convertido para o tipo de moeda.
{#Scoped-GCEV-getCurrency__table_z1s_v5t_2y__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 3. Parâmetros]

{#Scoped-GCEV-getCurrency__table_z1s_v5t_2y} {#Scoped-GCEV-getCurrency__table_abs_v5t_2y__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Código de moeda ISO de três letras do convertido para a moeda. |
[Tabela 4. Retorna]

{#Scoped-GCEV-getCurrency__table_abs_v5t_2y}  
Este exemplo mostra como chamar o método.

    var convertValues = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    convertValues.setAmount(100);
    gs.info('Exchanged Currency (To): ' + convertValues.convert().getCurrency());

Saída:

    Exchanged Currency (To): JPY

## GlideCurrancyExchangeValue - getOriginalCurrency() {#ariaid-title4}

Retorna o tipo de moeda original de pré-conversão.
{#Scoped-GCEV-getOrigCurr__table_d5y_ylb_fy__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 5. Parâmetros]

{#Scoped-GCEV-getOrigCurr__table_d5y_ylb_fy} {#Scoped-GCEV-getOrigCurr__table_e5y_ylb_fy__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Código de moeda ISO de três letras da moeda convertida. |
[Tabela 6. Retorna]

{#Scoped-GCEV-getOrigCurr__table_e5y_ylb_fy}  
Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Original Amount: ' + convertValues.getOriginalCurrency());

Saída:

    Original Amount: USD

## GlideCurrencyExchangeValue - getOriginalValue() {#ariaid-title5}

Retorna o valor original de pré-conversão.
{#Scoped-GCEV-getOrigValue__table_tkp_zkb_fy__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 7. Parâmetros]

{#Scoped-GCEV-getOrigValue__table_tkp_zkb_fy} {#Scoped-GCEV-getOrigValue__table_ukp_zkb_fy__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Valor original antes da conversão. |
[Tabela 8. Retorna]

{#Scoped-GCEV-getOrigValue__table_ukp_zkb_fy}  
Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Original Amount: ' + 'convertValues.getOriginalAmount());

Saída:

    Original Amount: 999.999

## GlideCurrencyExchangeValue -- getRate() {#ariaid-title6}

Retorna a taxa de câmbio usada durante a conversão.
{#Scoped-GCEV-getRate__table_t4h_hmb_fy__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 9. Parâmetros]

{#Scoped-GCEV-getRate__table_t4h_hmb_fy} {#Scoped-GCEV-getRate__table_u4h_hmb_fy__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Taxa de câmbio usada na conversão de moeda. |
[Tabela 10. Retorna]

{#Scoped-GCEV-getRate__table_u4h_hmb_fy}  
Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Original Amount: ' + convertValues.getRate());

Saída:

    Exchange rate: 1.0559

## GlideCurrencyExchangeValue -- getRateSysId() {#ariaid-title7}

Retorna o sys_id do registro na tabela de taxas usada na conversão de moeda.
{#Scoped-GCEV-getRateSysId__table_fbq_q4b_fy__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 11. Parâmetros]

{#Scoped-GCEV-getRateSysId__table_fbq_q4b_fy} {#Scoped-GCEV-getRateSysId__table_gbq_q4b_fy__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Sys_id da tabela de taxas usada na conversão de moeda. |
[Tabela 12. Retorna]

{#Scoped-GCEV-getRateSysId__table_gbq_q4b_fy}  
Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Rate table sys_id: ' + convertValues.getRateSysId());

Saída:

    Original Amount: 99ebb4156fa831005be8883e6b3ee4b9