集合管理功能 collection-management-functions
關於查詢收集函式
運算式語言也會引入一組函式來查詢集合。 這些函式將於下文說明。
在下列範例中，我們使用名為「LobbyBeacon」的事件，其中包含推播通知權杖的集合。 本頁面的範例使用事件裝載結構，如下所示：
{
"_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"
}
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens}參考的，其中「LobbyBeacon」是事件名稱，而路徑的其餘部分則對應至上述結構。all(<condition>)函式
all函式使用布林運算式啟用指定集合上篩選的定義。
<listExpression>.all(<condition>)
概念範例：在所有應用程式使用者中，您可以使用IOS 13 （布林運算式「用於IOS 13」==應用程式）來取得這些使用者。 此函式的結果是篩選的清單，其中包含符合布林值運算式的專案（例如：應用程式使用者1、應用程式使用者34、應用程式使用者432）。
在資料Source條件活動中，您可以檢查 all 函式的結果是否為Null。 您也可以將此 所有 函式與其他函式（例如count）結合。 如需詳細資訊，請參閱資料Source條件活動。
使用LobbyBeacon裝載的程式碼範例：
以下範例會使用顯示在此頁面頂端的事件裝載。
範例 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。
本節包含結構化知識，用於支援與本主題相關的解譯、擷取和問答。
如需完整瞭解，此資訊應結合本頁的檔案。 兩者皆非獨立來源；頁面說明功能，本節提供額外內容，以協助去除術語、意圖、適用性和限制條件的歧義。
- TL；DR：此頁面記錄了Journey進階運算式編輯器中使用的
all()、first()、last()和at()集合管理函式，以推播通知權杖裝載範例說明。
意圖：
- 使用帶有
all(<condition>)的布林條件來篩選事件或資料來源欄位的集合 - 使用
count()結合集合函式來計算已篩選或未篩選的集合專案 - 使用
first()或last()擷取集合的第一個或最後一個相符專案 - 使用
at(<index>)存取特定以零為基底之索引的集合元素 - 瞭解哪個回圈變數(
currentEventField，currentDataPackField，currentActionField)套用至每個集合內容
字彙表：
- all(condition)：篩選集合併傳回符合指定布林運算式 （產品特定） 的所有專案
- first(condition)：傳回集合中符合條件 （產品特定） 的第一個（體驗事件的最近）元素
- last(condition)：傳回符合條件 （產品特定） 之集合中的最後（體驗事件的最舊）專案
- at(index)：傳回集合 （產品特定） 之指定以零為基底的索引處的專案
- currentEventField：重複處理事件集合 （產品專屬） 時，才能使用回圈變數
- currentDataPackField：回圈變數只有在反複處理資料來源集合 （產品特定） 時才能使用
- currentActionField：重複處理自訂動作回應集合 （產品特定） 時，才可使用回圈變數
護欄：
- 不支援在歷程運算式/條件中使用體驗事件；請考慮其他方法，例如計算屬性
currentEventField、currentDataPackField和currentActionField只能在其各自的集合內容中使用all函式不需要用來計算集合專案 —count()可以直接套用至欄位路徑- 以空白條件呼叫
all()時，會傳回集合中的所有元素
術語：
- 正式名稱：集合管理函式 — 縮寫：無 — 變體：集合函式，查詢集合函式
- 同義字： “all()” = “collection filter function”； “at()” = “index accessor”
- 請勿混淆：
first()（最近體驗事件）≠一般清單中第一個插入的專案
常見問題集：
- 問：具有空白條件的
all()與具有條件的all()之間有何差異？ — 空白的all()會傳回每個元素；以條件為基礎的all()只會傳回符合布林運算式的元素。 - 問：如何在不使用
all()的情況下計算推播通知權杖？ — 直接在Token欄位路徑上呼叫count()，例如count(@event{LobbyBeacon...pushNotificationTokens.token})。 - 問：當在資料來源集合上循環時，我該使用哪個變數來參考目前的專案？ — 在資料來源集合的
all()、first()或last()中使用currentDataPackField。 - 問：如何取得集合中的第二個專案？ — 使用
at(1)，因為索引0是第一個元素。 - 問：為什麼
last()會傳回最舊的體驗事件？ — 體驗事件會以反向時間順序儲存，因此集合中的最後一個位置會對應至最舊的事件。