SourceSum – sumowanie danych ze źródła statycznego

Do czego służy `SourceSum`

SourceSum sumuje wartości z kolumn źródła typu Static. Funkcja może działać na całym źródle, na wierszach spełniających warunek albo na grupach.

Źródło musi mieć dokładnie jedną kolumnę klucza głównego.

Suma jednej kolumny

query = CreateObject();
query.srcName = "BudzetMPK";
query.aggColumns = "Wykonanie";

wynik = SourceSum(query);

Funkcja zwraca listę obiektów. Nazwa pola z wynikiem ma postać SUM(Wykonanie).

Suma kilku kolumn

query = CreateObject();
query.srcName = "BudzetMPK";
query.aggColumns = "Budzet,Wykonanie,Rezerwacje";

wynik = SourceSum(query);

Ten wariant zwraca sumę każdej wskazanej kolumny.

Suma z filtrem

query = CreateObject();
query.srcName = "BudzetMPK";
query.aggColumns = "Wykonanie";
query.whereQuery = "'Rok' = '2026' AND 'MPK' = 'MPK-100'";

wynik = SourceSum(query);

whereQuery ogranicza wiersze przed wykonaniem sumowania.

Suma z grupowaniem

query = CreateObject();
query.srcName = "BudzetMPK";
query.aggColumns = "Wykonanie";
query.groupColumns = "MPK";

wynik = SourceSum(query);

Wynik zawiera osobny obiekt dla każdej grupy.

Kiedy używać `SourceSum`

Użyj SourceSum, gdy reguła potrzebuje wyniku zbiorczego, na przykład sumy wykonania budżetu dla MPK albo sumy rezerwacji w roku. To lepszy wariant niż pobieranie wielu wierszy przez SourceGet i sumowanie ich w pętli.