Valeurs de devise par défaut dans les scripts
Vous pouvez utiliser des champs de devise dans les scripts.
Ces méthodes sont disponibles sur les objets GlideElement.
Pour afficher les valeurs monétaires, utilisez l’API d’affichage getDisplayValue(). Pour utiliser les valeurs monétaires autrement qu’à l’affichage, utilisez les API qui renvoient/acceptent les nombres non formatés.
Remarque :
Avant d’effectuer des calculs sur la valeur, n’utilisez pas les méthodes getDisplayValue(), puis traitez la chaîne pour supprimer les informations de formatage.
Des méthodes telles que getValue() et getCurrencyValue() renvoient des nombres non formatés sous forme de chaînes. Pour obtenir la valeur à virgule flottante, utilisez la fonction JavaScript parseFloat(), puis utilisez la valeur résultante pour effectuer des calculs. Pour obtenir la devise associée à ces valeurs, utilisez les API qui renvoient le code de devise. Vous pouvez également utiliser les méthodes getCurrencyCode() pour déterminer la devise d’un champ.
var rate = parseFloat(current.base_rate);
var currencyCode = current.base_rate.getCurrencyCode();
Utilisez la méthode setValue() pour définir la valeur d’un champ de devise. Si cette devise est la devise de session de l’utilisateur, utilisez un nombre brut ou le nombre à virgule flottante d’une chaîne qui la contient. Sinon, ajoutez le code de devise ISO à 3 lettres à la valeur.
var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);
Vous travaillez avec la valeur de devise de référence lorsque vous utilisez GlideAggregate sur des champs de devise ou de prix. Assurez-vous de convertir les valeurs agrégées en devise de la session de l’utilisateur pour l’affichage. La valeur résultante peut ne pas correspondre à vos attentes. Le taux de conversion utilisé pour la devise ou la valeur de champ de prix et pour sa devise de référence, utilisée pour l’agrégation, peut avoir changé.
Lorsque vous supprimez un enregistrement contenant une valeur de devise, la plateforme supprime tous les enregistrements de devise associés.
Remarque :
N’utilisez pas deleteMultiple() sur les tables avec des champs de devise. Supprimez toujours chaque enregistrement individuellement.
Les valeurs monétaires contiennent quatre décimales.
- Les API qui renvoient des valeurs telles que getValue() renvoient jusqu’à quatre décimales. Les zéros de fin sont toujours supprimés.
- Les API qui renvoient des valeurs d’affichage telles que getDisplayValue() ont au moins deux décimales et jusqu’à quatre décimales.
- GlideAggregate renvoie quatre décimales.
Vous pouvez faire en sorte que le système utilise deux décimales. Lorsque vous le définissez sur deux décimales, les valeurs numériques renvoyées par l’API contiennent deux décimales. Bien que les taux de conversion de devise puissent comporter plus de décimales, les champs de devise ne stockent que deux décimales. API qui acceptent les décimales arrondies de valeurs numériques à deux positions.
- Les API qui renvoient des valeurs telles que getValue() renvoient jusqu’à deux décimales. Les zéros de fin sont supprimés pour les valeurs lues à partir de la base de données, mais si une valeur telle que 00 est définie ultérieurement, 1,00 peut être renvoyé. Le nombre de zéros à la fin renvoyés n’est pas cohérent.
- Les API qui renvoient des valeurs d’affichage telles que getDisplayValue() contiennent jusqu’à deux décimales. Il peut parfois renvoyer deux places même pour des valeurs telles que 7,10, mais peut supprimer les zéros de fin à d’autres moments. Le nombre de zéros à la fin renvoyés n’est pas cohérent.
- GlideAggregate renvoie deux décimales.
Remarque :
Pour savoir comment modifier le nombre de décimales utilisées par le système, reportez-vous à la section Changer le nombre de décimales de la devise par défaut.
Dans l’exemple suivant, les paramètres régionaux de l’utilisateur sont définis sur Allemand (de.DE) et la devise de référence sur USD. Les valeurs utilisent une valeur monétaire de 21345,67 en yens japonais, 1563,72 en euros et 1152,48 en dollars américains.
| Nom de méthode | Description | Exemple |
|---|---|---|
| getValue() | Renvoie la valeur de devise dans la devise de la session de l’utilisateur sous forme de nombre non formaté. | 1563.72 |
| getReferenceValue() | Renvoie la valeur de la devise dans la devise de référence sous forme de nombre non formaté. | 1152.48 |
| getSessionValue() | Renvoie la valeur de devise dans la devise de la session de l’utilisateur sous forme de nombre non formaté. | 1563.72 |
| getCurrencyValue() | Renvoie la valeur de devise saisie sous forme de nombre non formaté. | 21345.67 |
| getDisplayValue() | Renvoie la valeur de devise dans la devise de la session de l’utilisateur, formatée dans les paramètres régionaux de l’utilisateur avec un symbole de devise. | €1.563,72 |
| getSessionDisplayValue() | Renvoie la valeur de devise dans la devise de la session de l’utilisateur, formatée dans les paramètres régionaux de l’utilisateur avec un symbole de devise. | €1.563,72 |
| getReferenceDisplayValue() | Renvoie la valeur de la devise dans la devise de référence, formatée dans les paramètres régionaux de l’utilisateur avec un symbole de devise. | 1 152,48 $ |
| getCurrencyDisplayValue() | Renvoie la valeur de la devise telle qu’elle a été saisie, formatée dans les paramètres régionaux de l’utilisateur avec un symbole de devise. | ¥21.345,67 |
| getCurrencyString() | Renvoie la valeur de devise saisie sous forme de nombre non formaté, préfixé par le code de devise ISO à 3 lettres, séparée par un point-virgule. | JPY 21345.67 |
| getCurrencyCode() | Renvoie le code de devise ISO à 3 lettres pour la valeur de devise saisie. | JPY |
| getSessionCurrencyCode() | Renvoie le code de devise ISO à 3 lettres pour la devise de la session de l’utilisateur. | EUR |
| getReferenceCurrencyCode() | Renvoie le code de devise ISO à 3 lettres pour la devise de référence. | USD |
| setValue() | Définit la valeur de devise comme suit :
|
4369.21 ou 4369.21 JPY |
| setDisplayValue() | Définit la valeur de devise comme suit :
|
4369.21 ou 4369.21 JPY |