Funktionen zur Verwaltung von Sammlungen collection-management-functions
Informationen zu Funktionen zum Abfragen von Sammlungen
Die Ausdruckssprache bietet auch eine Reihe von Funktionen zum Abfragen von Sammlungen. Diese Funktionen werden nachfolgend erläutert.
Im folgenden Beispiel verwenden wir die Ereignis-Payload, die eine Sammlung enthält:
{
"_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"
}
Die Funktion „all(<condition>)“
Die Funktion all ermöglicht mithilfe eines booleschen Ausdrucks die Definition eines Filters für eine bestimmte Sammlung.
<listExpression>.all(<condition>)
Beispielsweise können Sie von allen App-Benutzenden diejenigen abfragen, die iOS 13 nutzen (boolescher Ausdruck „app used == iOS 13“). Das Ergebnis dieser Funktion ist die gefilterte Liste mit Elementen, die dem booleschen Ausdruck entsprechen (Beispiel: App-Anwender 1, App-Anwender 34, App-Anwender 432).
In einer Aktivität des Typs „Bedingung der Datenquelle“ können Sie überprüfen, ob das Ergebnis der Funktion all null ist. Sie können die Funktion all auch mit anderen Funktionen wie count kombinieren. Weitere Informationen finden Sie unter Aktivität „Bedingung der Datenquelle“.
Beispiel 1
Wir möchten überprüfen, ob ein Anwender eine bestimmte Version einer App installiert hat. Zu diesem Zweck rufen wir alle Push-Benachrichtigungs-Token für Mobile Apps mit der Version 1.0 ab. Anschließend führen wir eine Bedingung mit der Funktion Zählen aus, um zu überprüfen, ob die zurückgegebene Liste von Tokens mindestens ein Element enthält.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0
Das Ergebnis ist wahr.
Beispiel 2
Hier verwenden wir die Funktion count, um zu überprüfen, ob in der Sammlung Push-Benachrichtigungs-Token vorhanden sind.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0
Das Ergebnis ist wahr.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})
Das Ergebnis des Ausdrucks ist 3.
-
Wenn die Filterbedingung in der Funktion all() leer ist, gibt der Filter alle Elemente in der Liste zurück. **Um jedoch die Anzahl der Elemente einer Sammlung zu zählen, ist die Funktion „all“ nicht erforderlich.
-
currentEventFieldist nur bei der Bearbeitung von Ereignissammlungen verfügbar,currentDataPackFieldbei der Bearbeitung von Datenquellensammlungen undcurrentActionFieldbei der Bearbeitung von benutzerdefinierten Aktionsantwortsammlungen.Bei der Verarbeitung von Sammlungen mit
all,firstundlastwird nacheinander eine Schleife um jedes Element der Sammlung gebildet.currentEventField,currentDataPackFieldundcurrentActionFieldentsprechen dem Element, um das die Schleife gebildet wird.
Die Funktionen „first(<condition>)“ und „last(<condition>)“
Die Funktionen first und last ermöglichen auch die Definition eines Filters für die Sammlung, wobei das erste/letzte Element der Liste zurückgegeben wird, das dem Filter entspricht.
<listExpression>.first(<condition>)
<listExpression>.last(<condition>)
Beispiel 1
Dieser Ausdruck gibt das erste Push-Benachrichtigungs-Token zurück, das mit Apps verknüpft ist, deren Version 1.0 ist.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token}
Das Ergebnis ist token_1.
Beispiel 2
Dieser Ausdruck gibt das letzte Push-Benachrichtigungs-Token zurück, das mit Apps verknüpft ist, deren Version 1.0 ist.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last(currentEventField.application.version == "1.0").token}
Das Ergebnis ist token_2.
Die Funktion „at(<index>)“
Mit der Funktion at können Sie anhand eines Index auf ein bestimmtes Element in einer Sammlung verweisen.
Der Index „0“ ist der erste Index der Sammlung.
<listExpression>.at(<index>)
Beispiel
Dieser Ausdruck gibt das zweite Push-Benachrichtigungs-Token der Liste zurück.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}`
Das Ergebnis ist token_2.