ドキュメントExperience PlatformData Prep ガイド

データ準備のマッピング機能

最終更新日： 2026年9月22日

作成対象：

  • 開発者

データ準備関数を使用すると、ソースフィールドに入力された内容に基づいて値を計算および計算できます。

フィールド

フィールド名には、任意の法的識別子（文字、ドル記号（$）、アンダースコア文字（_）で始まるUnicode文字と数字の無制限の長さのシーケンス）を指定できます。 変数名でも大文字と小文字が区別されます。

フィールド名がこの規則に従わない場合、フィールド名は${}で囲む必要があります。 例えば、フィールド名が「First Name」または「First.Name」の場合、名前はそれぞれ${First Name}または${First\.Name}のようにラップする必要があります。

TIP
階層を操作する際に、子属性にピリオド（.）がある場合は、バックスラッシュ（\）を使用して特殊文字をエスケープする必要があります。 詳しくは、特殊文字のエスケープ ​に関するガイドを参照してください。

フィールド名が次の予約済みキーワードの​ any ​の場合、フィールド名は${}{}で囲む必要があります。

new, mod, or, break, var, lt, for, false, while, eq, gt, div, not, null, continue, else, and, ne, true, le, if, ge, return, _errors, do, function, empty, size

さらに、予約済みキーワードには、このページに記載されているマッパー関数も含まれます。

サブフィールド内のデータには、ドット表記を使用してアクセスできます。 例えば、name オブジェクトがある場合、firstName フィールドにアクセスするには、name.firstNameを使用します。

関数のリスト

次の表に、サポートされているすべてのマッピング関数（サンプル式と結果の出力を含む）の一覧を示します。

文字列関数 string

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
concat
指定された文字列を連結します。
  • STRING：連結される文字列。
