GlideElementwährung2 – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Die GlideElementwährung2 Die API bietet Methoden zum Ausführen von Vorgängen in Devisenfeldern (FX) (auch als Devisen2 bezeichnet) im aktuellen GlideRecord.

    Diese API bietet Methoden, mit denen Sie Folgendes ausführen können:
    • Rufen Sie die vom Anwender eingegebene Anzeigezeichenfolge des Felds „FX-Währung“ ab.
    • Rufen Sie den Anzeigewert eines Felds „FX-Währung“ ab.
    • Rufen Sie den Referenzwährungswert eines Felds „FX-Währung“ ab.
    • Ruft den Sitzungswährungswert eines Felds „FX-Währung“ ab.
    • Legen Sie den Anzeigewert eines FX-Währungsfelds fest.

    Die GlideElementwährung2 Klasse hat keinen Konstruktor.

    GlideElementCurrency 2 – getAsEnteredDisplayValue()

    Gibt eine vom Anwender eingegebene Anzeigezeichenfolge für das Feld „FX-Währung“ aus dem zugehörigen GlideRecord zurück.

    Weitere Informationen zu FX-Währungsfeldern finden Sie unter Felder für Devisenwährung einrichten und Betrieb .

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Währungszeichenfolge anzeigen, wie vom Anwender eingegeben.

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

    Ausgabe:

    As entered display value: ¥999,999.12

    GlideElementwährungs2 – getDisplayValue()

    Gibt den Anzeigewert eines FX-Währungsfelds im zugehörigen GlideRecord zurück.

    Je nachdem, wie Display_value in der Tabelle „FX-Währungskonfiguration“ [fx_Configuration] festgelegt ist, kann der zurückgegebene Wert sein:
    • Vom Anwender eingegebener Währungswert
    • Währungswert, der in die Sitzungswährung konvertiert wird (basierend auf dem Gebietsschema des Anwenders)
    • Währungswert, der in die Referenzwährung konvertiert wird

    Weitere Informationen zur FX-Währung und zur Konfigurationstabelle finden Sie unter Konfigurieren Sie globale Einstellungen für FX-Währungen .

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Währungswert anzeigen

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

    Ausgabe:

    Display Value: ¥999,999.12

    GlideElementWährung2 – getReferenceDisplayValue()

    Gibt den Referenzwährungswert eines Felds „FX-Währung“ im zugehörigen GlideRecord zurück.

    Referenzwährung ist die allgemeine Währung, in die alle Währungswerte in einem Feld konvertiert werden. Der Währungscode, der verwendet wird GetReferenceDisplayValue() Die Methode, die zum Ableiten der Referenzwährung verwendet wird, basiert auf:
    • Wenn ein Instanzdatensatz vorhanden ist, verwendet die Methode den Wert im Feld reference_currency der Tabelle „fx-Währung“ [fx_currcy2_instance].
    • Wenn kein Instanzdatensatz vorhanden ist, verwendet die Methode die Referenzwährung, die im Instanzdatensatz festgelegt wird, wenn der Instanzdatensatz schließlich erstellt wird (in der folgenden Reihenfolge):
      • Wenn festgelegt, wird reference_currencyIn der Tabelle „FX-Währungskonfiguration“ [fx_Configuration].
      • Wenn festgelegt, wird reference_currency_sourceIn der Tabelle „FX-Währungskonfiguration“ [fx_Configuration].
      • Systemstandard, Systemreferenzwährung.

    Weitere Informationen zu den Werten in der Tabelle „FX-Währungskonfiguration“ [fx_Configuration] finden Sie unter Felder für Devisenwährung einrichten und Betrieb .

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Referenzwährungsbetrag für den zugehörigen Anzeigewert der FX-Währung.

    In diesem Beispiel wird davon ausgegangen, dass der Referenzwährungscode USD ist, und der Standardkonvertierungskurs verwendet, der in der Tabelle „fx-Währungskonfiguration“ [fx_Configuration] angegeben ist. Die Ausgabe ändert sich basierend auf dem Gebietsschema.

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

    Ausgabe:

    Reference display value: $8,677.99

    GlideElementWährung2 – getSessionDisplayValue()

    Gibt den Sitzungswährungswert des zugehörigen Felds „FX-Währung“ im aktuellen GlideRecord zurück.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Währungswert, der in die Sitzungswährung konvertiert wird, der auf dem Gebietsschema des aktuellen Anwenders basiert.

    In diesem Beispiel wird davon ausgegangen, dass das Sitzungsgebietsschema Sprachcode = eng und Ländercode = USA ist, und der Standardkonvertierungskurs verwendet, der in der Tabelle „fx-Währungskonfiguration“ [fx_Configuration] angegeben ist. Die Ausgabe ändert sich basierend auf dem Gebietsschema.

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

    Ausgabe:

    Session display value: $8,677.99

    GlideElementwährungs2 – setDisplayValue(Zeichenfolge DisplayValue)

    Legt den Anzeigewert eines FX-Währungsfelds mit dem angegebenen Währungswert fest.

    Weitere Informationen zu FX-Währungsfeldern finden Sie unter Felder für Devisenwährung einrichten und Betrieb .

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    displayValue Zeichenfolge Wert, der im Feld „FX-Währung“ im Format festgelegt werden soll <currency code>;<currency amount> . Sie müssen formatieren <currency amount> Feld im Gebietsschema des Anwenders.

    Wenn beispielsweise das Gebietsschema des Anwenders USA/eng ist, wurde übergeben <currency amount> Wäre 123.45. Wenn der lokale Benutzer FRA/fre ist, wurde übergeben <currency amount> Wäre 123.45.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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