Funktioner för datapersonmappning

Dataprep-funktioner kan användas för att beräkna och beräkna värden baserat på vad som anges i källfält.

Fält

Ett fältnamn kan vara vilken giltig identifierare som helst - en sekvens med obegränsad längd av Unicode-bokstäver och siffror som börjar med en bokstav, dollartecknet ($) eller understrecket (_). Variabelnamn är också skiftlägeskänsliga.

Om ett fältnamn inte följer den här regeln måste fältnamnet kapslas in med ${}. Om fältnamnet till exempel är "Förnamn" eller "Förnamn" måste namnet radbrytas som ${First Name} respektive ${First\.Name}.

TIP
Om ett underordnat attribut har en punkt (.) vid interaktion med hierarkier måste du använda ett omvänt snedstreck (\) för att undvika specialtecken. Mer information finns i handboken om att kringgå specialtecken.

Om ett fältnamn är något av följande reserverade nyckelord måste det kapslas med ${}{}:

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

Dessutom innehåller reserverade nyckelord alla mappningsfunktioner som listas på den här sidan.

Du kan komma åt data i underfält genom att använda punktnotation. Om det till exempel finns ett name-objekt använder du name.firstName för att komma åt fältet firstName.

Lista över funktioner

I följande tabeller visas alla mappningsfunktioner som stöds, inklusive exempeluttryck och deras resulterande utdata.

Strängfunktioner string

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
concat
Sammanfogar de angivna strängarna.
  • STRING: Strängarna som ska sammanfogas.