concat （STRING_1, STRING_2）
concat("Hi, ", “there”, “!”)
"Hi, there!"
explode
正規表現に基づいて文字列を分割し、部分の配列を返します。 オプションで、文字列を分割する正規表現を含めることができます。 デフォルトでは、分割は「,」に解決されます。 次の区切り文字​ need ​は\でエスケープする必要があります：+, ?, ^, |, ., [, (, {, ), *, $, \区切り文字として複数の文字を含める場合、区切り文字は複数文字の区切り文字として扱われます。
  • 文字列：必須​分割する必要がある文字列。
  • REGEX: オプション​文字列の分割に使用できる正規表現。
explode （STRING, REGEX）
explode(“Hi, there!”, " ")
["Hi,", "there"]
instr
サブ文字列の場所/インデックスを返します。
  • INPUT: Required​検索中の文字列。
  • 部分文字列：必須​文字列内で検索される部分文字列。
  • START_POSITION: オプション​文字列の検索を開始する場所。
  • 発生件数：オプション​開始位置から検索する発生件数は9件です。 デフォルトの重み付けは 1 です。
instr （INPUT, SUBSTRING, START_POSITION, OCCURRENCE）
instr （“adobe.com”, “com”）
6
replacestr
元の文字列に検索文字列が存在する場合は、その文字列を置き換えます。
  • 入力：必須​入力文字列。
  • TO_FIND: 必須​入力内で検索する文字列。
  • TO_REPLACE: 必須 「TO_FIND」内の値を置き換える文字列。
replacestr （INPUT, TO_FIND, TO_REPLACE）
replacestr(“This is a string re test”, “re”, “replace”)
“This is a string replace test”
substr
指定された長さのサブ文字列を返します。
  • 入力：必須​入力文字列。
  • START_INDEX: 必須 サブストリングが開始する入力文字列のインデックス。
  • LENGTH: Required サブストリングの長さ。
substr （INPUT, START_INDEX, LENGTH）
substr(“This is a substring test”, 7, 8)
“サブセット”
lower /
lcase
文字列を小文字に変換します。
  • INPUT: Required​小文字に変換される文字列。
lower （INPUT）
lower(“HeLLo”)
lcase(“HeLLo”)
“hello”
upper /
ucase
文字列を大文字に変換します。
  • INPUT: 必須​大文字に変換される文字列。
upper （INPUT）
upper(“HeLLo”)
ucase(“HeLLo”)
“HELLO”
split
入力文字列を区切り記号に分割します。 次の区切り記号​ は\でエスケープする必要があります：\。 ​複数の区切り文字を含める場合、文字列は、文字列内に存在する区切り文字のうち​ any ​に分割されます。 注意：​この関数は、区切り記号の有無に関係なく、文字列からnull以外のインデックスのみを返します。 結果の配列にヌルを含むすべてのインデックスが必要な場合は、代わりに「explode」関数を使用します。
  • INPUT: Required​分割する入力文字列。
  • 区切り記号：必須​入力を分割するために使用される文字列。
split （INPUT, SEPARATOR）
split(“Hello world”, " ")
["Hello", "world"]
join
区切り記号を使用してオブジェクトのリストを結合します。
  • 区切り記号：必須 オブジェクトの結合に使用される文字列。
  • オブジェクト : 必須​結合される文字列の配列。
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
“Hello world”
lpad
文字列の左側を他の指定された文字列とパディングします。
  • INPUT: Required パディングされる文字列。 この文字列はnullにできます。
  • COUNT: 必須 パディングする文字列のサイズ。
  • PADDING: Required​入力を入力する文字列。 nullまたは空の場合は、1つのスペースとして扱われます。
lpad （INPUT, COUNT, PADDING）
lpad （“bat”, 8, “yz”）
「イズィバト」
rpad
文字列の右側を他の指定された文字列とパディングします。
  • INPUT: Required パディングされる文字列。 この文字列はnullにできます。
  • COUNT: 必須 パディングする文字列のサイズ。
  • PADDING: Required​入力を入力する文字列。 nullまたは空の場合は、1つのスペースとして扱われます。
rpad （INPUT, COUNT, PADDING）
rpad （“bat”, 8, “yz”）
「バティジジー」
left
指定された文字列の最初の「n」文字を取得します。
  • 文字列：必須​の最初の「n」文字を取得する文字列。
  • COUNT: 必須​文字列から取得する「n」文字。
left （STRING, COUNT）
left （“abcde”, 2）
「ab」
はい
指定された文字列の最後の「n」文字を取得します。
  • 文字列：必須​の最後の「n」文字を取得する文字列。
  • COUNT: 必須​文字列から取得する「n」文字。
right （STRING, COUNT）
right （“abcde”, 2）
「de」
ltrim
文字列の先頭から空白を削除します。
  • 文字列：必須​空白を削除する文字列。
ltrim （STRING）
ltrim （" hello"）
“hello”
rtrim
文字列の末尾から空白を削除します。
  • 文字列：必須​空白を削除する文字列。
rtrim （STRING）
rtrim （"hello "）
“hello”
trim
文字列の先頭と末尾から空白を削除します。
  • 文字列：必須​空白を削除する文字列。
trim （STRING）
trim （" hello "）
“hello”
次と等しい
2つの文字列を比較して、それらが等しいかどうかを確認します。 この関数では、大文字と小文字が区別されます。
  • STRING1: 必須​最初の文字列を比較します。
  • STRING2: 必須​比較する2番目の文字列。
STRING1.​equals （​STRING2）
“string1”.​equals​（“STRING1”）
false
equalsIgnoreCase
2つの文字列を比較して、それらが等しいかどうかを確認します。 この関数は、大文字と小文字を区別して​ not ​です。
  • STRING1: 必須​最初の文字列を比較します。
  • STRING2: 必須​比較する2番目の文字列。
STRING1.​equalsIgnoreCase​（STRING2）
“string1”.​equalsIgnoreCase​（"STRING1）
true

正規表現関数

関数
説明
パラメーター
構文
式
サンプル出力
extract_regex
正規表現に基づいて、入力文字列からグループを抽出します。
  • STRING: Required グループを抽出する文字列。
  • REGEX: 必須 グループを一致させる正規表現。
extract_regex （STRING, REGEX）
extract_regex​（“E259,E259B_009,1_1”,​"（[,]+）,[,]*,（[^,]+）"）
[“E259,E259B_009,1_1”, “E259”, “1_1”]
matches_regex
文字列が入力された正規表現と一致するかどうかを確認します。
  • STRING: 必須 チェックする文字列は、正規表現と一致します。
  • REGEX: 必須​比較対象の正規表現。
matches_regex （STRING, REGEX）
matches_regex （“E259,E259B_009,1_1”, “（[,]+）,[,]*,（[^,]+）”）
true

ハッシュ関数 hashing

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
sha1
入力を受け取り、Secure Hash Algorithm 1 （SHA-1）を使用してハッシュ値を生成します。
  • 入力：必須 ハッシュ化するプレーンテキスト。
  • CHARSET: オプション​文字セットの名前。 使用可能な値には、UTF-8、UTF-16、ISO-8859-1、US-ASCIIなどがあります。
sha1 （INPUT, CHARSET）
sha1 （“my text”, “UTF-8”）
c3599c11e47719df18a24​48690840c5dfcce3c80
sha256
入力を受け取り、Secure Hash Algorithm 256 （SHA-256）を使用してハッシュ値を生成します。
  • 入力：必須 ハッシュ化するプレーンテキスト。
  • CHARSET: オプション​文字セットの名前。 使用可能な値には、UTF-8、UTF-16、ISO-8859-1、US-ASCIIなどがあります。
sha256 （INPUT, CHARSET）
sha256 （“my text”, “UTF-8”）
7330d2b39ca35eaf4cb95fc846c21​ee6a39af698154a83a586ee270a0d372104
sha512
入力を受け取り、セキュアハッシュアルゴリズム 512 （SHA-512）を使用してハッシュ値を生成します。
  • 入力：必須 ハッシュ化するプレーンテキスト。
  • CHARSET: オプション​文字セットの名前。 使用可能な値には、UTF-8、UTF-16、ISO-8859-1、US-ASCIIなどがあります。
sha512 （INPUT, CHARSET）
sha512 （“my text”, “UTF-8”）
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef​708bf11b4232bb21d2a8704ada2cdcd7b367dd0788a89​a5c908cfe377b1072a7b38 7d4fd2ff68a8fd24d16
md5
入力を受け取り、MD5を使用してハッシュ値を生成します。
  • 入力：必須 ハッシュ化するプレーンテキスト。
  • CHARSET: オプション​文字セットの名前。 使用可能な値には、UTF-8、UTF-16、ISO-8859-1、US-ASCIIなどがあります。
md5 （INPUT, CHARSET）
md5 （“my text”, “UTF-8”）
d3b96ce8c9fb4​e9bd0198d03ba6852c7
crc32
入力を取得するには、巡回冗長検査（CRC）アルゴリズムを使用して32 ビットの巡回コードを生成します。
  • 入力：必須 ハッシュ化するプレーンテキスト。
  • CHARSET: オプション​文字セットの名前。 使用可能な値には、UTF-8、UTF-16、ISO-8859-1、US-ASCIIなどがあります。
crc32 （INPUT, CHARSET）
crc32 （“my text”, “UTF-8”）
8df92e80

URL 関数 url

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
get_url_protocol
指定されたURLからプロトコルを返します。 入力が無効な場合は、nullを返します。
  • URL: 必須 プロトコルを抽出する必要があるURL。
get_url_protocol​（URL）
get_url_protocol （“.adobe.com/home”）
https
get_url_host
指定されたURLのホストを返します。 入力が無効な場合は、nullを返します。
  • URL: 必須 ホストを抽出する必要があるURL。
get_url_host​（URL）
get_url_host​（“https://platform​.adobe.com/home”）
platform.adobe.com
get_url_port
指定されたURLのポートを返します。 入力が無効な場合は、nullを返します。
  • URL: 必須 ポートを抽出する必要があるURL。
get_url_port （URL）
get_url_port​（“sftp://example.com//home/​joe/employee.csv”）
22
get_url_path
指定されたURLのパスを返します。 デフォルトでは、フルパスが返されます。
  • URL: 必須 パスを抽出する必要があるURL。
  • FULL_PATH: オプション​完全なパスが返されるかどうかを決定するブール値。 falseに設定すると、パスの最後のみが返されます。
get_url_path​（URL, FULL_PATH）
get_url_path​（“sftp://example.com//​home/joe/employee.csv”）
“//home/joe/​employee.csv”
get_url_query_str
特定のURLのクエリ文字列を、クエリ文字列名とクエリ文字列値のマップとして返します。
  • URL: 必須 クエリ文字列を取得しようとしているURL。
  • アンカー：必須 クエリ文字列内のアンカーで何が行われるかを決定します。 「retain」、「remove」、または「append」の3つの値のいずれかを指定できます。

    値が「retain」の場合、アンカーは返された値に添付されます。
    値が「remove」の場合、アンカーは返された値から削除されます。
    値が「append」の場合、アンカーは別の値として返されます。
get_url_query_str​（URL, ANCHOR）
get_url_query_str​（“foo://example.com:8042​/over/there?name=​ferret#nose”, “retain”）
get_url_query_str​（“foo://example.com:8042​/over/there?name=​ferret#nose”, “remove”）
get_url_query_str​ ​ ​（“foo://example.com:8042/over/thereとします？name=ferret#nose”, “append”）
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
この関数は、URLを入力として受け取り、特殊文字をASCII文字に置き換えるかエンコードします。 特殊文字について詳しくは、このドキュメントの付録の特殊文字リスト ​を参照してください。
  • URL: 必須​入力URLは、ASCII文字で置き換えたり、エンコードしたりする特殊文字を含みます。
get_url_encoded （URL）
get_url_encoded （“https://example.com/partneralliance_asia-pacific_2022”）
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022
get_url_decoded
この関数は、URLを入力として受け取り、ASCII文字を特殊文字にデコードします。 特殊文字について詳しくは、このドキュメントの付録の特殊文字リスト ​を参照してください。
  • URL: 必須 ASCII文字を使用して特殊文字にデコードする入力URL。
get_url_decoded （URL）
get_url_decoded （“https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022”）
https://example.com/partneralliance_asia-pacific_2022

日付および時間関数 date-and-time

NOTE
表の全内容を表示するには、左右にスクロールしてください。 date関数の詳細については、​ データ形式処理ガイド ​の日付セクションを参照してください。
関数
説明
パラメーター
構文
式
サンプル出力
now
現在の時刻を取得します。
now()
now()
2021-10-26T10:10:24Z
timestamp
現在の Unix 時間を取得します。
timestamp()
timestamp()
1571850624571
format
指定された形式に従って入力日付をフォーマットします。
  • 日付：必須 ZonedDateTime オブジェクトとして書式設定する入力日。
  • 書式：必須​日付を変更する書式。
format （DATE, FORMAT）
format （2019-10-23T11:24:00+00:00, “yyyy-MM-dd HH:mm:ss”）
2019-10-23 11:24:35
dformat
指定された形式に従ってタイムスタンプを日付文字列に変換します。
  • TIMESTAMP: 必須​書式設定するタイムスタンプ。 ミリ秒単位で記述されます。
  • 書式：必須 タイムスタンプを設定する書式。
dformat （TIMESTAMP, FORMAT）
dformat （1571829875000, “yyyy-MM-dd'T'HH:mm:ss.SSSX”）
2019-10-23T11:24:35.000Z
date
日付文字列をZonedDateTime オブジェクトに変換します（ISO 8601形式）。
  • 日付：必須​日付を表す文字列。
  • FORMAT: 必須 ソース日付の形式を表す文字列。注：​これは、not​が日付文字列を変換する形式を表しています。
  • DEFAULT_DATE: 必須​指定された日付がnullの場合に返されるデフォルトの日付。
date （DATE, FORMAT, DEFAULT_DATE）
date （“2019-10-23 11:24”, “yyyy-MM-dd HH:mm”, now （））
2019-10-23T11:24:00Z
date
日付文字列を ZonedDateTime オブジェクト（ISO 8601 形式）に変換します。
  • 日付：必須​日付を表す文字列。
  • FORMAT: 必須 ソース日付の形式を表す文字列。注：​これは、not​が日付文字列を変換する形式を表しています。
date （DATE, FORMAT）
date （“2019-10-23 11:24”, “yyyy-MM-dd HH:mm”）
2019-10-23T11:24:00Z
date
日付文字列を ZonedDateTime オブジェクト（ISO 8601 形式）に変換します。
  • 日付：必須​日付を表す文字列。
date （DATE）
date （“2019-10-23 11:24”）
「2019-10-23T11:24:00Z」
date_part
日付の一部を取得します。 次のコンポーネント値がサポートされています。

“year”
“yyyy”
“yy”

“quarter”
“qq”
“q”

“month”
“mm”
“m”

“dayofyear”
“dy”
“y”

“day”
“dd”
“d”

“week”
“ww”

“weekday”
“w”
  • コンポーネント : 必須​日付の一部を表す文字列。
  • 日付：必須​日付（標準形式）。
date_part​（COMPONENT, DATE）
date_part （“MM”, date （“2019-10-17 11:55:12”）
10
set_date_part
指定された日付のコンポーネントを置き換えます。 次のコンポーネントが受け入れられます。

“year”
“yyyy”
“yy”

“month”
“mm”
“m”

“day”
“dd”
“d”

“hour”
“hh”

“minute”
“mi”
“n”

“second”
“ss”
“s”
  • コンポーネント : 必須​日付の一部を表す文字列。
  • 値：必須​特定の日付のコンポーネントに設定する値。
  • 日付：必須​日付（標準形式）。
set_date_part​（COMPONENT, VALUE, DATE）
set_date_part （“m”, 4, date （“2016-11-09T11:44:44.797”）
「2016-04-09T11:44:44Z」
make_date_time
パーツから日付を作成します。 この関数は、make_timestampを使用して生成することもできます。
  • 年：必須​年。4桁で書きます。
  • 月：必須​月 許可される値は1 ～ 12です。
  • 日：必須 許可される値は1 ～ 31です。
  • 時間：必要​時間。 許可される値は0 ～ 23です。
  • 分：必須​分。 許可される値は0 ～ 59です。
  • NANOSECOND: 必須 ナノ秒の値。 許可される値は0 ～ 999999999です。
  • TIMEZONE: 必須​日時のタイムゾーン。
make_date_time​（YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, NANOSECOND, TIMEZONE）
make_date_time​（2019, 10, 17, 11, 55, 12, 999, “America/Los_Angeles”）
2019-10-17T11:55:12Z
zone_date_to_utc
任意のタイムゾーンの日付をUTCの日付に変換します。
  • 日付：必須​変換しようとしている日付。
zone_date_to_utc​（DATE）
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
あるタイムゾーンから別のタイムゾーンに日付を変換します。
  • 日付：必須​変換しようとしている日付。
  • ゾーン：必須​日付を変換しようとしているタイムゾーン。
zone_date_to_zone​（DATE, ZONE）
zone_date_to_zone(now(), "Europe/Paris")
2021-10-26T15:43:59Z

階層 – オブジェクト objects

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
is_empty
オブジェクトが空かどうかを確認します。
  • INPUT: Required チェックしようとしているオブジェクトが空です。
is_empty （INPUT）
is_empty([1, null, 2, 3])
false
arrays_to_object
オブジェクトのリストを作成します。
  • 入力：必須 キーと配列のペアのグループ化。
arrays_to_object （INPUT）
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])
[{ "sku": "id1", "price": 22.5 }, { "sku": "id2", "price": 14.35 }]
to_object
指定されたフラットキーと値のペアに基づいてオブジェクトを作成します。
  • 入力：必須 キーと値のペアのフラットリスト。
