Leistungssummen

Für die Optimierung von kundenspezifischen Auswertungen oder zur Verwendung in benutzerdefinierten Berichten steht eine beschleunigte Summierung und Gruppierung in Form eines OCL Operators zu Verfügung.

Der groupLeistungen Operator existiert in verschiedenen Varianten, die sich vor allem dadurch unterscheiden, dass sie auf verschiedene Typen von Objekten anwendbar sind:

Die Syntax für alle diese Operatoren lautet wie folgt:

<obj>->groupLeistungen(<von>, <bis>, <group>)

Die Argumente (in spitzen Klammern) des groupLeistungen Operators haben folgende Bedeutungen:

<obj>->groupLeistungen(encodeDate(2019,01,01).dateToStrGerman, date.dateToStrGerman, 'PROJEKT')

Import datetime

def DatumGermanFormat(datum):
    """Gibt das Datum in deutschem Format zurück, dd.mm.yyy, als String. 
       Ist das Datum leer, wird ein Leerstring zurückgegeben."""
       
    if datum:
        return datum.strftime("%d.%m.%Y")
    else:
        return ''

Als Ergebnis erhalten Sie eine Liste von Objekten des Typs LeistSum. Diese werden jeweils gemäss der angegebenen Gruppierung sortiert.

Diese Leistungssummen-Objekte besitzen verschiedene Summenattribute sowie einen Wert für jeden Gruppierbegriff. Im Detail sind dies die folgenden Eigenschaften:

Auf einem Projekt (oder einer Liste von Projekten) wird der Operator groupLeistungenP angewendet. Als Datumsperiode wird Januar bis Dezember angegeben. Wir möchten die Summen gruppiert nach Monaten und Projekten, die angegebene Gruppieranweisung ('MONTH,PROJEKT') macht dies.

->groupLeistungenP('01.01.2016','31.12.2016','MONTH,PROJEKT')

Als Resultat erhalten wir eine Liste von LeistSum Objekten. Diese enthalten beispielsweise folgende Attribute:

• Monat: datum.formatDateTime('mm.yyyy')
• Projekt: projekt
• Aufwand intern: minutenintOffen + minutenIntVerrechnet
• Wert extern: wertExtOffen + wertExtVerrechnet

Speziallfälle für die Berechnung ergeben sich zum Beispiel bei pauschalen Rechnungen ohne Leistungen oder bei Rechnungsrabatten. In diesem Fall kann nicht einfach der externe Wert der Leistungen für die Berechnung der Leistungssummen verwendet werden. Wie diese Spezialfälle im Detail behandelt werden, ist hier nachfolgend erklärt:

Aufgrund dieser Spezialfälle können sich natürlich Abweichungen ergeben zwischen der Summe der Leistungen und den summierten Leistungssummen. In diesem Fall ergibt dann beispielsweise:

offeneleistungen->union(verrechneteleistungen)->select((datum >= encodedate(1990,1,1)) 
and (datum < encodedate(2018,1,1))).wertExt->sum

einen anderen Wert als:

self->groupleistungenP('01.01.1990','01.01.2018','')->collect(wertExtOffen + wertExtVerrechnet)->sum

Ist das bei Ihnen der Fall, schauen Sie, ob es im analysierten Zeitraum obengenannte Spezialfälle hat.

Im Falle der fixierten Leistungen auf pauschalen Phasen bzw. Rechnungen kann hier keine Differenz festgestellt werden, da weder die Leistungen noch die Leistungssummen den Pauschalbetrag enthalten. In diesem Fall erkennen Sie die Differenz nur, wenn Sie die Summen der Leistungen mit den Summen der Rechnungen vergleichen.

Vertec wird ab Version 6.7.0.9 mit Firebird 5 ausgeliefert. Ab dieser Version gibt es dieses Problem nicht mehr. Wird jedoch ein groupLeistungenX Operator auf einer Liste von Projekten, Phasen oder Bearbeiter mit einer früheren Firebird Version aufgerufen, gibt es folgende Einschränkung:

Wenn die Liste der aufrufenden Objekte (also nicht die Anzahl Leistungen im Ergebnis, sondern die Projekte, Phasen oder Bearbeiter, auf denen der Operator aufgerufen wird) grösser ist als 1500 Einträge, gibt es einen Fehler vom Firebird-Server wegen unzulässigem SQL:

General SQL Error.
Implementation limit exceeded
too many values (more than 1500) in member list
to match against.

Eine Möglichkeit, dieses Problem zu umgehen, ist die Verwendung des globalen groupLeistungen Operators, der sich auf alle Leistungen bezieht.

Beispiel: Sind mehr als 1500 Projekte vorhanden, und es soll projekt->groupLeistungenP(...) aufgerufen werden, kann das so umgangen werden:

TimSession.allInstances->first->groupLeistungen('', '', 'PROJEKT')

Ergibt eine Liste von LeistSums über alle Leistungen im System, gruppiert nach Projekten.

Da die Leistungssummen optimiert via SQL berechnet werden, ist das Verhalten bei Veränderungen von Grundlagendaten geringfügig anders als sonst in Vertec.

Leistungssummen werden grundsätzlich neu berechnet, sobald irgendeine Leistung im System verändert wird. Die Neuberechnung erfolgt jedoch nur, wenn die Zahlen der Leistungssumme auch sichtbar sind. Zum Beispiel ist es nicht empfehlenswert beim Erfassen von neuen Leistungen gleichzeitig eine Liste mir Leistungssummen auf dem Bildschirm zu haben, da diese bei jeder neuen Leistung neu berechnet würde. Die Berechnung von Leistungssummen geht zwar relativ schnell, aber bei unnötig häufigem Neuberechnen ist die Verzögerung trotzdem spürbar.

Insbesondere ist es nicht zu empfehlen, groupLeistungen Operatoren in Spaltenexpressions von Listen zu verwenden, da der Performance Gewinn beim Berechnen der Summe durch die grosse Anzahl einzelner SQL Anfragen in der Regel überkompensiert wird.

Diverse Werte im Vertec sind derived, das heisst, sie werden jeweils bei Zugriff berechnet. Das bedeutet, sie sind dadurch immer aktuell, aber nicht in der Datenbank abrufbar.

Damit diese Werte für die beschleunigte Summierung trotzdem zur Verfügung stehen, gibt es sogenannte Shadow Attribute, welche bei der Berechnung der derived Attribute geschrieben werden. Diese Shadow Attributes sind persistent, das heisst, sie befinden sich in der Datenbank und können direkt abgefragt werden.

Folgende Shadow Attribute sind verfügbar. Sie haben als Präfix jeweils sql.