Functies voor het beheer van verzamelingen collection-management-functions

Over queryverzamelingsfuncties

De uitdrukkingstaal introduceert ook een reeks functies aan vraaginzamelingen. Deze functies worden hieronder uitgelegd.

In het volgende voorbeeld gebruiken we de gebeurtenislading die een verzameling bevat:

                {
   "_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"
}

De all(<condition>) functie

De functie all laat de definitie van een filter op een bepaalde inzameling toe door een booleaanse uitdrukking te gebruiken.

<listExpression>.all(<condition>)

Zo kunt u onder alle gebruikers van de app de toepassingen ophalen met IOS 13 (Booleaanse expressie "app used == IOS 13"). Het resultaat van deze functie is de gefilterde lijst met items die overeenkomen met de booleaanse expressie (bijvoorbeeld: app-gebruiker 1, app-gebruiker 34, app-gebruiker 432).

Bij een Source Condition-activiteit van Data kunt u controleren of het resultaat van de functie all null is of niet. U kunt deze all functie ook combineren met andere functies, zoals count . Voor meer informatie, zie de activiteit van de Voorwaarde van Source van Gegevens.

Voorbeeld 1

We willen controleren of een gebruiker een specifieke versie van een toepassing heeft geïnstalleerd. Hiervoor krijgen we alle pushberichttokens die zijn gekoppeld aan mobiele toepassingen waarvoor de versie 1.0 is. Vervolgens voeren we een voorwaarde uit met de functie count om te controleren of de geretourneerde lijst met tokens ten minste één element bevat.

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0

Het resultaat is waar.

Voorbeeld 2

Hier gebruiken we de functie count om te controleren of er pushberichttokens in de verzameling aanwezig zijn.

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0

Het resultaat is waar.

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})

Het resultaat van de uitdrukking is 3.

De eerste (<condition>) en laatste (<condition>) functies

De functies first en last laten ook de definitie van een filter op de inzameling toe terwijl het terugkeren van het eerste/laatste element van de lijst die de filter ontmoet.

<listExpression>.first(<condition>)

<listExpression>.last(<condition>)

Voorbeeld 1

Deze expressie retourneert het eerste pushmeldingtoken dat is gekoppeld aan mobiele toepassingen waarvoor de versie 1.0 is.

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token}

Het resultaat is token_1 .

Voorbeeld 2

Deze expressie retourneert het laatste pushmeldingtoken dat is gekoppeld aan mobiele toepassingen waarvoor de versie 1.0 is.

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last(currentEventField.application.version == "1.0").token}

Het resultaat is token_2 .

De functie at(<index>)

Met de functie at kunt u naar een specifiek element in een verzameling verwijzen op basis van een index.
Index 0 is de eerste index van de verzameling.

<listExpression>.at(<index>)

Voorbeeld

Deze expressie retourneert de tweede token voor pushmeldingen van de lijst.

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}`

Het resultaat is token_2 .