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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 s’affichent 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 la sys_id est de 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 de celui des champs de devises 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. Par conséquent, 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 de devise 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 de devise saisies à l’origine en USD s’affichent.

    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 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 marquage d’un champ Devise FX comme étant 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 groupage des devises FX par

    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 Devise FX apparaissent 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 à afficher dans 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 agrégé des données sur les devises FX dans le Now Platform®:

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

    USD :134.980000

    Dans le cas contraire, 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 agrégé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 effectuer un regroupement par cost.amount ou cost.currency.
    • Les opérations d’agrégation, telles que SUM, se traduisent par SUM(amount) ou SUM(reference_amount). La source d’agrégation détermine la conversion 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 caractères de format USD ; 1234.56. La valeur totale de la devise est exprimée dans la devise de référence unique qui est associée à toutes les valeurs de devise 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 exprimées 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 par montant, ou par reference_currency et reference_amount, selon les exigences de 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().