GlideCurrencyConverter – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Die GlideCurrencyConverter- API bietet Methoden zum Konvertieren eines Währungswerts in einen anderen, z. B. zum Konvertieren von US-Dollar in Euro.

    Sie können das GlideCurrencyConverter-Objekt instanziieren und die Quell- und Zielwährungen während der Instanziierung mit GlideCurrencyConverter(from, to)definieren. Sie können das Objekt auch ohne diese Werte instanziieren und sie später mit den Methoden setFromCurrency() und setToCurrency() definieren. Diese Werte und der zu konvertierende Betrag müssen vor dem Aufruf der Methode „ convert() “ festgelegt werden, um die Währungsumrechnung durchzuführen. Um den zu konvertierenden Betrag festzulegen, verwenden Sie die Methode setAmount().

    Die GlideCurrencyConverter()- API bietet auch optionale Methoden, mit denen Sie:
    • Legen Sie das Datum und die Uhrzeit fest, für die die Konvertierung durchgeführt werden soll, setDateTime(). Durch das Festlegen von Datum und Uhrzeit wird für die Konvertierungsberechnung der Kurs für das angegebene Datum und die angegebene Uhrzeit verwendet, anstatt das aktuelle Datum und die aktuelle Uhrzeit.
    • Legen Sie die Ratentabelle fest, die in der Konvertierung verwendet werden soll, setRateTable(). Standardmäßig verwendet die Konvertierung die Tabelle „fx_system_rate“. Sie können jedoch benutzerdefinierte Ratentabellen für Ihre Instanz definieren. Weitere Informationen zum Erstellen von Ratentabellen finden Sie unter Wechselkurse mithilfe einer benutzerdefinierten Ratentabelle hinzufügen.

    Diese Klasse wird im Namespace sn_currency ausgeführt.

    Scoped GlideCurrencyConverter – convert()

    Führt den Währungsumrechner aus.

    Rufen Sie diese Methode auf, nachdem Sie andere GlideCurrencyConverter- Methoden aufgerufen haben, die die Währungsumrechnung erstellen, z. B. setAmount(), setRateTable()und setDate().

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Objekt Wenn die Konvertierung erfolgreich ist, wird das CurrencyExchangeValue-Objekt zurückgegeben. Wenn nicht erfolgreich, wird „null“ zurückgegeben.
    CurrencyExchangeValue {
Rate: Number,
OriginalAmount: Number,
Amount: Number,
fromCurrency: String,
toCurrency: String,
rateSysId: String
}

    Rate: Nummer. Bei der Konvertierung verwendeter Wechselkurs.

    OriginalAmount: Nummer. Betrag in der Quellwährung.

    Amount: Nummer. Konvertierter Betrag (OriginalAmount * Rate).

    fromCurrency: Zeichenfolge. Dreistelliger ISO 3166-Ländercode der Quellwährung.

    toCurrency: Zeichenfolge. Dreistelliger ISO 3166-Ländercode der umgerechneten Währung.

    rateSysId: Zeichenfolge. Sys_id des Ratentabellen-Datensatzes, der zur Berechnung der Konvertierung verwendet wird.

    Beispiel

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);
gs.info(conv.convert());

    Ausgabe:

    CurrencyExchangeValue{Rate = 1.0777, OriginalAmount = 100, Amount = 107.7700, fromCurrency = 'EUR', toCurrency = 'USD', rateSysId = '2ed537fcb271937adb'}

    Scoped GlideCurrencyConverter – GlideCurrencyConverter()

    Instanziiert ein GlideCurrencyConverter- Objekt.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine

    Beispiel

    var conv = new sn_currency.GlideCurrencyConverter();

    Scoped GlideCurrencyConverter – GlideCurrencyConverter(String from, String to)

    Instantiiert ein GlideCurrencyConverter- Objekt und legt die Quell- und Ziellandcodes fest, die bei der Währungsumrechnung verwendet werden sollen.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    from Zeichenfolge Dreistelliger ISO 3166-Ländercode der Quellwährung.
    bis Zeichenfolge Dreistelliger ISO 3166-Ländercode der umgerechneten Währung.

    Beispiel

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');

    Scoped GlideCurrencyConverter – setAmount(String amount)

    Legt den Betrag der zu konvertierenden Währung fest.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    amount Zeichenfolge Zu konvertierender Währungsbetrag. Dieser Wert darf bis auf einen Dezimalpunkt zur Angabe der Bruchwährung nicht formatiert sein. Zum Beispiel ist 1234,56 gültig, 1.234,56 ist ungültig.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    void

    Beispiel

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);

    Scoped GlideCurrencyConverter – setDateTime(Object date)

    Legt Datum und Uhrzeit der Währungsumrechnung fest.

    Dieses Datum und diese Uhrzeit bestimmen den Umrechnungskurs, der zum Umrechnen der Währung verwendet wird. Wenn diese Methode nicht vor der GlideCurrencyConverter.convert() -Methode aufgerufen wird, wird die Konvertierung mit dem Kurs für das aktuelle Datum/die aktuelle Uhrzeit durchgeführt.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Datum GlideDateTime Datum/Uhrzeit, für die die Währungsumrechnung berechnet werden soll. Dieser Wert bestimmt den Kurs, der bei der Umrechnung verwendet wird.
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie diese Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);
var gd = new GlideDateTime("2019-01-03 11:00:00");
conv.setDateTime(gd);
gs.info(conv.convert());

    Ausgabe:

    CurrencyExchangeValue{fOriginalAmount=100, fOriginalCurrency='EUR', fRate=1.061, fAmount=106.1, fCurrency='USD', fRateSysId='4555525f5553445f3130303030313031'}

    Scoped GlideCurrencyConverter – setFromCurrency(String from)

    Legt den Ländercode der Quellwährung fest.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    from Zeichenfolge Dreistelliger ISO 3166-Ländercode der Quellwährung.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    void

    Beispiel

    var conv = new sn_currency.GlideCurrencyConverter().setFromCurrency('FRA');

    Scoped GlideCurrencyConverter – setRateTable(String rateTable)

    Definiert die Ratentabelle, die bei der Währungsumrechnung verwendet werden soll.

    Wenn diese Methode nicht vor dem Aufruf der GlideCurrencyConverter.convert()- Methode aufgerufen wird, wird die Konvertierung mithilfe der Tabelle „fx_system_rate“ durchgeführt. Alle benutzerdefinierten Ratentabellen müssen die Tabelle „fx_conversion_rate“ erweitern. Weitere Informationen zum Erstellen von Ratentabellen finden Sie unter Wechselkurse mithilfe einer benutzerdefinierten Ratentabelle hinzufügen.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    rateTable Zeichenfolge Name der Kurstabelle, die bei der Währungsumrechnung verwendet werden soll.
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    void

    Beispiel

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setRateTable(custom_rate_table);

    Scoped GlideCurrencyConverter – setToCurrency(String to)

    Legt den Ländercode der Zielwährung fest.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    to Zeichenfolge Dreistelliger ISO 3166-Ländercode der Quellwährung.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    void

    Beispiel

    var conv = new sn_currency.GlideCurrencyConverter().setToCurrency('USA');