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 diesen Werten zugeordnete Währung zu erhalten, 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 setValue()- Methode, um den Wert eines Währungsfelds festzulegen. Wenn diese Währung die Sitzungswährung des Benutzers 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 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 entspricht möglicherweise nicht Ihren Erwartungen. Der Umrechnungskurs, der für den Währungs- oder Preisfeldwert und für seine Referenzwährung verwendet wird, die für die Zusammenfassung verwendet wird, 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. Nachgestellte Nullen werden immer entfernt.
- APIs, die Anzeigewerte wie getDisplayValue() zurückgeben, 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 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. Selbst für Werte wie 7,10 könnten manchmal zwei Stellen zurückgegeben werden, zu anderen Zeiten könnten jedoch nachgestellte Nullen 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 wird 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 Japanischer Yen, 1563,72 in Euro und 1152,48 in US-Dollar.
| Methodenname | Beschreibung | Beispiel |
|---|---|---|
| getValue () | Gibt den Währungswert in der Sitzungswährung des Benutzers 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 Benutzers als unformatierte Zahl zurück. | 1563,72 |
| getCurrencyValue() | Gibt den eingegebenen Währungswert als unformatierte Zahl zurück. | 21345,67 |
| getDisplayValue () | Gibt den Währungswert in der Sitzungswährung des Benutzers zurück, formatiert im Gebietsschema des Benutzers mit einem Währungssymbol. | 1.563,72 Euro |
| getSessionDisplayValue() | Gibt den Währungswert in der Sitzungswährung des Benutzers zurück, formatiert im Gebietsschema des Benutzers mit einem Währungssymbol. | 1.563,72 Euro |
| getReferenceDisplayValue() | Gibt den Währungswert in der Referenzwährung zurück, formatiert im Gebietsschema des Benutzers mit einem Währungssymbol. | 1.152,48 USD |
| getCurrencyDisplayValue() | Gibt den eingegebenen Währungswert zurück, formatiert im Gebietsschema des Benutzers, mit einem Währungssymbol. | 21,345,67 Yen |
| getCurrencyString () | Gibt den eingegebenen Währungswert als unformatierte Zahl zurück, der der dreistellige ISO-Währungscode vorangestellt und durch ein Semikolon getrennt ist. | JPY 21345,67 |
| getCurrencyCode() | Gibt den dreistelligen ISO-Währungscode für den eingegebenen Währungswert zurück. | JPY |
| getSessionCurrencyCode() | Gibt den dreistelligen ISO-Währungscode für die Sitzungswährung des Benutzers zurück. | EUR |
| getReferenceCurrencyCode() | 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 |
| setDisplayValue() | Legt den Währungswert fest als:
|
4369,21 oder JPY 4369,21 |