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

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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 de devise FX apparaissent sous la forme d’une chaîne de devise formatée renvoyée par getDisplayValue().
    • Les paramètres des champs Chiffres d’affichage et Devise de la valeur d’affichage 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 est basé sur 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 d’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 la 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 des 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é lorsqu’une valeur de devise est saisie à l’origine 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épendants

    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 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 afin d’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 de devises FX

    Vous pouvez sélectionner des champs Devise FX à inclure dans les rapports, et ils s’affichent de la même manière que dans les vues de listes.
    • Les champs FX Devise s’affichent sous la forme d’une chaîne de devise formatée renvoyée par getDisplayValue().
    • Si vous définissez le champ Devise de la valeur d’affichage dans Localisation de système > Toutes les propriétés pour afficher dans la devise de la session, la devise de la session affectée à l’utilisateur exécutant 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 de change 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 de devises FX, la valeur renvoyée est au format currency_code :currency_value, par exemple :

    USD :134.980000

    Sinon, la valeur renvoyée est uniquement 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 regroupées. La valeur est renvoyée sous la forme d’un 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 conversion lorsque la devise associée aux valeurs de devise du regroupement est la même.

      Par exemple, la valeur agrégée renvoyée par GlideAggregate.getAggregate() est une chaîne au 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 groupement.

    • 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 dans 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 à l’aide d’une API telle que getDisplayValue().