to_object （INPUT）
to_object​（“firstName”, “John”, “lastName”, “Doe”）
{"firstName": "John", "lastName": "Doe"}
str_to_object
入力文字列からオブジェクトを作成します。
  • 文字列：必須 オブジェクトを作成するために解析される文字列。
  • VALUE_DELIMITER: オプション フィールドと値を区切る区切り文字。 デフォルトの区切り文字は:です。
  • FIELD_DELIMITER: オプション フィールド値のペアを区切る区切り文字。 デフォルトの区切り文字は,です。
str_to_object​（STRING, VALUE_DELIMITER, FIELD_DELIMITER） 注意: get()関数とstr_to_object()を使用して、文字列内のキーの値を取得できます。
  • 例#1: str_to_object （“firstName - John ; lastName - ; - 123 345 7890”, “-”, “;”）
  • 例#2: str_to_object （“firstName - John ; lastName - ; phone - 123 456 7890”, “-”, “;”）.get （“firstName”）
  • 例#1:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • 例#2:「John」
contains_key
ソースデータ内にオブジェクトが存在するかどうかを確認します。 注：​この関数は、非推奨のis_set()関数に置き換わります。
  • INPUT: 必須 ソースデータ内に存在するかどうかを確認するパス。
contains_key （INPUT）
contains_key （“evars.evar.field1”）
true
無効にする
属性値をnullに設定します。 フィールドをターゲットスキーマにコピーしない場合に使用します。 重要: ターゲット XDM スキーマで必須としてマークされている宛先フィールドの戻り値としてnullify()を使用しないでください。 これにより、null値が必須フィールドに書き込まれ、行が拒否されます。 必須フィールドには、null以外のフォールバック値を代わりに使用します。
nullify （）
nullify （）
null
get_keys
キーと値のペアを解析し、すべてのキーを返します。
  • オブジェクト : 必須 キーが抽出されるオブジェクト。
