GlideElementCurrency2: Bereichsbezogen

Die GlideElementCurrency2- API bietet Methoden zum Durchführen von Vorgängen in FX-Währungsfeldern (auch bekannt als Currency2) im aktuellen GlideRecord.

Diese API stellt Methoden bereit, mit denen Sie Folgendes ausführen können:

• Ruft die Anzeigezeichenfolge des Felds „FX-Währung“ ab, wie vom Anwender eingegeben.
• Ruft den Anzeigewert eines FX-Währungsfelds ab.
• Bezugswährungswert eines FX-Währungsfelds abrufen
• Ruft den Sitzungswährungswert eines FX-Währungsfelds ab.
• Legen Sie den Anzeigewert eines FX-Währungsfelds fest.

Die GlideElementCurrency2 -Klasse hat keinen Konstruktor.

GlideElementCurrency2 – getAsEnteredDisplayValue()

Gibt eine Anzeigezeichenfolge für das FX-Währungsfeld zurück, wie vom Anwender eingegeben, aus dem zugeordneten GlideRecord.

Weitere Informationen zu FX-Währungsfeldern finden Sie unter FX-Währungsfelder einrichten und verwenden.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Währungszeichenfolge wie vom Anwender eingegeben angezeigt.

In diesem Beispiel wird gezeigt, 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

GlideElementCurrency2 - 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 wie folgt lauten:

• Währungswert, wie vom Anwender eingegeben
• In Sitzungswährung konvertierter Währungswert (basierend auf dem Gebietsschema des Anwenders)
• In die Bezugswährung konvertierter Währungswert

Weitere Informationen zur FX-Währung und zur Konfigurationstabelle finden Sie unter Globale Einstellungen für FX-Währung konfigurieren.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Währungswert anzeigen

In diesem Beispiel wird gezeigt, 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

GlideElementCurrency2 - getReferenceDisplayValue()

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

Die Bezugswährung ist die allgemeine Währung, in die alle Währungswerte in einem Feld konvertiert werden. Der Währungscode, den die getReferenceDisplayValue()- Methode zum Ableiten der Referenzwährung verwendet, basiert auf Folgendem:

• Wenn ein Instanzdatensatz vorhanden ist, verwendet die Methode den Wert im Feld „reference_currency“ der Tabelle „FX-Währung“ [fx_currency2_instance].
• Wenn ein Instanzdatensatz nicht vorhanden ist, verwendet die Methode die Referenzwährung, die für den Instanzdatensatz festgelegt würde, wenn der Instanzdatensatz schließlich erstellt wird (in der folgenden Reihenfolge):
  • Wenn festgelegt, reference_currency in der Tabelle „FX-Währungskonfiguration“ [fx_configuration].
  • Wenn festgelegt, reference_currency_source in 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 FX-Währungsfelder einrichten und verwenden.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Referenzwährungsbetrag für den Anzeigewert der zugehörigen FX-Währung.

In diesem Beispiel wird davon ausgegangen, dass der Referenzwährungscode USD ist, und es wird der in der Tabelle „FX-Währungskonfiguration“ [fx_configuration] angegebene Standard-Wechselkurs verwendet. Die Ausgabe ändert sich je nach 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

GlideElementCurrency2 – getSessionDisplayValue()

Gibt den Sitzungswährungswert des zugeordneten FX-Währungsfelds 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, die auf dem Gebietsschema des aktuellen Anwenders basiert.

In diesem Beispiel wird davon ausgegangen, dass das Gebietsschema der Sitzung Sprachcode = eng und der Ländercode = USA lautet und der in der Tabelle „FX-Währungskonfiguration“ [fx_configuration] angegebene Standard-Wechselkurs verwendet wird. Die Ausgabe ändert sich je nach 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

GlideElementCurrency2 - setDisplayValue(String displayValue)

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

Weitere Informationen zu FX-Währungsfeldern finden Sie unter FX-Währungsfelder einrichten und verwenden.

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 Benutzers. Beispiel: Wenn das Gebietsschema des Benutzers USA/eng ist, wird in übergeben<currency amount> wäre 123,45. Wenn das lokale Element des Anwenders FRA/Fr ist, wird übergeben<currency amount> wäre 123,45.

Tabelle : 10. Ergebnisse

Typ	Beschreibung
void

In diesem Beispiel wird gezeigt, 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();