DocumentazioneExperience PlatformGuida alla preparazione dei dati

Funzioni di mappatura della preparazione dati

Last update: Thu Oct 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Le funzioni di preparazione dati possono essere utilizzate per calcolare i valori in base a ciò che viene immesso nei campi sorgente.

Campi

Un nome di campo può essere qualsiasi identificatore legale, ovvero una sequenza di caratteri Unicode e cifre di lunghezza illimitata, che inizia con una lettera, il simbolo del dollaro ($) o il carattere di sottolineatura (_). Anche i nomi delle variabili fanno distinzione tra maiuscole e minuscole.

Se un nome di campo non segue questa convenzione, il nome del campo deve essere racchiuso con ${}. Pertanto, ad esempio, se il nome del campo è "First Name" o "First.Name", il nome deve essere racchiuso come ${First Name} o ${First\.Name} rispettivamente.

TIP
Quando si interagisce con le gerarchie, se un attributo figlio ha un punto (.), è necessario utilizzare una barra rovesciata (\) per eliminare i caratteri speciali. Per ulteriori informazioni, leggere la guida su escape di caratteri speciali.

Se un nome di campo è any delle seguenti parole chiave riservate, deve essere racchiuso con ${}{}:

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

Inoltre, le parole chiave riservate includono anche una delle funzioni di mappatura elencate in questa pagina.

È possibile accedere ai dati all’interno dei sottocampi utilizzando la notazione del punto. Se ad esempio è presente un oggetto name, per accedere al campo firstName utilizzare name.firstName.

Elenco delle funzioni

Nelle tabelle seguenti sono elencate tutte le funzioni di mappatura supportate, incluse le espressioni di esempio e i relativi output risultanti.

Funzioni stringa string

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
concatena
Concatena le stringhe specificate.
  • STRING: le stringhe che verranno concatenate.