get_keys （OBJECT）
get_keys （{“book1”: “Pride and Prejudice”, “book2”: “1984”}）
["book1", "book2"]
get_values
キーと値のペアを解析し、指定されたキーに基づいて文字列の値を返します。
  • 文字列：必須​解析する文字列。
  • キー：必須​値を抽出するキー。
  • VALUE_DELIMITER: 必須 フィールドと値を区切る区切り文字。 nullまたは空の文字列が指定されている場合、この値は:です。
  • FIELD_DELIMITER: オプション フィールドと値のペアを区切る区切り文字。 nullまたは空の文字列が指定されている場合、この値は,です。
get_values （STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER）
get_values （"firstName - John , lastName - Cena , phone - 555 420 8692", "firstName", "-", ","）
John
map_get_values
マップとキー入力を取得します。 入力が1つのキーの場合、関数はそのキーに関連付けられた値を返します。 入力が文字列配列の場合、関数は指定されたキーに対応するすべての値を返します。 受信マップに重複するキーがある場合、戻り値はキーの重複を解除し、一意の値を返す必要があります。
  • MAP: 必須​入力マップデータ。
  • キー：必須 キーは、単一の文字列または文字列配列にすることができます。 他のプリミティブ型（データ/数値）が指定されている場合、それは文字列として扱われます。
