---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElementCurrency2: Bereichsbezogen

# GlideElementCurrency2: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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.
{#GlideElementCurrency2ScopedAPI__ul_dvb_b14_yjb}

Die GlideElementCurrency2 -Klasse hat keinen Konstruktor.

## GlideElementCurrency2 -- getAsEnteredDisplayValue() {#ariaid-title2}

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](https://www.servicenow.com/docs/access?context=fx-currency&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
{#Scoped-GEC-getAsEntDispVal__table_tpv_5kd_fy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#Scoped-GEC-getAsEntDispVal__table_tpv_5kd_fy} {#Scoped-GEC-getAsEntDispVal__table_upv_5kd_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Währungszeichenfolge wie vom Anwender eingegeben angezeigt. |
[Tabelle : 2. Ergebnisse]

{#Scoped-GEC-getAsEntDispVal__table_upv_5kd_fy}  
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() {#ariaid-title3}

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
{#Scoped-GEC-getDisplayVal__ul_c3x_vhj_qjb}

Weitere Informationen zur FX-Währung und zur Konfigurationstabelle finden Sie unter [Globale Einstellungen für FX-Währung konfigurieren](https://www.servicenow.com/docs/access?context=fx-currency-configure&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
{#Scoped-GEC-getDisplayVal__table_qxq_k5c_fy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#Scoped-GEC-getDisplayVal__table_qxq_k5c_fy} {#Scoped-GEC-getDisplayVal__table_rxq_k5c_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Währungswert anzeigen |
[Tabelle : 4. Ergebnisse]

{#Scoped-GEC-getDisplayVal__table_rxq_k5c_fy}  
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() {#ariaid-title4}

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.
  {#Scoped-GEC-getRefDispVal__ul_sb1_2tx_sjb}
{#Scoped-GEC-getRefDispVal__ul_l5z_x3j_qjb}

Weitere Informationen zu den Werten in der Tabelle „FX-Währungskonfiguration" \[fx_configuration\] finden Sie unter FX-Währungsfelder einrichten [und verwenden](https://www.servicenow.com/docs/access?context=fx-currency&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
{#Scoped-GEC-getRefDispVal__table_ywn_hmd_fy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

{#Scoped-GEC-getRefDispVal__table_ywn_hmd_fy} {#Scoped-GEC-getRefDispVal__table_zwn_hmd_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Referenzwährungsbetrag für den Anzeigewert der zugehörigen FX-Währung. |
[Tabelle : 6. Ergebnisse]

{#Scoped-GEC-getRefDispVal__table_zwn_hmd_fy}  
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() {#ariaid-title5}

Gibt den Sitzungswährungswert des zugeordneten FX-Währungsfelds im aktuellen GlideRecord zurück.
{#Scoped-GEC-getSesDispVal__table_ozy_rld_fy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#Scoped-GEC-getSesDispVal__table_ozy_rld_fy} {#Scoped-GEC-getSesDispVal__table_pzy_rld_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Währungswert, der in die Sitzungswährung konvertiert wird, die auf dem Gebietsschema des aktuellen Anwenders basiert. |
[Tabelle : 8. Ergebnisse]

{#Scoped-GEC-getSesDispVal__table_pzy_rld_fy}  
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) {#ariaid-title6}

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](https://www.servicenow.com/docs/access?context=fx-currency&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
{#Scoped-GEC-setDisplayVal_S__table_enw_5jd_fy__entry__3}

| 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 : 9. Parameter]

{#Scoped-GEC-setDisplayVal_S__table_enw_5jd_fy} {#Scoped-GEC-setDisplayVal_S__table_fnw_5jd_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 10. Ergebnisse]

{#Scoped-GEC-setDisplayVal_S__table_fnw_5jd_fy}  
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();