DocumentatieExperience PlatformHandleiding Data Prep

Toewijzingsfuncties van Data Prep

Last update: Tue Aug 06 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 teruggekoppeld met ${} . Als de veldnaam bijvoorbeeld "Voornaam" of "Voornaam" is, moet de naam als ${First Name} respectievelijk ${First\.Name} worden omwikkeld.

TIP
Wanneer het in wisselwerking staan met hiërarchieën, als een kindattribuut een periode (.) heeft, moet u backslash (\) gebruiken om speciale karakters te ontsnappen. Voor meer informatie, lees de gids op het ontsnapen speciale karakters.

Als een gebiedsnaam om het even welke van de volgende gereserveerde sleutelwoorden is, moet het met ${}{} worden verpakt:

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

Daarnaast bevatten gereserveerde trefwoorden ook alle mapfuncties die op deze pagina worden vermeld.

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

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 moeten met \ worden ontsnapt: +, ?, ^, |, ., [, (, {, ), *, $, \ als u veelvoudige karakters als afbakening omvat, zal het scheidingsteken als multi-karakterscheidingsteken worden behandeld.
  • STRING: Vereiste het koord dat moet worden gesplitst.
  • REGEX: Facultatieve De regelmatige uitdrukking die kan worden gebruikt om het koord te verdelen.
explode(STRING, REGEX)
explode("Hallo, daar!", " ")
["Hi,", "there"]
instr
Retourneert de locatie/index van een subtekenreeks.
  • INPUT: Vereiste het koord dat wordt gezocht.
  • SUBSTRING: Vereiste substring die binnen het koord wordt gezocht.
  • START_POSITION: Facultatieve de plaats van waar te beginnen in het koord te kijken.
  • VOORVALLEN: Facultatieve het nde voorkomen om van de beginpositie te zoeken. 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.
  • INPUT: Vereiste het inputkoord.
  • TO_FIND: Vereiste het koord om binnen de input omhoog te kijken.
  • TO_REPLACE: Vereiste het koord dat de waarde binnen "TO_FIND"zal vervangen.
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.
  • INPUT: Vereiste het inputkoord.
  • START_INDEX: Vereiste de index van het inputkoord waar substring begint.
  • LENGTH: Vereiste de lengte van substring.
substr(INPUT, START_INDEX, LENGTH)
substr("This is a substring test", 7, 8)
" a subst"
lower /
case
Zet een tekenreeks om in kleine letters.
  • INPUT: Vereiste het koord dat in kleine letters zal worden omgezet.
lower (INPUT)
lower ("HeLLo")
geval ("HeLLo")
"hallo"
upper /
ucase
Zet een tekenreeks om in hoofdletters.
  • INPUT: Vereiste het koord dat in hoofdletters zal worden omgezet.
upper(INPUT)
upper ("HeLLo")
ucase ("HeLLo")
HELLO
split
Splitst een invoertekenreeks op een scheidingsteken. Het volgende separator moet met \ worden ontsnapt: \. Als u veelvoudige afbakeningen omvat, zal het koord op om het even welk van de afbakenaars huidig in het koord verdelen. Nota: Deze functie keert slechts niet-krachteloze indexen van het koord, ongeacht de aanwezigheid van separator terug. Wanneer alle indexen, inclusief null, in de resulterende array zijn vereist, gebruikt u in plaats daarvan de functie "explode".
  • INPUT: Vereiste het inputkoord dat zal worden gesplitst.
  • SEPARATOR: Vereist het koord dat wordt gebruikt om de input te verdelen.
split(INPUT, SEPARATOR)
split("Hello world", " ")
["Hello", "world"]
join
Hiermee wordt een lijst met objecten samengevoegd met het scheidingsteken.
  • SEPARATOR: Vereiste het koord dat zal worden gebruikt om zich bij de voorwerpen aan te sluiten.
  • OBJECTEN: Vereiste een serie van koorden die zullen worden aangesloten.
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.
  • INPUT: Vereiste het koord dat uit zal worden opgevuld. Deze tekenreeks kan null zijn.
  • COUNT: Vereiste de grootte van het uit te vullen koord.
  • PADDING: Vereiste het koord om de input met te stoten. 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.
  • INPUT: Vereiste het koord dat uit zal worden opgevuld. Deze tekenreeks kan null zijn.
  • COUNT: Vereiste de grootte van het uit te vullen koord.
  • PADDING: Vereiste het koord om de input met te stoten. 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: Vereiste het koord u de eerste "n"karakters voor krijgt.
  • COUNT: Vereiste de "n"karakters u van het koord wilt krijgen.
left(STRING, COUNT)
left("abcde", 2)
"ab"
right
Haalt de laatste 'n'-tekens van de opgegeven tekenreeks op.
  • STRING: Vereiste het koord u de laatste "n"karakters voor krijgt.
  • COUNT: Vereiste de "n"karakters u van het koord wilt krijgen.
right (STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Verwijdert de witruimte aan het begin van de tekenreeks.
  • STRING: Vereiste het koord u whitespace van wilt verwijderen.
ltrim(STRING)
ltrim(" hello")
"hallo"
rtrim
Verwijdert de witruimte aan het einde van de tekenreeks.
  • STRING: Vereiste het koord u whitespace van wilt verwijderen.
rtrim(STRING)
rtrim("hello ")
"hallo"
trim
Verwijdert de witruimte van het begin en het einde van de tekenreeks.
  • STRING: Vereiste het koord u whitespace van wilt verwijderen.
trim (STRING)
trim(" hello ")
"hallo"
equals
Vergelijkt twee tekenreeksen om te bevestigen of deze gelijk zijn. Deze functie is hoofdlettergevoelig.
  • STRING1: Vereiste het eerste koord u wilt vergelijken.
  • STRING2: Vereiste het tweede koord 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 gevoelig geval.
  • STRING1: Vereiste het eerste koord u wilt vergelijken.
  • STRING2: Vereiste het tweede koord 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: Vereiste het koord dat u de groepen uit haalt.
  • REGEX: Vereiste de regelmatige uitdrukking die u de groep wilt aanpassen.
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: Vereiste het koord dat u controleert past de regelmatige uitdrukking aan.
  • REGEX: Vereiste de regelmatige uitdrukking die u tegen 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).
  • INPUT: Vereiste de gewone tekst om worden gehakt.
  • CHARSET: Facultatieve De naam van de karakterreeks. 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).
  • INPUT: Vereiste de gewone tekst om worden gehakt.
  • CHARSET: Facultatieve De naam van de karakterreeks. 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).
  • INPUT: Vereiste de gewone tekst om worden gehakt.
  • CHARSET: Facultatieve De naam van de karakterreeks. 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.
  • INPUT: Vereiste de gewone tekst om worden gehakt.
  • CHARSET: Facultatieve De naam van de karakterreeks. 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.
  • INPUT: Vereiste de gewone tekst om worden gehakt.
  • CHARSET: Facultatieve De naam van de karakterreeks. 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: Vereiste URL waarvan het protocol moet worden gehaald.
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: Vereiste URL waarvan de gastheer moet worden gehaald.
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: Vereiste URL waarvan de haven moet worden gehaald.
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: Vereiste URL waarvan de weg moet worden gehaald.
  • FULL_PATH: Facultatieve een booleaanse waarde die bepaalt als de volledige weg is teruggekeerd. 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: Vereiste URL die u probeert om het vraagkoord van te krijgen.
  • ANCHOR: Vereiste bepaalt wat met het anker in het vraagkoord zal worden gedaan. Kan één van drie waarden zijn: "behouden", "verwijderen" of "toevoegen".

    als de waarde "behoudt"is, zal het anker aan de teruggekeerde waarde in bijlage zijn.
    als de waarde "verwijdert"is, zal het anker uit de teruggekeerde waarde worden verwijderd.
    als de waarde "toevoegt"is, zal het anker als afzonderlijke waarde zijn teruggekeerd.
