DocumentatieExperience PlatformHandleiding Data Prep

Toewijzingsfuncties van Data Prep

Last update: Tue Mar 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar

De functies van de Prep van gegevens kunnen worden gebruikt om waarden te berekenen en te berekenen die op wat in brongebieden zijn ingegaan.

Velden

Een veldnaam kan elke geldige id zijn: een reeks van Unicode-letters en -cijfers met een onbeperkte lengte, te beginnen met een letter, het dollarteken ($), of het onderstrepingsteken (_). De namen van variabelen zijn ook hoofdlettergevoelig.

Als deze conventie niet wordt gevolgd door een veldnaam, moet de veldnaam worden omwikkeld met ${}. Als de veldnaam bijvoorbeeld "Voornaam" of "Voornaam" is, moet de naam als volgt worden omwikkeld ${First Name} of ${First\.Name} respectievelijk.

TIP
Wanneer het in wisselwerking staan met hiërarchieën, als een kindattribuut een periode (.), moet u een backslash gebruiken (\) gebruiken om speciale tekens te verwijderen. Lees voor meer informatie de handleiding op speciale tekens verwijderen.

Als een veldnaam ook alle van de volgende gereserveerde trefwoorden: ${}:

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

Gegevens binnen subvelden zijn toegankelijk met behulp van de puntnotatie. Als er bijvoorbeeld een name -object, om toegang te krijgen tot firstName veld, gebruiken name.firstName.

Lijst met functies

In de volgende tabellen worden alle ondersteunde toewijzingsfuncties weergegeven, inclusief voorbeeldexpressies en de resulterende uitvoer.

Reeksfuncties string

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
concat
Voegt de opgegeven tekenreeksen samen.
  • STRING: De tekenreeksen die worden samengevoegd.