get_values （MAP, KEY）
コードサンプルについては、付録を参照してください。
map_has_keys
1つ以上の入力キーが指定されている場合、関数はtrueを返します。 文字列配列が入力として指定された場合、関数は最初に見つかったキーに対してtrueを返します。
  • MAP: 必須​入力マップデータ
  • キー：必須 キーは、単一の文字列または文字列配列にすることができます。 他のプリミティブ型（データ/数値）が指定されている場合、それは文字列として扱われます。
map_has_keys （MAP, KEY）
コードサンプルについては、付録を参照してください。
add_to_map
少なくとも2つの入力を受け入れます。 任意の数のマップを入力として指定できます。 Data Prepは、すべての入力からのすべてのキーと値のペアを持つ単一のマップを返します。 1つ以上のキーが（同じマップ内またはマップ間で）繰り返される場合、Data Prepはキーの重複を排除して、最初のキーと値のペアが入力で渡された順序で保持されるようにします。
MAP: 必須​入力マップデータ。
add_to_map （MAP 1, MAP 2, MAP 3, …）
コードサンプルについては、付録を参照してください。
object_to_map （構文1）
この関数を使用して、マップデータタイプを作成します。
  • キー：必須 キーは文字列である必要があります。 整数や日付などの他のプリミティブ値が指定されている場合、それらは文字列に自動変換され、文字列として扱われます。
  • ANY_TYPE: 必須 マップ以外でサポートされているXDM データタイプを指します。
object_to_map （KEY, ANY_TYPE, KEY, ANY_TYPE, …）
コードサンプルについては、付録を参照してください。
object_to_map （構文2）
この関数を使用して、マップデータタイプを作成します。
  • オブジェクト : 必須​着信オブジェクトまたはオブジェクト配列を指定し、オブジェクト内の属性をキーとしてポイントできます。
object_to_map （OBJECT）
コードサンプルについては、付録を参照してください。
object_to_map （構文3）
この関数を使用して、マップデータタイプを作成します。
  • オブジェクト : 必須​着信オブジェクトまたはオブジェクト配列を指定し、オブジェクト内の属性をキーとしてポイントできます。
object_to_map （OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY）
コードサンプルについては、付録を参照してください。

オブジェクトコピー機能について詳しくは、以下の節を参照してください。

階層 – 配列 arrays

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
coalesce
指定された配列内の最初のnull以外のオブジェクトを返します。
  • INPUT: 必須​最初のnull以外のオブジェクトを検索する配列。
coalesce （INPUT）
coalesce(null, null, null, “first”, null, “second”)
“first”
first
指定された配列の最初の要素を取得します。
  • INPUT: 必須​最初の要素を検索する配列。
first （INPUT）
first(“1”, “2”, “3”)
“1”
last
指定された配列の最後の要素を取得します。
  • INPUT: 必須​の最後の要素を検索する配列。
last （INPUT）
last(“1”, “2”, “3”)
“3”
add_to_array
配列の末尾に要素を追加します。
  • 配列：必須​要素を追加する配列。
  • 値：配列に追加する要素。
add_to_array​（ARRAY, VALUES）
add_to_array​（[‘a’, ‘b’], ‘c’, ‘d’）
[‘a’, ‘b’, ‘c’, ‘d’]
join_arrays
配列を互いに結合します。
  • 配列：必須​要素を追加する配列。
  • 値：親配列に追加する配列。
join_arrays​（ARRAY, VALUES）
join_arrays​（[‘a’, ‘b’], [‘c’], [‘d’, ‘e’]）
[‘a’, ‘b’, ‘c’, ‘d’, ‘e’]
to_array
入力のリストを取得し、それを配列に変換します。
  • INCLUDE_NULLS: 必須​応答配列にNULLSを含めるかどうかを示すブール値。
  • 値：必須​配列に変換する要素。
to_array​（INCLUDE_NULLS, VALUES）
to_array （false, 1, null, 2, 3）
[1, 2, 3]
size_of
入力のサイズを返します。
  • INPUT: Required サイズを検索しようとしているオブジェクト。
size_of （INPUT）
size_of([1, 2, 3, 4])
4
upsert_array_append
この関数は、入力配列全体のすべての要素をProfileの配列の最後に追加するために使用されます。 この関数は、更新中に​ のみ ​適用できます。 挿入のコンテキストで使用する場合、この関数はそのまま入力を返します。
  • 配列：必須 プロファイルに配列を追加する配列。
upsert_array_append （ARRAY）
upsert_array_append([123, 456])
[123, 456]
upsert_array_replace
この関数は、配列内の要素を置き換えるために使用されます。 この関数は、更新中に​ のみ ​適用できます。 挿入のコンテキストで使用する場合、この関数はそのまま入力を返します。
  • 配列：必須 プロファイル内の配列を置き換える配列。
upsert_array_replace （ARRAY）
upsert_array_replace([123, 456], 1)
[123, 456]
[宛先のみ]{class="badge informative"} array_to_string
指定した区切り記号を使用して、配列内の要素の文字列表現を結合します。 配列が多次元の場合、結合される前にフラット化されます。 メモ：この関数は宛先で使用されます。 詳しくは、​ ドキュメント ​を参照してください。
  • 区切り記号：必須​配列内の要素の結合に使用する区切り記号。
  • 配列：必須​結合する配列（フラット化後）。
array_to_string （SEPARATOR, ARRAY）
array_to_string(";", ["Hello", "world"])
「Hello;world」
[宛先のみ]{class="badge informative"} filterArray*
述語に基づいて、指定された配列をフィルタリングします。 メモ：この関数は宛先で使用されます。 詳しくは、​ ドキュメント ​を参照してください。
  • 配列：必須 フィルターする配列
  • 述語：必須​指定された配列の各要素に適用される述語。