concat(STRING_1, STRING_2)
concat("Ciao, ", "ci", "!")
"Hi, there!"
esplodere
Divide la stringa in base a un regex e restituisce un array di parti. Facoltativamente, può includere regex per dividere la stringa. Per impostazione predefinita, la suddivisione viene risolta in ",". I seguenti delimitatori hanno bisogno di un escape con \: +, ?, ^, |, ., [, (, {, ), *, $, \ Se includi più caratteri come delimitatore, il delimitatore verrà trattato come un delimitatore con più caratteri.
  • STRING: Obbligatorio La stringa da dividere.
  • REGEX: Facoltativo L'espressione regolare che può essere utilizzata per dividere la stringa.
esplodi(STRING, REGEX)
esplodi("Salve!", "")
["Hi,", "there"]
instr
Restituisce la posizione o l'indice di una sottostringa.
  • INPUT: Obbligatorio Stringa in cui viene eseguita la ricerca.
  • SUBSTRING: Obbligatorio La sottostringa da ricercare all'interno della stringa.
  • START_POSITION: Facoltativo La posizione da cui iniziare a cercare nella stringa.
  • OCCORRENZA: Facoltativa l'ennesima occorrenza da cercare dalla posizione iniziale. Per impostazione predefinita, è 1.
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE)
instr("adobe.com", "com")
6
sostituto
Sostituisce la stringa di ricerca se presente nella stringa originale.
  • INPUT: Obbligatorio Stringa di input.
  • TO_FIND: Obbligatorio Stringa da cercare all'interno dell'input.
  • TO_REPLACE: Obbligatorio Stringa che sostituirà il valore in "TO_FIND".
replacestr(INPUT, TO_FIND, TO_REPLACE)
replacestr("This is a string re test", "re", "replace")
"Questo è un test di sostituzione della stringa"
substr
Restituisce una sottostringa di una determinata lunghezza.
  • INPUT: Obbligatorio Stringa di input.
  • START_INDEX: Obbligatorio Indice della stringa di input da cui inizia la sottostringa.
  • LUNGHEZZA: Obbligatorio La lunghezza della sottostringa.
substr(INPUT, START_INDEX, LENGTH)
substr("Questo è un test di sottostringa", 7, 8)
"a subst"
lower /
lcase
Converte una stringa in minuscolo.
  • INPUT: Obbligatorio Stringa che verrà convertita in minuscolo.
lower(INPUT)
lower("HeLLo")
lcase("HeLLo")
"ciao"
upper /
ucase
Converte una stringa in maiuscolo.
  • INPUT: Obbligatorio Stringa che verrà convertita in maiuscolo.
upper(INPUT)
upper("HeLLo")
ucase("HeLLo")
"CIAO"
split
Divide una stringa di input in un separatore. Il separatore ha bisogno di per avere un escape con \: \. Se si includono più delimitatori, la stringa verrà divisa su qualsiasi dei delimitatori presenti nella stringa. Nota: questa funzione restituisce solo indici non Null dalla stringa, indipendentemente dalla presenza del separatore. Se tutti gli indici, compresi i valori Null, sono necessari nell'array risultante, utilizzare la funzione "explode".
  • INPUT: Obbligatorio Stringa di input che verrà divisa.
  • SEPARATORE: Obbligatorio Stringa utilizzata per dividere l'input.
split(INPUT, SEPARATOR)
split("Hello world", "")
["Hello", "world"]
unire
Unisce un elenco di oggetti utilizzando il separatore.
  • SEPARATORE: Obbligatorio Stringa che verrà utilizzata per unire gli oggetti.
  • OGGETTI: Obbligatorio Matrice di stringhe che verrà unita in join.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Hello world"
lpad
Aggiunge il lato sinistro di una stringa alla stringa specificata.
  • INPUT: Obbligatorio Stringa che verrà aggiunta. Questa stringa può essere null.
  • COUNT: Obbligatorio dimensione della stringa da aggiungere.
  • PADDING: Obbligatorio Stringa con cui incollare l'input. Se null o vuoto, verrà considerato come un singolo spazio.
lpad(INPUT, COUNT, PADDING)
lpad("bat", 8, "yz")
yzyzybat
rpad
Aggiunge il lato destro di una stringa alla stringa specificata.
  • INPUT: Obbligatorio Stringa che verrà aggiunta. Questa stringa può essere null.
  • COUNT: Obbligatorio dimensione della stringa da aggiungere.
  • PADDING: Obbligatorio Stringa con cui incollare l'input. Se null o vuoto, verrà considerato come un singolo spazio.
rpad(INPUT, COUNT, PADDING)
rpad("bat", 8, "yz")
"batyzyzy"
left
Ottiene i primi "n" caratteri della stringa specificata.
  • STRINGA: Obbligatoria Stringa per la quale si stanno ottenendo i primi "n" caratteri.
  • COUNT: Obbligatorio I caratteri "n" che si desidera ottenere dalla stringa.
left(STRING, COUNT)
left("abcde", 2)
"ab"
destra
Ottiene gli ultimi "n" caratteri della stringa specificata.
  • STRINGA: Obbligatoria Stringa per la quale si stanno ottenendo gli ultimi "n" caratteri.
  • COUNT: Obbligatorio I caratteri "n" che si desidera ottenere dalla stringa.
right(STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Rimuove lo spazio vuoto dall'inizio della stringa.
  • STRING: Obbligatorio Stringa da cui rimuovere lo spazio vuoto.
ltrim(STRING)
ltrim("ciao")
"ciao"
rtrim
Rimuove lo spazio vuoto dalla fine della stringa.
  • STRING: Obbligatorio Stringa da cui rimuovere lo spazio vuoto.
rtrim(STRING)
rtrim("hello")
"ciao"
trim
Rimuove lo spazio vuoto dall'inizio e dalla fine della stringa.
  • STRING: Obbligatorio Stringa da cui rimuovere lo spazio vuoto.
trim(STRING)
trim(" hello ")
"ciao"
uguale a
Confronta due stringhe per verificare se sono uguali. Questa funzione distingue tra maiuscole e minuscole.
  • STRING1: Obbligatorio La prima stringa da confrontare.
  • STRING2: Obbligatorio Seconda stringa da confrontare.
STRINGA1.​equals(​STRING2)
"string1".​equals​("STRING1")
false
equalsIgnoreCase
Confronta due stringhe per verificare se sono uguali. Questa funzione non distingue tra maiuscole e minuscole.
  • STRING1: Obbligatorio La prima stringa da confrontare.
  • STRING2: Obbligatorio Seconda stringa da confrontare.
STRINGA1.​equalsIgnoreCase​(STRING2)
"string1".​equalsIgnoreCase​("STRING1)
true

Funzioni espressione regolare

Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
extract_regex
Estrae gruppi dalla stringa di input, in base a un'espressione regolare.
  • STRING: Required La stringa da cui si stanno estraendo i gruppi.
  • REGEX: Obbligatorio L'espressione regolare che si desidera associare al gruppo.
extract_regex(STRING, REGEX)
extract_regex​("E259,E259B_009,1_1"​, "([,]+),[,]*,([^,]+)")
["E259,E259B_009,1_1", "E259", "1_1"]
matches_regex
Verifica se la stringa corrisponde all’espressione regolare immessa.
  • STRING: Obbligatorio La stringa da controllare corrisponde all'espressione regolare.
  • REGEX: Obbligatorio Espressione regolare con cui si sta effettuando il confronto.
matches_regex(STRING, REGEX)
matches_regex("E259,E259B_009,1_1", "([,]+),[,]*,([^,]+)")
true

Funzioni di hashing hashing

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
sha1
Accetta un input e genera un valore hash utilizzando l’algoritmo 1 di hash sicuro (SHA-1).
  • INPUT: Obbligatorio Il testo normale a cui applicare l'hashing.
  • CHARSET: Facoltativo Il nome del set di caratteri. I valori possibili includono UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
sha1(INPUT, CHARSET)
sha1("il mio testo", "UTF-8")
c3599c11e47719df18a24​48690840c5dfcce3c80
sha256
Accetta un input e produce un valore hash utilizzando Secure Hash Algorithm 256 (SHA-256).
  • INPUT: Obbligatorio Il testo normale a cui applicare l'hashing.
  • CHARSET: Facoltativo Il nome del set di caratteri. I valori possibili includono UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
sha256(INPUT, CHARSET)
sha256("il mio testo", "UTF-8")
7330d2b39ca35eaf4cb95fc846c21​ee6a39af698154a83a586ee270a0d372104
sha512
Accetta un input e genera un valore hash utilizzando Secure Hash Algorithm 512 (SHA-512).
  • INPUT: Obbligatorio Il testo normale a cui applicare l'hashing.
  • CHARSET: Facoltativo Il nome del set di caratteri. I valori possibili includono UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
sha512(INPUT, CHARSET)
sha512("il mio testo", "UTF-8")
a3d7e45a0d9be4e4b9a3b8c9c2163c21ef​708bf11b4232bb21d2a8704ada2cdcd7b367dd0788a89​a5c908cfe377aceb1072a7b38 6b7d4fd2ff68a8fd24d16
md5
Accetta un input e produce un valore hash utilizzando MD5.
  • INPUT: Obbligatorio Il testo normale a cui applicare l'hashing.
  • CHARSET: Facoltativo Il nome del set di caratteri. I valori possibili includono UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
md5(INPUT, CHARSET)
md5("il mio testo", "UTF-8")
d3b96ce8c9fb4​e9bd0198d03ba6852c7
crc32
Prende un input utilizza un algoritmo CRC (Cyclic Redundancy Check) per produrre un codice ciclico a 32 bit.
  • INPUT: Obbligatorio Il testo normale a cui applicare l'hashing.
  • CHARSET: Facoltativo Il nome del set di caratteri. I valori possibili includono UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
crc32(INPUT, CHARSET)
crc32("il mio testo", "UTF-8")
8df92e80

Funzioni URL url

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
get_url_protocol
Restituisce il protocollo dall'URL specificato. Se l’input non è valido, restituisce null.
  • URL: Obbligatorio URL da cui estrarre il protocollo.
get_url_protocol​(URL)
get_url_protocol("https://platform​.adobe.com/home")
https
get_url_host
Restituisce l’host dell’URL specificato. Se l’input non è valido, restituisce null.
  • URL: Obbligatorio URL da cui estrarre l'host.
get_url_host​(URL)
get_url_host​("https://platform​.adobe.com/home")
platform.adobe.com
get_url_port
Restituisce la porta dell’URL specificato. Se l’input non è valido, restituisce null.
  • URL: Obbligatorio URL da cui estrarre la porta.
get_url_port(URL)
get_url_port​("sftp://example.com//home/​joe/employee.csv")
22
get_url_path
Restituisce il percorso dell’URL specificato. Per impostazione predefinita, viene restituito il percorso completo.
  • URL: Obbligatorio URL da cui estrarre il percorso.
  • FULL_PATH: Facoltativo Valore booleano che determina se viene restituito il percorso completo. Se impostato su false, viene restituita solo la fine del percorso.
get_url_path​(URL, FULL_PATH)
get_url_path​("sftp://example.com//​home/joe/employee.csv")
"//home/joe/​employee.csv"
get_url_query_str
Restituisce la stringa di query di un URL specificato come mappa del nome della stringa di query e del valore della stringa di query.
  • URL: Obbligatorio L'URL da cui stai tentando di ottenere la stringa di query.
  • ANCORAGGIO: Obbligatorio Determina l'operazione che verrà eseguita con l'ancoraggio nella stringa query. Può essere uno dei tre valori seguenti: "keep", "remove" o "append".

    Se il valore è "keep", l'ancoraggio verrà collegato al valore restituito.
    Se il valore è "remove", l'ancoraggio verrà rimosso dal valore restituito.
    Se il valore è "append", l'ancoraggio verrà restituito come valore separato.
get_url_query_str​(URL, ANCHOR)
get_url_query_str​("foo://example.com:8042​/over/there?name=​ferret#nose", "keep")
get_url_query_str​("foo://example.com:8042​/over/there?name=​ferret#nose", "remove")
get_url_query_str​ ​ ​("foo://example.com:8042/over/there?name=ferret#nose", "append")
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
Questa funzione accetta un URL come input e sostituisce o codifica i caratteri speciali con caratteri ASCII. Per ulteriori informazioni sui caratteri speciali, leggere l'elenco dei caratteri speciali nell'appendice di questo documento.
  • URL: Obbligatorio URL di input con caratteri speciali che si desidera sostituire o codificare con caratteri ASCII.
get_url_encoded(URL)
get_url_encoded("https://example.com/partneralliance_asia-pacific_2022")
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022
get_url_decoded
Questa funzione accetta un URL come input e decodifica i caratteri ASCII in caratteri speciali. Per ulteriori informazioni sui caratteri speciali, leggere l'elenco dei caratteri speciali nell'appendice di questo documento.
  • URL: Obbligatorio URL di input con caratteri ASCII da decodificare in caratteri speciali.
get_url_decoded(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022")
https://example.com/partneralliance_asia-pacific_2022

Funzioni data e ora date-and-time

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella. Ulteriori informazioni sulla funzione date sono disponibili nella sezione delle date della guida alla gestione del formato dei dati.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
now
Recupera l'ora corrente.
now()
now()
2021-10-26T10:10:24Z
timestamp
Recupera l’ora Unix corrente.
timestamp()
timestamp()
1571850624571
formato
Formatta la data di input in base a un formato specificato.
  • DATE: Obbligatorio La data di input, come oggetto ZonedDateTime, che si desidera formattare.
  • FORMATO: Obbligatorio Il formato in cui si desidera modificare la data.
format(DATE, FORMAT)
format(2019-10-23T11:24:00+00:00, "yyyy-MM-dd HH:mm:ss")
2019-10-23 11:24:35
format
Converte una marca temporale in una stringa di data in base al formato specificato.
  • TIMESTAMP: Obbligatorio Il timestamp da formattare. Questo è scritto in millisecondi.
  • FORMATO: Obbligatorio Il formato che si desidera rendere la marca temporale.
format(TIMESTAMP, FORMAT)
dformat(1571829875000, "yyyy-MM-dd'T'HH:mm:ss.SSSX")
2019-10-23T11:24:35.000Z
data
Converte una stringa di data in un oggetto ZonedDateTime (formato ISO 8601).
  • DATE: Required La stringa che rappresenta la data.
  • FORMAT: Required Stringa che rappresenta il formato della data di origine.Nota: not rappresenta il formato in cui si desidera convertire la stringa di data.
  • DEFAULT_DATE: Obbligatorio Se la data specificata è nulla, viene restituita la data predefinita.
date(DATE, FORMAT, DEFAULT_DATE)
date("2019-10-23 11:24", "yyyy-MM-dd HH:mm", now())
2019-10-23T11:24:00Z
data
Converte una stringa di data in un oggetto ZonedDateTime (formato ISO 8601).
  • DATE: Required La stringa che rappresenta la data.
  • FORMAT: Required Stringa che rappresenta il formato della data di origine.Nota: not rappresenta il formato in cui si desidera convertire la stringa di data.
date(DATE, FORMAT)
date("2019-10-23 11:24", "yyyy-MM-dd HH:mm")
2019-10-23T11:24:00Z
data
Converte una stringa di data in un oggetto ZonedDateTime (formato ISO 8601).
  • DATE: Required La stringa che rappresenta la data.
date(DATE)
date("2019-10-23 11:24")
"2019-10-23T11:24:00Z"
date_part
Recupera le parti della data. Sono supportati i seguenti valori dei componenti:

"year"
"yyyy"
"yy"

"quarter"
"qq"
"q"

"month"
"mm"
"m"

"dayofyear"
"dy"
"y"

"day"
"dd"
"d"

"week"
"ww"
"w"

"week
"dw"
"w"

"ora"
"hh"
"hh24"
"hh12"

"minuto"
"mi"
"n"

"secondo"
"ss"
"s"

"millisecondi"
"SSS"
  • COMPONENTE: Obbligatorio Stringa che rappresenta la parte della data.
  • DATA: Obbligatorio La data, in formato standard.
date_part​(COMPONENT, DATE)
date_part("MM", date("2019-10-17 11:55:12"))
10
set_date_part
Sostituisce un componente in una determinata data. Sono accettati i seguenti componenti:

"year"
"yyyy"
"yy"

"month"
"mm"
"m"

"day"
"dd"
"d"

"hour"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • COMPONENTE: Obbligatorio Stringa che rappresenta la parte della data.
  • VALORE: Obbligatorio Il valore da impostare per il componente per una data specificata.
  • DATA: Obbligatorio La data, in formato standard.
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
Crea una data da parti. Questa funzione può essere indotta anche utilizzando make_timestamp.
  • ANNO: Obbligatorio L'anno, scritto in quattro cifre.
  • MESE: Richiesto Il mese. I valori consentiti sono compresi tra 1 e 12.
  • GIORNO: Richiesto Il giorno. I valori consentiti sono compresi tra 1 e 31.
  • ORA: Necessaria L'ora. I valori consentiti sono compresi tra 0 e 23.
  • MINUTO: Obbligatorio Minuto. I valori consentiti sono compresi tra 0 e 59.
  • NANOSECOND: Obbligatori I valori dei nanosecondi. I valori consentiti sono compresi tra 0 e 999999999.
  • TIMEZONE: Obbligatorio Il fuso orario per la data e l'ora.
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
Converte una data in qualsiasi fuso orario in una data in UTC.
  • DATA: Obbligatorio La data che si sta tentando di convertire.
zone_date_to_utc​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
Converte una data da un fuso orario a un altro.
  • DATA: Obbligatorio La data che si sta tentando di convertire.
  • ZONE: Obbligatorio Il fuso orario in cui si sta tentando di convertire la data.
zone_date_to_zone​(DATE, ZONE)
zone_date_to_zone(now(), "Europe/Paris")
2021-10-26T15:43:59Z

Gerarchie - Oggetti objects

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
is_empty
Controlla se un oggetto è vuoto.
  • INPUT: Obbligatorio L'oggetto che si sta tentando di controllare è vuoto.
is_empty(INPUT)
is_empty([1, null, 2, 3])
false
array_a_oggetto
Crea un elenco di oggetti.
  • INPUT: Obbligatorio Raggruppamento di coppie chiave-matrice.
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
Crea un oggetto in base alle coppie chiave/valore fornite.
  • INPUT: Obbligatorio Un elenco semplice di coppie chiave/valore.
to_object(INPUT)
to_object​("firstName", "John", "lastName", "Doe")
{"firstName": "John", "lastName": "Doe"}
str_to_object
Crea un oggetto dalla stringa di input.
  • STRING: Obbligatorio Stringa da analizzare per creare un oggetto.
  • VALUE_DELIMITER: Facoltativo Il delimitatore che separa un campo dal valore. Il delimitatore predefinito è :.
  • FIELD_DELIMITER: Facoltativo Il delimitatore che separa le coppie di valori di campo. Il delimitatore predefinito è ,.
str_to_object​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Nota: è possibile utilizzare la funzione get() insieme a str_to_object() per recuperare i valori per le chiavi nella stringa.
  • Esempio #1: str_to_object("firstName - John ; lastName - ; - 123 345 7890", "-", ";")
  • Esempio #2: str_to_object("firstName - John ; lastName - ; phone - 123 456 7890", "-", ";").get("firstName")
  • #1 di esempio:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • Esempio #2: "John"
contains_key
Controlla se l'oggetto esiste nei dati di origine. Nota: questa funzione sostituisce la funzione is_set() obsoleta.
  • INPUT: Obbligatorio Percorso da controllare se esiste nei dati di origine.
contains_key(INPUT)
contains_key("evars.evar.field1")
true
annullare
Imposta il valore dell'attributo su null. Da utilizzare quando non si desidera copiare il campo nello schema di destinazione.
nullify()
nullify()
null
get_keys
Analizza le coppie chiave/valore e restituisce tutte le chiavi.
  • OGGETTO: Obbligatorio L'oggetto da cui verranno estratte le chiavi.
get_keys(OBJECT)
get_keys({"book1": "Pride and Prejudice", "book2": "1984"})
["book1", "book2"]
get_values
Analizza le coppie chiave/valore e restituisce il valore della stringa, in base alla chiave specificata.
  • STRING: Required La stringa da analizzare.
  • KEY: Required la chiave per la quale è necessario estrarre il valore.
  • VALUE_DELIMITER: Obbligatorio Il delimitatore che separa il campo e il valore. Se viene fornita una stringa vuota o null, il valore è :.
  • FIELD_DELIMITER: Facoltativo Il delimitatore che separa le coppie di campi e valori. Se viene fornita una stringa vuota o null, il valore è ,.
get_values(STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER)
get_values("firstName - John , lastName - Cena , phone - 555 420 8692", "firstName", "-", ",")
John
map_get_values
Prende una mappa e un input chiave. Se l’input è un singolo tasto, la funzione restituisce il valore associato a tale tasto. Se l’input è una matrice di stringhe, la funzione restituisce tutti i valori corrispondenti alle chiavi fornite. Se la mappa in ingresso contiene chiavi duplicate, il valore restituito deve deduplicare le chiavi e restituire valori univoci.
  • MAP: Obbligatorio I dati della mappa di input.
  • CHIAVE: Obbligatoria La chiave può essere una singola stringa o una matrice di stringhe. Se viene fornito un altro tipo primitivo (dati/numero), viene trattato come una stringa.
get_values(MAP, KEY)
Per un esempio di codice, consulta la appendice.
map_has_keys
Se vengono forniti uno o più tasti di input, la funzione restituisce true. Se come input viene fornita una matrice di stringhe, la funzione restituisce true sulla prima chiave trovata.
  • MAP: Obbligatorio Dati mappa di input
  • CHIAVE: Obbligatoria La chiave può essere una singola stringa o una matrice di stringhe. Se viene fornito un altro tipo primitivo (dati/numero), viene trattato come una stringa.
map_has_keys(MAP, KEY)
Per un esempio di codice, consulta la appendice.
add_to_map
Accetta almeno due input. È possibile fornire come input qualsiasi numero di mappe. La preparazione dati restituisce una singola mappa contenente tutte le coppie chiave-valore provenienti da tutti gli input. Se una o più chiavi sono ripetute (nella stessa mappa o su più mappe), la preparazione dati deduplica le chiavi in modo che la prima coppia chiave-valore persista nell’ordine in cui sono state passate nell’input.
MAP: Obbligatorio I dati della mappa di input.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Per un esempio di codice, consulta la appendice.
object_to_map (Sintassi 1)
Utilizza questa funzione per creare tipi di dati per mappe.
  • KEY: Required Le chiavi devono essere una stringa. Se vengono forniti altri valori primitivi come numeri interi o date, questi verranno automaticamente convertiti in stringhe e verranno trattati come stringhe.
  • ANY_TYPE: Obbligatorio fa riferimento a qualsiasi tipo di dati XDM supportato, ad eccezione di Mappe.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, … )
Per un esempio di codice, consulta la appendice.
object_to_map (Sintassi 2)
Utilizza questa funzione per creare tipi di dati per mappe.
  • OGGETTO: Obbligatorio È possibile fornire un oggetto o una matrice di oggetti in ingresso e puntare a un attributo all'interno dell'oggetto come chiave.
object_to_map(OBJECT)
Per un esempio di codice, consulta la appendice.
object_to_map (Sintassi 3)
Utilizza questa funzione per creare tipi di dati per mappe.
  • OGGETTO: Obbligatorio È possibile fornire un oggetto o una matrice di oggetti in ingresso e puntare a un attributo all'interno dell'oggetto come chiave.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Per un esempio di codice, consulta la appendice.

Per informazioni sulla funzione di copia dell'oggetto, vedere la sezione sotto.

Gerarchie - Array arrays

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
coalesce
Restituisce il primo oggetto non nullo in una matrice specificata.
  • INPUT: Obbligatorio Matrice di cui trovare il primo oggetto non nullo.
coalesce(INPUT)
coalesce(null, null, null, "first", null, "second")
"first"
primo
Recupera il primo elemento dell’array specificato.
  • INPUT: Obbligatorio Array di cui trovare il primo elemento.
first(INPUT)
first("1", "2", "3")
"1"
ultime/i
Recupera l’ultimo elemento dell’array specificato.
  • INPUT: Obbligatorio Array di cui trovare l'ultimo elemento.
last(INPUT)
last("1", "2", "3")
3"
add_to_array
Aggiunge elementi alla fine dell'array.
  • MATRICE: Obbligatoria Matrice a cui si stanno aggiungendo elementi.
  • VALORI: gli elementi che desideri aggiungere alla matrice.
add_to_array​(ARRAY, VALUES)
add_to_array​(['a', 'b'], 'c', 'd')
['a', 'b', 'c', 'd']
join_array
Combina gli array tra loro.
  • MATRICE: Obbligatoria Matrice a cui si stanno aggiungendo elementi.
  • VALORI: gli array che si desidera aggiungere all’array principale.
join_arrays​(ARRAY, VALUES)
join_arrays​(['a', 'b'], ['c'], ['d', 'e'])
['a', 'b', 'c', 'd', 'e']
to_array
Prende un elenco di input e lo converte in un array.
  • INCLUDE_NULLS: Obbligatorio Valore booleano che indica se includere o meno valori Null nella matrice di risposta.
  • VALORI: Obbligatori Gli elementi da convertire in un array.
to_array​(INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Restituisce la dimensione dell'input.
  • INPUT: Obbligatorio L'oggetto di cui si sta tentando di trovare le dimensioni.
size_of(INPUT)
size_of([1, 2, 3, 4])
4
upsert_array_append
Questa funzione viene utilizzata per aggiungere tutti gli elementi dell’intero array di input alla fine dell’array in Profilo. Questa funzione è solo applicabile durante gli aggiornamenti. Se utilizzata nel contesto degli inserti, questa funzione restituisce l’input così com’è.
  • ARRAY: Obbligatorio array da aggiungere nel profilo.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[123, 456]
upsert_array_replace
Questa funzione viene utilizzata per sostituire gli elementi in un array. Questa funzione è solo applicabile durante gli aggiornamenti. Se utilizzata nel contesto degli inserti, questa funzione restituisce l’input così com’è.
  • MATRICE: Obbligatoria Matrice che sostituisce la matrice nel profilo.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123, 456]
[Solo destinazioni]{class="badge informative"} array_to_string
Unisce le rappresentazioni di stringa degli elementi in un array utilizzando il separatore specificato. Se l'array è multidimensionale, viene appiattito prima di essere unito. Nota: questa funzione viene utilizzata nelle destinazioni. Per ulteriori informazioni, consulta la documentazione.
  • SEPARATORE: Obbligatorio Separatore utilizzato per unire gli elementi nell'array.
  • MATRICE: Obbligatoria Matrice da unire (dopo la conversione).
array_to_string(SEPARATOR, ARRAY)
array_to_string(";", ["Hello", "world"])
"Hello;world"
[Solo destinazioni]{class="badge informative"} filterArray*
Filtra l’array specificato in base a un predicato. Nota: questa funzione viene utilizzata nelle destinazioni. Per ulteriori informazioni, consulta la documentazione.
  • MATRICE: Obbligatoria Matrice da filtrare
  • PREDICATE: Obbligatorio Il predicato da applicare a ciascun elemento dell'array specificato.
filterArray(ARRAY, PREDICATE)
filterArray([5, -6, 0, 7], x -> x > 0)
[5, 7]
[Solo destinazioni]{class="badge informative"} transformArray*
Trasforma l’array specificato in base a un predicato. Nota: questa funzione viene utilizzata nelle destinazioni. Per ulteriori informazioni, consulta la documentazione.
  • MATRICE: Obbligatoria Matrice da trasformare.
  • PREDICATE: Obbligatorio Il predicato da applicare a ciascun elemento dell'array specificato.
transformArray(ARRAY, PREDICATE)
transformArray([5, 6, 7], x -> x + 1)
[6, 7, 8]
[Solo destinazioni]{class="badge informative"} flattenArray*
Appiattisce la matrice (multidimensionale) specificata a una matrice unidimensionale. Nota: questa funzione viene utilizzata nelle destinazioni. Per ulteriori informazioni, consulta la documentazione.
  • MATRICE: Obbligatoria Matrice da appiattire.
flattenArray(ARRAY)
flattenArray([['a', 'b'], ['c', 'd']], [['e'], ['f']])
['a', 'b', 'c', 'd', 'e', 'f']

Gerarchie - Mappa map

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
array_to_map
Questa funzione accetta un array di oggetti e una chiave come input e restituisce una mappa del campo della chiave con il valore come chiave e l’elemento dell’array come valore.
  • INPUT: Obbligatorio Matrice di oggetti di cui trovare il primo oggetto non nullo.
  • KEY: Obbligatorio La chiave deve essere un nome di campo nella matrice dell'oggetto e l'oggetto deve essere un valore.
array_to_map(OBJECT[] INPUTS, KEY)
Leggi l'appendice per un esempio di codice.
object_to_map
Questa funzione prende un oggetto come argomento e restituisce una mappa di coppie chiave-valore.
  • INPUT: Obbligatorio Matrice di oggetti di cui trovare il primo oggetto non nullo.
object_to_map(OBJECT_INPUT)
"object_to_map(address) dove input è " + "address: {line1 : "345 park ave",line2: "bldg 2",City : "san jose",State : "CA",type: "office"}"
Restituisce una mappa con le coppie nome campo e valore specificate o null se l'input è null. Ad esempio: "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
Questa funzione prende un elenco di coppie chiave-valore e restituisce una mappa di coppie chiave-valore.
to_map(OBJECT_INPUT)
"to_map("firstName", "John", "lastName", "Doe")"
Restituisce una mappa con le coppie nome campo e valore specificate o null se l'input è null. Ad esempio: "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Operatori logici logical-operators

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
decodificare
Dato un tasto e un elenco di coppie di valori chiave appiattite come array, la funzione restituisce il valore se viene trovata una chiave oppure restituisce un valore predefinito se presente nell’array.
  • CHIAVE: Obbligatoria Chiave da associare.
  • OPTIONS: Obbligatorio Matrice semplificata di coppie chiave/valore. Facoltativamente, è possibile inserire un valore predefinito alla fine.
decode(KEY, OPTIONS)
decode(stateCode, "ca", "California", "pa", "Pennsylvania", "N/A")
Se il codice stato dato è "ca", "California".
Se il codice stato specificato è "pa", "Pennsylvania".
Se stateCode non corrisponde a "N/D".
iif
Valuta una determinata espressione booleana e restituisce il valore specificato in base al risultato.
  • ESPRESSIONE: Obbligatoria L'espressione booleana in fase di valutazione.
  • TRUE_VALUE: Obbligatorio Il valore restituito se l'espressione restituisce true.
  • FALSE_VALUE: Obbligatorio Il valore restituito se l'espressione restituisce false.
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE)
iif("s".equalsIgnoreCase("S"), "True", "False")
"Vero"

Aggregazione aggregation

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
min
Restituisce il minimo degli argomenti specificati. Utilizza l’ordinamento naturale.
  • OPTIONS: Obbligatorio Uno o più oggetti possono essere confrontati tra loro.
min(OPTIONS)
min(3, 1, 4)
1
max
Restituisce il massimo degli argomenti specificati. Utilizza l’ordinamento naturale.
  • OPTIONS: Obbligatorio Uno o più oggetti possono essere confrontati tra loro.
max(OPTIONS)
max(3, 1, 4)
4

Conversioni tipo type-conversions

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
to_bigint
Converte una stringa in un BigInteger.
  • STRING: Obbligatorio Stringa da convertire in BigInteger.
to_bigint(STRING)
to_bigint​("1000000.34")
1000000,34
to_decimal
Converte una stringa in un valore Double.
  • STRING: Obbligatorio Stringa da convertire in Double.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Converte una stringa in un elemento mobile.
  • STRING: Obbligatorio Stringa da convertire in Mobile.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Converte una stringa in un numero intero.
  • STRING: Obbligatorio Stringa da convertire in un numero intero.
to_integer(STRING)
to_integer("12")
12

Funzioni JSON json

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
json_to_object
Deserializza il contenuto JSON dalla stringa specificata.
  • STRING: Required Stringa JSON da deserializzare.
json_to_object​(STRING)
json_to_object​({"info":{"firstName":"John","lastName": "Doe"}})
Oggetto che rappresenta il JSON.

Operazioni speciali special-operations

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
uuid /
guid
Genera un ID pseudo-casuale.
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
Questa funzione prende una stringa FPID e la converte in un ECID da utilizzare nelle applicazioni Adobe Experience Platform e Adobe Experience Cloud.
  • STRING: Required Stringa FPID da convertire in ECID.
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

Funzioni dell’agente utente user-agent

Una qualsiasi delle funzioni dell’agente utente contenute nella tabella seguente può restituire uno dei seguenti valori:

  • Telefono - Un dispositivo mobile con uno schermo piccolo (comunemente < 7")
  • Mobile: dispositivo mobile non ancora identificato. Questo dispositivo mobile può essere un eReader, un tablet, un telefono, un orologio, ecc.

Per ulteriori informazioni sui valori dei campi dispositivo, leggere l'elenco dei valori dei campi dispositivo nell'appendice di questo documento.

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
ua_os_name
Estrae il nome del sistema operativo dalla stringa dell'agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
ua_os_name​(USER_AGENT)
ua_os_name​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 come Mac OS X) AppleWebKit/534.46 (KHTML, come Gecko) Versione/5.1 Mobile/9B206 Safari/7534.48.3")
iOS
ua_os_version_major
Estrae la versione principale del sistema operativo dalla stringa dell’agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
ua_os_version_major​(USER_AGENT)
ua_os_version_major​s("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 come Mac OS X) AppleWebKit/534.46 (KHTML, come Gecko) Versione/5.1 Mobile/9B206 Safari/7534.48.3")
IOS 5
ua_os_version
Estrae la versione del sistema operativo dalla stringa dell'agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
ua_os_version​(USER_AGENT)
ua_os_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 come Mac OS X) AppleWebKit/534.46 (KHTML, come Gecko) Versione/5.1 Mobile/9B206 Safari/7534.48.3")
5.1.1.
ua_os_name_version
Estrae il nome e la versione del sistema operativo dalla stringa agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
ua_os_name_version​(USER_AGENT)
ua_os_name_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 come Mac OS X) AppleWebKit/534.46 (KHTML, come Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5.1.1
ua_agent_version
Estrae la versione dell’agente dalla stringa dell’agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
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
Estrae il nome e la versione principale dell’agente dalla stringa dell’agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
ua_agent_version_major​(USER_AGENT)
ua_agent_version_major​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 come Mac OS X) AppleWebKit/534.46 (KHTML, come Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari 5
ua_agent_name
Estrae il nome dell'agente dalla stringa dell'agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
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
Estrae la classe device dalla stringa dell'agente utente.
  • USER_AGENT: Obbligatorio Stringa dell'agente utente.
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")
Telefono

Funzioni di Analytics analytics

NOTE
Per i flussi Web SDK e Adobe Analytics puoi utilizzare solo le seguenti funzioni di analisi.
Funzione
Descrizione
Elemento “parameters”
Sintassi
Espressione
Output di esempio
aa_get_event_id
Estrae l’ID evento da una stringa evento Analytics.
  • EVENT_STRING: Obbligatorio Stringa dell'evento Analytics separato da virgole.
  • EVENT_NAME: Obbligatorio Il nome dell'evento da cui estrarre e ID.
aa_get_event_id(EVENT_STRING, EVENT_NAME)
aa_get_event_id("event101=5:123456,scOpen", "event101")
123456
aa_get_event_value
Estrae il valore dell’evento da una stringa dell’evento Analytics. Se il valore dell’evento non è specificato, viene restituito 1.
  • EVENT_STRING: Obbligatorio Stringa dell'evento Analytics separato da virgole.
  • EVENT_NAME: Obbligatorio Nome dell'evento da cui estrarre un valore.
aa_get_event_value(EVENT_STRING, EVENT_NAME)
aa_get_event_value("event101=5:123456,scOpen", "event101")
5
aa_get_product_Categories
Estrae la categoria di prodotto da una stringa di prodotti Analytics.
  • PRODUCTS_STRING: Obbligatorio Stringa di prodotti Analytics.
aa_get_product_Categories(PRODUCTS_STRING)
aa_get_product_Categories(";Esempio di prodotto 1;1;3.50,Esempio di categoria 2;Esempio di prodotto 2;1;5.99")
[null,"Esempio di categoria 2"]
aa_get_product_names
Estrae il nome del prodotto da una stringa di prodotti Analytics.
  • PRODUCTS_STRING: Obbligatorio Stringa di prodotti Analytics.
aa_get_product_names(PRODUCTS_STRING)
aa_get_product_names(";Esempio di prodotto 1;1;3.50,Esempio di categoria 2;Esempio di prodotto 2;1;5.99")
["Prodotto di esempio 1","Prodotto di esempio 2"]
aa_get_product_quantity
Estrae le quantità da una stringa di prodotti Analytics.
  • PRODUCTS_STRING: Obbligatorio Stringa di prodotti Analytics.
aa_get_product_quantity(PRODUCTS_STRING)
aa_get_product_quantity(";Esempio di prodotto 1;1;3.50,Esempio di categoria 2;Esempio di prodotto 2")
["1", null]
aa_get_product_price
Estrae il prezzo da una stringa di prodotti Analytics.
  • PRODUCTS_STRING: Obbligatorio Stringa di prodotti Analytics.
aa_get_product_price(PRODUCTS_STRING)
aa_get_product_price(";Esempio di prodotto 1;1;3.50,Esempio di categoria 2;Esempio di prodotto 2")
["3.50", null]
aa_get_product_event_values
Estrae i valori per l’evento denominato dalla stringa prodotti come array di stringhe.
  • PRODUCTS_STRING: Obbligatorio Stringa di prodotti Analytics.
  • EVENT_NAME: Obbligatorio Il nome dell'evento da cui estrarre i valori.
aa_get_product_event_values(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_event_values(";Esempio di prodotto 1;1;4.20;event1=2.3|event2=5:1; Esempio di prodotto 2;1;4.20;event1=3|event2=2:2", "event1")
["2.3", "3"]
aa_get_product_evars
Estrae i valori evar per l’evento denominato dalla stringa prodotti come array di stringhe.
  • PRODUCTS_STRING: Obbligatorio Stringa di prodotti Analytics.
  • EVAR_NAME: Obbligatorio Il nome eVar da estrarre.
aa_get_product_evars(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_evars(";Esempio di prodotto;1;6.69;;eVar 1=valore merchandising", "eVar 1")
["Valore merchandising"]

Copia oggetto object-copy

TIP
La funzione di copia degli oggetti viene applicata automaticamente quando un oggetto nell’origine viene mappato a un oggetto in XDM. Non è necessaria alcuna azione aggiuntiva da parte degli utenti.

È possibile utilizzare la funzione copia oggetto per copiare automaticamente gli attributi di un oggetto senza apportare modifiche alla mappatura. Ad esempio, se i dati di origine hanno una struttura di:

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

e una struttura XDM di:

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

Quindi la mappatura diventa:

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

Nell'esempio precedente, anche gli attributi city e state vengono acquisiti automaticamente in fase di runtime perché l'oggetto address è mappato a addr. Se si crea un attributo line2 nella struttura XDM e i dati di input contengono anche un attributo line2 nell'oggetto address, anche questo verrà acquisito automaticamente senza dover modificare manualmente la mappatura.

Per garantire il funzionamento della mappatura automatica, è necessario soddisfare i seguenti prerequisiti:

  • Gli oggetti a livello principale devono essere mappati;
  • I nuovi attributi devono essere stati creati nello schema XDM;
  • I nuovi attributi devono avere nomi corrispondenti nello schema di origine e nello schema XDM.

Se uno dei prerequisiti non è soddisfatto, devi mappare manualmente lo schema di origine allo schema XDM utilizzando la preparazione dati.

Appendice

Di seguito sono riportate ulteriori informazioni sull’utilizzo delle funzioni di mappatura della preparazione dati

Caratteri speciali special-characters

La tabella seguente delinea un elenco di caratteri riservati e dei corrispondenti caratteri codificati.

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

Valori dei campi dispositivo device-field-values

La tabella seguente illustra un elenco di valori dei campi dispositivo e le relative descrizioni.

Dispositivo
Descrizione
Desktop
Dispositivo di tipo Desktop o Laptop.
Anonima
Un dispositivo anonimo. In alcuni casi si tratta di useragents che sono stati modificati da un software di anonimizzazione.
Sconosciuto
Dispositivo sconosciuto. Si tratta in genere di useragents che non contengono informazioni sul dispositivo.
Dispositivi mobili
Un dispositivo mobile non ancora identificato. Questo dispositivo mobile può essere un eReader, un tablet, un telefono, un orologio, ecc.
Tablet
Un dispositivo mobile con uno schermo grande (di solito > 7").
Telefono
Un dispositivo mobile con uno schermo piccolo (di solito < 7").
Osserva
Un dispositivo mobile con uno schermo piccolo (di solito < 2"). Questi dispositivi normalmente funzionano come uno schermo aggiuntivo per un tipo di telefono/tablet di dispositivo.
Realtà aumentata
Un dispositivo mobile con funzionalità AR.
Realtà virtuale
Un dispositivo mobile con funzionalità VR.
eReader
Un dispositivo simile a un tablet, ma in genere con una schermata eInk.
Set-top box
Un dispositivo collegato che consente l'interazione attraverso uno schermo di dimensioni televisive.
TV
Dispositivo simile al set-top box, ma incorporato nel televisore.
Apparecchiatura domestica
Un elettrodomestico (di solito grande), come un frigorifero.
Console giochi
Un sistema di gioco fisso come Playstation o XBox.
Console di gioco palmare
Un sistema di gioco mobile come un Nintendo Switch.
Voce
Un dispositivo basato sulla voce come Amazon Alexa o Google Home.
Auto
Un browser basato su veicolo.
Robot
Robot che visitano un sito web.
Robot mobile
Robot che visitano un sito web ma indicano che desiderano essere visti come visitatori di Mobile.
Imitatore robot
Robot che visitano un sito Web fingendo di essere robot come Google, ma non lo sono. Nota: nella maggior parte dei casi gli imitatori robot sono effettivamente robot.
Cloud
Applicazione basata su cloud. Non si tratta né di robot né di hacker, ma di applicazioni che devono connettersi. Sono inclusi Mastodon server.
Hacker
Questo valore di dispositivo viene utilizzato nel caso in cui venga rilevato uno script nella stringa useragent.

Esempi di codice code-samples

map_get_values map-get-values

Seleziona per visualizzare l’esempio
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

Seleziona per visualizzare l’esempio
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

Seleziona per visualizzare l’esempio
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

Sintassi 1

Seleziona per visualizzare l’esempio
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Sintassi 2

Seleziona per visualizzare l’esempio
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\"}"

Sintassi 3

Seleziona per visualizzare l’esempio
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

Seleziona per visualizzare l’esempio
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