컬렉션 관리 기능 collection-management-functions
쿼리 컬렉션 함수 기본 정보
표현식 언어에서는 컬렉션을 쿼리하기 위한 함수 집합도 소개합니다. 이러한 기능은 아래에 설명되어 있습니다.
다음 예제에서는 컬렉션을 포함하는 이벤트 페이로드를 사용하겠습니다.
{
"_experience":{
"campaign":{
"message":{
"profile":{
"pushNotificationTokens":[
{
"token":"token_1",
"application":{
"_id":"APP1",
"name":"MarltonMobileApp",
"version":"1.0"
}
},
{
"token":"token_2",
"application":{
"_id":"APP2",
"name":"MarketplaceApp",
"version":"1.0"
}
},
{
"token":"token_3",
"application":{
"_id":"APP3",
"name":"VendorApp",
"version":"2.0"
}
}
]
}
}
}
},
"timestamp":"1536160728"
}
all(<condition>) 함수
all 함수를 사용하면 부울 식을 사용하여 주어진 컬렉션에서 필터를 정의할 수 있습니다.
<listExpression>.all(<condition>)
예를 들어 모든 앱 사용자 중에서 IOS 13(부울 표현식 "IOS 13== 사용된 앱")을 사용하여 앱 사용자를 가져올 수 있습니다. 이 함수의 결과는 부울 표현식(예: 앱 사용자 1, 앱 사용자 34, 앱 사용자 432)과 일치하는 항목을 포함하는 필터링된 목록입니다.
Data Source 조건 활동에서 all 함수의 결과가 null인지 여부를 확인할 수 있습니다. 이 all 함수를 count 와 같은 다른 함수와 결합할 수도 있습니다. 자세한 내용은 데이터 Source 조건 활동을 참조하세요.
예제 1
사용자가 특정 버전의 애플리케이션을 설치했는지 확인하려고 합니다. 이를 위해 버전이 1.0인 모바일 애플리케이션과 연결된 모든 푸시 알림 토큰을 가져옵니다. 그런 다음 count 함수로 조건을 수행하여 반환된 토큰 목록에 하나 이상의 요소가 포함되어 있는지 확인합니다.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0
결과는 true입니다.
예제 2
여기에서는 count 함수를 사용하여 컬렉션에 푸시 알림 토큰이 있는지 확인합니다.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0
결과는 true입니다.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})
식의 결과는 3 입니다.
-
all() 함수의 필터링 조건이 비어 있으면 필터가 목록에 있는 모든 요소를 반환합니다. **그러나 컬렉션의 요소 수를 계산하려면 all 함수가 필요하지 않습니다.
-
currentEventField은(는) 이벤트 컬렉션을 조작할 때만 사용할 수 있으며,currentDataPackField은(는) 데이터 소스 컬렉션을 조작할 때 사용할 수 있고currentActionField은(는) 사용자 지정 작업 응답 컬렉션을 조작할 때만 사용할 수 있습니다.all,first및last(으)로 컬렉션을 처리할 때 컬렉션의 각 요소를 하나씩 반복합니다.currentEventField,currentDataPackField및currentActionField은(는) 루프가 적용되는 요소에 해당합니다.
첫 번째(<condition>) 및 마지막(<condition>) 함수
first 및 last 함수는 필터를 충족하는 목록의 첫 번째/마지막 요소를 반환하면서 컬렉션에서 필터를 정의할 수도 있습니다.
<listExpression>.first(<condition>)
<listExpression>.last(<condition>)
예제 1
이 표현식은 버전이 1.0인 모바일 애플리케이션과 연결된 첫 번째 푸시 알림 토큰을 반환합니다.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token}
결과는 token_1입니다.
예제 2
이 표현식은 버전이 1.0인 모바일 애플리케이션과 연결된 마지막 푸시 알림 토큰을 반환합니다.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last(currentEventField.application.version == "1.0").token}
결과는 token_2입니다.
at(<index>) 함수
at 함수를 사용하면 색인에 따라 컬렉션의 특정 요소를 참조할 수 있습니다.
색인 0은 컬렉션의 첫 번째 색인입니다.
<listExpression>.at(<index>)
예
이 표현식은 목록의 두 번째 푸시 알림 토큰을 반환합니다.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}`
결과는 token_2입니다.