Funciones de administración de colecciones collection-management-functions
Acerca de las funciones de recopilación de consultas
El lenguaje de expresión también introduce un conjunto de funciones para consultar colecciones. Estas funciones se explican a continuación.
En el siguiente ejemplo, usemos la carga útil de evento que contiene una colección:
{
"_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"
}
La función all(<condition>)
La función all habilita la definición de un filtro en una colección determinada mediante una expresión booleana.
<listExpression>.all(<condition>)
Por ejemplo, entre todos los usuarios de la aplicación, puede obtener los que usan IOS 13 (expresión booleana "app used == IOS 13"). El resultado de esta función es la lista filtrada que contiene elementos que coinciden con la expresión booleana (ejemplo: usuario de aplicación 1, usuario de aplicación 34, usuario de aplicación 432).
En una actividad de condición de Data Source puede comprobar si el resultado de la función all es nulo o no. También puede combinar esta función all con otras funciones como count. Para obtener más información, consulte Actividad de la condición de Data Source.
Ejemplo 1
Queremos comprobar si un usuario ha instalado una versión específica de una aplicación. Para esto, obtenemos todos los tokens de notificaciones push asociados con aplicaciones móviles para las que la versión es 1.0. A continuación, realizamos una condición con la función count para comprobar que la lista devuelta de tokens contiene al menos un elemento.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0
El resultado es true.
Ejemplo 2
Aquí utilizamos la función count para comprobar si hay tokens de notificación push en la colección.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0
El resultado es true.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})
El resultado de la expresión es 3.
-
Cuando la condición de filtrado de la función all() esté vacía, el filtro devolverá todos los elementos de la lista. **Sin embargo, para contar el número de elementos de una colección, no es necesaria la función all.
-
currentEventFieldsolo está disponible al manipular colecciones de eventos,currentDataPackFieldal manipular colecciones de orígenes de datos ycurrentActionFieldal manipular colecciones de respuestas de acciones personalizadas.Al procesar colecciones con
all,firstylast, realizamos un bucle en cada elemento de la colección uno por uno.currentEventField,currentDataPackFieldycurrentActionFieldcorresponden al elemento que se está reproduciendo en bucle.
Funciones first(<condition>) y last(<condition>)
Las funciones first y last también habilitan la definición de un filtro en la colección al devolver el primer/último elemento de la lista que cumple con el filtro.
<listExpression>.first(<condition>)
<listExpression>.last(<condition>)
Ejemplo 1
Esta expresión devuelve el primer token de notificación push asociado a aplicaciones móviles para las que la versión es 1.0.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token}
El resultado es token_1.
Ejemplo 2
Esta expresión devuelve el último token de notificación push asociado a aplicaciones móviles para las que la versión es 1.0.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last(currentEventField.application.version == "1.0").token}
El resultado es token_2.
Función at(<index>)
La función at le permite hacer referencia a un elemento específico de una colección según un índice.
El índice 0 es el primer índice de la colección.
<listExpression>.at(<index>)
Ejemplo
Esta expresión devuelve el segundo token de notificación push de la lista.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}`
El resultado es token_2.