GlideElementwährung2 – Umfang

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