Aggregation

Name

String

Der optionale Parameter Name kann verwendet werden, um der Projektion einen (Alias-)Namen zuzuweisen.

• Wenn kein Name angegeben ist, wird als Spaltenname (sofern relevant) der im Kontext der Projektion anwendbare Name nach dem Schema "<function> of <projection>" versehen. Den Platzhalter <function> ersetzt dabei der englische "Funktionsname" aus der obigen Tabelle für den ausgewählten Typ.

Typ

AggregateType

Der Typ bestimmt welche Art von Aggregation, Berechnung under Umwandlung auf Basis der Projektion vorgenommen werden soll.

• Das Auswahlfeld/Combobox-Element mit Suchfunktion bezieht sich auf die statische Aufzählung "Suche Aggregatstyp" (AggregateType).

►HINWEIS◄ Die Gliederung der obigen Tabelle nach Kategorien ("Aggregationsfunktionen", "Arithmetik", ...) spiegelt sich nicht im Dropdown.

Projektion

Projektion

Für den Parameter Projektion können grundsätzlich beliebige Projektionen konfiguriert werden, solange diese einen für den Typ zulässigen Datentyp als Rückgabewert liefern und das verwendete Datenbanksystem deren Verwendung im gegebenen Kontext unterstützt.

ACHTUNG Für "echte Aggregationen", also solche mit einem Typ aus der Kategorie Aggregationsfunktionen, sind ggf. folgende Einschränkungen relevant:

• Eine Aggregationsfunktion kann generell nicht innerhalb einer anderen Aggregation verwendet werden, die ebenfalls eine Aggregationsfunktion ist. Man kann Aggregationsfunktionen nicht verschachtelt einsetzen.

• Bestimmte Datenbanksysteme (z. B. MSSQL) unterstützen außerdem die Verwendung einer Subselect Projektion im Kontext einer Aggregationsfunktion nicht.

Der Screenshot links zeigt einen Ausschnitt aus der Spalte "Zuletzt geändert von", für die nicht nur die Restriktionsprojektion (wie oben) angepasst wurde, sondern auch die Projektion, so dass für Gastbenutzer die (positive) ID des Kontos mit dem Präfix "G#" erscheint.

Wie der Filterausdruck (7251|2701) verdeutlicht, bezieht sich der Filter trotzdem wie gewünscht ausschließlich auf die positiven ID-Werte der betreffenden Konten.

►ANMERKUNG◄ Die Projektion verwendet eine Wenn ( Case ) Projektion (s. Screenshot unten), die den Anzeigetext für Referenzen auf Gastbenutzer im rechten Zweig der Fallunterscheidung durch eine einfache Textverkettungsprojektion zusammenstellt. Dabei kommt wiederum eine Aggregation mit dem Typ "Absolut" (ABS) zum Einsatz, um das Minuszeichen des negativen s-Werts zu eliminieren. Dem linken Zweig der Fallunterscheidung wurde die per Standard vorgegebene Subselect Projektion platziert, die den Benutzernamen im Konto nachschlägt.

Die rechts dargestellte Projektion liefert in Verbindung mit einer - hier nicht gezeigten - Gruppierung der Suche nach dem Feld "ID" (id) der Sendung die gewünschte Kennzahl für die "Komplexität":

• Die innere Aggregation mit dem Typ "Anzahl (unterschiedlich)" ermittelt unter Berücksichtigung der Gruppierung die "Vielfalt" der Werte für das Feld "Übergeord. Positions-Nr." (parentLineItemId) der "Positionen" (lineItems) je Sendung.
  
  

• Die äußere Aggregation mit dem Typ "Wurzel" (SQRT) berechnet aus dem aggregierten Zahlenwert aus der inneren Aggregation den "radizierten" Wert.

Laufzeitbeispiel:

ID,VOLUME,COMPLEXITY

8455,1,2.0

7955,10,1.7320508075688772

7951,,1.7320508075688772

4006,2,1.7320508075688772

9251,4,1.4142135623730951

9252,4,1.0

Die Beispieldaten links zeigen für die Spalte COMPLEXITY die berechneten Double-Werte für "Komplexitätswerte" von √4, √3, √2 und √1.

Die Quadratwurzel kommt hier zum Einsatz, da eine Verdopplung der Anzahl von "Übergeordneten Positionen" in der Positionshierarchie nicht doppelte Komplexität bedeuten soll. Eine Vervierfachung aber schon.

