Aggregationsfunktionen aggregation-functions

Syntax

Parameter

Unterstützte Typen:

• listInteger
• listDecimal
• decimal
• integer

Signaturen und zurückgegebener Typ

avg(<listInteger>)

avg(<listDecimal>)

avg(<decimal>,<decimal>)

avg(<decimal>,<integer>)

avg(<integer>,<decimal>)

avg(<integer>,<integer>)

Gibt eine Dezimalzahl zurück.

Beispiele

avg(@event{BarBeacon.inventory},5)

avg([10,3,8])

Gibt 7.0 zurück.

avg(10.2, 3)

Gibt 6.6 zurück.

Syntax

count(<listAny>)

count(<listObject>)

Parameter

table 0-row-3 1-row-3
Parameter	Typ	Beschreibung
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly oder listObject	Zu verarbeitende Liste. Bei listObject muss es sich um einen Feldverweis handeln. Ein listObject kann kein Null-Objekt enthalten.

Signaturen und zurückgegebener Typ

count(<listAny>)

Gibt eine Ganzzahl zurück.

Beispiele

count([10,2,10,null])

Gibt 3 zurück.

count(@event{my_event.productListItems})

Gibt die Anzahl der Objekte im angegebenen Array von Objekten zurück (listObject-Typ). Anmerkung: Ein listObject kann kein Null-Objekt enthalten.

Syntax

Parameter

table 0-row-2 1-row-2
Parameter	Typ
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

Signaturen und zurückgegebener Typ

countOnlyNull(<listAny>)

Gibt eine Ganzzahl zurück.

Beispiele

countOnlyNull([10,2,10,null])

Gibt 1 zurück.

Syntax

Parameter

table 0-row-2 1-row-2
Parameter	Typ
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

Signaturen und zurückgegebener Typ

countWithNull(<listAny>)

Gibt eine Ganzzahl zurück.

Beispiele

countWithNull([10,2,10,null])

Gibt 4 zurück.

Syntax

Parameter

table 0-row-3 1-row-3 2-row-3
Parameter	Typ	Beschreibung
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly oder listObject	Zu verarbeitende Liste. Bei listObject muss es sich um einen Feldverweis handeln.
keyAttributeName	Zeichenfolge	Dieser Parameter ist optional und nur für listObject. Wenn der Parameter nicht angegeben wird, wird ein Objekt als doppelt betrachtet, wenn alle Attribute dieselben Werte aufweisen. Andernfalls wird ein Objekt als doppelt betrachtet, wenn das angegebene Attribut denselben Wert aufweist.

Signaturen und zurückgegebener Typ

distinctCount(<listAny>)

Gibt eine Ganzzahl zurück.

distinctCount(<listObject>)

distinctCount(<listObject>,<string>)

Gibt eine Liste mit Objekten zurück.

Beispiele

distinctCount([10,2,10,null])

Gibt 2 zurück.

distinctCount(@event{my_event.productListItems})

Gibt die Anzahl der eindeutig voneinander unabhängigen Objekte im angegebenen Array von Objekten (listObject-Typ) zurück.

distinctCount(@event{my_event.productListItems}, "SKU")

Gibt die Anzahl der Objekte mit einem eindeutigen „SKU“-Attributwert{} zurück.

Syntax

Parameter

table 0-row-2 1-row-2
Parameter	Typ
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

Signaturen und zurückgegebener Typ

distinctCountWithNull(<listAny>)

Gibt eine Ganzzahl zurück.

Beispiele

distinctCountWithNull([10,2,10,null])

Gibt 3 zurück.

Syntax

Parameter

• listDuration
• listInteger
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• duration
• integer
• decimal
• dateTime
• dateTimeOnly

Signaturen und zurückgegebene Typen

max(<listDuration>)

Gibt eine Dauer zurück.

max(<listInteger>)

Gibt eine Dauer zurück.

max(<listDateTimeOnly>)

Gibt einen Datum/Uhrzeit-Wert ohne Berücksichtigung der Zeitzone zurück.

max(<listDateTime>)

Gibt einen Datum/Uhrzeit-Wert zurück.

max(<listDateOnly>)

Gibt ein Datum zurück.

max(<listDecimal>)

Gibt eine Dezimalzahl zurück.

max(<decimal>,<decimal>)

Gibt eine Dezimalzahl zurück.

max(<duration>,<duration>)

Gibt eine Dauer zurück.

max(<dateTime>,<dateTime>)

Gibt einen Datum/Uhrzeit-Wert zurück.

max(<dateTimeOnly>,<dateTimeOnly>)

Gibt einen Datum/Uhrzeit-Wert ohne Berücksichtigung der Zeitzone zurück.

max(<integer>,<integer>)

Gibt eine Ganzzahl zurück.

Beispiele

max(@event{BarBeacon.inventory},5)

max([10,3,8])

Gibt 10 zurück.

max([10,null,8])

Gibt 10 zurück.

Syntax

Parameter

• listDuration
• listInteger
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• duration
• integer
• decimal
• dateTime
• dateTimeOnly

Signaturen und zurückgegebene Typen

min(<listDuration>)

Gibt eine Dauer zurück.

min(<listInteger>)

Gibt eine Dauer zurück.

min(<listDateTimeOnly>)

Gibt einen Datum/Uhrzeit-Wert ohne Berücksichtigung der Zeitzone zurück.

min(<listDateTime>)

Gibt einen Datum/Uhrzeit-Wert zurück.

min(<listDateOnly>)

