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 lastModifierId-Werts zu eliminieren. Dem linken Zweig der Fallunterscheidung wurde die per Standard vorgegebene Subselect Projektion platziert, die den Benutzernamen im Konto nachschlägt.

Die Tupel-Suche verwendet die zwei rechts abgebildeten Projektionen:

• Die erste, eine Feldprojektion identifiziert die übergeordnete Entität (das betreffende "Konto") anhand des Referenzfelds parentId.
  ►WICHTIG◄ Dieses Feld muss auch im Kontext der Gruppierung projiziert werden, damit alle Positionen je "Konto" aggregiert werden.
  
  

• Als zweite Projektion wird eine Aggregation mit dem Typ "Summe" (SUM) verwendet, die per Name TOTAL den aggregierten Saldo je "Konto" berechnen soll.
  
  

• Damit die je Position hinterlegten positiven Zahlbeträge im Kontext der Aggregation abhängig vom angegebenen "Zahlungstyp" korrekt gegeneinander verrechnet werden, muss innerhalb der Projektion eine Vorzeichenumkehr für den Betrag im Feld payment.value vorgenommen werden, wenn der "Zahlungstyp" (paymentType) mit dem Kennbuchstaben "R" beginnt:
  
  

  • Eine Wenn ( Case ) Projektion prüft den paymentType per Feld Einschränkung und verwendet im DANN-Zweig eine Aggregation mit dem Typ "Negieren" (NEG), um das Vorzeichen für Zahlenwert aus der Feldprojektion payment.value umzukehren.
    
    

  • Im SONST-Zweig (für Einzahlungen) wird das payment.value unerändert "durchgeleitet".

►ANMERKUNG◄ Das Beispiel verwendet die Berechnungsfunktion NEG hier eher zufällig im Kontext einer "echten" Aggregationsfunktion (SUM). Berechnungsfunktionen können jederzeit auch ohne Aggregationsfunktion und Gruppierung eingesetzt werden, etwa auch um Werte in Bedingungen "anzupassen".

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 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 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, 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 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 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.

Eine Aggregation mit dem Typ "Anzahl" soll alle Firmen 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.

COMPANIES

Bisher konnten die Firmen per Typ "Anzahl" (COUNT) gezählt werden, weil je Firma genau eine Zeile ausgegeben wurde.

Die Aggregation wird jetzt umgestellt, auf den Typ "Anzahl (unterschiedlich)" (COUNT_DISTINCT), sodass jede von der Suche "gefundene" Firma (identifiziert über die eindeutige "ID") nur einmal in die Zählung eingeht.

WITH_COUNTRY

Die bisherige Aggregation hat den Effekt ausgenutzt, dass eine Aggregation mit dem Typ "Anzahl" (COUNT) nur Werte aus der Projektion zählt, die nicht "Kein Wert" ($null) sind.

Stattdessen prüfen wir jetzt innerhalb der Projektion über eine Fallunterscheidung per Wenn ( Case ) Projektion ausdrücklich fest, ob das auszuwertende Adressfeld "Land" (countryCode) einen Wert enthält. Nur dann soll die Wenn ( Case ) Projektion die "ID" (id) der Firma Rückgabewert an die Aggregation übergeben.

Für die Aggregation wird der Typ umgestellt auf "Anzahl (unterschiedlich)" (COUNT_DISTINCT). Dies kompensiert die Mehrfachnennung desselben "ID"-Werts, falls der Rückgabewert "multipliziert" wird, weil die zusätzliche Projektion für die Spalte HAS_PARENT (s. ganz unten) mehrere "Übergeordnete Firmen" vorfindet.

COUNTRIES

Die Projektion für die Spalte COUNTRIES kann unverändert beibehalten werden, da hier der Typ "Anzahl (unterschiedlich)" (COUNT_DISTINCT) bereits verwendet wird.

An der Vielfalt der Länder änder auch ein Multiplizieren der Eingangswerte für die Aggregation nichts.

unverändert:

HAS_PARENT

bisher nicht vorhanden
(bzw. per Subselect Projektion realisiert; s. oben)

Die Projektion für die Spalte HAS_PARENT reproduziert das Konzept für die Spalte WITH_COUNTRY:

• In der Projektion wird die Liste "Übergeordnete Firmen" (parentCompanies) per Wenn ( Case ) Projektion auf Inhalt geprüft.
  
  

• Die Feld Einschränkung trifft für jede aufgelistete Referenz für eine übergeordnete Firma zu. Nur dann soll die Wenn ( Case ) Projektion die "ID" (id) der untergeordneten Firma Rückgabewert an die Aggregation übergeben.
  
  

• Die Aggregation verwendet den Typ "Anzahl (unterschiedlich)" (COUNT_DISTINCT), sodass jede ID einer "untergeordneten" Firma nur einfach in die Zählung eingeht. Die IDs von Firmen ohne übergeordnete Firma tauchen in der Zählung sowieso nicht auf, weil in der Wenn ( Case ) Projektion kein ELSE-Zweig mit einer Projektion vorhanden ist.