Die rechts abgebildete Aggregation definiert per Name die Ausgabespalte DEACTIVATED:

• Der Typ "Nicht" (NOT) erwartet einen Booleschen Wert für die Projektion, der logisch verneint wird.
  
  

• Die Projektion verwendet eine Feldprojektion, die auf das Feld "Aktiv" (active) zugreift.

Als Basis für den Einsatz einer Aggregation mit dem Typ "Anzahl" (s. unten) für die eigentlichen Aggregation der Benutzerkonten wird eine Gruppierung benötigt, die wie rechts abgebildet konfiguriert werden kann:

• Innerhalb einer Aggregation definiert der Typ "Groß" (UPPER), dass der Rückgabewert der Projektion in Großbuchstaben umgewandelt werden soll.
  
  

• Als Projektion dient hier eine Teilstring Projektion, die das erste Zeichen aus dem Feld "Benutzername" (username) zurückgibt.

Als Projektionen für die CSV-Suche sollen die folgenden beiden Spalten ausgegeben werden:

• Als erste Spalte soll der Großbuchstabe ausgegeben werden, nach dem die Benutzer zwecks Zählung gruppiert werden:

  • Die in der Gruppierung (s. o.) verwendete Projektion muss aus formalen Gründen im Kontext einer echten Aggregationsfunktion verwendet werden. Für die äußere Aggregation wurde hier der Typ "Min" ausgewählt. Die zugehörige Projektion kann mit dieser Einstellung direkt aus der Gruppierung übernommen werden.
    
    

• Die zweite Spalte definiert den Zahlenwert für die Anzahl der Benutzer, die sich den in der ersten Spalte angegebenen Anfangsbuchstaben im Feld "Benutzername" teilen durch eine weitere Aggregation:
  
  

  • Als Typ ist hier "Anzahl" (COUNT) ausgewählt.
    
    

  • Die Projektion bezieht sich auf das Feld "ID" (id), also die eindeutige Kennung des Benutzerkontos, das zuverlässig für jeden Benutzer eine Wert enthält.

Die rechts abgebildete Feld Einschränkung ergibt den gewünschten Abgleich:

• Als Prüfwert (links) dient eine Teilstring Projektion, die die ersten beiden Zeichen der internen Kennung für die "Sprache" (locale) des Benutzers zurückgibt. Diese sollten per Konvention (s. Sprache) Kleinbuchstaben sein.
  
  

• Als Vergleichswert (rechts) wandelt eine Aggregation mit dem Typ "Klein" (LOWER) den Rückgabewert aus dem Adressfeld "Land" (address.countryCode) in Kleinbuchstaben um. Per Konvention (s. Land) handelt es sich dabei in Anlehnung an den ISO 3166 Standard um eine Kombination von zwei Großbuchstaben.

Die rechts abgebildete Bedingung prüft über eine Feld Einschränkung, ob sich der als "Name" (name1) angegebene Text vom Rückgabewert der Trim-Funktion für dasselbe Feld unterscheidet (!=):

• Als Prüfwert (links) wird direkt über eine Feldprojektion direkt auf das Feld "Name" (name1) zugegriffen.
  
  

• Als Vergleichswert wird dieselbe Feldprojektion als Projektion innerhalb einer Aggregation mit dem Typ "Trim" (TRIM) eingesetzt.

►HINWEIS◄ Eine Suche mit dieser Bedingung liefert alle Adressen zurück, auf die im Ausführungskontext Zugriff besteht, weil Adressbucheinträge auf sie verweisen. Adressen, die im Kontext anderer Entitäten (z. B. Firmen/Mandanten oder Benutzer) erstellt wurden, sind dagegen nicht Bestandteil des Suchergebnisses, solange der Zugriff nicht über Joins, eine Sub-Suche, o. ä. erfolgt.

Das Beispiel rechts zeigt das Ergebnis einer Tupel-Suche mit folgender Charakteristik:

• Es liegen 3 Ergebniszeilen (row) vor, von denen jede die Daten für eine bestimmte Firma wiedergibt.
  
  

• Der Wert (item) für die erste Spalte (COMPANY) identifiziert die Firma über deren "ID" (id).
  
  

• Die zweite Spalte (GUEST_ACCOUNTS) gibt die Anzahl aller je Firma angelegten Gastbenutzer als Ganzzahl (long) aus.
  
  

