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 des valeurs monétaires d’une autre manière que 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 la session de l’utilisateur, utilisez un nombre brut ou le nombre à virgule flottante d’une chaîne qui la contient. Sinon, ajoutez à la valeur le code de devise ISO à 3 lettres.
var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);
Vous utilisez 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 dans la devise de la session de l’utilisateur pour l’affichage. La valeur résultante peut ne pas être celle à laquelle vous vous attendez. Le taux de conversion utilisé pour la devise ou la valeur du champ de prix, et pour sa devise de référence, qui est utilisée pour l’agrégation, peut avoir changé.
Lorsque vous supprimez un enregistrement contenant une valeur monétaire, 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 demander au système d’utiliser deux décimales. Lorsque vous la 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 devises puissent comporter plus de décimales, les champs de devise ne stockent que deux décimales. API qui acceptent les valeurs numériques, arrondissent les décimales à deux places.
- 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ée. Le nombre de zéros à droite 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 positions même pour des valeurs telles que 7,10, mais peut supprimer les zéros à d’autres moments. Le nombre de zéros à droite 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 les décimales de la devise par défaut.
Dans l’exemple suivant, les paramètres régionaux de l’utilisateur sont définis sur l’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 la devise dans la devise de la session de l’utilisateur sous forme de nombre non formaté. | 1563.72 |
| getCurrencyValue() | Renvoie la valeur de devise telle que saisie sous forme de nombre non formaté. | 21345.67 |
| getDisplayValue() | Renvoie la valeur de la 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 la 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 devise telle que 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écédé du code de devise ISO à 3 lettres et séparé par un point-virgule. | JPY 21345,67 |
| getCurrencyCode() | Renvoie le code de devise ISO à 3 lettres pour la valeur de devise telle que 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 la devise comme suit :
|
4369.21 ou JPY 4369.21 |
| setDisplayValue() | Définit la valeur de la devise comme suit :
|
4369.21 ou JPY 4369.21 |