concat(STRING_1, STRING_2)
concat("Hi, ", "there", "!")
"Hi, there!"
explodera
Delar strängen baserat på en regex och returnerar en array med delar. Kan även inkludera regex för att dela upp strängen. Som standard tolkas delningen som ",". Följande avgränsare måste föregås av \: +, ?, ^, |, ., [, (, {, ), *, $, \ Om du inkluderar flera tecken som avgränsare behandlas avgränsaren som en avgränsare med flera tecken.
  • STRING: Required Strängen som måste delas.
  • REGEX: Valfritt Det reguljära uttryck som kan användas för att dela strängen.
explode(STRING, REGEX)
explode("Hej, där!", "")
["Hi,", "there"]
instr
Returnerar platsen/indexvärdet för en delsträng.
  • INPUT: Required Strängen som söks igenom.
  • SUBSTRING: Required Den delsträng som söks efter i strängen.
  • START_POSITION: Valfritt Platsen där sökningen ska börja i strängen.
  • FÖREKOMST: Valfritt Den n förekomsten att söka efter från startpositionen. Som standard är det 1.
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE)
instr("adobe.com", "com")
6
replacester
Ersätter söksträngen om den finns i den ursprungliga strängen.
  • INPUT: Required Indatasträngen.
  • TO_FIND: Required Strängen som ska slås upp i indata.
  • TO_REPLACE: Required Strängen som ska ersätta värdet i TO_FIND.
replacester(INPUT, TO_FIND, TO_REPLACE)
replacestr("This is a string re test", "re", "replace")
"This is a string replace test"
substr
Returnerar en delsträng med en viss längd.
  • INPUT: Required Indatasträngen.
  • START_INDEX: Required Indexvärdet för den indatasträng där delsträngen börjar.
  • LENGTH: Required Längden på delsträngen.
substr(INPUT, START_INDEX, LENGTH)
substr("This is a substring test", 7, 8)
" a subst"
lower /
lcase
Konverterar en sträng till gemener.
  • INPUT: Required Strängen som ska konverteras till gemener.
lower(INPUT)
lower("HanLo")
lcase("HanLo")
"hello"
upper /
ucase
Konverterar en sträng till versaler.
  • INPUT: Required Strängen som ska konverteras till versaler.
upper(INPUT)
upper("HanLo")
ucase("HanLo")
"HELLO"
dela
Delar en indatasträng på en avgränsare. Följande avgränsare måste föregås av \: \. Om du inkluderar flera avgränsare delas strängen upp på valfri av avgränsarna som finns i strängen. Obs! Den här funktionen returnerar bara index som inte är null från strängen, oavsett om avgränsaren finns. Om alla index, inklusive null, krävs i den resulterande arrayen använder du funktionen "explode" i stället.
  • INPUT: Required Den indatasträng som ska delas.
  • SEPARATOR: Required Strängen som används för att dela indata.
split(INPUT, SEPARATOR)
split("Hello world", " ")
["Hello", "world"]
join
Sammanfogar en lista med objekt med hjälp av avgränsaren.
  • SEPARATOR: Required Strängen som ska användas för att förena objekten.
  • OBJEKT: Obligatoriskt En matris med strängar som ska kopplas.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Hello world"
lpad
Placerar den vänstra sidan av en sträng med den andra angivna strängen.
  • INPUT: Required Strängen som ska utfyllas. Strängen kan vara null.
  • ANTAL: Obligatoriskt Strängstorleken som ska utfyllas.
  • PADDING: Required Strängen som indata ska fyllas med. Om värdet är null eller tomt behandlas det som ett enda mellanslag.
lpad(INPUT, COUNT, PADDING)
lpad("bat", 8, "yz")
"yzybat"
rpad
Placerar höger sida av en sträng med den andra angivna strängen.
  • INPUT: Required Strängen som ska utfyllas. Strängen kan vara null.
  • ANTAL: Obligatoriskt Strängstorleken som ska utfyllas.
  • PADDING: Required Strängen som indata ska fyllas med. Om värdet är null eller tomt behandlas det som ett enda mellanslag.
rpad(INPUT, COUNT, PADDING)
rpad("bat", 8, "yz")
"batyzyzy"
vänster
Hämtar de första n-tecknen i den angivna strängen.
  • STRING: Required Strängen som du hämtar de första n-tecknen för.
  • ANTAL: Obligatoriskt De n-tecken som du vill hämta från strängen.
left(STRING, COUNT)
left("abcde", 2)
"ab"
höger
Hämtar de sista n-tecknen i den angivna strängen.
  • STRING: Required Strängen du hämtar de sista n-tecknen för.
  • ANTAL: Obligatoriskt De n-tecken som du vill hämta från strängen.
right(STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Tar bort mellanrummet från början av strängen.
  • STRING: Required Strängen som du vill ta bort mellanrummet från.
ltrim(STRING)
ltrim(" hello")
"hello"
rtrim
Tar bort mellanrummet från strängens slut.
  • STRING: Required Strängen som du vill ta bort mellanrummet från.
rtrim(STRING)
rtrim("hello ")
"hello"
trim
Tar bort mellanrummet från början och slutet av strängen.
  • STRING: Required Strängen som du vill ta bort mellanrummet från.
trim(STRING)
trim(" hello ")
"hello"
är lika med
Jämför två strängar för att bekräfta om de är lika. Den här funktionen är skiftlägeskänslig.
  • STRING1: Required Den första strängen som du vill jämföra.
  • STRING2: Required Den andra strängen som du vill jämföra.
STRING1. ​equals( ​ STRING2)
"string1". ​equals ​("STRING1")
false
equalsIgnoreCase
Jämför två strängar för att bekräfta om de är lika. Den här funktionen är inte skiftlägeskänslig.
  • STRING1: Required Den första strängen som du vill jämföra.
  • STRING2: Required Den andra strängen som du vill jämföra.
STRING1. ​equalsIgnoreCase ​(STRING2)
"string1". ​equalsIgnoreCase ​("STRING1)
true

Funktioner för reguljära uttryck

Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
extract_regex
Extraherar grupper från indatasträngen baserat på ett reguljärt uttryck.
  • STRING: Required Strängen som du extraherar grupperna från.
  • REGEX: Obligatoriskt Det reguljära uttryck som du vill att gruppen ska matcha.
extract_regex(STRING, REGEX)
extract_regex ​("E259,E259B_009,1_1" ​, "([,]+),[,]*,([^,]+)")
["E259,E259B_009,1_1", "E259", "1_1"]
match_regex
Kontrollerar om strängen matchar det inmatade reguljära uttrycket.
  • STRING: Required Strängen som du kontrollerar matchar det reguljära uttrycket.
  • REGEX: Obligatoriskt Det reguljära uttryck som du jämför med.
match_regex(STRING, REGEX)
match_regex("E259,E259B_009,1_1", "([,]+),[,]*,([^,]+)")
true

Hash-funktioner hashing

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
sha1
Tar en inmatning och skapar ett hash-värde med SHA-1 (Secure Hash Algorithm 1).
  • INMATNING: Krävs Den oformaterade text som ska hashas.
  • CHARSET: Valfritt Namnet på teckenuppsättningen. Möjliga värden är UTF-8, UTF-16, ISO-8859-1 och US-ASCII.
sha1(INPUT, CHARSET)
sha1("min text", "UTF-8")
c3599c11e47719df18a24 ​ 48690840c5dfcce3c80
sha256
Tar en inmatning och skapar ett hash-värde med Secure Hash Algorithm 256 (SHA-256).
  • INMATNING: Krävs Den oformaterade text som ska hashas.
  • CHARSET: Valfritt Namnet på teckenuppsättningen. Möjliga värden är UTF-8, UTF-16, ISO-8859-1 och US-ASCII.
sha256(INPUT, CHARSET)
sha256("min text", "UTF-8")
7330d2b39ca35eaf4cb95fc846c21 ​ ee6a39af698154a83a586ee270a0d372104
sha512
Tar en inmatning och skapar ett hash-värde med hjälp av den säkra hash-algoritmen 512 (SHA-512).
  • INMATNING: Krävs Den oformaterade text som ska hashas.
  • CHARSET: Valfritt Namnet på teckenuppsättningen. Möjliga värden är UTF-8, UTF-16, ISO-8859-1 och US-ASCII.
sha512(INPUT, CHARSET)
sha512("min text", "UTF-8")
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef ​ 708bf11b4232bb21d2a8704ada2cdcd7b367dd07 88a89 ​ a5c908cfe377aceb1072a7b386b7d4fd2ff68a8fd24d16
md5
Tar en inmatning och skapar ett hash-värde med MD5.
  • INMATNING: Krävs Den oformaterade text som ska hashas.
  • CHARSET: Valfritt Namnet på teckenuppsättningen. Möjliga värden är UTF-8, UTF-16, ISO-8859-1 och US-ASCII.
md5(INPUT, CHARSET)
md5("min text", "UTF-8")
d3b96ce8c9fb4 ​ e9bd0198d03ba6852c7
crc32
Tar en inmatning använder en algoritm för cyklisk redundanskontroll (CRC) för att skapa en 32-bitars cyklisk kod.
  • INMATNING: Krävs Den oformaterade text som ska hashas.
  • CHARSET: Valfritt Namnet på teckenuppsättningen. Möjliga värden är UTF-8, UTF-16, ISO-8859-1 och US-ASCII.
crc32(INPUT, CHARSET)
crc32("min text", "UTF-8")
8df92e80

URL-funktioner url

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
get_url_protocol
Returnerar protokollet från angiven URL. Om indata är ogiltiga returneras null.
  • URL: Obligatoriskt Den URL som protokollet måste extraheras från.
get_url_protocol ​(URL)
get_url_protocol("https://platform ​ .adobe.com/home")
https
get_url_host
Returnerar värddatorn för angiven URL. Om indata är ogiltiga returneras null.
  • URL: Obligatoriskt Den URL som värden måste extraheras från.
get_url_host ​(URL)
get_url_host ​("https://platform ​ .adobe.com/home")
platform.adobe.com
get_url_port
Returnerar porten för angiven URL. Om indata är ogiltiga returneras null.
  • URL: Obligatoriskt Den URL som porten måste extraheras från.
get_url_port(URL)
get_url_port ​("sftp://example.com//home/ ​ joe/employee.csv")
22
get_url_path
Returnerar sökvägen till angiven URL. Som standard returneras den fullständiga sökvägen.
  • URL: Obligatoriskt URL:en som sökvägen måste extraheras från.
  • FULL_PATH: Valfritt Ett booleskt värde som avgör om den fullständiga sökvägen returneras. Om värdet är false returneras bara slutet av sökvägen.
get_url_path ​(URL, FULL_PATH)
get_url_path ​("sftp://example.com// ​ home/joe/employee.csv")
"//home/joe/​ employee.csv"
get_url_query_str
Returnerar frågesträngen för en angiven URL som en mappning av frågesträngsnamnet och frågesträngsvärdet.
  • URL: Obligatoriskt Den URL som du försöker hämta frågesträngen från.
  • ANCHOR: Required Avgör vad som ska göras med ankaret i frågesträngen. Kan vara ett av tre värden: "keep", "remove" eller "append".

    Om värdet är "behåll" kopplas ankarpunkten till det returnerade värdet.
    Om värdet är "remove" tas ankarpunkten bort från det returnerade värdet.
    Om värdet är "append" returneras ankarpunkten som ett separat värde.
get_url_query_str ​(URL, ANCHOR)
get_url_query_str ​("foo://example.com:8042 ​/over/here?name= ​ ferret#nos", "keep")
get_url_query_str ​("foo://example.com:8042 ​/over/here?name= ​ ferret#nos", "remove")
get_url_query_str ​("foo://example.comågor:8042/over/where?name=illret#nos", "append")
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
Den här funktionen tar en URL som indata och ersätter eller kodar specialtecknen med ASCII-tecken. Mer information om specialtecken finns i listan över specialtecken i bilagan till det här dokumentet.
  • URL: Obligatoriskt Indata-URL:en med specialtecken som du vill ersätta eller koda med ASCII-tecken.
get_url_encoded(URL)
get_url_encoded("https://example.com/partneralliance_asia-pacific_2022")
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022
get_url_decoded
Den här funktionen tar en URL som indata och avkodar ASCII-tecken till specialtecken. Mer information om specialtecken finns i listan över specialtecken i bilagan till det här dokumentet.
  • URL: Obligatoriskt Indata-URL:en med ASCII-tecken som du vill avkoda till specialtecken.
get_url_decoded(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022")
/example.com/partneralliance_asia-pacific_2022

Datum- och tidsfunktioner date-and-time

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen. Mer information om funktionen date finns i datumavsnittet i hanteringsguiden för dataformat.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
now
Hämtar aktuell tid.
now()
now()
2021-10-26T10:10:24Z
tidsstämpel
Hämtar aktuell Unix-tid.
timestamp()
timestamp()
1571850624571
format
Formaterar indatadatum enligt ett angivet format.
  • DATE: Required Indatadatum, som ett ZonedDateTime-objekt, som du vill formatera.
  • FORMAT: Obligatoriskt Formatet som du vill ändra datumet till.
format(DATE, FORMAT)
format(2019-10-23T11:24:00+00:00, "yyyy-MM-dd HH:mm:ss")
2019-10-23 11:24:35
dformat
Konverterar en tidsstämpel till en datumsträng enligt ett angivet format.
  • TIDSSTÄMPEL: Krävs Tidsstämpeln som du vill formatera. Detta skrivs i millisekunder.
  • FORMAT: Obligatoriskt Det format som du vill att tidsstämpeln ska bli.
dformat(TIMESTAMP, FORMAT)
format(1571829875000, "yyyy-MM-dd'T'HH:mm:ss.SSSX")
2019-10-23T11:24:35.000Z
datum
Konverterar en datumsträng till ett ZonedDateTime-objekt (ISO 8601-format).
  • DATE: Required Strängen som representerar datumet.
  • FORMAT: Obligatoriskt Strängen som representerar formatet för källdatumet.Obs! Detta representerar inte formatet som du vill konvertera datumsträngen till.
  • DEFAULT_DATE: Required Standarddatumet returnerades om det angivna datumet är null.
date(DATE, FORMAT, DEFAULT_DATE)
date("2019-10-23 11:24", "yyy-MM-dd HH:mm", now())
2019-10-23T11:24:00Z
datum
Konverterar en datumsträng till ett ZonedDateTime-objekt (ISO 8601-format).
  • DATE: Required Strängen som representerar datumet.
  • FORMAT: Obligatoriskt Strängen som representerar formatet för källdatumet.Obs! Detta representerar inte formatet som du vill konvertera datumsträngen till.
date(DATE, FORMAT)
date("2019-10-23 11:24", "yyy-MM-dd HH:mm")
2019-10-23T11:24:00Z
datum
Konverterar en datumsträng till ett ZonedDateTime-objekt (ISO 8601-format).
  • DATE: Required Strängen som representerar datumet.
date(DATE)
date("2019-10-23 11:24")
"2019-10-23T11:24:00Z"
date_part
Hämtar datumets delar. Följande komponentvärden stöds:

"year"
"yyy"
"yy"

"quarters"
"qq"
"q"

"month"
"mm"
"m"

"day of year"
"dy"
"y"

"day"{1
"dd"
"d"

"vecka"
"ww"
"w"

"veckodag"
"dw"
"w"

"hour"
"hh"
"hh24"
"hh12"

"minute"
"mi"
"n"

"second"
"ss"
"s"

"millisecond"
"SSS"
  • KOMPONENT: Obligatorisk En sträng som representerar datumdelen.
  • DATUM: Obligatoriskt Datumet i standardformat.
date_part ​(COMPONENT, DATE)
date_part("MM", date("2019-10-17 11:55:12"))
10
set_date_part
Ersätter en komponent vid ett visst datum. Följande komponenter accepteras:

"year"
"yyy"
"yy"

"month"
"mm"
"m"

"day"
"dd"
"d"

"hour"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • KOMPONENT: Obligatorisk En sträng som representerar datumdelen.
  • VÄRDE: Obligatoriskt Värdet som ska anges för komponenten för ett visst datum.
  • DATUM: Obligatoriskt Datumet i standardformat.
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
Skapar ett datum från delar. Den här funktionen kan också induceras med make_timestamp.
  • ÅR: Obligatoriskt Året, skrivet med fyra siffror.
  • MÅNAD: Krävs Månad. Tillåtna värden är 1 till 12.
  • DAG: Krävs Dagen. Tillåtna värden är 1 till 31.
  • TIMME: Krävs Timmen. De tillåtna värdena är 0 till 23.
  • MINUT: Krävs minuten. De tillåtna värdena är 0 till 59.
  • NANOSECOND: Required The nanosecond values. De tillåtna värdena är 0 till 999999999.
  • TIMEZONE: Required Tidszonen för datumet och tiden.
make_date_time ​(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, NANOSECOND, TIMEZONE)
make_date_time ​(2019, 10, 17, 11, 55, 12, 999, "America/Los_Angeles")
2019-10-17T11:55:12Z
zone_date_to_utc
Konverterar ett datum i en tidszon till ett datum i UTC.
  • DATUM: Obligatoriskt Det datum som du försöker konvertera.
zone_date_to_utc ​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
Konverterar ett datum från en tidszon till en annan tidszon.
  • DATUM: Obligatoriskt Det datum som du försöker konvertera.
  • ZON: Obligatoriskt Tidszonen som du försöker konvertera datumet till.
zone_date_to_zone ​(DATE, ZONE)
zone_date_to_zone(now(), "Europe/Paris")
2021-10-26T15:43:59Z

Hierarkier - objekt objects

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
is_empty
Kontrollerar om ett objekt är tomt eller inte.
  • INMATNING: Nödvändigt Objektet som du försöker kontrollera är tomt.
is_empty(INPUT)
is_empty([1, null, 2, 3])
false
arrayer_to_object
Skapar en lista med objekt.
  • INMATNING: Obligatoriskt En gruppering av nyckel- och matrispar.
arrayer_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
Skapar ett objekt baserat på de platta nyckel-/värdepar som anges.
  • INMATNING: Krävs En platt lista över nyckel-/värdepar.
to_object(INPUT)
to_object ​("firstName", "John", "lastName", "Doe")
{"firstName": "John", "lastName": "Doe"}
str_to_object
Skapar ett objekt från indatasträngen.
  • STRING: Required Strängen som tolkas för att skapa ett objekt.
  • VALUE_DELIMITER: Valfritt Avgränsaren som skiljer ett fält från värdet. Standardavgränsaren är :.
  • FIELD_DELIMITER: Valfritt Avgränsaren som avgränsar fältvärdepar. Standardavgränsaren är ,.
str_to_object ​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Obs!: Du kan använda funktionen get() tillsammans med str_to_object() för att hämta värden för nycklarna i strängen.
  • Exempel 1: str_to_object("firstName - John ; lastName - ; - 123 345 7890", "-", ";")
  • Exempel 2: str_to_object("firstName - John ; lastName - ; phone - 123 456 7890", "-", ";").get("firstName")
  • Exempel 1:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • Exempel 2: "John"
contains_key
Kontrollerar om objektet finns i källdata. Obs! Den här funktionen ersätter den inaktuella is_set()-funktionen.
  • INMATNING: Nödvändig Sökvägen som ska kontrolleras om den finns i källdata.
contains_key(INPUT)
contains_key("evar.evar.field1")
true
null
Anger värdet för attributet till null. Detta bör användas när du inte vill kopiera fältet till målschemat.
nullify()
nullify()
null
get_keys
Tolkar nyckel/värde-paren och returnerar alla nycklar.
  • OBJEKT: Obligatoriskt Det objekt som nycklarna ska extraheras från.
get_keys(OBJECT)
get_keys({"book1": "Pride and Prekurce", "book2": "1984"})
["book1", "book2"]
get_values
Tolkar nyckel/värde-paren och returnerar värdet för strängen baserat på den angivna nyckeln.
  • STRING: Required Strängen som du vill tolka.
  • KEY: Required Nyckeln som värdet ska extraheras för.
  • VALUE_DELIMITER: Required Avgränsaren som avgränsar fältet och värdet. Om antingen null eller en tom sträng anges är det här värdet :.
  • FIELD_DELIMITER: Valfritt Avgränsaren som avgränsar fält- och värdepar. Om antingen null eller en tom sträng anges är det här värdet ,.
get_values(STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER)
get_values("firstName - John, lastName - Cena, phone - 555 420 8692", "firstName", "-", ",")
John
map_get_values
Tar en karta och tangentindata. Om indata är en enskild tangent returnerar funktionen det värde som är associerat med den tangenten. Om indata är en strängarray returnerar funktionen alla värden som motsvarar de angivna nycklarna. Om den inkommande kartan innehåller dubblettnycklar måste returvärdet avduplicera nycklarna och returnera unika värden.
  • MAP: Obligatoriskt Indatamappningsdata.
  • KEY: Required Nyckeln kan vara en sträng eller en strängmatris. Om någon annan primitiv typ (data/tal) anges behandlas den som en sträng.
get_values(MAP, KEY)
Ett kodexempel finns i bilagan.
map_has_keys
Om en eller flera indatanycklar anges returnerar funktionen true. Om en strängarray anges som indata returnerar funktionen true för den första nyckeln som hittas.
  • MAP: Obligatoriskt Indatamappningsdata
  • KEY: Required Nyckeln kan vara en sträng eller en strängmatris. Om någon annan primitiv typ (data/tal) anges behandlas den som en sträng.
map_has_keys(MAP, KEY)
Ett kodexempel finns i bilagan.
add_to_map
Accepterar minst två indata. Ett valfritt antal kartor kan anges som indata. Data Prep returnerar en enda karta som innehåller alla nyckelvärdepar från alla indata. Om en eller flera nycklar upprepas (på samma karta eller tvärs över kartor) deduplicerar Data Prep nycklarna så att det första nyckel/värde-paret kvarstår i den ordning som de skickades i indata.
MAP: Obligatoriskt Indatamappningsdata.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Ett kodexempel finns i bilagan.
object_to_map (Syntax 1)
Använd den här funktionen om du vill skapa datatyperna för kartan.
  • KEY: Obligatoriska-nycklar måste vara en sträng. Om det finns andra primitiva värden, till exempel heltal eller datum, konverteras de automatiskt till strängar och behandlas som strängar.
  • ANY_TYPE: Required Avser alla XDM-datatyper som stöds, förutom Maps.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, …)
Ett kodexempel finns i bilagan.
object_to_map (Syntax 2)
Använd den här funktionen om du vill skapa datatyperna för kartan.
  • OBJECT: Required Du kan ange en inkommande objekt- eller objektmatris och peka på ett attribut inuti objektet som nyckel.
object_to_map(OBJECT)
Ett kodexempel finns i bilagan.
object_to_map (Syntax 3)
Använd den här funktionen om du vill skapa datatyperna för kartan.
  • OBJECT: Required Du kan ange en inkommande objekt- eller objektmatris och peka på ett attribut inuti objektet som nyckel.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Ett kodexempel finns i bilagan.

Mer information om objektkopieringsfunktionen finns i avsnittet nedan.

Hierarkier - matriser arrays

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
coalesce
Returnerar det första icke-null-objektet i en given array.
  • INPUT: Required Arrayen som du vill hitta det första icke-null-objektet för.
coalesce(INPUT)
coalesce(null, null, null, "first", null, "second")
"first"
först
Hämtar det första elementet i den angivna arrayen.
  • INPUT: Required Arrayen som du vill hitta det första elementet i.
first(INPUT)
first("1", "2", "3")
"1"
sista
Hämtar det sista elementet i den angivna arrayen.
  • INPUT: Required Arrayen som du vill hitta det sista elementet i.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Lägger till element i slutet av arrayen.
  • ARRAY: Required Arrayen som du lägger till element i.
  • VÄRDEN: De element som du vill lägga till i arrayen.
add_to_array ​(ARRAY, VALUES)
add_to_array ​(['a', 'b'], 'c', 'd')
['a', 'b', 'c', 'd']
join_arrays
Kombinerar arrayerna med varandra.
  • ARRAY: Required Arrayen som du lägger till element i.
  • VÄRDEN: Den eller de matriser som du vill lägga till i den överordnade matrisen.
join_arrays ​(ARRAY, VALUES)
join_arrays ​(['a', 'b'], ['c'], ['d', 'e'])
['a', 'b', 'c', 'd', 'e']
to_array
Tar en lista med indata och konverterar den till en array.
  • INCLUDE_NULLS: Required Ett booleskt värde som anger om null-värden ska tas med i svarsarrayen eller inte.
  • VÄRDEN: Obligatoriskt De element som ska konverteras till en array.
to_array ​(INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Returnerar storleken på indata.
  • INPUT: Obligatoriskt Det objekt som du försöker hitta storleken på.
size_of(INPUT)
size_of([1, 2, 3, 4])
4
upsert_array_append
Den här funktionen används för att lägga till alla element i hela inmatningsarrayen i slutet av arrayen i profilen. Den här funktionen är endast tillämplig under uppdateringar. Om den används i infogningskontexten returneras indata i befintligt skick.
  • ARRAY: Required Arrayen som ska läggas till i arrayen i profilen.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[123, 456]
upsert_array_replace
Den här funktionen används för att ersätta element i en array. Den här funktionen är endast tillämplig under uppdateringar. Om den används i infogningskontexten returneras indata i befintligt skick.
  • ARRAY: Required Arrayen som ska ersätta arrayen i profilen.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123, 456]
[Endast mål]{class="badge informative"} array_to_string
Sammanfogar strängrepresentationerna för elementen i en array med den angivna avgränsaren. Om arrayen är flerdimensionell förenklas den innan den förenas. Obs! Den här funktionen används i mål. Mer information finns i dokumentationen.
  • SEPARATOR: Required Avgränsaren som används för att förena elementen i arrayen.
  • ARRAY: Required Arrayen som ska förenas (efter förenkling).
array_to_string(SEPARATOR, ARRAY)
array_to_string(";", ["Hello", "world"])
"Hello;world"
[Endast mål]{class="badge informative"} filterArray*
Filtrerar den angivna arrayen baserat på ett predikat. Obs! Den här funktionen används i mål. Mer information finns i dokumentationen.
  • ARRAY: Obligatorisk Matrisen som ska filtreras
  • PREDICATE: Required Predikatet som ska användas för varje element i den angivna arrayen.
filterArray(ARRAY, PREDICATE)
filterArray([5, -6, 0, 7], x -> x > 0)
[5, 7]
[Endast destinationer]{class="badge informative"} transformArray*
Omformar den angivna arrayen baserat på ett predikat. Obs! Den här funktionen används i mål. Mer information finns i dokumentationen.
  • ARRAY: Required Arrayen som ska omformas.
  • PREDICATE: Required Predikatet som ska användas för varje element i den angivna arrayen.
transformArray(ARRAY, PREDICATE)
transformArray([5, 6, 7], x -> x + 1)
[6, 7, 8]
[Endast mål]{class="badge informative"} flattenArray*
Förenklar den angivna (flerdimensionella) arrayen till en endimensionell array. Obs! Den här funktionen används i mål. Mer information finns i dokumentationen.
  • ARRAY: Obligatorisk Matrisen som ska förenklas.
flattenArray(ARRAY)
flattenArray([['a', 'b'], ['c', 'd']], [['e'], ['f']]))
['a', 'b', 'c', 'd', 'e', 'f']

Hierarkier - karta map

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
array_to_map
Den här funktionen tar en objektarray och en nyckel som indata och returnerar en karta över nyckelfältet med värdet key och arrayelementet som value.
  • INPUT: Required Objektarrayen som du vill hitta det första icke-null-objektet för.
  • KEY: Required Nyckeln måste vara ett fältnamn i objektarrayen och objektet som värde.
array_to_map(OBJECT[] INPUTS, KEY)
I bilagan finns ett kodexempel.
object_to_map
Den här funktionen tar ett objekt som argument och returnerar en karta över nyckelvärdepar.
  • INPUT: Required Objektarrayen som du vill hitta det första icke-null-objektet för.
object_to_map(OBJECT_INPUT)
"object_to_map(address) där input är " + "address: {line1 : "345 park ave",line2: "bldg 2",City : "san jose",State : "CA",type: "office"}"
Returnerar en karta med angivet fältnamn och värde-par eller null om indata är null. Till exempel: "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
Den här funktionen tar en lista över par med nyckelvärden och returnerar en karta med par med nyckelvärden.
to_map(OBJECT_INPUT)
"to_map("firstName", "John", "lastName", "Doe")"
Returnerar en karta med angivet fältnamn och värde-par eller null om indata är null. Till exempel: "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Logiska operatorer logical-operators

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
decode
Om en nyckel och en lista med nyckelvärdepar förenklas som en array, returnerar funktionen värdet om nyckeln hittas eller returnerar ett standardvärde om det finns i arrayen.
  • NYCKEL: Krävs Nyckeln som ska matchas.
  • OPTIONS: Obligatorisk En förenklad matris med nyckel/värde-par. Ett standardvärde kan också placeras i slutet.
decode(KEY, OPTIONS)
decode(stateCode, "ca", "California", "pa", "Pennsylvania", "N/A")
Om given stateCode är "ca", "California".
Om angiven stateCode är "pa", "Pennsylvania".
Om stateCode inte matchar följande, "N/A".
iif
Utvärderar ett givet booleskt uttryck och returnerar det angivna värdet baserat på resultatet.
  • UTTRYCK: Obligatoriskt Det booleska uttryck som utvärderas.
  • TRUE_VALUE: Required Värdet som returneras om uttrycket utvärderas till true.
  • FALSE_VALUE: Required Värdet som returneras om uttrycket utvärderas till false.
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE)
iif("s".equalsIgnoreCase("S"), "True", "False")
"Sant"

Aggregering aggregation

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
min
Returnerar det minsta av de angivna argumenten. Använder naturlig beställning.
  • OPTIONS: Obligatoriskt Ett eller flera objekt som kan jämföras med varandra.
min(OPTIONS)
min(3, 1, 4)
1
max
Returnerar det maximala antalet angivna argument. Använder naturlig beställning.
  • OPTIONS: Obligatoriskt Ett eller flera objekt som kan jämföras med varandra.
max(OPTIONS)
max(3, 1, 4)
4

Typkonverteringar type-conversions

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
to_bigint
Konverterar en sträng till ett BigInteger.
  • STRING: Required Strängen som ska konverteras till ett BigInteger.
to_bigint(STRING)
to_bigint ​("100000.34")
1000000,34
to_decimal
Konverterar en sträng till en dubbel sträng.
  • STRING: Required Strängen som ska konverteras till Double.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Konverterar en sträng till en flyttal.
  • STRING: Required Strängen som ska konverteras till ett flyttal.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Konverterar en sträng till ett heltal.
  • STRING: Required Strängen som ska konverteras till ett heltal.
to_integer(STRING)
to_integer("12")
12

JSON-funktioner json

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
json_to_object
Deserialisera JSON-innehåll från angiven sträng.
  • STRING: Required JSON-strängen som ska avserialiseras.
json_to_object ​(STRING)
json_to_object ​({"info":{"firstName":"John","lastName": "Doe"}})
Ett objekt som representerar JSON.

Särskilda åtgärder special-operations

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
uuid /
guid
Skapar ett pseudoslumpmässigt ID.
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c20633
fpid_to_ecid
Den här funktionen tar en FPID-sträng och konverterar den till ett ECID som ska användas i Adobe Experience Platform- och Adobe Experience Cloud-program.
  • STRING: Required Den FPID-sträng som ska konverteras till ECID.
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

Användaragentfunktioner user-agent

Alla användaragentfunktioner i tabellen nedan kan returnera något av följande värden:

  • Telefon - En mobil enhet med liten skärm (vanligen < 7 tum)
  • Mobil - En mobil enhet som ännu inte har identifierats. Den här mobila enheten kan vara en eReader, en surfplatta, en telefon, en klocka osv.

Mer information om enhetsfältvärden finns i listan över enhetsfältvärden i bilagan till det här dokumentet.

NOTE
Rulla åt vänster/höger för att visa hela innehållet i tabellen.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
ua_os_name
Extraherar operativsystemets namn från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_os_name ​(USER_AGENT)
ua_os_name ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS
ua_os_version_major
Extraherar operativsystemets huvudversion från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_os_version_major ​(USER_AGENT)
ua_os_version_major ​ s("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5
ua_os_version
Hämtar operativsystemets version från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_os_version ​(USER_AGENT)
ua_os_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5.1.1
ua_os_name_version
Hämtar operativsystemets namn och version från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_os_name_version ​(USER_AGENT)
ua_os_name_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5.1.1
ua_agent_version
Hämtar agentversionen från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_agent_version ​(USER_AGENT)
ua_agent_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5,1
ua_agent_version_major
Hämtar agentnamnet och huvudversionen från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_agent_version_major ​(USER_AGENT)
ua_agent_version_major ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari 5
ua_agent_name
Hämtar agentnamnet från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_agent_name ​(USER_AGENT)
ua_agent_name ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari
ua_device_class
Hämtar enhetsklassen från användaragentsträngen.
  • USER_AGENT: Required Användaragentsträngen.
ua_device_class ​(USER_AGENT)
ua_device_class ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Telefon

Analysfunktioner analytics

NOTE
Du får bara använda följande analysfunktioner för WebSDK- och Adobe Analytics-flöden.
Funktion
Beskrivning
Parametrar
Syntax
Uttryck
Exempelutdata
aa_get_event_id
Extraherar händelse-ID:t från en Analytics-händelsesträng.
  • EVENT_STRING: Required Den kommaavgränsade händelsesträngen Analytics.
  • EVENT_NAME: Required Händelsenamnet att extrahera och ID från.
aa_get_event_id(EVENT_STRING, EVENT_NAME)
aa_get_event_id("event101=5:123456,scOpen", "event101")
123456
aa_get_event_value
Extraherar händelsevärdet från en Analytics-händelsesträng. Om händelsevärdet inte anges returneras 1.
  • EVENT_STRING: Required Den kommaavgränsade händelsesträngen Analytics.
  • EVENT_NAME: Required Händelsenamnet som ett värde ska extraheras från.
aa_get_event_value(EVENT_STRING, EVENT_NAME)
aa_get_event_value("event101=5:123456,scOpen", "event101")
5
aa_get_product_categories
Extraherar produktkategorin från en analysproduktsträng.
  • PRODUCTS_STRING: Required Produktsträngen Analytics.
a_get_product_categories(PRODUCTS_STRING)
aa_get_product_categories(";Exempel product 1;1;3.50,Exempelkategori 2;Exempelprodukt 2;1;5.99")
[null,"Exempelkategori 2"]
aa_get_product_names
Extraherar produktnamnet från en analysproduktsträng.
  • PRODUCTS_STRING: Required Produktsträngen Analytics.
a_get_product_names(PRODUCTS_STRING)
a_get_product_names(";Exempel: produkt 1;1;3.50,Exempelkategori 2;Exempelprodukt 2;1;5.99")
["Exempelprodukt 1","Exempelprodukt 2"]
aa_get_product_quantity
Extraherar kvantiteterna från en Analytics-produktsträng.
  • PRODUCTS_STRING: Required Produktsträngen Analytics.
a_get_product_quantity(PRODUCTS_STRING)
a_get_product_quantity(";Exempel: produkt 1;1;3.50,Exempelkategori 2;Exempelprodukt 2")
["1", null]
a_get_product_prices
Extraherar priset från en analysproduktsträng.
  • PRODUCTS_STRING: Required Produktsträngen Analytics.
a_get_product_prices(PRODUCTS_STRING)
a_get_product_prices(";Exempelprodukt 1;1;3.50,Exempelkategori 2;Exempelprodukt 2")
["3.50", null]
aa_get_product_event_values
Extraherar värden för den namngivna händelsen från produktsträngen som en array med strängar.
  • PRODUCTS_STRING: Required Produktsträngen Analytics.
  • EVENT_NAME: Required Händelsenamnet som värden ska extraheras från.
a_get_product_event_values(PRODUCTS_STRING, EVENT_NAME)
a_get_product_event_values(";Exempel: product 1;1;4.20;event1=2.3|event2=5:1,;Exempel: product 2;1;4.20;event1=3|event2=2:2", "event1")
["2.3", "3"]
aa_get_product_vars
Extraherar evar-värdena för den namngivna händelsen från produktsträngen som en array med strängar.
  • PRODUCTS_STRING: Required Produktsträngen Analytics.
  • EVAR_NAME: Required eVarnas namn som ska extraheras.
a_get_product_vars(PRODUCTS_STRING, EVENT_NAME)
a_get_product_vars(";Exempelprodukt;1;6.69;;eVar1=Merchandising value", "eVar1")
["Merchandising value"]

Objektkopia object-copy

TIP
Objektkopieringsfunktionen används automatiskt när ett objekt i källan mappas till ett objekt i XDM. Ingen ytterligare åtgärd krävs från användarna.

Du kan använda objektkopieringsfunktionen för att automatiskt kopiera attribut till ett objekt utan att göra ändringar i mappningen. Om källdata till exempel har strukturen:

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

och en XDM-struktur på

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

Därefter blir mappningen:

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

I exemplet ovan kapslas även attributen city och state automatiskt vid körning eftersom objektet address mappas till addr. Om du skulle skapa ett line2-attribut i XDM-strukturen och dina indata även innehåller en line2 i address -objektet, kommer det också att kapslas in automatiskt utan att mappningen behöver ändras manuellt.

För att automatisk mappning ska fungera måste följande krav vara uppfyllda:

  • Objekt på överordnad nivå bör mappas.
  • Nya attribut måste ha skapats i XDM-schemat;
  • Nya attribut ska ha matchande namn i källschemat och XDM-schemat.

Om något av villkoren inte uppfylls måste du manuellt mappa källschemat till XDM-schemat med hjälp av dataprep.

Bilaga

Nedan finns ytterligare information om hur du använder funktioner för dataprep

Specialtecken special-characters

Tabellen nedan visar en lista med reserverade tecken och motsvarande kodade tecken.

Reserverat tecken
Kodat tecken
space
%20
!
%21
"
%22
#
%23
$
%24
%
%25
&
%26
'
%27
(
%28
)
%29
*
%2A
+
%2B
,
%2C
/
%2F
:
%3A
;
%3B
<
%3C
=
%3D
>
%3E
?
%3F
@
%40
[
%5B
]
%5D
^
%5E
`
%60
~
%7E

Värden för enhetsfält device-field-values

Tabellen nedan visar en lista med enhetsfältvärden och motsvarande beskrivningar.

Enhet
Beskrivning
Skrivbord
En stationär eller bärbar typ av enhet.
Anonymiserad
En anonym enhet. I vissa fall är det useragents som har ändrats av en anonymiseringsprogramvara.
Okänd
En okänd enhet. Dessa är vanligtvis useragents som inte innehåller någon information om enheten.
Mobil
En mobil enhet som ännu inte har identifierats. Den här mobila enheten kan vara en eReader, en surfplatta, en telefon, en klocka osv.
Tablet
En mobil enhet med stor skärm (vanligtvis > 7 tum).
Telefon
En mobil enhet med liten skärm (vanligen < 7 tum).
Titta
En mobil enhet med en liten skärm (vanligen < 2 tum). Dessa enheter fungerar normalt som en extra skärm för en typ av telefon/surfplatta.
Förstärkt verklighet
En mobil enhet med AR-funktioner.
Virtuell verklighet
En mobil enhet med VR-funktioner.
eReader
En enhet som liknar en surfplatta, men vanligtvis med en eInk-skärm.
Rutan Ange överkant
En ansluten enhet som tillåter interaktion via en skärm i tv-storlek.
TV
En enhet som liknar digitalboxen, men är inbyggd i tv:n.
Hemutrustning
En (vanligtvis stor) hemutrustning, som ett kylskåp.
Spelkonsol
Ett fast spelsystem som Playstation eller XBox.
Handdatorspelskonsol
Ett mobilt spelsystem som Nintendo Switch.
Voice
En röststyrd enhet som Amazon Alexa eller Google Home.
Bil
En fordonsbaserad webbläsare.
Robot
Robotar som besöker en webbplats.
Robot Mobile
Robotar som besöker en webbplats men som anger att de vill bli synliga som mobilbesökare.
Robot Imitator
Robotar som besöker en webbplats, låtsas vara robotar som Google, men de gör det inte. Obs!: I de flesta fall är Robot Imitators robotar.
Cloud
Ett molnbaserat program. Detta är varken robotar eller hackare, men är program som måste anslutas. Detta inkluderar Mastodon servrar.
Hacker
Det här enhetsvärdet används om skript upptäcks i strängen useragent.

Kodexempel code-samples

map_get_values map-get-values

Markera för att visa exempel
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

Markera för att visa exempel
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

Markera för att visa exempel
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

Syntax 1

Markera för att visa exempel
code language-json
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Syntax 2

Markera för att visa exempel
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\"}"

Syntax 3

Markera för att visa exempel
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

Markera för att visa exempel
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