Data Prep mapping functions
Data Prep functions can be used to compute and calculate values based on what is entered in source fields.
Fields
A field name can be any legal identifier - an unlimited-length sequence of Unicode letters and digits, beginning with a letter, the dollar sign ($), or the underscore character (_). Variable names are also case sensitive.
If a field name does not follow this convention, the field name must be wrapped with ${}. So, for example, if the field name is “First Name” or “First.Name”, then the name must be wrapped like ${First Name} or ${First\.Name} respectively.
.), you must use a backslash (\) to escape special characters. For more information, read the guide on escaping special characters.If a field name is any of the following reserved keywords, it must be wrapped with ${}{}:
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
Additionally, reserved keywords also include any of the mapper functions listed on this page.
Data within sub-fields can be accessed by using the dot notation. For example, if there was a name object, to access the firstName field, use name.firstName.
List of functions
The following tables list all supported mapping functions, including sample expressions and their resulting outputs.
String functions string
- STRING: The strings that will be concatenated.
"Hi, there!"\: +, ?, ^, |, ., [, (, {, ), *, $, \ If you include multiple characters as the delimiter, the delimiter will be treated as a multi-character delimiter.- STRING: Required The string that needs to be split.
- REGEX: Optional The regular expression that can be used to split the string.
["Hi,", "there"]- INPUT: Required The string that is being searched.
- SUBSTRING: Required The substring that is being searched for within the string.
- START_POSITION: Optional The location of where to start looking in the string.
- OCCURRENCE: Optional The nth occurrence to look for from the start position. By default, it is 1.
- INPUT: Required The input string.
- TO_FIND: Required The string to look up within the input.
- TO_REPLACE: Required The string that will replace the value within “TO_FIND”.
- INPUT: Required The input string.
- START_INDEX: Required The index of the input string where the substring starts.
- LENGTH: Required The length of the substring.
lcase
- INPUT: Required The string that will be converted to lowercase.
lcase(“HeLLo”)
ucase
- INPUT: Required The string that will be converted to uppercase.
ucase(“HeLLo”)
\: \. If you include multiple delimiters, the string will split on any of the delimiters present in the string. Note: This function only returns non-null indexes from the string, regardless of the presence of the separator. If all indexes, including nulls, are required in the resulting array, use the “explode” function instead.- INPUT: Required The input string that is going to be split.
- SEPARATOR: Required The string that is used to split the input.
["Hello", "world"]- SEPARATOR: Required The string that will be used to join the objects.
- OBJECTS: Required An array of strings that will be joined.
join(SEPARATOR, [OBJECTS])join(" ", to_array(true, "Hello", "world"))- INPUT: Required The string that is going to be padded out. This string can be null.
- COUNT: Required The size of the string to be padded out.
- PADDING: Required The string to pad the input with. If null or empty, it will be treated as a single space.
- INPUT: Required The string that is going to be padded out. This string can be null.
- COUNT: Required The size of the string to be padded out.
- PADDING: Required The string to pad the input with. If null or empty, it will be treated as a single space.
- STRING: Required The string you are getting the first “n” characters for.
- COUNT: RequiredThe “n” characters you want to get from the string.
- STRING: Required The string you are getting the last “n” characters for.
- COUNT: RequiredThe “n” characters you want to get from the string.
- STRING: Required The string you want to remove the whitespace from.
- STRING: Required The string you want to remove the whitespace from.
- STRING: Required The string you want to remove the whitespace from.
- STRING1: Required The first string you want to compare.
- STRING2: Required The second string you want to compare.
- STRING1: Required The first string you want to compare.
- STRING2: Required The second string you want to compare.
Regular expression functions
- STRING: Required The string that you are extracting the groups from.
- REGEX: Required The regular expression that you want the group to match.
- STRING: Required The string that you are checking matches the regular expression.
- REGEX: Required The regular expression that you are comparing against.
Hashing functions hashing
- INPUT: Required The plain text to be hashed.
- CHARSET: Optional The name of the character set. Possible values include UTF-8, UTF-16, ISO-8859-1, and US-ASCII.
- INPUT: Required The plain text to be hashed.
- CHARSET: Optional The name of the character set. Possible values include UTF-8, UTF-16, ISO-8859-1, and US-ASCII.
- INPUT: Required The plain text to be hashed.
- CHARSET: Optional The name of the character set. Possible values include UTF-8, UTF-16, ISO-8859-1, and US-ASCII.
- INPUT: Required The plain text to be hashed.
- CHARSET: Optional The name of the character set. Possible values include UTF-8, UTF-16, ISO-8859-1, and US-ASCII.
- INPUT: Required The plain text to be hashed.
- CHARSET: Optional The name of the character set. Possible values include UTF-8, UTF-16, ISO-8859-1, and US-ASCII.
URL functions url
- URL: Required The URL from which the protocol needs to be extracted.
- URL: Required The URL from which the host needs to be extracted.
- URL: Required The URL from which the port needs to be extracted.
- URL: Required The URL from which the path needs to be extracted.
- FULL_PATH: Optional A boolean value that determines if the full path is returned. If set to false, only the end of the path is returned.
- URL: Required The URL that you are trying to get the query string from.
- ANCHOR: Required Determines what will be done with the anchor in the query string. Can be one of three values: “retain”, “remove”, or “append”.
If the value is “retain”, the anchor will be attached to the returned value.
If the value is “remove”, the anchor will be removed from the returned value.
If the value is “append”, the anchor will be returned as a separate value.
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"}- URL: Required The input URL with special characters that you want to replace or encode with ASCII characters.
- URL: Required The input URL with ASCII characters that you want to decode into special characters.
Date and time functions date-and-time
date function can be found in the dates section of the data format handling guide.2021-10-26T10:10:24Z- DATE: Required The input date, as a ZonedDateTime object, that you want to format.
- FORMAT: Required The format that you want the date to be changed to.
yyyy-MM-dd HH:mm:ss”)2019-10-23 11:24:35- TIMESTAMP: Required The timestamp you want to format. This is written in milliseconds.
- FORMAT: Required The format that you want the timestamp to become.
yyyy-MM-dd'T'HH:mm:ss.SSSX”)2019-10-23T11:24:35.000Z- DATE: Required The string that represents the date.
- FORMAT: Required The string representing the format of the source date.Note: This does not represent the format you want to convert the date string into.
- DEFAULT_DATE: Required The default date returned, if the date provided is null.
2019-10-23T11:24:00Z- DATE: Required The string that represents the date.
- FORMAT: Required The string representing the format of the source date.Note: This does not represent the format you want to convert the date string into.
2019-10-23T11:24:00Z- DATE: Required The string that represents the date.
“year”
“yyyy”
“yy”
“quarter”
“qq”
“q”
“month”
“mm”
“m”
“dayofyear”
“dy”
“y”
“day”
“dd”
“d”
“week”
“ww”
“w”
“weekday”
“dw”
“w”
“hour”
“hh”
“hh24”
“hh12”
“minute”
“mi”
“n”
“second”
“ss”
“s”
“millisecond”
“SSS”
- COMPONENT: Required A string representing the part of the date.
- DATE: Required The date, in a standard format.
“year”
“yyyy”
“yy”
“month”
“mm”
“m”
“day”
“dd”
“d”
“hour”
“hh”
“minute”
“mi”
“n”
“second”
“ss”
“s”
- COMPONENT: Required A string representing the part of the date.
- VALUE: Required The value to set for the component for a given date.
- DATE: Required The date, in a standard format.
- YEAR: Required The year, written in four digits.
- MONTH: Required The month. The allowed values are 1 to 12.
- DAY: Required The day. The allowed values are 1 to 31.
- HOUR: Required The hour. The allowed values are 0 to 23.
- MINUTE: Required The minute. The allowed values are 0 to 59.
- NANOSECOND: Required The nanosecond values. The allowed values are 0 to 999999999.
- TIMEZONE: Required The timezone for the date time.
2019-10-17T11:55:12Z- DATE: Required The date that you are trying to convert.
zone_date_to_utc(2019-10-17T11:55:12 PST2019-10-17T19:55:12Z- DATE: Required The date that you are trying to convert.
- ZONE: Required The timezone that you are trying to convert the date to.
zone_date_to_zone(now(), "Europe/Paris")2021-10-26T15:43:59ZHierarchies - Objects objects
- INPUT: Required The object that you’re trying to check is empty.
is_empty([1, null, 2, 3])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])| code language-[ |
|---|
|
- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])- INPUT: Required A grouping of key and array pairs.
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])
and an XDM structure of:
```json
addr{
addrLine1: 4191 Ridgebrook Way,
city: San Jose,
state: California
}
Then the mapping becomes:
address -> addr
address.line1 -> addr.addrLine1
In the example above, the city and state attributes are also ingested automatically at runtime because the address object is mapped to addr. If you were to create a line2 attribute in the XDM structure and your input data also contains a line2 in the address object, then it will also be automatically ingested without any need to manually alter the mapping.
To ensure that the automatic mapping works, the following prerequisites must be met:
- Parent-level objects should be mapped;
- New attributes must have been created in the XDM schema;
- New attributes should have matching names in the source schema and the XDM schema.
If any of the prerequisites are not met, then you must manually map the source schema to the XDM schema using data prep.
Appendix
The following provides additional information on using Data Prep mapping functions
Special characters special-characters
The table below outlines a list of reserved characters and their corresponding encoded characters.
Device field values device-field-values
The table below outlines a list of device field values and their corresponding descriptions.
useragents that have been altered by an anonymization software.useragents that contain no information about the device.useragent string.Code samples code-samples
map_get_values map-get-values
| code language-json |
|---|
|
map_has_keys map_has_keys
| code language-json |
|---|
|
add_to_map add_to_map
| code language-json |
|---|
|
object_to_map object_to_map
Syntax 1
| code language-json |
|---|
|
Syntax 2
| code language-json |
|---|
|
Syntax 3
| code language-json |
|---|
|
array_to_map array_to_map
| code language-json |
|---|
|