リスト関数 list-functions

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 型）。

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つのリスト間の共通の要素を検索
• limitを使用して、リストの最初または最後のN要素を返します
• listSizeを使用してリスト内の要素の合計数をカウントします
• serializeListを使用してリストを区切り文字列に変換する
• sortを使用してリストを昇順または降順で並べ替える

用語集：

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

ガードレール：

• distinctWithNullは<listObject> パラメーター型をサポートしていません
• filterでは、listObject パラメーターをインライン リテラルではなくフィールド参照にする必要があります
• listObjectのlistSizeでは、リストをフィールド参照にする必要があります。listObjectにnull オブジェクトを含めることはできません
• serializeListはlistObject タイプをサポートしていません

用語：

• 正規名：リスト関数 – 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」（特定のキー値に一致するエレメント）

FAQ:

• 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)を使用します。