Valeurs de devise par défaut dans les scripts
Vous pouvez utiliser des champs de devises 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 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, préfixez la valeur avec le code de devise ISO à 3 lettres.
var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);
Vous travaillez avec la valeur de la devise de référence lorsque vous utilisez GlideAggregate dans des champs de devise ou de prix. Assurez-vous de convertir les valeurs d’agrégat en 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 de champ de prix, ainsi que 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 devises 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 monétaires ne stockent que deux décimales. API qui acceptent les valeurs numériques, les décimales arrondies à 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 à gauche 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 à gauche 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 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 est définie sur USD. Les valeurs utilisent une valeur monétaire de 21345,67 en yen japonais, 1563,72 en euros et 1152,48 en dollars américains.
| Nom de méthode | Description | Exemple |
|---|---|---|
| getValue() | Renvoie la valeur de la devise de la session de l’utilisateur sous forme de nombre non formaté. | 1563.72 |
| getReferenceValue() | Renvoie la valeur de la devise de référence sous forme de nombre non formaté. | 1152.48 |
| getSessionValue() | Renvoie la valeur de la devise de la session de l’utilisateur sous forme de nombre non formaté. | 1563.72 |
| getCurrencyValue() | Renvoie la valeur de devise saisie sous la forme d’un nombre non formaté. | 21345.67 |
| getDisplayValue() | Renvoie la valeur de 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 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 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 la devise saisie sous la forme d’un nombre non formaté, précédé du code de devise ISO à 3 lettres, séparé 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 JPY 4369.21 |
| setDisplayValue() | Définit la valeur de devise comme suit :
|
4369.21 ou JPY 4369.21 |