filterArray （ARRAY, PREDICATE）
filterArray([5, -6, 0, 7], x -> x > 0)
[5, 7]
[宛先のみ]{class="badge informative"} transformArray*
述語に基づいて、指定された配列を変換します。 メモ：この関数は宛先で使用されます。 詳しくは、​ ドキュメント ​を参照してください。
  • 配列：必須​変換する配列。
  • 述語：必須​指定された配列の各要素に適用される述語。
transformArray （ARRAY, PREDICATE）
transformArray([5, 6, 7], x -> x + 1)
[6, 7, 8]
[宛先のみ]{class="badge informative"} flattenArray*
指定された（多次元）配列を一次元配列にフラット化します。 メモ：この関数は宛先で使用されます。 詳しくは、​ ドキュメント ​を参照してください。
  • 配列：必須 フラット化する配列。
flattenArray （ARRAY）
flattenArray （[[‘a’, ‘b’], [‘c’, ‘d’]], [[‘e’], [‘f’]]]）
[‘a’, ‘b’, ‘c’, ‘d’, ‘e’, ‘f’]

階層 – マップ map

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
array_to_map
この関数は、オブジェクト配列とキーを入力として受け取り、値をキー、配列要素を値としてキーのフィールドのマップを返します。
  • INPUT: 必須​最初のnull以外のオブジェクトを検索するオブジェクト配列。
  • KEY: 必須 キーは、オブジェクト配列のフィールド名で、値としてオブジェクトである必要があります。
array_to_map （OBJECT[] INPUTS, KEY）
コードサンプルについては、付録を参照してください。
object_to_map
この関数は、オブジェクトを引数として取り、キーと値のペアのマップを返します。
  • INPUT: 必須​最初のnull以外のオブジェクトを検索するオブジェクト配列。
object_to_map （OBJECT_INPUT）
"object_to_map （address） where input is " + “address: {line1 : "345 park ave",line2: "bldg 2",City : "san jose",State : "CA",type: "office"}”
指定されたフィールド名と値のペアを持つマップを返します。入力がnullの場合はnullを返します。 例："{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
この関数は、キーと値のペアのリストを取得し、キーと値のペアのマップを返します。
to_map （OBJECT_INPUT）
“to_map （"firstName", "John", "lastName", "Doe"）”
指定されたフィールド名と値のペアを持つマップを返します。入力がnullの場合はnullを返します。 例："{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

論理演算子 logical-operators

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
decode
キーと、配列としてフラット化されたキーと値のペアのリストが指定されると、この関数は、キーが見つかった場合はその値を返し、配列内にデフォルト値が存在する場合はそのデフォルト値を返します。
  • キー：必須​一致するキー。
  • OPTIONS: 必須 キーと値のペアのフラット化された配列。 オプションで、デフォルト値を最後に設定できます。
decode （KEY, OPTIONS）
decode （stateCode, “ca”, “California”, “pa”, “Pennsylvania”, “N/A”）
指定されたstateCodeが「ca」、「California」の場合。
指定されたstateCodeが「pa」の場合、「Pennsylvania」です。
stateCodeが次の「N/A」と一致しない場合。
iif
指定されたブール式を評価し、結果に基づいて指定された値を返します。
  • 式：必須​評価中のブール式。
  • TRUE_VALUE: 必須​式がtrueと評価された場合に返される値。
  • FALSE_VALUE: 必須​式がfalseと評価された場合に返される値。
iif （EXPRESSION, TRUE_VALUE, FALSE_VALUE）
iif(“s”.equalsIgnoreCase(“S”), “True”, “False”)
“True”

集計 aggregation

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
min
指定された引数の最小値を返します。 自然な順序を使用します。
  • OPTIONS: 必須​互いに比較できる1つ以上のオブジェクト。
min （OPTIONS）
min(3, 1, 4)
1
max
指定された引数の最大値を返します。 自然な順序を使用します。
  • OPTIONS: 必須​互いに比較できる1つ以上のオブジェクト。
max （OPTIONS）
max(3, 1, 4)
4

文字コンバージョン type-conversions

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
to_bigint
文字列をBigIntegerに変換します。
  • STRING: Required BigIntegerに変換する文字列。
to_bigint （STRING）
to_bigint​（“1000000.34”）
1000000.34
to_decimal
文字列をDoubleに変換します。
  • STRING: Required Doubleに変換する文字列。
to_decimal （STRING）
to_decimal （“20.5”）
20.5
to_float
文字列を浮動小数点に変換します。
  • STRING: Required​浮動小数点に変換する文字列。
to_float （STRING）
to_float （“12.3456”）
12.34566
to_integer
文字列を整数に変換します。
  • STRING: Required​整数に変換する文字列。
to_integer （STRING）
to_integer （“12”）
12

JSON関数 json

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
json_to_object
指定された文字列からJSON コンテンツをデシリアライズします。
  • 文字列：必須 シリアル化解除するJSON文字列。
json_to_object​（STRING）
json_to_object​({"info":{"firstName":"John","lastName": "Doe"}})
JSONを表すオブジェクト。

特殊作戦 special-operations

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
uuid /
guid
擬似ランダム ID を生成します。
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
この関数は、FPID文字列を取り出してECIDに変換し、Adobe Experience PlatformおよびAdobe Experience Cloud アプリケーションで使用します。
  • 文字列：必須 ECIDに変換するFPID文字列。
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

ユーザーエージェント関数 user-agent