• Die dritte Spalte (GUEST_LOGINS) gibt die Summe der ausgeführten Logins je Firma als Ganzzahl (int) aus.
  
  

• Die vierte Spalte (LOGIN_AVG) gibt die durchschnittliche Anzahl von Logins je Konto als Kommazahl (double) aus.
  ► ANMERKUNG◄ Der aggregierte Durchschnittswert kann im gegebenen Szenarion durch eine Division der Aggregationsergebnisse in Spalte 3 und 2 (GUEST_LOGINS/GUEST_ACCOUNTS) zur Verifikation "nachgerechnet" werden.

<core:TupleSearchResult maxResults="100" count="3">
      <columns>
         <name>COMPANY</name>
         <name>GUEST_ACCOUNTS</name>
         <name>GUEST_LOGINS</name>
         <name>LOGIN_AVG</name>
      </columns>
      <result>
         <row>
            <item xsi:type="xsd:long">101</item>
            <item xsi:type="xsd:long">2</item>
            <item xsi:type="xsd:int">0</item>
            <item xsi:type="xsd:double">0.0</item>
         </row>
         <row>
            <item xsi:type="xsd:long">1902</item>
            <item xsi:type="xsd:long">12</item>
            <item xsi:type="xsd:int">179</item>
            <item xsi:type="xsd:double">14.916666666666666</item>
         </row>
         <row>
            <item xsi:type="xsd:long">2202</item>
            <item xsi:type="xsd:long">2</item>
            <item xsi:type="xsd:int">9</item>
            <item xsi:type="xsd:double">4.5</item>
         </row>
      </result>

Da unsere Suche Kennzahlen für Gastbenutzer je Firma aggregieren soll, muss für die Suche eine Gruppierung definiert sein:

• Der Screenshot zeigt (rechts oben) eine Feldprojektion auf das Feld "Firma" (companyId), die zu diesem Zweck eingerichtet wird.
  
  

• Wie der Screenshot (rechts unten) zeigt, soll dieselbe Feldprojektion auch im Kontext der Sortierung als Projektion genutzt.
  
  ►ANMERKUNG◄ Es ist nicht notwendig eine Sortierung zu definieren. Sortierkriterien sollten nur dann definiert werden, wenn die Sortierung für den Einsatzzweck einen Mehrwert darstellt. Anstelle von Projektionen aus der Gruppierung könnte man innerhalb der Sortierung auch auf Aggregationsergebnisse zugreifen und im gegebenen Beispiel z. B. die Firmen absteigend nach der Anzahl der Gastbenutzer sortieren.

Das Screenshot rechts zeigt eine Übersicht über die für die Tupel-Suche eingerichteten Projektionen, die die Ausgabespalten definieren:

• Die erste Spalte (COMPANY) verwendet die auch als Gruppierung angegebene Feldprojektion auf das Feld "Firma" (companyId).

• Die Konfiguration für die nachfolgenden "Statistikspalten" wird unten Schritt für Schritt erörtert.

Die Spalte GUEST_ACCOUNTS verwendet eine Aggregation mit dem Typ "Anzahl" (COUNT) mit einer Feldprojektion für das Feld "ID" (id) der zu aggregierenden Gastbenutzer.

Für den Aggregationstyp "Anzahl" ist die Feldauswahl unerheblich solange sichergestellt ist, dass es nicht "Kein Wert" ($null) enthalten kann bzw. enthält. Sonst werden Gastbenutzer nicht gezählt, für das das Feld in der Projektion keinen Wert enthält.

Ohne einen Eintrag für den Parameter Name würde der Titel der Ausgabespalte "COUNT of id" lauten.

Die Spalte GUEST_LOGINS verwendet eine Aggregation mit dem Typ "Summe" (SUM) mit einer Feldprojektion für das Feld "Anzahl Logins" (loginCount) der zu aggregierenden Gastbenutzer.

Der Aggregationstyp "Summe" addiert alle gefundenen Zahlenwerte. Ob das Feld in der Projektion für alle aggregierten Gastbenutzer gefüllt ist, spielt für den als "Summe" zurückgegebenen Wert keine Rolle.

Ohne einen Eintrag für den Parameter Name würde der Titel der Ausgabespalte "SUM of loginCount" lauten.

Die Spalte LOGIN_AVG verwendet eine Aggregation mit dem Typ "Durchschnitt" (AVG) mit einer Feldprojektion für das Feld "Anzahl Logins" (loginCount) der zu aggregierenden Gastbenutzer.

