집계 함수 aggregation-functions

구문

매개변수

지원되는 유형:

• list정수
• listDecimal
• decimal
• 정수

서명 및 반환된 유형

avg(<listInteger>)

avg(<listDecimal>)

avg(<decimal>,<decimal>)

avg(<decimal>,<integer>)

avg(<integer>,<decimal>)

avg(<integer>,<integer>)

십진수를 반환합니다.

예시

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

avg([10,3,8])

7.0을 반환합니다

avg(10.2, 3)

6.6 반환.

구문

count(<listAny>)

count(<listObject>)

매개변수

table 0-row-3 1-row-3
매개 변수	유형	설명
listToprocess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly 또는 listObject	처리할 목록. listObject의 경우 필드 참조여야 합니다. listObject는 null 개체를 포함할 수 없습니다.

서명 및 반환된 유형

count(<listAny>)

정수 반환.

예시

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

3을 반환합니다.

count(@event{my_event.productListItems})

지정된 개체 배열(listObject 형식)에 있는 개체 수를 반환합니다. 비고: listObject는 null 개체를 포함할 수 없습니다.

구문

매개변수

table 0-row-2 1-row-2
매개 변수	유형
listToprocess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

서명 및 반환된 유형

countOnlyNull(<listAny>)

정수 반환.

예시

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

1을 반환합니다.

구문

매개변수

table 0-row-2 1-row-2
매개 변수	유형
listToprocess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

서명 및 반환된 유형

countWithNull(<listAny>)

정수 반환.

예시

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

4를 반환합니다.

구문

매개변수

table 0-row-3 1-row-3 2-row-3
매개 변수	유형	설명
listToprocess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly 또는 listObject	처리할 목록. listObject의 경우 필드 참조여야 합니다.
keyAttributeName	문자열	이 매개 변수는 선택 사항이며 listObject에만 사용됩니다. 매개변수를 제공하지 않으면 모든 속성의 값이 동일한 경우 객체가 복제된 것으로 간주됩니다. 그렇지 않으면, 지정된 속성에 동일한 값이 있으면 객체가 복제된 것으로 간주됩니다.

서명 및 반환된 유형

distinctCount(<listAny>)

정수 반환.

distinctCount(<listObject>)

distinctCount(<listObject>,<string>)

개체 목록을 반환합니다.

예시

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

2를 반환합니다.

distinctCount(@event{my_event.productListItems})

지정된 개체 배열(listObject 형식)에서 엄격히 구별되는 개체 수를 반환합니다.

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

고유한 “SKU” 속성 값{}이 있는 개체 수를 반환합니다.

구문

매개변수

table 0-row-2 1-row-2
매개 변수	유형
listToprocess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

서명 및 반환된 유형

distinctCountWithNull(<listAny>)

정수 반환.

예시

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

3을 반환합니다.

구문

매개변수

• listDuration
• list정수
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• 지속 시간
• 정수
• decimal
• dateTime
• dateTimeOnly

서명 및 반환된 유형

max(<listDuration>)

기간을 반환합니다.

max(<listInteger>)

기간을 반환합니다.

max(<listDateTimeOnly>)

시간대를 고려하지 않고 날짜/시간을 반환합니다.

max(<listDateTime>)

날짜/시간을 반환합니다.

max(<listDateOnly>)

날짜를 반환합니다.

max(<listDecimal>)

십진수를 반환합니다.

max(<decimal>,<decimal>)

십진수를 반환합니다.

max(<duration>,<duration>)

기간을 반환합니다.

max(<dateTime>,<dateTime>)

날짜/시간을 반환합니다.

max(<dateTimeOnly>,<dateTimeOnly>)

시간대를 고려하지 않고 날짜/시간을 반환합니다.

max(<integer>,<integer>)

정수 반환.

예시

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

max([10,3,8])

10을 반환합니다.

max([10,null,8])

10을 반환합니다.

구문

매개변수

• listDuration
• list정수
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• 지속 시간
• 정수
• decimal
• dateTime
• dateTimeOnly

서명 및 반환된 유형

min(<listDuration>)

기간을 반환합니다.

min(<listInteger>)

기간을 반환합니다.

min(<listDateTimeOnly>)

시간대를 고려하지 않고 날짜/시간을 반환합니다.

min(<listDateTime>)

날짜/시간을 반환합니다.

min(<listDateOnly>)

날짜를 반환합니다.

min(<listDecimal>)

십진수를 반환합니다.

min(<decimal>,<decimal>)

십진수를 반환합니다.

min(<duration>,<duration>)

기간을 반환합니다.

min(<dateTime>,<dateTime>)

날짜/시간을 반환합니다.

min(<dateTimeOnly>,<dateTimeOnly>)

시간대를 고려하지 않고 날짜/시간을 반환합니다.

min(<integer>,<integer>)

정수 반환.

예시

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

min([10,3,8])

3을 반환합니다.

min([10,null,8])

8을 반환합니다.

구문

매개변수

• list정수
• listDecimal
• 지속 시간
• 정수
• decimal

서명 및 반환된 유형

sum(<listDecimal>)

십진수를 반환합니다.

sum(<listInteger>)

정수 반환.

sum(<integer>,<integer>)

정수 반환.

sum(<decimal>,<decimal>)

십진수를 반환합니다.

예시

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

sum([10,3,8])

21을 반환합니다.

sum([10.5,null,8.1])

18.6을 반환합니다.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page documents all aggregation functions available in AJO journey expressions, covering how to compute averages, sums, min/max values, counts, and distinct counts over lists and arrays.

Intents:

• Calculate the average of a list of numeric values using avg
• Sum numeric values in a list or from event fields using sum
• Find the minimum or maximum value in a list using min or max
• Count non-null, null-only, or all elements in a list using count, countOnlyNull, or countWithNull
• Count distinct values in a list, with or without nulls, using distinctCount or distinctCountWithNull
• Filter unique objects in a listObject by a specific key attribute using distinctCount with a key parameter

Glossary:

• listObject: A list of complex objects (field references); cannot contain null objects (product-specific)
• listAny: A list of any supported scalar type (string, boolean, integer, decimal, duration, dateTime, dateTimeOnly, dateOnly) (product-specific)
• Null value: An absent or undefined element in a list; most aggregation functions ignore nulls unless the function explicitly handles them (e.g., countOnlyNull, countWithNull, distinctCountWithNull)

Guardrails:

• countOnlyNull, countWithNull, and distinctCountWithNull do not support the <listObject> parameter type
• distinctCount on a listObject requires the list to be a field reference, not an inline literal
• count on a listObject requires the list to be a field reference; a listObject cannot contain null objects

Terminology:

• Canonical name: Aggregation functions — Acronym: none — variants: aggregate functions, collection functions
• Synonyms: “count” = “count non-null elements”; “countWithNull” = “count all elements including nulls”
• Do not confuse: “distinctCount” (ignores nulls) ≠ “distinctCountWithNull” (includes nulls as a distinct value)

FAQ:

• Q: Does avg include null values in its calculation? — No, avg ignores null values automatically.
• Q: What is the difference between count and countWithNull? — count excludes null values from the total, while countWithNull counts every element including nulls.
• Q: Can I use countOnlyNull on a listObject? — No, <listObject> is not supported by countOnlyNull, countWithNull, or distinctCountWithNull.
• Q: How do I count distinct objects in an array based on a specific attribute? — Use distinctCount(@event{...}, "attributeName") providing the key attribute name as the second parameter.
• Q: What does max return when the list contains nulls? — max ignores null values and returns the maximum among the non-null elements.