次の表に含まれるユーザーエージェント関数は、次のいずれかの値を返すことができます。

  • 電話 – 小さな画面（通常は7 インチ未満）を備えたモバイルデバイス
  • モバイル – まだ識別されていないモバイルデバイス。 このモバイルデバイスは、eReader、タブレット、携帯電話、腕時計などであり得る。

デバイスフィールド値について詳しくは、このドキュメントの付録の「​ デバイスフィールド値のリスト ​」を参照してください。

NOTE
表の全内容を表示するには、左右にスクロールしてください。
関数
説明
パラメーター
構文
式
サンプル出力
ua_os_name
ユーザーエージェント文字列からオペレーティングシステム名を抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_os_name​（USER_AGENT）
ua_os_name​（“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
iOS
ua_os_version_major
ユーザーエージェント文字列からオペレーティングシステムのメジャーバージョンを抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_os_version_major​（USER_AGENT）
ua_os_version_major​s （“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
IOS 5
ua_os_version
ユーザーエージェント文字列からオペレーティングシステムのバージョンを抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_os_version​（USER_AGENT）
ua_os_version​（“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
5.1.1
ua_os_name_version
ユーザーエージェント文字列からオペレーティングシステムの名前とバージョンを抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_os_name_version​（USER_AGENT）
ua_os_name_version​（“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
iOS 5.1.1
ua_agent_version
ユーザーエージェント文字列からエージェントバージョンを抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_agent_version​（USER_AGENT）
ua_agent_version​（“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
5.1
ua_agent_version_major
ユーザーエージェント文字列からエージェント名とメジャーバージョンを抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_agent_version_major​（USER_AGENT）
ua_agent_version_major​（“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
Safari 5
ua_agent_name
ユーザーエージェント文字列からエージェント名を抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_agent_name​（USER_AGENT）
ua_agent_name​（“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
Safari
ua_device_class
ユーザーエージェント文字列からデバイスクラスを抽出します。
  • USER_AGENT: 必須 ユーザーエージェント文字列。
ua_device_class​（USER_AGENT）
ua_device_class​（“Mozilla/5.0 （iPhone; CPU iPhone OS 5_1_1 like Mac OS X） AppleWebKit/534.46 （KHTML, like Gecko） Version/5.1 Mobile/9B206 Safari/7534.48.3”）
Phone

Analytics関数 analytics

NOTE
WebSDKおよびAdobe Analytics フローに対してのみ、次の分析関数を使用できます。
関数
説明
パラメーター
構文
式
サンプル出力
aa_get_event_id
Analytics イベント文字列からイベント IDを抽出します。
  • EVENT_STRING: 必須 コンマ区切りのAnalytics イベント文字列。
  • EVENT_NAME: 必須​抽出してIDを指定するイベント名。
aa_get_event_id （EVENT_STRING, EVENT_NAME）
aa_get_event_id （“event101=5:123456,scOpen”, “event101”）
123456
aa_get_event_value
Analytics イベント文字列からイベント値を抽出します。 イベント値が指定されていない場合は、1が返されます。
  • EVENT_STRING: 必須 コンマ区切りのAnalytics イベント文字列。
  • EVENT_NAME: 必須​値を抽出するイベント名。
aa_get_event_value （EVENT_STRING, EVENT_NAME）
aa_get_event_value （“event101=5:123456,scOpen”, “event101”）
5
aa_get_product_categories
Analytics製品文字列から製品カテゴリを抽出します。
  • PRODUCTS_STRING: 必須 Analytics製品の文字列。
aa_get_product_categories （PRODUCTS_STRING）
aa_get_product_categories （“；製品の例1;1;3.50，カテゴリの例2；製品の例2;1;5.99”）
[null,“カテゴリ 2の例”]
aa_get_product_names
Analytics製品文字列から製品名を抽出します。
  • PRODUCTS_STRING: 必須 Analytics製品の文字列。
aa_get_product_names （PRODUCTS_STRING）
aa_get_product_names （“；製品の例1;1;3.50，カテゴリの例2；製品の例2;1;5.99”）
[“製品の例1”,“製品の例2”]
aa_get_product_quantities
Analytics製品文字列から数量を抽出します。
  • PRODUCTS_STRING: 必須 Analytics製品の文字列。
aa_get_product_quantities （PRODUCTS_STRING）
aa_get_product_quantities （“；製品の例1;1;3.50，カテゴリの例2；製品の例2”）
[“1”, null]
aa_get_product_prices
Analytics製品文字列から価格を抽出します。
  • PRODUCTS_STRING: 必須 Analytics製品の文字列。
aa_get_product_prices （PRODUCTS_STRING）
aa_get_product_prices （“；製品の例1;1;3.50，カテゴリの例2；製品の例2”）
[“3.50”, null]
aa_get_product_event_values
製品文字列から名前付きイベントの値を文字列の配列として抽出します。
  • PRODUCTS_STRING: 必須 Analytics製品の文字列。
  • EVENT_NAME: 必須​値を抽出するイベント名。
aa_get_product_event_values （PRODUCTS_STRING, EVENT_NAME）
aa_get_product_event_values （";Example product 1;1;4.20;event1=2.3
event2=5:1,Example product 2;1;4.20;event1=3
aa_get_product_evars
products文字列から名前付きイベントのevar値を文字列の配列として抽出します。
  • PRODUCTS_STRING: 必須 Analytics製品の文字列。
  • EVAR_NAME: 必須​抽出するeVar名。
aa_get_product_evars （PRODUCTS_STRING, EVENT_NAME）
aa_get_product_evars （“;Example product;1;6.69;;eVar1=Merchandising value”, “eVar1”）
[“マーチャンダイジング値”]

オブジェクトコピー object-copy

TIP
オブジェクトのコピー機能は、ソース内のオブジェクトがXDM内のオブジェクトにマッピングされたときに自動的に適用されます。 ユーザーからの追加のアクションは必要ありません。

