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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 celles que vous saisissez directement dans les champs Devise FX. Pour les rapports, les agrégations de 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 Afficher les chiffres 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 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 caractères (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 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. Les devises de référence ne sont pas prises en compte 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 Dollars américains (USD), la valeur de devise de référence peut apparaître dans une liste non filtrée.
    • Toutefois, 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 Devise 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 du champ Devise FX, reportez-vous à 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. 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 des devises FX

    Vous pouvez sélectionner les champs Devise FX à inclure dans les rapports. 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 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 de devise FX agrégé dans le Now Platform®:

    Tableau 1. Valeur de la devise FX de l’agrégat
    Type Description
    Chaîne Valeur de l’agrégation. Si les valeurs regroupées sont des valeurs de 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,980 000.
    Remarque :
    Si le champ contient des valeurs de devise 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 une opération Grouper par cost.amount ou cost.currency.
    • Les opérations d’agrégation, telles que SUM, sont traduites 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 associée à toutes les valeurs de devise du groupement.

    • Si différentes devises sont associées à des valeurs de devise dans le regroupement, la valeur agrégée est vide. Par exemple, si certaines des valeurs de devise sont exprimées en dollars américains, d’autres en euros et d’autres en yen, la valeur d’agrégat est 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 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().