|
jr_sum_subtable_column(string subtableViewName, string columnName, string thousandsSeparator, string decimalSeparator, int decimalPlaces, string sumField) |
Scroll Zurück Oben Weiter Mehr |
Die Funktion bildet eine Summe für eine Spalte in einer Untertabellenansicht. Es kann nur für Spalten angewendet werden, welche das automatische Berechnen einer Summe unterstützen. Momentan sind dies DECIMAL-, POS_AMOUNT- und TEXTBOX-Untertabellenansichtelemente.
Parameter |
Typ |
Beschreibung |
|---|---|---|
subtableViewName |
string |
Name der Untertabellenansicht |
columnName |
string |
Name der Spalte |
thousandsSeparator |
string |
Optional: Geben Sie ein Tausender-Trennzeichen an |
decimalSeparator |
string |
Optional: Geben Sie ein Dezimal-Trennzeichen an |
decimalPlaces |
int |
Optional: Geben Sie die Anzahl der Nachkommastellen an |
sumField |
string |
Optional: Name des Summenfelds |
Als Rückgabewert liefert diese Funktion die Summe einer Spalte als Dezimalzahl.
Des Weiteren wird das Ergebnis in das Summenfeld der Untertabelle geschrieben, falls dieses konfiguriert ist.
Hinweis: Überflüssige Nullen von Dezimalstellen werden in JavaScript nicht ausgegeben.
Bei TEXTBOX- (die als Dezimalzahl validiert werden) und DECIMAL-Elementen wird das Format automatisch aus den JobRouter-Einstellungen ermittelt.
Mit den optionalen Parametern thousandsSeparator, decimalSeparator und decimalPlaces können diese Einstellungen für die Summierung überschrieben werden. Falls decimalPlaces nicht angegeben wurde, wird die Anzahl der Nachkommastellen aus der Definition des Untertabellenelements verwendet. Für TEXTBOX-Dialogelementen ohne Validierung ist es zwingend notwendig alle drei Parameter anzugeben, um Werte summieren zu können.
Werden die optionalen Parameter thousandsSeparator und decimalSeparator beim Aufruf der Funktion nicht übergeben, werden bei einem DECIMAL-Dialogelement die Trennzeichen aus den Benutzereinstellungen verwendet. Bei einem TEXTBOX-Dialogelement werden die Trennzeichen aus den allgemeinen JobRouter Einstellungen verwendet.
Hinweis: Die Parameter thousandsSeparator und decimalSeparator definieren das Format, in dem die Werte auf Zeilenebene eingelesen werden. Der Parameter decimalPlaces betrifft nur die Ausgabe. Der Rückgabewert der Funktion ist vom JavaScript-Typ number.
Mit dem optionalen Parameter sumField kann das Ergebnis auch in ein Dialogelement zurückgeschrieben werden. Hierbei wird die Summe anhand der übergebenen Parameter formatiert.
Bitte beachten Sie: Wenn Sie eines der zu summierenden Felder mit jr_set_subtable_value überschreiben, dann wird nicht automatisch die Summenbildung neu ausgeführt. Hierzu müssen Sie diese Funktion erneut ausführen. Erhält die Funktion mehr als zwei Paramter, dann muss der Paramter "decimalPlaces" immer mitgegeben werden. Wird die Funktion mit einem ungültigen Wert für den Parameter "thousandsSeparator" oder "decimalSeparator" aufgerufen, wird eine entsprechende Fehlermeldung ausgegeben. Hierzu dürfen die Parameter "thousandsSeparator" und "decimalSeparator" nicht identisch sein.