オブジェクトのコピー機能を使用すると、マッピングに変更を加えずにオブジェクトの属性を自動的にコピーできます。 例えば、ソースデータの構造が次の場合です。

address{
        line1: 4191 Ridgebrook Way,
        city: San Jose,
        state: California
        }

次のXDM構造を使用します。

addr{
    addrLine1: 4191 Ridgebrook Way,
    city: San Jose,
    state: California
    }

次に、マッピングは次のようになります。

address -> addr
address.line1 -> addr.addrLine1

上記の例では、address オブジェクトがaddrにマッピングされているため、city属性とstate属性も実行時に自動的に取り込まれます。 XDM構造にline2属性を作成し、入力データにaddress オブジェクトにline2も含まれている場合、マッピングを手動で変更することなく自動的に取り込まれます。

自動マッピングを確実に機能させるには、次の前提条件を満たす必要があります。

  • 親レベルのオブジェクトはマッピングする必要があります。
  • XDM スキーマに新しい属性が作成されている必要があります。
  • 新しい属性には、ソーススキーマとXDM スキーマで一致する名前が必要です。

いずれかの前提条件が満たされない場合は、データ準備を使用してソーススキーマをXDM スキーマに手動でマッピングする必要があります。

付録

次に、データ準備マッピング関数の使用に関する追加情報を示します

特殊文字 special-characters

次の表は、予約済み文字とそれに対応するエンコードされた文字のリストの概要を示しています。

予約済み文字
エンコードされた文字
space
%20
!
%21
"
%22
#
%23
$
%24
%
%25
&
%26
’
%27
(
%28
）
%29
*
%2A
+
%2B
,
%2C
/
%2F
：
%3A
%3B
<
%3C
=
%3D
>
%3E
?
%3F
@
%40
[
%5B
|
%5C
]
%5D
^
%5E
’
%60
~
%7E

デバイスフィールド値 device-field-values

次の表は、デバイスフィールド値のリストとそれに対応する説明の概要を示しています。

デバイス
説明
Desktop
デスクトップまたはラップトップタイプのデバイス。
匿名化
匿名のデバイス。 場合によっては、これらは匿名化ソフトウェアによって変更されたuseragentsです。
不明
不明なデバイス。 これらは通常useragentsで、デバイスに関する情報が含まれていません。
Mobile
まだ特定されていないモバイルデバイス。 このモバイルデバイスは、eReader、タブレット、携帯電話、腕時計などであり得る。
タブレット
画面が大きい（通常は7 インチを超える）モバイルデバイス。
Phone
小さい画面（通常は7 インチ未満）のモバイルデバイス。
所要時間
小さな画面（通常は2 インチ未満）を備えたモバイルデバイス。 これらのデバイスは、通常、電話/タブレット型デバイスの追加画面として機能します。
拡張現実
AR機能を備えたモバイルデバイス。
バーチャルリアリティ
VR機能を備えたモバイルデバイス。
eReader
タブレットに似たデバイスですが、通常はeInk画面が表示されます。
セットトップボックス
TV サイズの画面を通じたインタラクションを可能にするコネクテッドデバイス。
TV
セットトップボックスに似ていますが、テレビに組み込まれています。
家電製品
冷蔵庫のような（通常は大きな）家電製品。
ゲームコンソール
PlaystationやXBoxのような固定ゲームシステム。
ハンドヘルドゲーム機
Nintendo Switchのようなモバイルゲームシステム。
音声
Amazon AlexaやGoogle Homeなどの音声駆動型デバイス。
車
車両ベースのブラウザー。
Robot
Web サイトを訪問するロボット。
Robot Mobile
web サイトにアクセスしたが、モバイル訪問者とみなされることを示すロボット。
ロボットイミテータ
GoogleのようなロボットであるふりをしてWeb サイトを訪問するロボットですが、そうではありません。 注意：ほとんどの場合、ロボット模倣者は実際にはロボットです。
クラウド
クラウドベースのアプリケーション。 これらはロボットでもハッカーでもありませんが、接続が必要なアプリケーションです。 これにはMastodon サーバーが含まれます。
ハッカー
このデバイス値は、useragent文字列でスクリプトが検出された場合に使用されます。

コードサンプル code-samples

map_get_values map-get-values

選択してサンプルを表示
code language-json 
 example = "map_get_values(book_details,\"author\") where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "{\"author\": \"George R. R. Martin\"}"

map_has_keys map_has_keys

選択してサンプルを表示
code language-json 
 example = "map_has_keys(book_details,\"author\")where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "true"

add_to_map add_to_map

選択してサンプルを表示
code language-json 
example = "add_to_map(book_details, book_details2) where input is {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}" +
        "{\n" +
        "    \"book_details2\":\n" +
        "    {\n" +
        "        \"author\": \"Neil Gaiman\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-0-380-97365-0\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      result = "{\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      returns = "A new map with all elements from map and addends"

object_to_map object_to_map

構文1

選択してサンプルを表示
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

構文2

選択してサンプルを表示
code language-json 
example = "object_to_map(address) where input is " +
  "address: {line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}",
result = "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"

構文3

選択してサンプルを表示
code language-json 
example = "object_to_map(addresses,type)" +
        "\n" +
        "[\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "]" ,
result = "{\n" +
        "    \"home\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    \"work\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    \"office\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "}"

array_to_map array_to_map

選択してサンプルを表示
code language-json 
example = "array_to_map(addresses, \"type\") where addresses is\n" +
  "\n" +
  "[\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "]" ,
result = "{\n" +
  "    \"home\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    \"work\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    \"office\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "}",
returns = "Returns a map with given field name and value pairs or null if input is null"
recommendation-more-help
experience-platform-help-data-prep