Der Aggregationstyp "Durchschnitt" bezieht die Summe aller Werte aus der Projektion auf die Anzahl der aggregierten Einzelwerte, die nicht "Kein Wert" ($null) sind. Da das loginCount-Feld mit dem Wert 0 initialisiert wird und datenbankseitig keinen $null-Wert enthalten kann, ist die Interpretation des Mittelwerts im Kontext unkritisch.

Ohne einen Eintrag für den Parameter Name würde der Titel der Ausgabespalte "AVG of loginCount" lauten.

Die Kennzahlen für die Auswertung soll alle Firmen "aggregieren", für die im Ausführungskontext Lesezugriff besteht.

Das bedeutet:

• Die Suche kommt ohne Gruppierung aus.
  
  

• Es ist nur genau eine Ergebniszeile zu erwarten (s. Beispieldaten), sofern überhaupt eine Firma (mit Lesezugriff) existiert.

  <core:TupleSearchResult maxResults="100" count="1">
      <columns>
         <name>COMPANIES</name>
         <name>WITH_COUNTRY</name>
         <name>COUNTRIES</name>
      </columns>
      <result>
         <row>
            <item xsi:type="xsd:long">40</item>
            <item xsi:type="xsd:long">28</item>
            <item xsi:type="xsd:long">10</item>
         </row>
      </result>
   </core:TupleSearchResult>

Die Spalte COMPANIES soll die Anzahl aller ausgewerteten Firmen/Mandanten wiedergeben.

Der Typ "Anzahl" ermöglicht dies in Verbindung mit einer Feldprojektion, die sich auf das Feld "ID" (id) der Firma bezieht. Das Ergebnis liefert die Anzahl der Firmen/Mandanten, für die Lesezugriff besteht, unter zwei Voraussetzungen:

1. Die Projektion liefert für keine Firma "Kein Wert" ($null), was für das "ID"-Feld sicher zutrifft.

2. Je Firma tritt immer genau eine Ergebniszeile auf. Das trifft zu, solange keine Projektionen auf mehrwertige Felder verwertet werden (s. folgende Variante).

Die Spalte WITH_COUNTRY soll die Anzahl aller ausgewerteten Firmen/Mandanten wiedergeben, in deren Adressfeld "Land" (countryCode) ein Land ausgewählt ist.

Da der Typ "Anzahl" nur die Werte aus der Projektion berücksichtigt, die nicht $null sind, liefert er mit er Feldprojektion auf den Pfad zum fraglichen Feld (address.countryCode) genau die gesuchte Anzahl, solange gewährleistet ist, dass keine der anderen Projektionen ein mehrwertiges Feld betrifft (s. folgende Variante).

Die Spalte COUNTRIES soll die Anzahl der unterschiedlichen "Länder" angeben, die in den Adressen der ausgewerteten Firmen vorgefunden werden.

Der Typ "Anzahl (unterschiedlich)" (COUNT_DISTINCT) ermöglicht in Verbindung mit einer Feldprojektion, die sich - wie in der vorherigen Spalte - auf das Adressfeld "Land" (countryCode) bezieht.

►WICHTIG◄ Der Zustand, dass in der Adresse kein Land angegeben ist, wird nicht mitgezählt. Falls die "Anzahl (unterschiedlich)" den Wert 1 ergibt, bedeutet das also nicht, dass alle Firmen/Mandanten in demselben Land verortet sind, sondern nur, dass keine Firmenadresse sich auf ein anderes Land bezieht.

Im Unterschied zum Typ "Anzahl" ist der Typ "Anzahl (unterschiedlich)" grundsätzlich robust gegen das Szenario, dass eine mehrwertige Projektion mehrere Ergebniszeilen je Firma erzeugt (s. folgende Variante). Die Vielfalt der Werte in der Projektion erhöht sich durch eine wiederholte Nennung derselben Werte nicht.

Angelehnt an die Projektion für die Spalte WITH_COUNTRY könnte man versuchen, die Anzahl der Firmen mit gefülltem "Übergeordnete Firmen" (parentCompanies) wie rechts abgebildet zu ermitteln.

ACHTUNG Dieser Ansatz funktioniert formal "fehlerfrei", liefert dabei aber keineswegs die erwarteten Ergebnisse.

