GlideElementCurrency2 : dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

    • L’API GlideElementCurrency2 fournit des méthodes permettant d’effectuer des opérations sur les champs 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.
    • Obtenez la valeur d’affichage d’un champ Devise FX.
    • Obtenir 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 fonctionnement des champs Devise FX.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. Renvoie
    Type Description
    Chaîne Affiche 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 la display_value est définie dans la table Configuration de devise FX [fx_configuration], la valeur renvoyée peut être la suivante :
    • Valeur de devise saisie par l’utilisateur
    • Valeur de devise convertie dans la devise de la session (en fonction des paramètres régionaux de l’utilisateur)
    • Valeur de 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
    Aucun
    Tableau 4. Renvoie
    Type Description
    Chaîne Afficher la valeur de la 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 de 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 que la méthode getReferenceDisplayValue() utilise 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 éventuelle de l’enregistrement d’instance (dans l’ordre suivant) :
      • Si défini, le reference_currency dans la table Configuration de devise FX [fx_configuration].
      • Si défini, le reference_currency_source dans la table Configuration de 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 Paramétrage et exploitation des champs Devise FX.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Chaîne Montant de la 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 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
    Aucun
    Tableau 8. Renvoie
    Type Description
    Chaîne Valeur de 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 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(String displayValue)

    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 fonctionnement 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 USA/eng, 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();