リスト関数 list-functions

differenceLists(listString,listString)：listString

differenceLists(listInteger,listInteger)：listInteger

differenceLists(listDecimal,listDecimal)：listDecimal

differenceLists(listBoolean,listBoolean)：listBoolean

differenceLists(listDuration,listDuration)：listDuration

differenceLists(listDateTime,listDateTime)：listDateTime

differenceLists(listDateTimeOnly,listDateTimeOnly)：listDateTimeOnly

differenceLists(listDateOnly,listDateOnly)：listDateOnly

differenceLists(['a','b','c'], ['b'])

['a','c'] を返します。

differenceLists(['a','a','b'], [])

['a','b'] を返します。

differenceLists([], ['a'])

[] を返します。

distinct(<listInteger>)

整数のリストを返します。

distinct(<listDecimal>)

小数のリストを返します。

distinct(<listString>)

文字列のリストを返します。

distinct(<listDateTimeOnly>)

タイムゾーンを考慮しない日時のリストを返します。

distinct(<listDateTime>)

日時のリストを返します。

distinct(<listDateOnly>)

日付のリストを返します。

distinct(<listBoolean>)

ブール値のリストを返します。

distinct(<listDuration>)

期間のリストを返します。

distinct(<listObject>)

distinct(<listObject>,<string>)

オブジェクトのリストを返します。

distinct([10,2,10,null])

[10, 2] を返します。

distinctWithNull(<listInteger>)

整数のリストを返します。

distinctWithNull(<listDecimal>)

小数のリストを返します。

distinctWithNull(<listString>)

文字列のリストを返します。

distinctWithNull(<listDateTimeOnly>)

タイムゾーンを考慮しない日時のリストを返します。

distinctWithNull(<listDateTime>)

日時のリストを返します。

distinctWithNull(<listDateOnly>)

日付のリストを返します。

distinctWithNull(<listBoolean>)

ブール値のリストを返します。

distinctWithNull(<listDuration>)

期間のリストを返します。

distinctWithNull([10,2,10,null])

[10, 2, null] を返します。

filter(listObject, string, listString)

filter(listObject, string, listInteger)

filter(listObject, string, listDecimal)

filter(listObject, string, listDateTime)

filter(listObject, string, listDateTimeOnly)

filter(listObject, string, listDateOnly)

filter(listObject, string, listDuration)

filter(listObject, string, listBoolean)

listObject を返します。

受信イベント「myevent」で渡されるペイロードの例を次に示します。

"productListItems": [{
   "id": "product1",
   "name": "the product 1",
   "price": 20
},{
   "id": "product2",
   "name": "the product 2",
   "price": 30
},{
   "id": "product3",
   "name": "the product 3",
   "price": 50
}]

次の式を使用できます。

filter(
 @event{myevent.productListItems},
 "id",
 ["product2", "product3", "product4"]
)

「product2」と「product3」を id とする 2 つのオブジェクトから成る listObject を返します。

getListItem(<listInteger>,<index>)

整数を返します。

getListItem(<listDecimal>,<index>)

小数を返します。

getListItem(<listString>,<index>)

文字列を返します。

getListItem(<listDateTimeOnly>,<index>)

タイムゾーンを無視して日時を返します。

getListItem(<listDateTime>,<index>)

日時を返します。

getListItem(<listDateOnly>,<index>)

日付のリストを返します。

getListItem(<listBoolean>,<index>)

ブール値を返します。

getListItem(<listDuration>,<index>)

期間を返します。

getListItem([10, 2, 3], 1)

「2」を返します。

getListItem(["A", "B", "C"], 2)

「C」を返します。

値「20.45.2.3434」を持つイベントフィールド「event.appVersion」の例

split(@event{event.appVersion}, "\\.")

["20", "45", "2", "3434"] を返します

getListItem(split(@event{event.appVersion}, "\\."), 0)

「20」を返します

in(<integer>,<listInteger>)

in(<decimal>,<listDecimal>)

in(<string>,<listString>)

in(<boolean>,<listBoolean>)

in(<dateTimeOnly>,<listDateTimeOnly>)

in(<dateTime>,<listDateTime>)

in(<dateOnly>,<listDateOnly>)

in(<duration>,<listDuration>)

ブール値を返します。

in(4,[4,5,3,4])

true を返します。

in(8,[4,5,3,4])

false を返します。

