Standardwährungswerte in Skripts
Sie können Währungsfelder in Skripts verwenden.
Diese Methoden sind für GlideElement-Objekte verfügbar.
Verwenden Sie zum Anzeigen von Währungswerten GetDisplayValue() Anzeige-API. Um mit Währungswerten zu arbeiten, die nicht angezeigt werden, verwenden Sie die APIs, die unformatierte Zahlen zurückgeben/akzeptieren.
Hinweis:
Verwenden Sie nicht, bevor Sie Berechnungen für den Wert durchführen GetDisplayValue() Methoden und verarbeiten Sie dann die Zeichenfolge, um Formatierungsinformationen zu entfernen.
Methoden wie GetValue() Und GetCurrency-Wert() Unformatierte Zahlen als Zeichenfolgen zurückgeben. Um den Gleitkommawert zu erhalten, verwenden Sie die JavaScript-Funktion ParseFloat() , Und verwenden Sie dann den resultierenden Wert, um Berechnungen durchzuführen. Um die diesen Werten zugeordnete Währung zu erhalten, verwenden Sie die APIs, die den Währungscode zurückgeben. Sie können auch verwenden GetCurrency-Code() Methoden zum Bestimmen der Währung eines Felds.
var rate = parseFloat(current.base_rate);
var currencyCode = current.base_rate.getCurrencyCode();
Verwenden Sie SetValue() Methode zum Festlegen des Werts eines Währungsfelds. Wenn diese Währung die Sitzungswährung des Anwenders ist, verwenden Sie eine einfache Zahl oder die Gleitkommazahl einer Zeichenfolge, die sie enthält. Andernfalls setzen Sie dem Wert den 3-Buchstaben-ISO-Währungscode voran.
var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);
Sie arbeiten mit dem Referenzwährungswert, wenn Sie GlideAggregate für Währungs- oder Preisfelder verwenden. Stellen Sie sicher, dass Sie die Zusammenfassungswerte für die Anzeige in die Sitzungswährung des Benutzers konvertieren. Der resultierende Wert ist möglicherweise nicht das, was Sie erwarten. Der für die Währung oder den Preisfeldwert und seine Referenzwährung, die für die Zusammenfassung verwendet wird, verwendete Wechselkurs hat sich möglicherweise geändert.
Wenn Sie einen Datensatz löschen, der einen Währungswert enthält, löscht die Plattform alle zugehörigen Währungsdatensätze.
Hinweis:
Verwenden Sie nicht deleteMultiple() für Tabellen mit Währungsfeldern. Löschen Sie jeden Datensatz einzeln.
Währungswerte enthalten vier Dezimalstellen.
- APIs, die Werte wie zurückgeben GetValue() Gibt bis zu vier Dezimalstellen zurück. Nachfolgende Nullen werden immer entfernt.
- APIs, die Anzeigewerte wie zurückgeben GetDisplayValue() Haben mindestens zwei Dezimalstellen und bis zu vier Dezimalstellen.
- GlideAggregate gibt vier Dezimalstellen zurück.
Das System kann zwei Dezimalstellen verwenden. Wenn Sie sie auf zwei Dezimalstellen festlegen, enthalten numerische Werte, die von der API zurückgegeben werden, zwei Dezimalstellen. Obwohl Währungsumrechnungskurse mehr Dezimalstellen haben können, speichern Währungsfelder nur zwei Dezimalstellen. APIs, die numerische Werte akzeptieren, runden Dezimalstellen auf zwei Stellen auf.
- APIs, die Werte wie zurückgeben GetValue() Gibt bis zu zwei Dezimalstellen zurück. Die nachgestellten Nullen werden für Werte entfernt, die aus der Datenbank gelesen werden. Wenn jedoch später ein Wert wie 00 festgelegt wird, kann 1,00 zurückgegeben werden. Die Anzahl der zurückgegebenen nachgestellten Nullen ist nicht konsistent.
- APIs, die Anzeigewerte wie getDisplayValue() zurückgeben, enthalten bis zu zwei Dezimalstellen. Manchmal können zwei Stellen zurückgegeben werden, auch für Werte wie 7,10, nachfolgende Nullen können jedoch zu anderen Zeiten entfernt werden. Die Anzahl der zurückgegebenen nachgestellten Nullen ist nicht konsistent.
- GlideAggregate gibt zwei Dezimalstellen zurück.
Hinweis:
Informationen zum Ändern der Anzahl der vom System verwendeten Dezimalstellen finden Sie unter Ändern Sie die Dezimalstellen der Standardwährung.
Im folgenden Beispiel ist das Gebietsschema des Anwenders auf Deutsch (de.DE) und die Referenzwährung auf USD festgelegt. Die Werte verwenden einen Währungswert von 21345,67 in japanischen Yen, 1563,72 in Euro und 1152,48 in US-Dollar.
| Methodenname | Beschreibung | Beispiel |
|---|---|---|
| GetValue() | Gibt den Währungswert in der Sitzungswährung des Anwenders als unformatierte Zahl zurück. | 1563.72 |
| GetReferenceValue() | Gibt den Währungswert in der Referenzwährung als unformatierte Zahl zurück. | 1152.48 |
| GetSessionValue() | Gibt den Währungswert in der Sitzungswährung des Anwenders als und unformatierte Zahl zurück. | 1563,72 |
| GetCurrency-Wert() | Gibt den eingegebenen Währungswert als unformatierte Zahl zurück. | 21345.67 |
| GetDisplayValue() | Gibt den Währungswert in der Sitzungswährung des Anwenders zurück, formatiert im Gebietsschema des Anwenders mit einem Währungssymbol. | 1.563,72 € |
| GetSessionDisplayValue() | Gibt den Währungswert in der Sitzungswährung des Anwenders zurück, formatiert im Gebietsschema des Anwenders mit einem Währungssymbol. | 1.563,72 € |
| GetReferenceDisplayValue() | Gibt den Währungswert in der Referenzwährung zurück, formatiert im Gebietsschema des Anwenders mit einem Währungssymbol. | 1.152,48 USD |
| GetCurrency cyDisplayValue() | Gibt den Währungswert wie eingegeben formatiert im Gebietsschema des Anwenders mit einem Währungssymbol zurück. | ¥ 21.345,67 |
| GetCurrency-Zeichenfolge() | Gibt den eingegebenen Währungswert als unformatierte Zahl zurück, dem der dreistellige ISO-Währungscode vorangestellt ist, getrennt durch ein Semikolon. | 21345,67 JPY |
| GetCurrency-Code() | Gibt den 3-Buchstaben-ISO-Währungscode für den eingegebenen Währungswert zurück. | JPY |
| GetSessionCurrency Code() | Gibt den 3-Buchstaben-ISO-Währungscode für die Sitzungswährung des Anwenders zurück. | EUR |
| GetReferenceCurrency Code() | Gibt den 3-Buchstaben-ISO-Währungscode für die Referenzwährung zurück. | USD |
| setValue() | Legt den Währungswert wie folgt fest:
|
4369,21 oder JPY 4369,21 |
| SetDisplayValue() | Legt den Währungswert wie folgt fest:
|
4369,21 oder JPY 4369,21 |