GlideElementCurrency2 : inclus dans le champ d’application

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 :
    • Obtenir 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 inclus dans le champ d’application : getAsEnteredDisplayValue()

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

    Pour plus d’informations sur les champs Devise FX, reportez-vous à la section Configuration et exploitation des champs Devise FX.

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

    Exemple

    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 inclus dans le périmètre : getDisplayValue()

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

    En fonction de la façon dont le display_value est défini dans la table Configuration de devise FX [fx_configuration], la valeur renvoyée peut être :
    • Valeur de devise saisie par l’utilisateur
    • Valeur de devise convertie en devise de la session (basée sur les 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 la table 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

    Exemple

    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 inclus dans le champ d’application : 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 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 serait 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].
      • Devise système par défaut, devise de référence système.

    Pour plus d’informations sur les valeurs de la table Configuration de devise FX [fx_configuration], reportez-vous à la section Configuration 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 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 inclus dans le périmètre : 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 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 le code de langue = eng et le code de pays = USA, et utilisent 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 inclus dans le périmètre : 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, reportez-vous à la section Configuration 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 USA/eng, le montant transmis en <currency> sera 123,45. Si le local de l’utilisateur est FRA/fre, le montant transmis en <currency> sera 123,45.
    Tableau 10. Renvoie
    Type Description
    nul

    Exemple

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