---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElementCurrency2 : inclus dans le champ d'application

# GlideElementCurrency2 : inclus dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

L'API GlideElementCurrency2 fournit des méthodes permettant d'effectuer des opérations sur les champs de devise de change (FX) (également appelés Currency2) dans le GlideRecord actuel.  
Cette API fournit des méthodes qui vous permettent d'effectuer les opérations suivantes :

* Obtenez la chaîne d'affichage du champ Devise FX, telle que saisie par l'utilisateur.
* Obtenir la valeur d'affichage d'un champ Devise FX.
* Obtenir la valeur de devise de référence d'un champ Devise FX.
* Obtenir la valeur de devise de session d'un champ Devise FX.
* Définissez la valeur d'affichage d'un champ Devise FX.
{#GlideElementCurrency2ScopedAPI__ul_dvb_b14_yjb}

La classe GlideElementCurrency2 n'a pas de constructeur.

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

Renvoie une chaîne d'affichage du champ Devise FX, telle qu'entrée par l'utilisateur, à partir du GlideRecord associé.
Pour plus d'informations sur les champs de devises FX, voir [Configuration et exploitation des champs de devises FX](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}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Affichez la chaîne de devise telle qu'entrée par l'utilisateur. |
[Tableau 2. Renvoie]

{#Scoped-GEC-getAsEntDispVal__table_upv_5kd_fy}  
Cet exemple montre comment appeler la méthode.

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

Sortie :

    As entered display value: ¥999,999.12

## GlideElementCurrency2 : getDisplayValue() {#ariaid-title3}

Renvoie la valeur d'affichage d'un champ Devise FX dans le GlideRecord associé.
Selon la façon dont la display_value est définie dans la table Configuration de la devise FX \[fx_configuration\], la valeur renvoyée peut être la suivante :

* Valeur de devise saisie par l'utilisateur
* Valeur de devise convertie en devise de la session (en fonction des paramètres régionaux de l'utilisateur)
* Valeur de devise convertie en devise de référence
{#Scoped-GEC-getDisplayVal__ul_c3x_vhj_qjb}

Pour plus d'informations sur la devise FX et le tableau de configuration, consultez [Configurer les paramètres globaux de devise FX](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}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Afficher la valeur de devise |
[Tableau 4. Renvoie]

{#Scoped-GEC-getDisplayVal__table_rxq_k5c_fy}  
Cet exemple montre comment appeler la méthode.

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

Sortie :

    Display Value: ¥999,999.12

## GlideElementCurrency2 : getReferenceDisplayValue() {#ariaid-title4}

Renvoie la valeur de devise de référence d'un champ de devise FX dans le GlideRecord associé.
La devise de référence est la devise commune dans laquelle toutes les valeurs de devise d'un champ sont converties. Le code de devise que la méthode getReferenceDisplayValue() utilise pour dériver la devise de référence est basé sur les éléments suivants :

* Si un enregistrement d'instance existe, la méthode utilise la valeur du champ reference_currency de la table Devise FX \[fx_currency2_instance\].
* Si aucun enregistrement d'instance n'existe, la méthode utilise la devise de référence qui sera définie sur l'enregistrement d'instance lors de la création de l'enregistrement d'instance (dans l'ordre suivant) :
  * Si défini, le reference_currency dans la table Configuration de la devise FX \[fx_configuration\].
  * Si défini, le reference_currency_source dans la table Configuration de la devise FX \[fx_configuration\].
  * Système par défaut, devise de référence système.
  {#Scoped-GEC-getRefDispVal__ul_sb1_2tx_sjb}
{#Scoped-GEC-getRefDispVal__ul_l5z_x3j_qjb}

Pour plus d'informations sur les valeurs de la table Configuration des devises FX \[fx_configuration\], consultez [Configuration et exploitation des champs Devises FX](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}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Montant de la devise de référence pour la valeur d'affichage de la devise FX associée. |
[Tableau 6. Renvoie]

{#Scoped-GEC-getRefDispVal__table_zwn_hmd_fy}  
Cet exemple suppose que le code de devise de référence est USD et utilise le taux de conversion par défaut spécifié dans la table Configuration de la devise FX \[fx_configuration\]. La sortie changera en fonction des paramètres régionaux.

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

Sortie :

    Reference display value: $8,677.99

## GlideElementCurrency2 : getSessionDisplayValue() {#ariaid-title5}

Renvoie la valeur de devise de la session du champ Devise FX associé dans le GlideRecord actuel.
{#Scoped-GEC-getSesDispVal__table_ozy_rld_fy__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Valeur de devise convertie en devise de session, qui est basée sur les paramètres régionaux de l'utilisateur actuel. |
[Tableau 8. Renvoie]

{#Scoped-GEC-getSesDispVal__table_pzy_rld_fy}  
Cet exemple suppose que les paramètres régionaux de la session sont code de langue = eng et code de pays = États-Unis, et utilisent le taux de conversion par défaut spécifié dans la table Configuration de la devise FX \[fx_configuration\]. La sortie changera en fonction des paramètres régionaux.

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

Sortie :

    Session display value: $8,677.99

## GlideElementCurrency2 : setDisplayValue (chaîne displayValue) {#ariaid-title6}

Définit la valeur d'affichage d'un champ Devise FX avec la valeur de devise spécifiée.
Pour plus d'informations sur les champs de devises FX, voir [Configuration et exploitation des champs de devises FX](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}

| Nom | Type | Description |
|-|-|-|
| displayValue | Chaîne | Valeur à définir dans le champ Devise FX au format `<code de devise> ; <montant de la devise>`. Vous devez formater le champ `< montant en devise >` dans les paramètres régionaux de l'utilisateur. Par exemple, si les paramètres régionaux de l'utilisateur sont USA/eng, le `montant de la <currency>` transmis sera 123,45. Si le local de l'utilisateur est FRA/fre, le montant de `la <currency>` transmis est 123,45. |
[Tableau 9. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 10. Renvoie]

{#Scoped-GEC-setDisplayVal_S__table_fnw_5jd_fy}  
Cet exemple montre comment appeler la méthode.

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