Standardwährungswerte in Skripts
Sie können Währungsfelder in Skripts verwenden.
Diese Methoden sind für GlideElement-Objekte verfügbar.
Um Währungswerte anzuzeigen, verwenden Sie die Anzeige-API getDisplayValue(). Um mit Währungswerten auf andere Weise als zur Anzeige zu arbeiten, verwenden Sie die APIs, die unformatierte Zahlen zurückgeben/akzeptieren.
Hinweis:
Bevor Sie Berechnungen für den Wert durchführen, verwenden Sie nicht die getDisplayValue()- Methoden und verarbeiten dann die Zeichenfolge, um Formatierungsinformationen zu entfernen.
Methoden wie getValue() und getCurrencyValue() geben unformatierte Zahlen als Zeichenfolgen zurück. Um den Gleitkommawert zu erhalten, verwenden Sie die JavaScript-Funktion parseFloat()und verwenden dann den resultierenden Wert, um Berechnungen durchzuführen. Um die Währung zu erhalten, die diesen Werten zugeordnet ist, verwenden Sie die APIs, die den Währungscode zurückgeben. Sie können auch die getCurrencyCode()- Methoden verwenden, um die Währung eines Felds zu bestimmen.
var rate = parseFloat(current.base_rate);
var currencyCode = current.base_rate.getCurrencyCode();
Verwenden Sie die Methode setValue(), um den Wert eines Währungsfelds festzulegen. 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 stellen Sie dem Wert den dreistelligen ISO-Währungscode voran.
var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);
Sie arbeiten mit dem Bezugswä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 entspricht möglicherweise nicht dem erwarteten Wert. Der für den Währungs- oder Preisfeldwert und für die 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 getValue() zurückgeben, geben bis zu vier Dezimalstellen zurück. Nachfolgende Nullen werden immer entfernt.
- APIs, die Anzeigewerte zurückgeben, wie z. B. getDisplayValue(), haben mindestens zwei Dezimalstellen und bis zu vier Dezimalstellen.
- GlideAggregate gibt vier Dezimalstellen zurück.
Sie können festlegen, dass das System zwei Dezimalstellen verwendet. Wenn Sie ihn auf zwei Dezimalstellen festlegen, enthalten die von der API zurückgegebenen numerischen Werte 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.
- APIs, die Werte wie getValue() zurückgeben, geben bis zu zwei Dezimalstellen zurück. Die nachfolgenden Nullen werden für aus der Datenbank gelesene Werte entfernt, wenn jedoch ein Wert wie 00 später festgelegt wird, kann 1,00 zurückgegeben werden. Die Anzahl der zurückgegebenen nachfolgenden Nullen ist nicht konsistent.
- APIs, die Anzeigewerte wie getDisplayValue() zurückgeben, enthalten bis zu zwei Dezimalstellen. Manchmal konnten auch für Werte wie 7,10 zwei Stellen zurückgegeben werden, nachgestellte Nullen konnten jedoch zu anderen Zeiten entfernt werden. Die Anzahl der zurückgegebenen nachfolgenden 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 Benutzers auf Deutsch (de.DE) und die Referenzwährung auf USD festgelegt. Die Werte verwenden einen Währungswert von 21345,67 in Yen, 1563,72 in Euro und 1152,48 in US-Dollar.
| Methodenname | Beschreibung | Beispiel |
|---|---|---|
| abrufenWert() | Gibt den Währungswert in der Sitzungswährung des Anwenders als unformatierte Zahl zurück. | 1563.72 |
| abrufenReferenzwert() | Gibt den Währungswert in der Referenzwährung als unformatierte Zahl zurück. | 1152.48 |
| abrufenSessionValue () | Gibt den Währungswert in der Sitzungswährung des Anwenders als und unformatierte Zahl zurück. | 1563,72 |
| abrufenCurrencyValue() | Gibt den eingegebenen Währungswert als unformatierte Zahl zurück. | 21345.67 |
| abrufenAnzeigewert() | Gibt den Währungswert in der Sitzungswährung des Anwenders zurück, formatiert im Gebietsschema des Anwenders, mit einem Währungssymbol. | 1.563,72 $ |
| abrufenSitzungAnzeigewert() | Gibt den Währungswert in der Sitzungswährung des Anwenders zurück, formatiert im Gebietsschema des Anwenders, mit einem Währungssymbol. | 1.563,72 $ |
| abrufenReferenzAnzeigewert() | Gibt den Währungswert in der Referenzwährung zurück, formatiert im Gebietsschema des Anwenders, mit einem Währungssymbol. | 1.152,48 $ |
| abrufenCurrencyDisplayValue () | Gibt den Währungswert zurück, wie im Gebietsschema des Anwenders formatiert mit einem Währungssymbol eingegeben. | 21,345,67 Yen |
| abrufenCurrencyString() | Gibt den eingegebenen Währungswert als unformatierte Zahl mit vorangestelltem 3-stelligem ISO-Währungscode und durch ein Semikolon getrennt zurück. | JPY 21345,67 |
| abrufenWährungscode () | Gibt den 3-buchstabigen ISO-Währungscode für den eingegebenen Währungswert zurück. | JPY |
| abrufenSessionCurrencyCode() | Gibt den dreistelligen ISO-Währungscode für die Sitzungswährung des Anwenders zurück. | EUR |
| abrufenReferenzwährungscode () | Gibt den dreistelligen ISO-Währungscode für die Referenzwährung zurück. | USD |
| setValue() | Legt den Währungswert fest als:
|
4369,21 oder JPY 4369,21 |
| festlegenAnzeigewert() | Legt den Währungswert fest als:
|
4369,21 oder JPY 4369,21 |