GlideCurrencyExchangeValue - Scoped

The GlideCurrencyExchangeValue API provides methods to access information related to FX Currency conversions.

There is no constructor for this class. Use the convert() method from the GlideCurrencyConverter API to return a GlideCurrencyExchangeValue object.

This API is provided within the sn_currency namespace.

GlideCurrencyExchangeValue - getAmount()

Returns the currency amount after the conversion.

Table 1. Parameters

Name	Type	Description
None

Table 2. Returns

Type	Description
Number	Currency amount after the conversion.

This example assumes a conversion rate of 1 Euro = .92 US dollars.

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

Output:

Exchanged Amount: $92.00

GlideCurrencyExchangeValue - getCurrency()

Returns the converted to currency type.

Table 3. Parameters

Name	Type	Description
None

Table 4. Returns

Type	Description
String	Three-letter ISO currency code of the converted to currency.

This example shows how to call the method.

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

Output:

Exchanged Currency (To): JPY

GlideCurrancyExchangeValue - getOriginalCurrency()

Returns the original, pre-conversion currency type.

Table 5. Parameters

Name	Type	Description
None

Table 6. Returns

Type	Description
String	Three-letter ISO currency code of the currency converted from.

This example shows how to call the method.

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

Output:

Original Amount: USD

GlideCurrencyExchangeValue - getOriginalValue()

Returns the original, pre-conversion amount.

Table 7. Parameters

Name	Type	Description
None

Table 8. Returns

Type	Description
Number	Original amount before conversion.

This example shows how to call the method.

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

Output:

Original Amount: 999.999

GlideCurrencyExchangeValue - getRate()

Returns the exchange rate used during the conversion.

Table 9. Parameters

Name	Type	Description
None

Table 10. Returns

Type	Description
Number	Exchange rate used in the currency conversion.

This example shows how to call the method.

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

Output:

Exchange rate: 1.0559

GlideCurrencyExchangeValue - getRateSysId()

Returns the sys_id of the record in the rate table used in the currency conversion.

Table 11. Parameters

Name	Type	Description
None

Table 12. Returns

Type	Description
String	Sys_id of the rate table used in the currency conversion.

This example shows how to call the method.

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

Output:

Original Amount: 99ebb4156fa831005be8883e6b3ee4b9