get_url_query_str ​(URL, ANCHOR)
get_url_query_str ​ ("foo://example.com:8042 ​/over/daar?name= ​ ferret#nose", "behouden")
get_url_query_str ​ ("foo://example.com:8042 ​/over/daar?name= ​ ferret#nose", "remove")
get get_url_query_str ​ ("foo://example.com 2:04/over/daar?=daar 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. Voor meer informatie over speciale karakters, te lezen gelieve de lijst van speciale karaktersin bijlage van dit document.
  • URL: Vereiste input URL met speciale karakters die u met karakters wilt vervangen of coderen 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_decodeerd
Deze functie neemt een URL als invoer en decodeert de ASCII-tekens tot speciale tekens. Voor meer informatie over speciale karakters, te lezen gelieve de lijst van speciale karaktersin bijlage van dit document.
  • URL: Vereiste input URL met karakters ASCII die u in speciale karakters wilt decoderen.
get_url_decode(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022")
https://example.com/partnership_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 kan in de datumsectie van de gegeven worden gevonden behandelende gids.
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: Vereiste de inputdatum, als voorwerp ZonedDateTime, die u wilt formatteren.
  • FORMAT: Vereiste het formaat dat u de datum wilt worden veranderd in.
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.
  • TIMESTAMP: Vereiste timestamp u wilt formatteren. Dit wordt geschreven in milliseconden.
  • FORMAT: Vereiste het formaat dat u timestamp wilt worden.
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: Vereiste het koord dat de datum vertegenwoordigt.
  • FORMAT: Vereiste het koord dat het formaat van de brondatum vertegenwoordigt.Nota: dit ​ ​vertegenwoordigt niet het formaat u het datumkoord in wilt omzetten.
  • DEFAULT_DATE: Vereiste de teruggekeerde standaarddatum, als de verstrekte datum ongeldig 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: Vereiste het koord dat de datum vertegenwoordigt.
  • FORMAT: Vereiste het koord dat het formaat van de brondatum vertegenwoordigt.Nota: dit ​ ​vertegenwoordigt niet het formaat u het datumkoord in 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: Vereiste het koord dat 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 componentenwaarden worden gesteund:

"jaar"
"jjjj"
"jj"

"kwart"
"qq"
"q"

"maand"
"mm"
"m"

"dag-van-jaar"
"dag"
"y"

"dag"
3} "dd"
"d"

"week"
"ww"
"w"

"weekdag"
"dw"
"w"

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

"minuut"
"mi"
"n"

"seconde"
"ss"
"s"

"millisecond"
"SSS"
  • COMPONENT: Vereiste een koord dat het deel van de datum vertegenwoordigt.
  • DATUM: Vereiste de datum, in een standaardformaat.
date_part ​(COMPONENT, DATE)
date_part ("MM", date ("2019-10-17 11 :55: 12")
10
set_date_part
Hiermee vervangt u een component in een bepaalde datum. De volgende componenten worden goedgekeurd:

"jaar"
"jjjj"
"yy"

"maand"
"mm"
"m"

"dag"
"dd"
"d"

"uur"
"hh"

"minuut"
"mi"
"n"

"seconde"
"ss"
"s"
  • COMPONENT: Vereiste een koord dat het deel van de datum vertegenwoordigt.
  • WAARDE: Vereiste de waarde voor de component voor een bepaalde datum te plaatsen.
  • DATUM: Vereiste de datum, in een standaardformaat.
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
Hiermee maakt u een datum op basis van onderdelen. Deze functie kan ook worden geïnduceerd met make_timestamp.
  • JAAR: Vereiste het jaar, die in vier cijfers wordt geschreven.
  • MAAND: vereiste de maand. De toegestane waarden zijn 1 tot 12.
  • DAG: Vereiste de dag. De toegestane waarden zijn 1 tot 31.
  • HOUR: Vereiste het uur. De toegestane waarden zijn 0 tot 23.
  • MINUUT: Vereiste de minuut. De toegestane waarden zijn 0 tot en met 59.
  • NANOSECOND: Vereiste de nanotweede waarden. De toegestane waarden zijn 0 tot en met 999999999.
  • TIMEZONE: Vereiste de timezone 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: Vereiste de datum die u probeert om te zetten.
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: Vereiste de datum die u probeert om te zetten.
  • ZONE: Vereiste de timezone die u probeert om de datum in om te zetten.
zone_date_to_zone ​(DATE, ZONE)
zone_date_to_zone(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.
  • INPUT: Vereiste het voorwerp dat u probeert te controleren is leeg.
is_empty(INPUT)
is_empty([1, null, 2, 3])
false
arrays_to_object
Maakt een lijst met objecten.
  • INPUT: Vereiste een groepering van sleutel en serieparen.
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.
  • INPUT: Vereiste een vlakke lijst van 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: Vereiste het koord dat wordt ontleed om een voorwerp tot stand te brengen.
  • VALUE_DELIMITER: Facultatieve afbakening die een gebied van de waarde scheidt. Het standaardscheidingsteken is : .
  • FIELD_DELIMITER: Facultatieve afbakening die de paren van de gebiedswaarde scheidt. Het standaardscheidingsteken is , .
str_to_object ​ (STRING, VALUE_DELIMITER, FIELD_DELIMITER) Nota: U kunt de get() functie samen met str_to_object() gebruiken om waarden voor de sleutels in het koord terug te winnen.
  • 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. Nota: Deze functie vervangt de afgekeurde is_set() functie.
  • INPUT: Vereiste de weg die moet worden gecontroleerd als het binnen de brongegevens bestaat.
contains_key(INPUT)
contains_key("evars.evar.field1")
true
opheffen
Stelt de waarde van het kenmerk in 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: Vereiste het voorwerp waar de sleutels van zullen worden gehaald.
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: Vereiste het koord dat u wilt ontleden.
  • SLEUTEL: Vereiste de sleutel waarvoor de waarde moet worden gehaald.
  • VALUE_DELIMITER: Vereiste Scheidingsteken dat het gebied en de waarde scheidt. Wanneer een null of een lege tekenreeks wordt opgegeven, is deze waarde : .
  • FIELD_DELIMITER: Facultatieve afbakening die gebied en waardeparen scheidt. Wanneer een null of 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.
  • MAP: Vereiste de gegevens van de inputkaart.
  • SLEUTEL: Vereiste de sleutel kan één enkel koord of een koordserie zijn. Als een ander primitief type (data/number) wordt opgegeven, wordt het behandeld als een tekenreeks.
get_values(MAP, KEY)
Gelieve te zien bijlagevoor een codesteekproef.
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.
  • MAP: Vereiste de gegevens van de inputkaart
  • SLEUTEL: Vereiste de sleutel kan één enkel koord of een koordserie zijn. Als een ander primitief type (data/number) wordt opgegeven, wordt het behandeld als een tekenreeks.
map_has_keys(MAP, KEY)
Gelieve te zien bijlagevoor een codesteekproef.
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.
MAP: Vereiste de gegevens van de inputkaart.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Gelieve te zien bijlagevoor een codesteekproef.
object_to_map (Syntaxis 1)
Gebruik deze functie om gegevenstypen Kaart te maken.
  • SLEUTEL: Vereiste Sleutels moeten een koord 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: Vereiste verwijst naar om het even welk gesteund XDM gegevenstype behalve Kaarten.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, …)
Gelieve te zien bijlagevoor een codesteekproef.
object_to_map (syntaxis 2)
Gebruik deze functie om gegevenstypen Kaart te maken.
  • OBJECT: Vereiste U kunt een inkomende voorwerp of objecten serie verstrekken en aan een attribuut binnen het voorwerp als sleutel richten.
object_to_map(OBJECT)
Gelieve te zien bijlagevoor een codesteekproef.
object_to_map (syntaxis 3)
Gebruik deze functie om gegevenstypen Kaart te maken.
  • OBJECT: Vereiste U kunt een inkomende voorwerp of objecten serie verstrekken en aan een attribuut binnen het voorwerp als sleutel richten.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Gelieve te zien bijlagevoor een codesteekproef.

Voor informatie over de eigenschap van het objecten exemplaar, zie hieronder de sectie 🔗.

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.
  • INPUT: Vereiste de serie u het eerste niet-krachteloze voorwerp van wilt vinden.
kool(INPUT)
coalesce(null, null, null, "first", null, "second")
"first"
first
Hiermee wordt het eerste element van de opgegeven array opgehaald.
  • INPUT: Vereiste de serie u het eerste element van wilt vinden.
first (INPUT)
first("1", "2", "3")
"1"
last
Hiermee wordt het laatste element van de opgegeven array opgehaald.
  • INPUT: Vereiste de serie u het laatste element van wilt vinden.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Voegt elementen aan het einde van de array toe.
  • ARRAY: Vereiste de serie die u elementen aan 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: Vereiste de serie die u elementen aan toevoegt.
  • WAARDEN: de array(en) die u aan de bovenliggende array wilt toevoegen.
join_arrays ​(ARRAY, VALUES)
join_series ​ ([ "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: Vereiste een booleaanse waarde om erop te wijzen al dan niet om nul in de reactieserie te omvatten.
  • WAARDEN: Vereiste de elementen die in een serie 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.
  • INPUT: Vereiste het voorwerp dat u probeert om de grootte van 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 slechts toepasselijk tijdens updates. Indien gebruikt in de context van tussenvoegsels, keert deze functie de input zoals is terug.
  • ARRAY: Vereiste de serie om de serie in het Profiel toe te voegen.
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 slechts toepasselijk tijdens updates. Indien gebruikt in de context van tussenvoegsels, keert deze functie de input zoals is terug.
  • ARRAY: Vereiste de serie om de serie in het Profiel te 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.
  • INPUT: Vereiste de objecten serie u het eerste niet-krachteloze voorwerp van wilt vinden.
  • SLEUTEL: Vereiste de sleutel moet een gebiedsnaam in de objecten serie en het voorwerp als waarde zijn.
array_to_map(OBJECT [] INPUTS, KEY)
Lees het bijlagevoor een codesteekproef.
object_to_map
Deze functie neemt een voorwerp als argument en keert een kaart van zeer belangrijk-waardeparen terug.
  • INPUT: Vereiste de objecten serie u het eerste niet-krachteloze voorwerp van wilt vinden.
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.
  • SLEUTEL: Vereiste de sleutel die moet worden aangepast.
  • OPTIONS: Vereiste een samengevoegde serie 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.
  • UITDRUKKING: Vereiste de booleaanse uitdrukking die wordt geëvalueerd.
  • TRUE_VALUE: Vereiste de waarde die is teruggekeerd als de uitdrukking aan waar evalueert.
  • FALSE_VALUE: Vereiste de waarde die is teruggekeerd als de uitdrukking aan vals evalueert.
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: Vereiste Één of meerdere voorwerpen 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: Vereiste Één of meerdere voorwerpen 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: Vereiste het koord dat in een BigInteger moet worden omgezet.
to_bigint(STRING)
to_bigint ​("1000000.34")
1000000,34
to_decimal
Zet een tekenreeks om in een double.
  • STRING: Vereiste het koord dat in een Dubbel moet worden omgezet.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Zet een tekenreeks om in een zwevende waarde.
  • TEKENREEKS: Vereiste het koord dat in een Float moet worden omgezet.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Zet een tekenreeks om in een geheel getal.
  • TEKENREEKS: Vereiste het koord dat in een Geheel 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: vereiste het koord JSON om 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-2e1c9c20633
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: Vereiste het koord FPID dat 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 de waarden van het apparatengebied, te lezen gelieve de lijst van de waarden van het apparatengebiedin 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: Vereiste het koord van de gebruikersagent.
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: Vereiste het koord van de gebruikersagent.
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: Vereiste het koord van de gebruikersagent.
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: Vereiste het koord van de gebruikersagent.
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: Vereiste het koord van de gebruikersagent.
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: Vereiste het koord van de gebruikersagent.
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: Vereiste het koord van de gebruikersagent.
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: Vereiste het koord van de gebruikersagent.
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: Vereiste het komma-gescheiden de gebeurteniskoord van de Analyse.
  • EVENT_NAME: Vereiste de gebeurtenisnaam om uit te halen en identiteitskaart van.
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: Vereiste het komma-gescheiden de gebeurteniskoord van de Analyse.
  • EVENT_NAME: Vereiste de gebeurtenisnaam om een waarde uit te halen.
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: Vereiste het koord van de Producten van de Analyse.
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")
[ ongeldig, "Categorie 2 van het Voorbeeld"]
aa_get_product_names
Extraheert de productnaam uit een productreeks Analytics.
  • PRODUCTS_STRING: Vereiste het koord van de Producten van de Analyse.
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: Vereiste het koord van de Producten van de Analyse.
a_get_product_Quantities(PRODUCTS_STRING)
aa_get_product_Quantities(";Voorbeeld product 1;1;3.50,Voorbeeld categorie 2;Voorbeeld product 2")
[ "1", ongeldig ]
aa_get_product_pricing
Extraheert de prijs uit een productreeks van Analytics.
  • PRODUCTS_STRING: Vereiste het koord van de Producten van de Analyse.
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: Vereiste het koord van de Producten van de Analyse.
  • EVENT_NAME: Vereiste de gebeurtenisnaam om waarden uit te halen.
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: Vereiste het koord van de Producten van de Analyse.
  • EVAR_NAME: Vereiste de naam van eVar om te halen.
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 worden de kenmerken city en state ook automatisch opgenomen bij uitvoering, omdat het object address wordt toegewezen aan addr . Als u een line2 -kenmerk in de XDM-structuur moet maken en uw invoergegevens ook een line2 in het address -object bevatten, wordt dit kenmerk automatisch opgenomen zonder dat u de toewijzing handmatig hoeft te wijzigen.

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 zijn dit useragents die zijn gewijzigd door een anonymiisatiesoftware.
Onbekend
Een onbekend apparaat. Dit zijn meestal useragents die geen informatie over het apparaat bevatten.
Mobiel
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 een Playstation of een XBox .
Handheldspelconsole
Een mobiel gamesysteem zoals een Nintendo Switch .
Stem
Een door spraak gestuurd apparaat zoals een Amazon Alexa of een 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 zoals Google , maar dat zijn ze niet. Nota: In de meeste gevallen, zijn de Imitators van Robot inderdaad robots.
Wolk
Een cloudgebaseerde toepassing. Dit zijn geen robots of hackers, maar toepassingen die verbinding moeten maken. Dit geldt ook voor Mastodon servers.
Hacker
Deze apparaatwaarde wordt gebruikt voor het geval dat scripts worden gedetecteerd in de 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