GlideElementCurrency2 : inclus dans le champ d’application

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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.

    La classe GlideElementCurrency2 n’a pas de constructeur.

    GlideElementCurrency2 : getAsEnteredDisplayValue()

    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.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. Renvoie
    Type Description
    Chaîne Affichez la chaîne de devise telle qu’entrée 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 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

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

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    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 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.

    Pour plus d’informations sur les valeurs de la table Configuration des devises FX [fx_configuration], consultez Configuration et exploitation des champs Devises 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 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 la 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 en devise de 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 = É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)

    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.

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