Es wichtig zu verstehen, was passiert, wenn man die rechts abgebildete Projektion den bestehenden (s. oben) hinzufügt.

Mit denselben Firmendaten wie im obigen Laufzeitbeispiel liefert die erweiterte Tupel-Suche folgendes Ergebnis:

<core:TupleSearchResult maxResults="100" count="1">
      <columns>
         <name>COMPANIES</name>
         <name>WITH_COUNTRY</name>
         <name>COUNTRIES</name>
         <name>HAS_PARENT</name>
      </columns>
      <result>
         <row>
            <item xsi:type="xsd:long">57</item>
            <item xsi:type="xsd:long">45</item>
            <item xsi:type="xsd:long">10</item>
            <item xsi:type="xsd:long">46</item>
         </row>
      </result>
   </core:TupleSearchResult>

Ohne den direkten Vergleich zum vorherigen Ergebnis machen die Ergebnisdaten einen durchaus "unverdächtigen" Eindruck.

Allerdings liefern die Spalten COMPANIES und WITH_COUNTRY jetzt höhere Werte (57←40 und 45←28) als vor der Erweiterung, ohne dass zusätzliche Firmen/Mandanten erstellt oder deren Adressen bearbeiten worden wären.

Warum? Die hinzugefügte Aggregation bezieht sich per Feldprojektion auf ein mehrwertiges Feld (s. a. Datentyp Long[] im Screenshot oben), was sinngemäß eine Multiplikation der vorherigen Ergebniszeilen für Firmen/Mandanten mit der zugehörigen Liste von Long-Referenzen für übergeordnete Firmen bewirkt.

Die Aggregationsfunktionen verarbeiten das Ergebnis des "Kreuzprodukts": {Firmen} x {Übergeordnete Firmen}

Die unmittelbar bzw. in einer (1:1)-Relation mit der Firma verknüpften Daten (hier: die Feldwerte für id und address.countryCode) werden in so vielen Ergebniszeilen wiederholt, wie "Übergeordnete Firmen" für die betreffende Firma referenziert sind.

• Für die COMPANIES-Spalte würde ein Wechsel zum Typ "Anzahl (unterschiedlich)" Abhilfe schaffen, da die Aggregation dann nur die Zahl der unterschiedlichen "ID"-Werte liefert.

• Die Fehlanzeigen für die WITH_COUNTRIES-Spalte und die neue HAS_PARENT-Spalte können nicht so einfach "kuriert" werden.

• Die COUNTRIES-Spalte zeigt einen unveränderten Wert an, weil hier sowieso der Typ "Anzahl (unterschiedlich)" ausgewählt ist.

Eine Aggregation mit dem Typ "Anzahl" soll alle Firmen/Mandanten zählen, die über mindestens eine übergeordnete Firma verfügen.

Die Projektion muss zu diesem Zweck genau dann einen beliebigen von "Kein Wert" ($null) unterschiedlichen Rückgabewert liefern, wenn die Anzahl der übergeordneten Firmen >0 ist.

• Die Wenn ( Case ) Projektion innerhalb der Projektion formuliert diese Bedingung über eine Feld Einschränkung und weist über eine Literale Projektion willkürlich einen Leerstring als Rückgabewert zu, wenn die Bedingung erfüllt ist. Anderenfalls lautet der Rückgabewert "Kein Wert" ($null).
  
  

• Als Prüfwert für die Feld Einschränkung muss die Anzahl der parentCompanies des Firmenkontos ermittelt werden, auf das sich die übergeordnete Suche bezieht. Diese Anzahl kann im Kontext einer Aggregation nur über eine Subselect Projektion ermittelt werden. Das direkte Verschachteln von Aggregationsfunktionen ist nicht zulässig.
  

  • Als Entität für den Subselect ist wieder der Typ "Firmenkonto" ausgewählt.
    
    

  • Die Spaltenprojektion für Subselect definiert die Aggregation zum Ermitteln der "Anzahl" der übergeordneten Firmen (parentCompanies).
    
    

  • Die Parameter Feld für Join und Feld der Entität für Join fordern eine Übereinstimmung bzgl. des Felds "ID" (id). Der Subselect wird hier ausnahmsweise verwendet, um eine (1:1)-Relation abzubilden. Das innere Aggregationsergebnis ("Anzahl der übergeordneten Firmen") soll logischerweise genau der Firma zugeordnet werden, für die es erhoben wurde.