Comprendre les valeurs de devises FX dans les listes et les rapports

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

    • Par défaut, les valeurs de devise qui apparaissent dans les champs Devise FX des listes et des rapports sont les valeurs que vous saisissez directement dans les champs Devise FX. Pour les rapports, les agrégations des champs Devise FX sont, par défaut, des valeurs de devise de référence.

    Valeurs de devises FX dans les vues de listes

    Dans les listes, les valeurs Devise FX apparaissent sous la forme d’une chaîne de devise formatée renvoyée par getDisplayValue().
    • Les paramètres des champs Afficher les chiffres et Afficher la valeur de devise dans Localisation de système > Configuration de la devise FX Déterminez comment les valeurs de devise apparaissent dans les listes.
    • Pour en savoir plus, consultez Identifier le champ Devise FX et ses paramètres d’affichage.
    Pour un champ Devise FX qui dépend d’un autre champ Devise FX, la valeur de devise provient de l’enregistrement Instance de devise [fx_currency2_instance] associé à ce dernier. Le format de la valeur d’affichage dépend de la façon dont vous avez configuré ses paramètres d’affichage dans Localisation de système > Configuration de la devise FX.
    Remarque :
    Un champ Devise FX dans une table personnalisée est un champ de référence qui stocke la référence (sys_id) à l’enregistrement réel. Étant donné que le sys_id comporte 32 caractères, la longueur maximale de la colonne Devise FX doit être de 32 (par défaut).

    Filtrage des valeurs de devises FX dans les listes

    Dans les listes, le filtrage des champs Devise FX se comporte différemment des champs Devise standard. Le filtrage s’effectue à l’aide du type de devise sélectionné lors de la saisie initiale d’une valeur de devise dans un champ Devise FX. Il ne prend pas en compte les devises de référence lorsque vous filtrez une liste. Ainsi, si la liste non filtrée contient des entrées de champ Devise FX dans plusieurs devises, une liste filtrée ne contiendra que les enregistrements saisis à l’origine à l’aide de la devise de filtrage spécifiée.
    • Par exemple, si vous avez saisi une valeur monétaire en euros (EUR) et que la devise de référence est le dollar américain (USD), la valeur de la devise de référence peut apparaître dans une liste non filtrée.
    • Cependant, si vous filtrez la liste et sélectionnez USD comme devise, la valeur de la devise, saisie à l’origine en euros, n’apparaît pas. Dans ce cas, seules les valeurs monétaires saisies à l’origine en USD apparaîtraient.

    Champs de devises FX dépendantes

    L’utilisation de la vue Devise FX ou des champs dépendants vous permet d’utiliser d’autres configurations d’affichage définies dans Localisation de système > Configuration de la devise FX pour un champ de devise FX particulier. Pour en savoir plus sur les configurations des champs Devise FX, reportez-vous à la section Configuration du comportement du champ Devise FX.

    Lorsque vous créez un champ Devise FX, vous pouvez le marquer comme dépendant d’un autre champ Devise FX. Le fait de marquer un champ Devise FX comme dépendant lui permet d’utiliser les paramètres de configuration du champ Devise FX d’origine pour afficher les valeurs de montant dans une devise différente. Les modifications que vous apportez au champ dépendant n’affectent pas le champ Devise FX d’origine.

    Génération de rapports, agrégation et regroupement en devises FX

    Vous pouvez sélectionner des champs Devise FX pour les inclure dans les rapports, et ils s’affichent de la même manière que dans les vues de listes.
    • Les champs Devise FX s’affichent sous la forme d’une chaîne de devise formatée renvoyée par getDisplayValue().
    • Si vous définissez le champ Display Value Currency (Devise de la valeur d’affichage ) dans Localisation de système > Toutes les propriétés pour s’afficher dans la devise de la session, la devise de la session affectée à l’utilisateur qui exécute le rapport s’affiche.

    Vous pouvez agréger des valeurs de devise de référence similaires dans un enregistrement d’instance de devise. Voici le format de données agrégées sur devises FX dans le ServiceNow AI Platform®:

    Tableau 1. Regrouper la valeur de devise FX
    Type Description
    Chaîne Valeur de l’agrégation. Si les valeurs regroupées sont des valeurs en devise FX, la valeur renvoyée est au format currency_code :currency_value, par exemple :

    USD :134.980000

    Sinon, la valeur renvoyée est simplement la valeur de la devise, par exemple : 134.980000.
    Remarque :
    Si le champ contient des valeurs de devises FX de types de devises mixtes, les valeurs ne peuvent pas être agrégées. La valeur est renvoyée sous forme de point-virgule (;).
    Par exemple, si le champ Coût d’un enregistrement de transaction est un champ Devise FX, vous pouvez regrouper par cost.amount ou cost.currency.
    • Les opérations d’agrégation, telles que SUM, se traduisent par SUM(montant) ou SOMME(reference_amount). La source d’agrégation détermine la traduction lorsque la devise associée aux valeurs de devise dans le regroupement est la même.

      Par exemple, la valeur d’agrégat renvoyée par GlideAggregate.getAggregate() est une chaîne de format USD ; 1234.56. La valeur totale de la devise est exprimée dans la devise de référence unique associée à toutes les valeurs monétaires du regroupement.

    • Si différentes devises sont associées à des valeurs monétaires dans le regroupement, la valeur agrégée est vide. Par exemple, si certaines des valeurs monétaires sont en dollars américains, d’autres en euros et d’autres en yens, la valeur agrégée sera vide.
    Vous pouvez également utiliser une commande Grouper par sur les champs Devise FX.
    • Cela équivaut à un regroupement par devise et montant, ou par reference_currency et reference_amount, selon la source d’agrégation.
    • La valeur du regroupement est disponible en remontée pas à pas sur le champ Devise FX ou en utilisant une API telle que getDisplayValue().