Gibt ein Datum zurück.

min(<listDecimal>)

Gibt eine Dezimalzahl zurück.

min(<decimal>,<decimal>)

Gibt eine Dezimalzahl zurück.

min(<duration>,<duration>)

Gibt eine Dauer zurück.

min(<dateTime>,<dateTime>)

Gibt einen Datum/Uhrzeit-Wert zurück.

min(<dateTimeOnly>,<dateTimeOnly>)

Gibt einen Datum/Uhrzeit-Wert ohne Berücksichtigung der Zeitzone zurück.

min(<integer>,<integer>)

Gibt eine Ganzzahl zurück.

Beispiele

min(@event{BarBeacon.inventory},5)

min([10,3,8])

Gibt 3 zurück.

min([10,null,8])

Gibt 8 zurück.

Syntax

Parameter

• listInteger
• listDecimal
• duration
• integer
• decimal

Signaturen und zurückgegebene Typen

sum(<listDecimal>)

Gibt eine Dezimalzahl zurück.

sum(<listInteger>)

Gibt eine Ganzzahl zurück.

sum(<integer>,<integer>)

Gibt eine Ganzzahl zurück.

sum(<decimal>,<decimal>)

Gibt eine Dezimalzahl zurück.

Beispiele

sum(@event{BarBeacon.inventory},5)

sum([10,3,8])

Gibt 21 zurück.

sum([10.5,null,8.1])

Gibt 18.6 zurück.

KI-Wissensreferenz

Dieser Abschnitt enthält strukturiertes Wissen zur Unterstützung von Interpretation, Abrufen und Antworten auf Fragen zu diesem Thema.

Zum vollständigen Verständnis sollten diese Informationen mit der Dokumentation auf dieser Seite kombiniert werden. Keine der beiden Quellen ist für Einzelpersonen gedacht. Die Seite beschreibt die Funktion, während dieser Abschnitt zusätzlichen Kontext bietet, der dabei hilft, Begriffe, Absichten, Anwendbarkeit und Begrenzungen zu unterscheiden.

• TL;DR: Auf dieser Seite werden alle in AJO-Journey-Ausdrücken verfügbaren Aggregationsfunktionen dokumentiert, die die Berechnung von Durchschnittswerten, Summen, Min-/Max-Werten, Zählungen und eindeutigen Zählungen im Vergleich zu Listen und Arrays umfassen.

intents:

• Berechnen des Durchschnitts einer Liste numerischer Werte mithilfe von avg
• Summe numerischer Werte in einer Liste oder aus Ereignisfeldern mithilfe von sum
• Suchen des minimalen oder maximalen Werts in einer Liste mithilfe von min oder max
• Nicht-Null-, Nur-Null- oder alle Elemente in einer Liste mithilfe von count, countOnlyNull oder countWithNull zählen
• Zählen unterschiedlicher Werte in einer Liste, mit oder ohne NULL, mithilfe von distinctCount oder distinctCountWithNull
• Filtern von eindeutigen Objekten in einem listObject nach einem bestimmten Schlüsselattribut mithilfe von distinctCount mit einem Schlüsselparameter

Glossar:

• listObject: Eine Liste komplexer Objekte (Feldverweise); darf keine Null-Objekte enthalten (produktspezifisch)
• listAny: Eine Liste eines beliebigen unterstützten Skalartyps (Zeichenfolge, Boolesch, Ganzzahl, Dezimalzahl, Dauer, DatumUhrzeit, DatumUhrzeitNur, DatumNur) (produktspezifisch)
• Nullwert: Ein fehlendes oder nicht definiertes Element in einer Liste. Die meisten Aggregationsfunktionen ignorieren NULL, es sei denn, die Funktion verarbeitet sie explizit (z. B. countOnlyNull, countWithNull, distinctCountWithNull).

Leitplanken:

• countOnlyNull, countWithNull und distinctCountWithNull unterstützen nicht den Parametertyp <listObject>
• distinctCount auf einem listObject muss die Liste ein Feldverweis sein, kein Inline-Literal
• count auf einem listObject muss die Liste ein Feldverweis sein. Ein listObject darf keine Null-Objekte enthalten

Terminologie:

• Kanonischer Name: Aggregationsfunktionen — Akronym: none — Varianten: Aggregatfunktionen, Sammlungsfunktionen
• Synonyme: „count“ = „count Elemente ungleich null“; „countWithNull“ = „count alle Elemente einschließlich NULL“
• Verwechseln Sie nicht: „distinctCount“ (ignoriert NULL) ≠ „distinctCountWithNull“ (enthält NULL als eindeutigen Wert)

FAQ:

• F: Enthält avg Nullwerte in ihre Berechnung? — Nein, avg ignoriert Nullwerte automatisch.
• F: Was ist der Unterschied zwischen count und countWithNull? — count schließt Nullwerte aus der Summe aus, während countWithNull jedes Element einschließlich Nullwerten zählt.
• F: Kann ich countOnlyNull für ein listObject verwenden? — Nein, <listObject> wird von countOnlyNull, countWithNull oder distinctCountWithNull nicht unterstützt.
• F: Wie zähle ich verschiedene Objekte in einem Array basierend auf einem bestimmten Attribut? — Verwenden Sie distinctCount(@event{...}, "attributeName") Angabe des Namens des Schlüsselattributs als zweiten Parameter.
• F: Was gibt max zurück, wenn die Liste NULL enthält? — max ignoriert Nullwerte und gibt das Maximum unter den Elementen zurück, die nicht null sind.