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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElementwährung2 -- Umfang

# GlideElementwährung2 -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die GlideElementwährung2 Die API bietet Methoden zum Ausführen von Vorgängen für Devisenfelder (FX) (auch als Währung2 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 FX-Währungsfelds ab.
* Rufen Sie 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.
{#GlideElementCurrency2ScopedAPI__ul_dvb_b14_yjb}

Die GlideElementwährung2 Klasse hat keinen Konstruktor.

## GlideElementwährungs2 -- getAsEnteredDisplayValue() {#ariaid-title2}

Gibt eine vom Anwender eingegebene Anzeigezeichenfolge des FX-Währungsfelds aus dem zugehörigen GlideRecord zurück.
Weitere Informationen zu FX-Währungsfeldern finden Sie unter [Einrichten und Betrieb von FX-Währungsfeldern](https://www.servicenow.com/docs/access?context=fx-currency&version=yokohama&pubname=yokohama-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 | Zeigt die vom Anwender eingegebene Währungszeichenfolge an. |
[Tabelle : 2. Rückgaben]

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

Weitere Informationen zur FX-Währung und der Konfigurationstabelle finden Sie unter [Konfigurieren Sie globale Einstellungen für FX-Währungen](https://www.servicenow.com/docs/access?context=fx-currency-configure&version=yokohama&pubname=yokohama-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. Rückgaben]

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

Gibt den Referenzwährungswert eines FX-Währungsfelds 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 dem folgenden:

* Wenn ein Instanzdatensatz vorhanden ist, verwendet die Methode den Wert im Feld reference_currency der Tabelle FX Currency \[fx_currency cy2_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.
  {#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 [Einrichten und Betrieb von FX-Währungsfeldern](https://www.servicenow.com/docs/access?context=fx-currency&version=yokohama&pubname=yokohama-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 zugehörigen Anzeigewert der FX-Währung. |
[Tabelle : 6. Rückgaben]

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

Gibt den Sitzungswährungswert des zugehörigen 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 und auf dem Gebietsschema des aktuellen Anwenders basiert. |
[Tabelle : 8. Rückgaben]

{#Scoped-GEC-getSesDispVal__table_pzy_rld_fy}  
In diesem Beispiel wird davon ausgegangen, dass das Sitzungsgebietsschema „Sprachcode = eng" und „Ländercode = USA" ist, und der in der Tabelle „fx-Währungskonfiguration" \[fx_Configuration\] angegebene Standardkonvertierungskurs 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

## GlideElementwährungs2 -- setDisplayValue(Zeichenfolge 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 [Einrichten und Betrieb von FX-Währungsfeldern](https://www.servicenow.com/docs/access?context=fx-currency&version=yokohama&pubname=yokohama-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 Anwenders. Beispiel: Wenn das Gebietsschema des Anwenders USA/eng ist, wird übergeben `<currency amount> `Wäre 123.45. Wenn der lokale Wert des Anwenders FRA/fre ist, wird der ü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 |
|-|-|
| Ungültig |   |
[Tabelle : 10. Rückgaben]

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


