GlideElementCurrency2 : délimité

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • L’API GlideElementCurrency2 fournit des méthodes pour effectuer des opérations sur les champs de devises de change (FX) (également connus sous le nom de 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.
    • Obtenez la valeur d’affichage d’un champ Devise FX.
    • Obtenez la valeur de devise de référence d’un champ de devise FX.
    • Obtenez la valeur de devise de session d’un champ de devise FX.
    • Définissez la valeur d’affichage d’un champ Devise FX.

    La classe GlideElementCurrency2 n’a pas de constructeur.

    GlideElementCurrency2 : getAsEnteredDisplayValue()

    Renvoie une chaîne d’affichage du champ Devise FX, telle que saisie par l’utilisateur, à partir du GlideRecord associé.

    Pour plus d’informations sur les champs Devise FX, voir Paramétrage et exploitation des champs Devise FX.

    Tableau 1. Paramètres
    Nom Type Description
    Néant
    Tableau 2. Renvoie
    Type Description
    Chaîne Affichez la chaîne de devise telle que saisie par l’utilisateur.

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

    Renvoie la valeur d’affichage d’un champ Devise FX dans le GlideRecord associé.

    Selon la façon dont le display_value est défini dans la table Configuration de la devise FX [fx_configuration], la valeur renvoyée peut être la suivante :
    • Valeur de la devise telle que saisie par l’utilisateur
    • Valeur de la devise convertie dans la devise de la session (en fonction des paramètres régionaux de l’utilisateur)
    • Valeur de la devise convertie dans la devise de référence

    Pour plus d’informations sur la devise FX et la table de configuration, voir Configurer les paramètres globaux de la devise FX.

    Tableau 3. Paramètres
    Nom Type Description
    Néant
    Tableau 4. Renvoie
    Type Description
    Chaîne Afficher la valeur de devise

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

    Renvoie la valeur de devise de référence d’un champ Devise FX dans le GlideRecord associé.

    La devise de référence est la devise commune dans laquelle toutes les valeurs monétaires d’un champ sont converties. Le code de devise utilisé par la méthode getReferenceDisplayValue() pour dériver la devise de référence est basé sur ce qui suit :
    • 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 activé, dans reference_currency la table Configuration de la devise FX [fx_configuration].
      • Si activé, dans reference_currency_source la table Configuration de la devise FX [fx_configuration].
      • Valeur par défaut du système, devise de référence du système.

    Pour plus d’informations sur les valeurs de la table Configuration de devise FX [fx_configuration], voir Configuration et exploitation des champs Devise FX.

    Tableau 5. Paramètres
    Nom Type Description
    Néant
    Tableau 6. Renvoie
    Type Description
    Chaîne Montant en devise de référence pour la valeur d’affichage de la devise FX associée.

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

    Renvoie la valeur de devise de session du champ Devise FX associé dans le GlideRecord actuel.

    Tableau 7. Paramètres
    Nom Type Description
    Néant
    Tableau 8. Renvoie
    Type Description
    Chaîne Valeur de la devise convertie dans la devise de la session, qui est basée sur les paramètres régionaux de l’utilisateur actuel.

    Cet exemple suppose que les paramètres régionaux de la session sont code de langue = eng et code de pays = USA, 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('Session display value: ' + setcur2.currency_2_field.getSessionDisplayValue());

    Sortie :

    Session display value: $8,677.99

    GlideElementCurrency2 : setDisplayValue (valeur d’affichage de la chaîne)

    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 Devise FX, voir Paramétrage et exploitation des champs Devise FX.

    Tableau 9. Paramètres
    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 États-Unis/Angleterre, le <montant en devise> transmis serait de 123,45. Si le local de l’utilisateur est FRA/fre, le <montant en devise> transmis serait de 123,45.
    Tableau 10. Renvoie
    Type Description
    nul

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