GlideElementCurrency2 – Scoped

Die GlideElementCurrency2- API stellt Methoden zum Ausführen von Vorgängen in Fremdwährungsfeldern (auch als Währung2 bezeichnet) innerhalb des aktuellen GlideRecord bereit.

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

• Ruft die vom Benutzer eingegebene Anzeigezeichenfolge für das FX-Währungsfeld ab.
• Ruft den Anzeigewert eines FX-Währungsfelds ab.
• Ruft den Referenzwährungswert eines FX-Währungsfelds ab.
• Ruft den Sitzungswährungswert eines FX-Währungsfelds ab.
• Legen Sie den Anzeigewert eines FX-Währungsfelds fest.

Die GlideElementCurrency2 -Klasse hat keinen Konstruktor.

Scoped GlideElementCurrency2 – getAsEnteredDisplayValue()

Gibt eine vom Benutzer eingegebene FX-Währungsfeld-Anzeigezeichenfolge aus dem zugeordneten GlideRecord zurück.

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

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Zeigt die vom Benutzer eingegebene Währungszeichenfolge an.

Beispiel

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

Scoped GlideElementCurrency2 – getDisplayValue()

Gibt den Anzeigewert eines FX-Währungsfelds innerhalb des zugeordneten 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 Benutzer eingegeben
• In die Sitzungswährung konvertierter Währungswert (basierend auf dem Gebietsschema des Benutzers)
• In die Referenzwährung konvertierter Währungswert

Weitere Informationen zu 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	Anzeigewährungswert

Beispiel

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

Scoped GlideElementCurrency2 – getReferenceDisplayValue()

Gibt den Referenzwährungswert eines FX-Währungsfelds innerhalb des zugeordneten GlideRecord zurück.

Referenzwährung ist die allgemeine Währung, in die alle Währungswerte in einem Feld umgerechnet 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 FX-Währungstabelle [fx_currency2_instance].
• Wenn kein Instanzdatensatz vorhanden ist, verwendet die Methode die Referenzwährung, die für den Instanzdatensatz festgelegt wird, 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 undbedienen.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Referenzwährungsbetrag für den zugeordneten FX-Währungsanzeigewert.

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

Scoped GlideElementCurrency2 – getSessionDisplayValue()

Gibt den Sitzungswährungswert des zugehörigen FX-Währungsfeldes innerhalb des 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 Benutzers basiert.

In diesem Beispiel wird davon ausgegangen, dass das Sitzungsgebietsschema Sprachcode = eng und Ländercode = USA ist, und es wird der in der Tabelle „FX-Währungskonfiguration“ [fx_configuration] angegebene Standard-Wechselkurs verwendet. 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

Scoped 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 bedienen.

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 die formatieren<currency amount> Feld im Gebietsschema des Benutzers. Beispiel: Wenn das Gebietsschema des Benutzers USA/eng ist, wird übergeben<currency amount> wäre 123,45. Wenn der lokale Name des Benutzers FRA/fr ist, wird übergeben<currency amount> wäre 123,45.

Tabelle : 10. Ergebnisse

Typ	Beschreibung
void

Beispiel

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