in(#{ExperiencePlatform.ProfileFieldGroup.profile.person.gender}, ["male"])

intersect(listString,listString)：listString

intersect(listDecimal,listDecimal)：listDecimal

intersect(listInteger,listInteger)：listInteger

intersect(listDateTime,listDateTime)：listDateTime

intersect(listDateTimeOnly,listDateTimeOnly)：listDateTimeOnly

intersect(listDateOnly,listDateOnly)：listDateOnly

intersect(listDuration,listDuration)：listDuration

intersect(listBoolean,listBoolean)：listBoolean

リストを返します。

intersect(
    ["sports", "news", "documentary"],
    ["sports", "movies", "documentary"]
)

[“sports”, “news”] を返します。

intersect(
    #{ExperienceDataPlatform.profile.interests},
    ["sports", "documentary"]
)

プロファイル属性と指定されたカテゴリリストの間の共通項目を返します。

intersect(
    #{ExperienceDataPlatform.profile.interests},
        @event{myEvent.sport_interests}
)

プロファイル属性と指定されたイベントフィールドの間の共通項目を返します。

limit(<listString>,<integer>)

limit(<listString>,<integer>,<boolean>)

文字列のリストを返します。

limit(<listInteger>,<integer>)

limit(<listInteger>,<integer>,<boolean>)

整数のリストを返します。

limit(<listDecimal>,<integer>)

limit(<listDecimal>,<integer>,<boolean>)

小数のリストを返します。

limit(<listBoolean>,<integer>)

limit(<listBoolean>,<integer>,<boolean>)

ブール値のリストを返します。

limit(<listDateOnly>,<integer>)

limit(<listDateOnly>,<integer>,<boolean>)

日付のリストを返します。

limit(<listDateTimeOnly>,<integer>)

limit(<listDateTimeOnly>,<integer>,<boolean>)

タイムゾーンを考慮しない日時のリストを返します。

limit(<listDateTime>,integer>)

limit(<listDateTime>,<integer>,<boolean>)

日時のリストを返します。

limit(<listDuration>,<integer>)

limit(<listDuration>,<integer>,<boolean>)

期間のリストを返します。

limit(<listObject>,<integer>)

limit(<listObject>,<integer>,<boolean>)

オブジェクトのリストを返します。

limit(["A", "B", "C", "D", "E"], 3)

["A","B","C"] を返します。

limit(["A", "B", "C", "D", "E"], 3, false)

["C","D","E"] を返します。

listSize(<listInteger>)

listSize(<listDecimal>)

listSize(<listString>)

listSize(<listBoolean>)

listSize(<listDateTimeOnly>)

listSize(<listDateTime>)

listSize(<listDateOnly>)

listSize(<listDuration>)

整数を返します。

listSize(<listObject>)

listSize([10,2,3])

3 を返します。

listSize(@event{my_event.productListItems})

指定されたオブジェクト配列内のオブジェクト数を返します（listObject 型）。

mergeLists(listString,listString,boolean)：listString

mergeLists(listInteger,listInteger,boolean)：listInteger

mergeLists(listDecimal,listDecimal,boolean)：listDecimal

mergeLists(listBoolean,listBoolean,boolean)：listBoolean

mergeLists(listDuration,listDuration,boolean)：listDuration

mergeLists(listDateTime,listDateTime,boolean)：listDateTime

mergeLists(listDateTimeOnly,listDateTimeOnly,boolean)：listDateTimeOnly

mergeLists(listDateOnly,listDateOnly,boolean)：listDateOnly

mergeLists(['a','b'], ['b','c'], true)

['a','b','c'] を返します。

mergeLists(['a','b'], ['b','c'], false)

['a','b','b','c'] を返します。

serializeList(<listInteger>,<string>,<boolean>)

serializeList(<listDecimal>,<string>,<boolean>)

serializeList(<listString>,<string>,<boolean>)

serializeList(<listBoolean>,<string>,<boolean>)

serializeList(<listDateTimeOnly>,<string>,<boolean>)

serializeList(<listDateTime>,<string>,<boolean>)

serializeList(<listDateOnly>,<string>,<boolean>)

serializeList(<listDuration>,<string>,<boolean>)

文字列を返します。

serializeList(["Hello","World"], " ", false)

「Hello World」を返します。

serializeList(["Hello", "World"], ",", true)

「“Hello”,“World”」を返します。

sort(<listInteger>,<boolean>)

整数のリストを返します。

sort(<listDecimal>,<boolean>)

小数のリストを返します。

sort(<listString>,<boolean>)

文字列のリストを返します。

sort(<listDateTimeOnly>,<boolean>)

タイムゾーンを考慮しない日時のリストを返します。

sort(<listDateTime>,<boolean>)

日時のリストを返します。

sort(<listDateOnly>,<boolean>)

日付のリストを返します。

sort(<listBoolean>,<boolean>)

ブール値のリストを返します。

sort(<listObject>,<string>,<boolean>)

オブジェクトのリストを返します。

sort(["A", "C", "B"], true)

["A","B","C"] を返します。

sort([1, 3, 2], false)

[3, 2, 1] を返します。

sort(@event{my_event.productListItems}, "SKU", true)

SKU 属性で並べ替えられた listObject を返します（昇順）

この節には、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。

完全に理解するには、この情報をこのページのドキュメント組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明していますが、この節では、用語、意図、適用可能性、制約の曖昧さを解消するのに役立つ追加コンテキストを提供しています。

• TL;DR:​このページでは、AJO ジャーニー式で使用できるすべてのリスト関数について説明します。リストと配列の交差をフィルタリング、並べ替え、重複排除、メンバーシップの確認、制限、シリアル化、結合、減算、検索する方法について説明します。

インテント：

• distinct （nullを無視）またはdistinctWithNull （nullを保持）を使用して、リストから重複する値を削除します
• filterを使用して特定のキー値に一致するオブジェクトのみを返すようにlistObjectをフィルタリングします
• getListItemを使用して、リストから特定のインデックスの要素を取得します
• inを使用して、リストに値が存在するかどうかを確認します
• intersectを使用して2つのリスト間の共通の要素を検索
• mergeListsを使用して、重複排除の有無にかかわらず2つのリストを結合します
• differenceListsを使用して、あるリストを別のリスト（差を設定）から減算する
• limitを使用して、リストの最初または最後のN要素を返します
• listSizeを使用してリスト内の要素の合計数をカウントします
• serializeListを使用してリストを区切り文字列に変換する
• sortを使用してリストを昇順または降順で並べ替える

用語集：

• listObject: フィールド参照である必要がある複雑なオブジェクトのリスト。null オブジェクトを含めることはできません​（製品固有）
• keyAttributeName: distinct、filter、sortで使用されるオプションの文字列パラメーターで、重複排除、フィルタリング、並べ替えに使用するオブジェクト属性​ （製品固有） ​を識別します
• intersect：両方の入力リストに存在する要素のみを返す設定操作
• mergeLists: deduplicate パラメーター​ （製品固有） ​に応じて、2つのリストの結合（重複あり）または連結（重複あり）を返すセット操作
• differenceLists:2番目のリスト （製品固有）​に存在しない最初のリストの項目を返す設定操作

ガードレール：

• distinctWithNullは<listObject> パラメーター型をサポートしていません
• filterでは、listObject パラメーターをインライン リテラルではなくフィールド参照にする必要があります
• listObjectのlistSizeでは、リストをフィールド参照にする必要があります。listObjectにnull オブジェクトを含めることはできません
• serializeListはlistObject タイプをサポートしていません
• mergeListsとdifferenceListsはスカラーのリスト型（文字列、整数、小数、ブール値、dateTime、dateTimeOnly、dateOnly、duration）のみをサポートしています。listObjectはサポートされていません
• mergeListsのdeduplicate パラメーターは、動的ブール式ではなく、リテラル true/falseである必要があります
• differenceListsは常に結果の重複を除外します。重複を保持するオプションはありません

用語：

• 正規名：リスト関数 – Acronym: none — バリアント：コレクション関数、配列関数
• 同義語：“listSize” = “count list elements”; “serializeList” = “join list to string”
• 混同しないでください：“distinct” （nullを無視） ≠ “distinctWithNull” （nullを一意の値として保持）
• 次を混同しないでください：「limit」と3番目のパラメーターtrue （最初のN個の項目を返します）≠「limit」とfalse （最後のN個の項目を返します）
• 混同しないでください。「intersect」（2つのリスト間の共通エレメント）≠「filter」（特定のキー値に一致するエレメント）
• 混同しないでください。「mergeLists」（2つのリスト、和集合または連結を組み合わせる）≠「differenceLists」（あるリストを別のリストから減算する）≠「intersect」（共通の要素のみ）

よくある質問：

• Q: リストの最初の3つの項目を取得するにはどうすればよいですか？ — limit(myList, 3)またはlimit(myList, 3, true)を使用します。デフォルトでは、最初の項目を返します。
• Q: リストの最後の3つの項目を取得するにはどうすればよいですか？ — limit(myList, 3, false)を使用します。
• Q: distinctとdistinctWithNullの違いは何ですか？ — distinctはnull値を無視して結果から除外します。distinctWithNullはnullを明確な値として扱い、nullが存在する場合は1つのnull エントリを含みます。
• Q: filterで文字列のリストをフィルタリングできますか？ – いいえ、filterはlistObjectでのみ機能します。スカラー一覧の場合は、重複排除にinまたはdistinctを使用します。
• Q：値がリストにあるかどうかを確認するにはどうすればよいですか？ — リスト内に値が見つかった場合にtrueを返すin(value, myList)を使用します。
• Q: listObjectを特定の属性で並べ替えることはできますか？ – はい、2番目のパラメーターが属性名、3番目のパラメーターが並べ替え方向（true = ascending）の場合はsort(@event{...}, "attributeName", true)を使用します。
• Q: 2つのリストを組み合わせて重複を削除するにはどうすればよいですか？ — mergeLists(list1, list2, true)を使用します。
• Q: 2つのリストを組み合わせても重複した値を保持する方法を教えてください。 — mergeLists(list1, list2, false)を使用します。
• Q：別のリストにない項目を1つのリストで見つけるにはどうすればよいですか？ — differenceLists(list1, list2)を使用します。list2に存在しないlist1の項目を返します。
• Q: intersectとdifferenceListsの違いは何ですか？ — intersectは両方のリストに共通する項目を返し、differenceListsは2番目のリストに存在しない最初のリストの項目を返します。