CALCSUM

Die Funktion CALCSUM berechnet die Summe aller Werte eines Summenindex-Feldes in einer Tabelle.

Parameter

Die Funktion CALCSUM wird mit einer FieldRef-Variablen aufgerufen, die das Feld referenziert, das aufsummiert werden soll.

Rückgabewert

Die Funktion CALCSUM liefert einen Boolean-Wert zurück, der „FALSE” ausgibt, wenn die FieldRef-Variable nicht auf ein gültiges Summenindex-Feld zeigt. Wenn der Rückgabewert nicht abgefragt wird und ein Feld referenziert wird, für das kein SIFT-Index vorhanden ist, erscheint ein Runtime-Error.

Hinweise zur Anwendung

Die Funktion CALSUM funktioniert wie die Funktion CALCSUMS. Es besteht lediglich der Unterschied, dass CALCSUM über eine FieldRef-Variable aufgerufen wird und dementsprechend nur ein Feld pro Aufruf aufsummieren kann.

Beispiel

Zuerst werden zwei neue Variablen angelegt, eine RecordRef und eine FieldRef:

Name Datentyp
MyRecRef RecordRef
MyFieldRef FieldRef

Anschließend wird folgender Code eingefügt:

MyRecRef.OPEN(25);
MyFieldRef := MyRecRef.FIELD(18);
MESSAGE('Vor CALCSUM sind die Einkäufe (MW) %1', MyFieldRef.VALUE);
MyFieldRef.CALCSUM;
MESSAGE('Nach CALCSUM sind die Einkäufe (MW) %1', MyFieldRef.VALUE);

Nach Ausführen des Codes erscheinen folgende Benachrichtigungen in Dynamics 365 Business Central:

Vor CALCSUM sind die Einkäufe (MW) 0
Nach CALCSUM sind die Einkäufe (MW) -411.174,56

Falls wir nun das Feld von „Einkäufen (MW)”, das über einen SIFT-Index verfügt, auf ein anderes Feld ohne einen SIFT-Index, wie z.B. „Betrag (MW)”, ändern, erscheint folgender Runtime-Error, wenn CALCSUM ausgeführt werden soll:

Der folgende SQL-Fehler war nicht erwartet: Ungültiger Spaltenname "Amount (LCY)"