concat(STRING_1, STRING_2)
concat("Hi, ", "there", "!")
"Hi, there!"
ontploffen
Splitst de tekenreeks op basis van een regex en retourneert een array met onderdelen. Kan optioneel regex opnemen om de tekenreeks te splitsen. Standaard wordt de splitsing omgezet in ",". De volgende scheidingstekens behoefte te ontsnappen \: +, ?, ^, |, ., [, (, {, ), *, $, \ Als u meerdere tekens opneemt als scheidingsteken, wordt het scheidingsteken behandeld als een scheidingsteken voor meerdere tekens.
  • STRING: Vereist De tekenreeks die moet worden gesplitst.
  • REGEX: Optioneel De reguliere expressie die kan worden gebruikt om de tekenreeks te splitsen.
explode(STRING, REGEX)
explode("Hallo, daar!", " ")
["Hi,", "there"]
instr
Retourneert de locatie/index van een subtekenreeks.
  • INVOER: Vereist De tekenreeks die wordt doorzocht.
  • SUBSTRING: Vereist De subtekenreeks waarnaar wordt gezocht binnen de tekenreeks.
  • START_POSITION: Optioneel De locatie waar moet worden begonnen met zoeken in de tekenreeks.
  • VOORVALLEN: Optioneel De nde instantie die vanaf de beginpositie moet worden gezocht. Standaard is dit 1.
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE)
instr("adobe.com", "com")
6
vervanger
Vervangt de zoektekenreeks indien aanwezig in de oorspronkelijke tekenreeks.
  • INVOER: Vereist De invoertekenreeks.
  • TO_FIND: Vereist De tekenreeks die binnen de invoer moet worden opgezocht.
  • TO_REPLACE: Vereist De tekenreeks die de waarde binnen "TO_FIND" vervangt.
replacer(INPUT, TO_FIND, TO_REPLACE)
replacestr("This is a string re test", "re", "replace")
"Dit is een test ter vervanging van een tekenreeks
substr
Retourneert een subtekenreeks van een bepaalde lengte.
  • INVOER: Vereist De invoertekenreeks.
  • START_INDEX: Vereist De index van de invoertekenreeks waar de subtekenreeks begint.
  • LENGTE: Vereist De lengte van de subtekenreeks.
substr(INPUT, START_INDEX, LENGTH)
substr("This is a substring test", 7, 8)
" a subst"
lager /
lcase
Zet een tekenreeks om in kleine letters.
  • INVOER: Vereist De tekenreeks die wordt omgezet in kleine letters.
lower (INPUT)
lower("HeLLo")
lcase("HeLLo")
"hallo"
upper /
kauwen
Zet een tekenreeks om in hoofdletters.
  • INVOER: Vereist De tekenreeks die wordt omgezet in hoofdletters.
upper(INPUT)
upper("HeLLo")
ucase("HeLLo")
HELLO
split
Splitst een invoertekenreeks op een scheidingsteken. Het volgende scheidingsteken behoeften te ontsnappen \: \. Als u meerdere scheidingstekens opneemt, wordt de tekenreeks gesplitst alle van de scheidingstekens in de tekenreeks. Opmerking: Deze functie retourneert alleen indexen die niet 'null' zijn van de tekenreeks, ongeacht de aanwezigheid van het scheidingsteken. Wanneer alle indexen, inclusief null, in de resulterende array zijn vereist, gebruikt u in plaats daarvan de functie "explode".
  • INVOER: Vereist De invoertekenreeks die wordt gesplitst.
  • SCHEIDINGSTEKEN: Vereist De tekenreeks die wordt gebruikt om de invoer te splitsen.
split(INPUT, SEPARATOR)
split("Hello world", " ")
["Hello", "world"]
join
Hiermee wordt een lijst met objecten samengevoegd met het scheidingsteken.
  • SCHEIDINGSTEKEN: Vereist De tekenreeks die wordt gebruikt om de objecten te verbinden.
  • OBJECTEN: Vereist Een array van tekenreeksen die worden gekoppeld.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Hello world"
lpad
Hiermee wordt de linkerzijde van een tekenreeks met de andere opgegeven tekenreeks geplakt.
  • INVOER: Vereist De tekenreeks die wordt opgevuld. Deze tekenreeks kan null zijn.
  • TELLING: Vereist De grootte van de tekenreeks die moet worden opgevuld.
  • TOEVOEGEN: Vereist De tekenreeks waarmee de invoer moet worden geplakt. Als deze null of leeg is, wordt deze behandeld als één spatie.
lpad(INPUT, COUNT, PADDING)
lpad("bat", 8, "yz")
"yzyzyzybat"
rpad
Hiermee wordt de rechterzijde van een tekenreeks overgeladen met de andere opgegeven tekenreeks.
  • INVOER: Vereist De tekenreeks die wordt opgevuld. Deze tekenreeks kan null zijn.
  • TELLING: Vereist De grootte van de tekenreeks die moet worden opgevuld.
  • TOEVOEGEN: Vereist De tekenreeks waarmee de invoer moet worden geplakt. Als deze null of leeg is, wordt deze behandeld als één spatie.
rpad(INPUT, COUNT, PADDING)
rpad("bat", 8, "yz")
"batyzyzy"
left
Haalt de eerste 'n'-tekens van de opgegeven tekenreeks op.
  • STRING: Vereist De tekenreeks waarvoor u de eerste 'n'-tekens ontvangt.
  • TELLING: Vereist De 'n' tekens die u uit de tekenreeks wilt halen.
left(STRING, COUNT)
left("abcde", 2)
"ab"
right
Haalt de laatste 'n'-tekens van de opgegeven tekenreeks op.
  • STRING: Vereist De tekenreeks waarvoor u de laatste 'n'-tekens ontvangt.
  • TELLING: Vereist De 'n' tekens die u uit de tekenreeks wilt halen.
right (STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Verwijdert de witruimte aan het begin van de tekenreeks.
  • STRING: Vereist De tekenreeks waaruit u de witruimte wilt verwijderen.
ltrim(STRING)
ltrim(" hello")
"hallo"
rtrim
Verwijdert de witruimte aan het einde van de tekenreeks.
  • STRING: Vereist De tekenreeks waaruit u de witruimte wilt verwijderen.
rtrim(STRING)
rtrim("hello ")
"hallo"
trim
Verwijdert de witruimte van het begin en het einde van de tekenreeks.
  • STRING: Vereist De tekenreeks waaruit u de witruimte wilt verwijderen.
trim (STRING)
trim(" hello ")
"hallo"
equals
Vergelijkt twee tekenreeksen om te bevestigen of deze gelijk zijn. Deze functie is hoofdlettergevoelig.
  • STRING1: Vereist De eerste tekenreeks die u wilt vergelijken.
  • STRING2: Vereist De tweede tekenreeks die u wilt vergelijken.
TEKENREEKS1. ​equals( ​ STRING2)
"string1". ​equals ​("STRING1")
false
equalsIgnoreCase
Vergelijkt twee tekenreeksen om te bevestigen of deze gelijk zijn. Deze functie is niet hoofdlettergevoelig.
  • STRING1: Vereist De eerste tekenreeks die u wilt vergelijken.
  • STRING2: Vereist De tweede tekenreeks die u wilt vergelijken.
TEKENREEKS1. ​equalsIgnoreCase ​(STRING2)
"string1". ​equalsIgnoreCase ​("STRING1)
true

Gewone expressiefuncties

Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
extract_regex
Haalt groepen uit de invoertekenreeks op basis van een reguliere expressie.
  • STRING: Vereist De tekenreeks waaruit de groepen worden geëxtraheerd.
  • REGEX: Vereist De reguliere expressie die moet overeenkomen met de groep.
extract_regex(STRING, REGEX)
extract_regex ​("E259,E259B_009,1_1" ​, "() [,]+),[,]*,([^,]+)"
["E259,E259B_009,1_1", "E259", "1_1"]
match_regex
Controleert of de tekenreeks overeenkomt met de ingevoerde reguliere expressie.
  • STRING: Vereist De tekenreeks die u controleert, komt overeen met de reguliere expressie.
  • REGEX: Vereist De reguliere expressie die u vergelijkt.
match_regex(STRING, REGEX)
match_regex("E259,E259B_009,1_1", "() [,]+),[,]*,([^,]+)"
true

Hashingfuncties hashing

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
sha1
Neemt een input en veroorzaakt een knoeiboelwaarde gebruikend Veilig algoritme 1 van de Hash (SHA-1).
  • INVOER: Vereist The plain text to be hashed.
  • TEKEN: Optioneel De naam van de tekenset. Mogelijke waarden zijn UTF-8, UTF-16, ISO-8859-1 en US-ASCII.
sha1(INPUT, CHARSET)
sha1("my text", "UTF-8")
c3599c11e47719df18a24 ​ 48690840c5dfcce3c80
sha256
Neemt een input en veroorzaakt een knoeiboelwaarde gebruikend Veilig algoritme 256 van de Hash (SHA-256).
  • INVOER: Vereist The plain text to be hashed.
  • TEKEN: Optioneel De naam van de tekenset. Mogelijke waarden zijn UTF-8, UTF-16, ISO-8859-1 en US-ASCII.
sha256 (INPUT, CHARSET)
sha256("my text", "UTF-8")
7330d2b39ca35eaf4cb95fc846c21 ​ ee6a39af698154a83a586ee270a0d372104
sha512
Neemt een input en veroorzaakt een knoeiboelwaarde gebruikend Veilig algoritme 512 van de Hash (SHA-512).
  • INVOER: Vereist The plain text to be hashed.
  • TEKEN: Optioneel De naam van de tekenset. Mogelijke waarden zijn UTF-8, UTF-16, ISO-8859-1 en US-ASCII.
sha512(INPUT, CHARSET)
sha512("my text", "UTF-8")
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef ​ 708bf11b4232bb21d2a8704ada2cdcd7b367dd07 88a89 ​ a5c908cfe377aceb1072a7b386b7d4fd2ff68a8fd24d16
md5
Gebruikt invoer en produceert een knoeiboelwaarde gebruikend MD5.
  • INVOER: Vereist The plain text to be hashed.
  • TEKEN: Optioneel De naam van de tekenset. Mogelijke waarden zijn UTF-8, UTF-16, ISO-8859-1 en US-ASCII.
md5(INPUT, CHARSET)
md5("my text", "UTF-8")
d3b96ce8c9fb4 ​ e9bd0198d03ba6852c7
crc32
Gebruikt een input een algoritme van de cyclische overtolligheidscontrole (CRC) om een cyclische code met 32 bits te produceren.
  • INVOER: Vereist The plain text to be hashed.
  • TEKEN: Optioneel De naam van de tekenset. Mogelijke waarden zijn UTF-8, UTF-16, ISO-8859-1 en US-ASCII.
crc32(INPUT, CHARSET)
crc32("my text", "UTF-8")
8df92e80

URL-functies url

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
get_url_protocol
Retourneert het protocol van de opgegeven URL. Als de invoer ongeldig is, wordt null geretourneerd.
  • URL: Vereist De URL waaruit het protocol moet worden geëxtraheerd.
get_url_protocol ​(URL)
get_url_protocol("https://platform ​ .adobe.com/home")
https
get_url_host
Geeft als resultaat de host van de opgegeven URL. Als de invoer ongeldig is, wordt null geretourneerd.
  • URL: Vereist De URL waarvan de host moet worden opgehaald.
get_url_host ​(URL)
get_url_host ​("https://platform ​ .adobe.com/home")
platform.adobe.com
get_url_port
Retourneert de poort van de opgegeven URL. Als de invoer ongeldig is, wordt null geretourneerd.
  • URL: Vereist De URL waarvan de poort moet worden geëxtraheerd.
get_url_port(URL)
get_url_port ​("sftp://example.com//home/ ​ joe/employee.csv")
22
get_url_path
Retourneert het pad van de opgegeven URL. Standaard wordt het volledige pad geretourneerd.
  • URL: Vereist De URL waaruit het pad moet worden geëxtraheerd.
  • FULL_PATH: Optioneel Een Booleaanse waarde die bepaalt of het volledige pad wordt geretourneerd. Indien ingesteld op false, wordt alleen het einde van het pad geretourneerd.
get_url_path ​(URL, FULL_PATH)
get_url_path ​("sftp://example.com// ​ home/joe/employee.csv")
"//home/joe/​ employee.csv"
get_url_query_str
Retourneert de querytekenreeks van een opgegeven URL als een kaart met de naam van de queryreeks en de waarde van de queryreeks.
  • URL: Vereist De URL waarvan u de queryreeks probeert te verkrijgen.
  • ANKER: Vereist Bepaalt wat met het anker in het vraagkoord zal worden gedaan. Kan één van drie waarden zijn: "behouden", "verwijderen" of "toevoegen".

    Als de waarde "preserve" is, wordt het anker aan de geretourneerde waarde gekoppeld.
    Als de waarde "remove" is, wordt het anker verwijderd van de geretourneerde waarde.
    Als de waarde "append" is, wordt het anker geretourneerd als een aparte waarde.
get_url_query_str ​(URL, ANCHOR)
get_url_query_str ​("foo://example.com:8042 ​/over/there?name= ​ ferret#nose", "preserve")
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
Deze functie gebruikt een URL als invoer en vervangt of codeert de speciale tekens met ASCII-tekens. Lees voor meer informatie over speciale tekens de lijst met speciale tekens in de bijlage van dit document.
  • URL: Vereist De invoer-URL met speciale tekens die u wilt vervangen of coderen met ASCII-tekens.
get_url_encoded(URL)
get_url_encoded("https://example.com/partnership_asia-pacific_2022")
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022
get_url_decodeerd
Deze functie neemt een URL als invoer en decodeert de ASCII-tekens tot speciale tekens. Lees voor meer informatie over speciale tekens de lijst met speciale tekens in de bijlage van dit document.
  • URL: Vereist De invoer-URL met ASCII-tekens die u wilt decoderen in speciale tekens.
get_url_decode(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022")
https/example.com/partneralliance_asia-pacific_2022

Datum- en tijdfuncties date-and-time

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven. Meer informatie over de date functie vindt u in de datumsectie van het dialoogvenster handleiding voor gegevensverwerking.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
now
Hiermee wordt de huidige tijd opgehaald.
now()
now()
2021-10-26T10:10:24Z
tijdstempel
Hiermee wordt de huidige Unix-tijd opgehaald.
timestamp()
timestamp()
1571850624571
format
Hiermee wordt de invoerdatum opgemaakt volgens een opgegeven notatie.
  • DATUM: Vereist De invoerdatum die u wilt opmaken als een ZonedDateTime-object.
  • INDELING: Vereist De notatie waarin de datum moet worden gewijzigd.
format(DATE, FORMAT)
formaat (2019-10-23T11):24:00+00:00, "yyyy-MM-dd HH:mm:ss")
2019-10-23 11:24:35
dformat
Converteert een tijdstempel naar een datumtekenreeks volgens een opgegeven notatie.
  • TIJDSTEMPEL: Vereist Het tijdstempel dat u wilt opmaken. Dit wordt geschreven in milliseconden.
  • INDELING: Vereist De indeling die u wilt instellen als tijdstempel.
dformat(TIMESTAMP, FORMAT)
dformat(1571829875000, "yyyy-MM-dd'T'HH:mm:ss.SSSX")
2019-10-23T11:24:35.000Z
date
Converteert een datumtekenreeks naar een ZonedDateTime-object (ISO 8601-indeling).
  • DATUM: Vereist De tekenreeks die de datum vertegenwoordigt.
  • INDELING: Vereist De tekenreeks die staat voor de indeling van de brondatum.Opmerking: Dit doet niet vertegenwoordigen de notatie waarin u de datumtekenreeks wilt omzetten.
  • DEFAULT_DATE: Vereist De geretourneerde standaarddatum als de opgegeven datum null is.
date(DATE, FORMAT, DEFAULT_DATE)
date("2019-10-23 11:24", "yyyy-MM-dd HH:mm", now())
2019-10-23T11:24:00Z
date
Converteert een datumtekenreeks naar een ZonedDateTime-object (ISO 8601-indeling).
  • DATUM: Vereist De tekenreeks die de datum vertegenwoordigt.
  • INDELING: Vereist De tekenreeks die staat voor de indeling van de brondatum.Opmerking: Dit doet niet vertegenwoordigen de notatie waarin u de datumtekenreeks wilt omzetten.
date(DATE, FORMAT)
date("2019-10-23 11:24", "yyyy-MM-dd HH:mm")
2019-10-23T11:24:00Z
date
Converteert een datumtekenreeks naar een ZonedDateTime-object (ISO 8601-indeling).
  • DATUM: Vereist De tekenreeks die de datum vertegenwoordigt.
date(DATE)
date("2019-10-23 11:24")
"2019-10-23T11:24:00Z"
date_part
Hiermee worden de delen van de datum opgehaald. De volgende componentwaarden worden ondersteund:

"year"
"yyyy"
"yy"

"kwart"
"qq"
"q"

"month"
"mm"
"m"

"dayofyear"
"dy"
"y"

"dag"
"dd"
"d"

"week"
"ww"
"w"

"weekdag"
"dw"
"w"

"uur"
"hh"
"hh24"
"hh12"

"minute"
"mi"
"n"

"second"
"ss"
"s"

"millisecond"
"SSS"
  • COMPONENT: Vereist Een tekenreeks die staat voor het deel van de datum.
  • DATUM: Vereist De datum, in een standaardformaat.
date_part ​(COMPONENT, DATE)
date_part("MM", date("2019-10-17 11):55:12 inch)
10
set_date_part
Hiermee vervangt u een component in een bepaalde datum. De volgende onderdelen worden geaccepteerd:

"year"
"yyyy"
"yy"

"month"
"mm"
"m"

"dag"
"dd"
"d"

"uur"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • COMPONENT: Vereist Een tekenreeks die staat voor het deel van de datum.
  • WAARDE: Vereist De waarde die voor de component voor een bepaalde datum moet worden ingesteld.
  • DATUM: Vereist De datum, in een standaardformaat.
set_date_part ​(COMPONENT, VALUE, DATE)
set_date_part("m", 4, date("2016-11-09T11):44:44,797 inch)
"2016-04-09T11:44:44Z"
make_date_time
Hiermee maakt u een datum op basis van onderdelen. Deze functie kan ook worden geïnduceerd met make_timestamp.
  • JAAR: Vereist Het jaar, geschreven in vier cijfers.
  • MAAND: Vereist De maand. De toegestane waarden zijn 1 tot 12.
  • DAG: Vereist De dag. De toegestane waarden zijn 1 tot 31.
  • UUR: Vereist Het uur. De toegestane waarden zijn 0 tot 23.
  • MINUUT: Vereist De minuut. De toegestane waarden zijn 0 tot en met 59.
  • NANOSECOND: Vereist De tweede nanowaarden. De toegestane waarden zijn 0 tot en met 999999999.
  • TIJDZONE: Vereist De tijdzone voor de datumtijd.
make_date_time ​(JAAR, MAAND, DAG, UUR, 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
Converteert een datum in een tijdzone naar een datum in UTC.
  • DATUM: Vereist De datum die u wilt omzetten.
zone_date_to_utc ​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
Converteert een datum van de ene tijdzone naar een andere tijdzone.
  • DATUM: Vereist De datum die u wilt omzetten.
  • ZONE: Vereist De tijdzone waarnaar u de datum wilt converteren.
zone_date_to_zone ​(DATE, ZONE)
zone_date_to_utc​(now(), "Europe/Paris")
2021-10-26T15:43:59Z

Hiërarchieën - Objecten objects

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
is_empty
Controleert of een object leeg is.
  • INVOER: Vereist Het object dat u wilt controleren, is leeg.
is_empty(INPUT)
is_empty([1, null, 2, 3])
false
arrays_to_object
Maakt een lijst met objecten.
  • INVOER: Vereist Een groep sleutel- en arrayparen.
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
Hiermee maakt u een object op basis van de opgegeven platte sleutel/waardeparen.
  • INVOER: Vereist Een platte lijst met sleutel/waardeparen.
to_object(INPUT)
to_object ​("firstName", "John", "lastName", "Doe")
{"firstName": "John", "lastName": "Doe"}
str_to_object
Maakt een object van de invoertekenreeks.
  • STRING: Vereist De tekenreeks die wordt geparseerd om een object te maken.
  • VALUE_DELIMITER: Optioneel Het scheidingsteken dat een veld van de waarde scheidt. Het standaardscheidingsteken is :.
  • FIELD_DELIMITER: Optioneel Het scheidingsteken dat de waardeparen van het gebied scheidt. Het standaardscheidingsteken is ,.
str_to_object ​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Opmerking: U kunt de opdracht get() samen met str_to_object() om waarden op te halen voor de toetsen in de tekenreeks.
  • Voorbeeld 1: str_to_object("firstName - John ; lastName - ; - 123 345 7890", "-", ";")
  • Voorbeeld 2: str_to_object("firstName - John ; lastName - ; phone - 123 456 7890", "-", ";").get("firstName")
  • Voorbeeld 1:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • Voorbeeld 2: "John"
contains_key
Controleert of het object bestaat in de brongegevens. Opmerking: Deze functie vervangt de vervangen is_set() functie.
  • INVOER: Vereist Het pad dat moet worden gecontroleerd als het bestaat in de brongegevens.
contains_key(INPUT)
contains_key("evars.evar.field1")
true
opheffen
Hiermee wordt de waarde van het kenmerk ingesteld op null. Dit zou moeten worden gebruikt wanneer u niet het gebied aan het doelschema wilt kopiëren.
nullify()
nullify()
null
get_keys
Parseert de sleutel/waardeparen en retourneert alle sleutels.
  • OBJECT: Vereist Het object waaruit de sleutels worden geëxtraheerd.
get_keys(OBJECT)
get_keys({"book1": "Pride and Prerechterlijke", "book2": "1984"})
["book1", "book2"]
get_values
Parseert de sleutel/waardeparen en retourneert de waarde van de tekenreeks op basis van de opgegeven sleutel.
  • STRING: Vereist De tekenreeks die u wilt parseren.
  • TOETS: Vereist De sleutel waarvoor de waarde moet worden geëxtraheerd.
  • VALUE_DELIMITER: Vereist Het scheidingsteken tussen het veld en de waarde. Indien null Als er een lege tekenreeks wordt opgegeven, is deze waarde :.
  • FIELD_DELIMITER: Optioneel Het scheidingsteken tussen veld- en waardeparen. Indien null Als er een lege tekenreeks wordt opgegeven, is deze waarde ,.
get_values(STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER)
get_values("firstName - John , lastName - Cena, phone - 555 420 8692", "firstName", "-", ",")
John
map_get_values
Neemt een kaart en een zeer belangrijke input. Als de invoer één toets is, retourneert de functie de waarde die aan die toets is gekoppeld. Als de invoer een tekenreeksarray is, retourneert de functie alle waarden die overeenkomen met de opgegeven sleutels. Als de inkomende kaart dubbele sleutels heeft, moet de terugkeerwaarde de sleutels dedupliceren en unieke waarden terugkeren.
  • KAART: Vereist De invoerkaartgegevens.
  • TOETS: Vereist De sleutel kan een enkele tekenreeks of een tekenreeks-array zijn. Als een ander primitief type (data/number) wordt opgegeven, wordt het behandeld als een tekenreeks.
get_values(MAP, KEY)
Zie de aanhangsel voor een codevoorbeeld.
map_has_keys
Als een of meer invoersleutels worden opgegeven, retourneert de functie true. Als een tekenreeks-array wordt opgegeven als invoer, retourneert de functie waar op de eerste key die wordt gevonden.
  • KAART: Vereist De gegevens van de invoerkaart
  • TOETS: Vereist De sleutel kan een enkele tekenreeks of een tekenreeks-array zijn. Als een ander primitief type (data/number) wordt opgegeven, wordt het behandeld als een tekenreeks.
map_has_keys(MAP, KEY)
Zie de aanhangsel voor een codevoorbeeld.
add_to_map
Accepteert minstens twee invoeren. Om het even welk aantal kaarten kan als input worden verstrekt. De Prep van gegevens keert één enkele kaart terug die alle zeer belangrijk-waardeparen van alle input heeft. Als één of meerdere sleutels (in de zelfde kaart of over kaarten) worden herhaald, dedupliceert Prep van Gegevens de sleutels zodat het eerste zeer belangrijk-waardepaar in de orde voortduurt dat zij in de input werden overgegaan.
KAART: Vereist De invoerkaartgegevens.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Zie de aanhangsel voor een codevoorbeeld.
object_to_map (Syntaxis 1)
Gebruik deze functie om gegevenstypen Kaart te maken.
  • TOETS: Vereist Toetsen moeten een tekenreeks zijn. Als er andere primitieve waarden zijn opgegeven, zoals gehele getallen of datums, worden deze automatisch omgezet in tekenreeksen en worden ze als tekenreeksen behandeld.
  • ANY_TYPE: Vereist Verwijst naar elk ondersteund XDM-gegevenstype, behalve Kaarten.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, …)
Zie de aanhangsel voor een codevoorbeeld.
object_to_map (syntaxis 2)
Gebruik deze functie om gegevenstypen Kaart te maken.
  • OBJECT: Vereist U kunt een binnenkomend object of objectarray opgeven en een kenmerk binnen het object aanwijzen als sleutel.
object_to_map(OBJECT)
Zie de aanhangsel voor een codevoorbeeld.
object_to_map (syntaxis 3)
Gebruik deze functie om gegevenstypen Kaart te maken.
  • OBJECT: Vereist U kunt een binnenkomend object of objectarray opgeven en een kenmerk binnen het object aanwijzen als sleutel.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Zie de aanhangsel voor een codevoorbeeld.

Zie de sectie voor informatie over de functie voor het kopiëren van objecten onder.

Hiërarchieën - arrays arrays

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
samenvoegen
Retourneert het eerste niet-null-object in een opgegeven array.
  • INVOER: Vereist De array waarvan u het eerste object met een andere waarde dan null wilt zoeken.
kool(INPUT)
coalesce(null, null, null, "first", null, "second")
"first"
first
Hiermee wordt het eerste element van de opgegeven array opgehaald.
  • INVOER: Vereist De array waarvan u het eerste element wilt zoeken.
first (INPUT)
first("1", "2", "3")
"1"
last
Hiermee wordt het laatste element van de opgegeven array opgehaald.
  • INVOER: Vereist De array waarvan u het laatste element wilt zoeken.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Voegt elementen aan het einde van de array toe.
  • ARRAY: Vereist De array waaraan u elementen toevoegt.
  • WAARDEN: de elementen die u aan de array wilt toevoegen.
add_to_array ​(ARRAY, VALUES)
add_to_array ​(["a", "b"], "c", "d")
["a", "b", "c", "d"]
join_arrays
Combineert de arrays met elkaar.
  • ARRAY: Vereist De array waaraan u elementen toevoegt.
  • WAARDEN: de array(en) die u aan de bovenliggende array wilt toevoegen.
join_arrays ​(ARRAY, VALUES)
join_arrays ​(["a", "b"], ["c"], ["d", "e"])
["a", "b", "c", "d", "e"]
to_array
Neemt een lijst van input en zet het in een serie om.
  • INCLUDE_NULLS: Vereist Een booleaanse waarde die aangeeft of null al dan niet moet worden opgenomen in de responsarray.
  • WAARDEN: Vereist De elementen die in een array moeten worden omgezet.
to_array ​(INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Retourneert de grootte van de invoer.
  • INVOER: Vereist Het object waarvan u de grootte probeert te vinden.
size_of(INPUT)
size_of([1, 2, 3, 4])
4
update_array_append
Deze functie wordt gebruikt om alle elementen in de volledige invoerarray toe te voegen aan het einde van de array in Profile. Deze functie is alleen van toepassing tijdens updates. Indien gebruikt in de context van tussenvoegsels, keert deze functie de input zoals is terug.
  • ARRAY: Vereist De array die moet worden toegevoegd aan de array in het profiel.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[123 456]
upsert_array_replace
Deze functie wordt gebruikt om elementen in een array te vervangen. Deze functie is alleen van toepassing tijdens updates. Indien gebruikt in de context van tussenvoegsels, keert deze functie de input zoals is terug.
  • ARRAY: Vereist De array die de array in het profiel moet vervangen.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123 456]

Hiërarchieën - Toewijzen map

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
array_to_map
Deze functie neemt een objectarray en een sleutel als invoer en retourneert een kaart van het veld van de sleutel met de waarde als sleutel en het arrayelement als waarde.
  • INVOER: Vereist De objectarray waarvan u het eerste object met een andere waarde dan null wilt zoeken.
  • TOETS: Vereist De sleutel moet een veldnaam zijn in de objectarray en het object als waarde.
array_to_map(OBJECT[] INVOER, SLEUTEL)
Lees de aanhangsel voor een codevoorbeeld.
object_to_map
Deze functie neemt een voorwerp als argument en keert een kaart van zeer belangrijk-waardeparen terug.
  • INVOER: Vereist De objectarray waarvan u het eerste object met een andere waarde dan null wilt zoeken.
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"}
Retourneert een kaart met opgegeven veldnaam- en waardeparen of null als de invoer null is. Bijvoorbeeld: "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
Deze functie neemt een lijst van ke-value paren en keert een kaart van zeer belangrijk-waardeparen terug.
to_map(OBJECT_INPUT)
"to_map("firstName", "John", "lastName", "Doe")"
Retourneert een kaart met opgegeven veldnaam- en waardeparen of null als de invoer null is. Bijvoorbeeld: "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Logische operatoren logical-operators

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
decoderen
Op basis van een sleutel en een lijst met sleutelwaardeparen die als een array zijn samengevoegd, retourneert de functie de waarde als een sleutel wordt gevonden of retourneert deze een standaardwaarde als deze aanwezig is in de array.
  • TOETS: Vereist De sleutel die moet worden aangepast.
  • OPTIONS: Vereist Een samengevoegde array van sleutel/waardeparen. Optioneel kan een standaardwaarde aan het einde worden geplaatst.
decoderen (SLEUTEL, OPTIONS)
decode(stateCode, "ca", "California", "pa", "Pennsylvania", "N/A")
Als stateCode gegeven "ca", "Californië" is.
Als stateCode gegeven "pa" is, "Pennsylvania".
Als stateCode niet het volgende aanpast, "n.v.t.".
iif
Evalueert een bepaalde booleaanse expressie en retourneert de opgegeven waarde op basis van het resultaat.
  • EXPRESSIE: Vereist De booleaanse expressie die wordt geëvalueerd.
  • TRUE_VALUE: Vereist De waarde die wordt geretourneerd als de expressie true oplevert.
  • FALSE_VALUE: Vereist De waarde die wordt geretourneerd als de expressie false oplevert.
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE)
iif("s".equalsIgnoreCase("S"), "True", "False")
"Waar"

Samenvoeging aggregation

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
min
Geeft als resultaat het minimum van de opgegeven argumenten. Gebruikt natuurlijke volgorde.
  • OPTIONS: Vereist Een of meer objecten die met elkaar kunnen worden vergeleken.
min(OPTIONS)
min(3, 1, 4)
1
max
Geeft als resultaat het maximum van de opgegeven argumenten. Gebruikt natuurlijke volgorde.
  • OPTIONS: Vereist Een of meer objecten die met elkaar kunnen worden vergeleken.
max(OPTIONS)
max(3, 1, 4)
4

Typeomzettingen type-conversions

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
to_bigint
Zet een tekenreeks om in een BigInteger.
  • STRING: Vereist De tekenreeks die moet worden omgezet in een BigInteger.
to_bigint(STRING)
to_bigint ​("1000000.34")
1000000,34
to_decimal
Zet een tekenreeks om in een double.
  • STRING: Vereist De tekenreeks die in een Double moet worden omgezet.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Zet een tekenreeks om in een zwevende waarde.
  • STRING: Vereist De tekenreeks die moet worden omgezet in een zwevende waarde.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Zet een tekenreeks om in een geheel getal.
  • STRING: Vereist De tekenreeks die in een geheel getal moet worden omgezet.
to_integer(STRING)
to_integer("12")
12

JSON-functies json

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
json_to_object
Maak JSON-inhoud deserialize vanuit de opgegeven tekenreeks.
  • STRING: Vereist De JSON-tekenreeks die moet worden gedeserialiseerd.
json_to_object ​(STRING)
json_to_object ​({"info":{"firstName":"John","lastName": "Doe"})
Een object dat de JSON vertegenwoordigt.

Bijzondere verrichtingen special-operations

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
uuid /
guid
Hiermee genereert u een pseudo-willekeurige id.
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fcda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
Deze functie neemt een FPID-tekenreeks en zet deze om in een ECID die in Adobe Experience Platform- en Adobe Experience Cloud-toepassingen moet worden gebruikt.
  • STRING: Vereist De FPID-tekenreeks die in ECID moet worden omgezet.
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

Functies van gebruikersagent user-agent

Om het even welke gebruikersagent functies in de lijst hieronder kunnen één van beiden van de volgende waarden terugkeren:

  • Telefoon - Een mobiel apparaat met een klein scherm (gewoonlijk < 7 inch)
  • Mobiel - Een mobiel apparaat dat nog moet worden geïdentificeerd. Dit mobiele apparaat kan een eReader, een tablet, een telefoon, een horloge, enz. zijn.

Voor meer informatie over apparaatveldwaarden leest u de lijst met apparaatveldwaarden in de bijlage van dit document.

NOTE
Schuif naar links/rechts om de volledige inhoud van de tabel weer te geven.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
ua_os_name
Extraheert de naam van het besturingssysteem uit de userAgent-tekenreeks.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_os_name ​(USER_AGENT)
ua_os_name ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS
ua_os_version_major
Extraheert de belangrijkste versie van het besturingssysteem uit de userAgent-tekenreeks.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_os_version_major ​(USER_AGENT)
ua_os_version_major ​ s("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5
ua_os_version
Extraheert de versie van het besturingssysteem uit de userAgent-tekenreeks.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_os_version ​(USER_AGENT)
ua_os_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5.1.1.
ua_os_name_version
Extraheert de naam en de versie van het besturingssysteem uit de userAgent-tekenreeks.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_os_name_version ​(USER_AGENT)
ua_os_name_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5.1.1
ua_agent_version
Extraheert de agentenversie uit het koord van de gebruikersagent.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_agent_version ​(USER_AGENT)
ua_agent_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5,1
ua_agent_version_major
Extraheert de agentennaam en belangrijkste versie van het koord van de gebruikersagent.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_agent_version_major ​(USER_AGENT)
ua_agent_version_major ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari 5
ua_agent_name
Extraheert de agentennaam uit het koord van de gebruikersagent.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_agent_name ​(USER_AGENT)
ua_agent_name ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari
ua_device_class
Extraheert de apparaatklasse uit de userAgent-tekenreeks.
  • USER_AGENT: Vereist De userAgent-tekenreeks.
ua_device_class ​(USER_AGENT)
ua_device_class ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 zoals Mac OS X) AppleWebKit/534.46 (KHTML, zoals Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Telefoon

Analysefuncties analytics

NOTE
U mag de volgende analytische functies alleen gebruiken voor WebSDK- en Adobe Analytics-stromen.
Functie
Beschrijving
Parameters
Syntaxis
Uitdrukking
Voorbeelduitvoer
aa_get_event_id
Extraheert de gebeurtenis-id uit een Analytics-gebeurtenistekenreeks.
  • EVENT_STRING: Vereist De door komma's gescheiden gebeurtenistekenreeks Analytics.
  • EVENT_NAME: Vereist The event name to extract and ID from.
a_get_event_id(EVENT_STRING, EVENT_NAME)
aa_get_event_id("event101=5:123456,scOpen", "event101")
123456
aa_get_event_value
Extraheert de gebeurteniswaarde uit een gebeurtenisreeks Analytics. Als de gebeurteniswaarde niet wordt opgegeven 1, wordt geretourneerd.
  • EVENT_STRING: Vereist De door komma's gescheiden gebeurtenistekenreeks Analytics.
  • EVENT_NAME: Vereist De naam van de gebeurtenis waaruit een waarde wordt geëxtraheerd.
a_get_event_value(EVENT_STRING, EVENT_NAME)
aa_get_event_value("event101=5:123456,scOpen", "event101")
5
aa_get_product_categorieën
Extraheert de productcategorie uit een productreeks van Analytics.
  • PRODUCTS_STRING: Vereist The Analytics products string.
a_get_product_Categorieën(PRODUCTS_STRING)
aa_get_product_category(";Voorbeeld product 1;1;3.50,Voorbeeld categorie 2;Voorbeeld product 2;1;5.99")
[null,"Voorbeeldcategorie 2"]
aa_get_product_names
Extraheert de productnaam uit een productreeks Analytics.
  • PRODUCTS_STRING: Vereist The Analytics products string.
a_get_product_names(PRODUCTS_STRING)
aa_get_product_names(";Voorbeeld product 1;1;3.50,Voorbeeld categorie 2;Voorbeeld product 2;1;5.99")
["Voorbeeld product 1","Voorbeeld product 2"]
aa_get_product_quantity
Extraheert de hoeveelheden uit een productreeks van Analytics.
  • PRODUCTS_STRING: Vereist The Analytics products string.
a_get_product_Quantities(PRODUCTS_STRING)
aa_get_product_Quantities(";Voorbeeld product 1;1;3.50,Voorbeeld categorie 2;Voorbeeld product 2")
["1", null]
aa_get_product_pricing
Extraheert de prijs uit een productreeks van Analytics.
  • PRODUCTS_STRING: Vereist The Analytics products string.
a_get_product_pricing(PRODUCTS_STRING)
aa_get_product_price(";Voorbeeld product 1;1;3.50,Voorbeeld categorie 2;Voorbeeld product 2")
["3.50", null]
aa_get_product_event_values
Extraheert waarden voor de benoemde gebeurtenis van de producttekenreeks als een array van tekenreeksen.
  • PRODUCTS_STRING: Vereist The Analytics products string.
  • EVENT_NAME: Vereist De naam van de gebeurtenis waaruit waarden moeten worden geëxtraheerd.
a_get_product_event_values(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_event_values(";Voorbeeld product 1;1;4.20;event1=2.3|event2=5:1;Voorbeeld product 2;1;4.20;event1=3|event2=2:2", "event1")
["2.3", "3"]
aa_get_product_evars
Extraheert de var waarden voor de genoemde gebeurtenis van het productkoord als serie van koorden.
  • PRODUCTS_STRING: Vereist The Analytics products string.
  • EVAR_NAME: Vereist De naam van de eVar die geëxtraheerd moet worden.
aa_get_product_evars(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_evars(";Voorbeeld product;1;6.69;;eVar1=Merchandising value", "eVar1")
["Merchandising value"]

Objectkopie object-copy

TIP
De functie voor het kopiëren van objecten wordt automatisch toegepast wanneer een object in de bron wordt toegewezen aan een object in de XDM. Geen extra actie nodig van gebruikers.

U kunt de functie voor het kopiëren van objecten gebruiken om automatisch kenmerken van een object te kopiëren zonder wijzigingen aan te brengen in de toewijzing. Als uw brongegevens bijvoorbeeld een structuur hebben van:

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

en een XDM-structuur van:

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

Vervolgens wordt de toewijzing:

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

In het bovenstaande voorbeeld wordt city en state kenmerken worden ook automatisch bij uitvoering ingevoerd, omdat de address object is toegewezen aan addr. Als u een line2 -kenmerk in de XDM-structuur en uw invoergegevens bevatten ook een line2 in de address -object, wordt deze automatisch opgenomen zonder dat de toewijzing handmatig hoeft te worden gewijzigd.

Om ervoor te zorgen dat de automatische mapping werkt, moet aan de volgende voorwaarden worden voldaan:

  • Objecten op hoofdniveau moeten worden toegewezen;
  • Nieuwe kenmerken moeten zijn gemaakt in het XDM-schema.
  • Nieuwe kenmerken moeten overeenkomende namen hebben in het bronschema en het XDM-schema.

Als aan om het even welke voorwaarden niet wordt voldaan, dan moet u het bronschema aan het XDM schema manueel in kaart brengen gebruikend gegevens prep.

Bijlage

Hieronder vindt u aanvullende informatie over het gebruik van Data Prep-toewijzingsfuncties

Speciale tekens special-characters

In de onderstaande tabel ziet u een lijst met gereserveerde tekens en de bijbehorende gecodeerde tekens.

Gereserveerd teken
Gecodeerd teken
spatie
%20
!
%21
’
%2
Aantal
%23
$
%24
%
%25
&
%26
'
%27
(
%28
)
%29
*
%2A
+
%2B
,
%2C
/
%2F
:
%3A
;
%3B
<
%3C
=
%3D
>
%3E
?
%3F
@
%40
[
%5B
]
%5D
^
%5E
`
%6
~
%7E

Waarden voor apparaatvelden device-field-values

In de onderstaande tabel wordt een lijst met apparaatveldwaarden en de bijbehorende beschrijvingen weergegeven.

Apparaat
Beschrijving
Desktop
Een desktop of laptop.
Anonymiet
Een anoniem apparaat. In sommige gevallen gaat het om useragents die zijn gewijzigd door een anonimisatiesoftware.
Onbekend
Een onbekend apparaat. Dit zijn meestal useragents die geen informatie over het apparaat bevatten.
Mobile
Een mobiel apparaat dat nog moet worden geïdentificeerd. Dit mobiele apparaat kan een eReader, een tablet, een telefoon, een horloge, enz. zijn.
Tablet
Een mobiel apparaat met een groot scherm (gewoonlijk > 7 inch).
Telefoon
Een mobiel apparaat met een klein scherm (doorgaans < 7 inch).
Controle
Een mobiel apparaat met een klein scherm (normaal < 2 inch). Deze apparaten werken normaal als extra scherm voor een telefoon/tablettype van apparaat.
Augmented Reality
Een mobiel apparaat met AR-mogelijkheden.
Virtuele realiteit
Een mobiel apparaat met VR-mogelijkheden.
eReader
Een apparaat dat lijkt op een tablet, maar meestal met een eInk scherm.
Vak Boven instellen
Een aangesloten apparaat dat interactie mogelijk maakt via een scherm ter grootte van een televisie.
TV
Een apparaat dat lijkt op de set-top box, maar dat in de tv is ingebouwd.
Toestel thuis
Een (gewoonlijk groot) huisapparaat, zoals een koelkast.
Gameconsole
Een vast gamesysteem zoals Playstation of een XBox.
Handheldspelconsole
Een mobiel gamesysteem zoals Nintendo Switch.
Stem
Een spraakgestuurd apparaat als een Amazon Alexa of Google Home.
Auto
Een op voertuigen gebaseerde browser.
Robot
Robots die een website bezoeken.
Robot Mobile
Robots die een website bezoeken, maar aangeven dat ze als een mobiele bezoeker willen worden beschouwd.
Robot Imitator
Robots die een website bezoeken, doen alsof dat robots zijn Google, maar dat zijn ze niet. Opmerking: In de meeste gevallen zijn robots inderdaad robots.
Wolk
Een cloudgebaseerde toepassing. Dit zijn geen robots of hackers, maar toepassingen die verbinding moeten maken. Dit omvat Mastodon servers.
Hacker
Deze apparaatwaarde wordt gebruikt als scripts worden gedetecteerd in het dialoogvenster useragent tekenreeks.

Codevoorbeelden code-samples

map_get_values map-get-values

Selecteren om voorbeeld weer te geven
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

Selecteren om voorbeeld weer te geven
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

Selecteren om voorbeeld weer te geven
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

Syntaxis 1

Selecteren om voorbeeld weer te geven
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Syntaxis 2

Selecteren om voorbeeld weer te geven
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\"}"

Syntaxis 3

Selecteren om voorbeeld weer te geven
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

Selecteren om voorbeeld weer te geven
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
461cc884-c234-4a0c-ac75-6efbaafc1394