DocumentazioneExperience PlatformGuida alla preparazione dei dati

Funzioni di mappatura della preparazione dati

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

Creato per:

  • Developer

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 un qualsiasi identificatore legale: una sequenza illimitata di lettere e cifre Unicode 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 tra ${}. 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, consulta la guida su escape di caratteri speciali.

Inoltre, se il nome di un campo è qualsiasi tra le 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

È possibile accedere ai dati all’interno dei sottocampi utilizzando la notazione del punto. Ad esempio, se è stato name oggetto, per accedere al firstName campo, utilizza 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
Parametri
Sintassi
Espressione
Output di esempio
concat
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 delimitatori seguenti bisogno da evitare con \: +, ?, ^, |, ., [, (, {, ), *, $, \ Se si includono più caratteri come delimitatore, il delimitatore verrà considerato come un delimitatore con più caratteri.
  • STRINGA: Obbligatorio Stringa da dividere.
  • REGEX: Facoltativo 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.
  • SOTTOSTRINGA: Obbligatorio Sottostringa da cercare all'interno della stringa.
  • POSIZIONE_INIZIALE: Facoltativo La posizione da cui iniziare a cercare nella stringa.
  • OCCORRENZA: Facoltativo 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.
  • DA_SOSTITUIRE: Obbligatorio Stringa che sostituirà il valore all’interno di "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 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("HeLo")
lcase("HeLo")
"ciao"
upper /
caso
Converte una stringa in maiuscolo.
  • INPUT: Obbligatorio Stringa che verrà convertita in maiuscolo.
upper(INPUT)
upper("HeLo")
ucase("HeLo")
"CIAO"
split
Divide una stringa di input in un separatore. Il seguente separatore esigenze da evitare con \: \. Se si includono più delimitatori, la stringa verrà suddivisa in base a qualsiasi dei delimitatori presenti nella stringa. Nota: Questa funzione restituisce solo indici non nulli 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 verranno unite.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Hello world"
lpad
Aggiunge il lato sinistro di una stringa alla stringa specificata.
  • INPUT: Obbligatorio La stringa che verrà imbottita. Questa stringa può essere null.
  • CONTEGGIO: Obbligatorio Dimensione della stringa da aggiungere.
  • SPAZIATURA: 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 La stringa che verrà imbottita. Questa stringa può essere null.
  • CONTEGGIO: Obbligatorio Dimensione della stringa da aggiungere.
  • SPAZIATURA: 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: Obbligatorio Stringa per la quale si stanno ottenendo i primi "n" caratteri.
  • CONTEGGIO: 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: Obbligatorio Stringa per la quale si stanno ottenendo gli ultimi "n" caratteri.
  • CONTEGGIO: 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.
  • STRINGA: Obbligatorio Stringa da cui rimuovere lo spazio vuoto.
ltrim(STRING)
ltrim("ciao")
"ciao"
rtrim
Rimuove lo spazio vuoto dalla fine della stringa.
  • STRINGA: 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.
  • STRINGA: 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.
  • STRINGA1: Obbligatorio La prima stringa che si desidera confrontare.
  • STRINGA2: Obbligatorio Seconda stringa da confrontare.
STRINGA1.​equals(​STRING2)
"string1".​equals​("STRING1")
false
equalsIgnoreCase
Confronta due stringhe per verificare se sono uguali. Questa funzione è non distinzione tra maiuscole e minuscole.
  • STRINGA1: Obbligatorio La prima stringa che si desidera confrontare.
  • STRINGA2: Obbligatorio Seconda stringa da confrontare.
STRINGA1.​equalsIgnoreCase​(STRING2)
"string1".​equalsIgnoreCase​("STRING1)
true

Funzioni espressione regolare

Funzione
Descrizione
Parametri
Sintassi
Espressione
Output di esempio
extract_regex
Estrae gruppi dalla stringa di input, in base a un'espressione regolare.
  • STRINGA: Obbligatorio Stringa da cui si stanno estraendo i gruppi.
  • REGEX: Obbligatorio 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.
  • STRINGA: Obbligatorio La stringa da controllare corrisponde all'espressione regolare.
  • REGEX: Obbligatorio L’espressione regolare con cui stai 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
Parametri
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 Testo normale con hash.
  • CHARSET: Facoltativo 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 Testo normale con hash.
  • CHARSET: Facoltativo 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 Testo normale con hash.
  • CHARSET: Facoltativo 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 Testo normale con hash.
  • CHARSET: Facoltativo 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 Testo normale con hash.
  • CHARSET: Facoltativo 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
Parametri
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 L’URL da cui deve essere estratto 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.
  • PERCORSO_COMPLETO: 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" (mantieni), l’ancoraggio verrà attaccato 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 elenco dei caratteri speciali nell'appendice del presente documento.
  • URL: Obbligatorio L’URL di input con caratteri speciali che desideri 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 elenco dei caratteri speciali nell'appendice del presente documento.
  • URL: Obbligatorio L’URL di input con caratteri ASCII che desideri 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 su date è disponibile nella sezione date della sezione guida alla gestione del formato dei dati.
Funzione
Descrizione
Parametri
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.
  • DATA: Obbligatorio Data di input, come oggetto ZonedDateTime, che si desidera formattare.
  • FORMATO: Obbligatorio Il formato in cui desideri 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 vuoi che la marca temporale diventi.
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).
  • DATA: Obbligatorio Stringa che rappresenta la data.
  • FORMATO: Obbligatorio Stringa che rappresenta il formato della data di origine.Nota: Questo fa non rappresenta il formato in cui desideri convertire la stringa di data.
  • DATA_PREDEFINITA: 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).
  • DATA: Obbligatorio Stringa che rappresenta la data.
  • FORMATO: Obbligatorio Stringa che rappresenta il formato della data di origine.Nota: Questo fa non rappresenta il formato in cui desideri 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).
  • DATA: Obbligatorio 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"
"aa"

"quarter"
"qq"
"q"

"month"
"mm"
m"

"dayofyear"
"giorno"
"y"

"giorno"
"gg"
"d"

"week"
"ww"
"w"

"giorno feriale"
"dw"
"w"

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

"minute"
"mi"
"n"

"second"
"ss"
"s"

"millisecondi"
"SSS"
  • COMPONENTE: Obbligatorio Stringa che rappresenta la parte della data.
  • DATA: Obbligatorio La data, in un 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"
"aa"

"month"
"mm"
m"

"giorno"
"gg"
"d"

"ora"
"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 un formato standard.
set_date_part​(COMPONENT, VALUE, DATE)
set_date_part("m", 4, date("2016-11-09T11:44:44,797")
"09/04/2016:44:44Z"
make_date_time
Crea una data da parti. Questa funzione può essere indotta anche utilizzando make_timestamp.
  • ANNO: Obbligatorio L'anno, composto da quattro cifre.
  • MESE: Obbligatorio Il mese. I valori consentiti sono compresi tra 1 e 12.
  • GIORNO: Obbligatorio Il giorno. I valori consentiti sono compresi tra 1 e 31.
  • ORA: Obbligatorio Ora. I valori consentiti sono compresi tra 0 e 23.
  • MINUTO: Obbligatorio Il minuto. I valori consentiti sono compresi tra 0 e 59.
  • NANOSECONDI: Obbligatorio I valori dei nanosecondi. I valori consentiti sono compresi tra 0 e 999999999.
  • FUSO ORARIO: 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 stai 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 stai tentando di convertire.
  • ZONA: Obbligatorio Fuso orario in cui si sta tentando di convertire la data.
zone_date_to_zone​(DATE, ZONE)
zone_date_to_utc​(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
Parametri
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 Un raggruppamento di coppie chiave-array.
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.
  • STRINGA: Obbligatorio Stringa analizzata per creare un oggetto.
  • DELIMITATORE_VALORE: Facoltativo Delimitatore che separa un campo dal valore. Il delimitatore predefinito è :.
  • DELIMITATORE_CAMPO: Facoltativo Il delimitatore che separa le coppie di valori di campo. Il delimitatore predefinito è ,.
str_to_object​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Nota: puoi utilizzare la get() funzione 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")
  • Esempio #1:{"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 obsoleta is_set() funzione.
  • 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 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.
  • STRINGA: Obbligatorio Stringa da analizzare.
  • CHIAVE: Obbligatorio Chiave per la quale estrarre il valore.
  • DELIMITATORE_VALORE: Obbligatorio Il delimitatore che separa il campo e il valore. Se uno dei due null o viene fornita una stringa vuota, questo valore è :.
  • DELIMITATORE_CAMPO: Facoltativo Il delimitatore che separa le coppie di campi e valori. Se uno dei due null o viene fornita una stringa vuota, questo 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.
  • MAPPA: Obbligatorio I dati della mappa di input.
  • CHIAVE: Obbligatorio 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)
Consulta la sezione appendice per un esempio di codice.
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.
  • MAPPA: Obbligatorio Dati della mappa di input
  • CHIAVE: Obbligatorio 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)
Consulta la sezione appendice per un esempio di codice.
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.
MAPPA: Obbligatorio I dati della mappa di input.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Consulta la sezione appendice per un esempio di codice.
object_to_map (Sintassi 1)
Utilizza questa funzione per creare tipi di dati per mappe.
  • CHIAVE: Obbligatorio 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, eccetto Mappe.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, … )
Consulta la sezione appendice per un esempio di codice.
object_to_map (Sintassi 2)
Utilizza questa funzione per creare tipi di dati per mappe.
  • OGGETTO: Obbligatorio È possibile fornire un oggetto o un array di oggetti in ingresso e puntare a un attributo all'interno dell'oggetto come chiave.
object_to_map(OBJECT)
Consulta la sezione appendice per un esempio di codice.
object_to_map (Sintassi 3)
Utilizza questa funzione per creare tipi di dati per mappe.
  • OGGETTO: Obbligatorio È possibile fornire un oggetto o un array 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)
Consulta la sezione appendice per un esempio di codice.

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
Parametri
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 Null.
coalesce(INPUT)
coalesce(null, null, null, "first", null, "second")
"first"
primo
Recupera il primo elemento dell’array specificato.
  • INPUT: Obbligatorio L’array di cui desideri trovare il primo elemento.
first(INPUT)
first("1", "2", "3")
"1"
ultimo
Recupera l’ultimo elemento dell’array specificato.
  • INPUT: Obbligatorio L’array di cui desideri trovare l’ultimo elemento.
last(INPUT)
last("1", "2", "3")
3"
add_to_array
Aggiunge elementi alla fine dell'array.
  • ARRAY: Obbligatorio 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.
  • ARRAY: Obbligatorio 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 per indicare se includere o meno valori Null nella matrice di risposta.
  • VALORI: Obbligatorio 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 Oggetto di cui stai cercando 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 a cui aggiungere l’array nel profilo.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[124, 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’è.
  • ARRAY: Obbligatorio Array che sostituisce l’array nel profilo.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[124, 456]

Gerarchie - Mappa map

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Parametri
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.
  • CHIAVE: Obbligatorio La chiave deve essere un nome di campo nell’array di oggetti e l’oggetto come valore.
array_to_map(OBJECT[] INPUT, CHIAVE)
Leggi le 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
Parametri
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: Obbligatorio Chiave da associare.
  • OPTIONS: Obbligatorio Array piatto 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 dello stato dato è "pa", "Pennsylvania".
Se stateCode non corrisponde a quanto segue, "N/D".
iif
Valuta una determinata espressione booleana e restituisce il valore specificato in base al risultato.
  • ESPRESSIONE: Obbligatorio Espressione booleana in fase di valutazione.
  • TRUE_VALUE: Obbligatorio Il valore che viene restituito se l’espressione restituisce true.
  • FALSE_VALUE: Obbligatorio Il valore che viene 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
Parametri
Sintassi
Espressione
Output di esempio
min
Restituisce il minimo degli argomenti specificati. Utilizza l’ordinamento naturale.
  • OPTIONS: Obbligatorio Uno o più oggetti che possono essere confrontati.
min(OPTIONS)
min(3, 1, 4)
1
max
Restituisce il massimo degli argomenti specificati. Utilizza l’ordinamento naturale.
  • OPTIONS: Obbligatorio Uno o più oggetti che possono essere confrontati.
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
Parametri
Sintassi
Espressione
Output di esempio
to_bigint
Converte una stringa in un BigInteger.
  • STRINGA: Obbligatorio Stringa da convertire in un BigInteger.
to_bigint(STRING)
to_bigint​("1000000.34")
1000000,34
to_decimal
Converte una stringa in un valore Double.
  • STRINGA: Obbligatorio Stringa da convertire in Double.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Converte una stringa in un elemento mobile.
  • STRINGA: Obbligatorio Stringa da convertire in Mobile.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Converte una stringa in un numero intero.
  • STRINGA: 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
Parametri
Sintassi
Espressione
Output di esempio
json_to_object
Deserializza il contenuto JSON dalla stringa specificata.
  • STRINGA: Obbligatorio 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
Parametri
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.
  • STRINGA: Obbligatorio 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, leggi elenco dei valori dei campi dispositivo nell'appendice del presente documento.

NOTE
Scorri verso sinistra o destra per visualizzare l’intero contenuto della tabella.
Funzione
Descrizione
Parametri
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
Parametri
Sintassi
Espressione
Output di esempio
aa_get_event_id
Estrae l’ID evento da una stringa evento Analytics.
  • STRINGA_EVENTO: Obbligatorio Stringa dell’evento Analytics separato da virgole.
  • NOME_EVENTO: Obbligatorio 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.
  • STRINGA_EVENTO: Obbligatorio Stringa dell’evento Analytics separato da virgole.
  • NOME_EVENTO: 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 La stringa dei 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 La stringa dei 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")
["Esempio di prodotto 1","Esempio di prodotto 2"]
aa_get_product_quantity
Estrae le quantità da una stringa di prodotti Analytics.
  • PRODUCTS_STRING: Obbligatorio La stringa dei 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", nulle]
aa_get_product_price
Estrae il prezzo da una stringa di prodotti Analytics.
  • PRODUCTS_STRING: Obbligatorio La stringa dei 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 La stringa dei prodotti Analytics.
  • NOME_EVENTO: Obbligatorio 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 La stringa dei prodotti Analytics.
  • NOME_EVAR: Obbligatorio 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 del 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, il city e state gli attributi vengono acquisiti automaticamente anche in fase di runtime perché address oggetto mappato a addr. Se dovessi creare un’ line2 nella struttura XDM e i dati di input contengono anche un line2 nel address , verranno acquisiti automaticamente anche senza la necessità di 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. Questi sono di solito 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 una compressa, ma solitamente con eInk schermo.
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 un Playstation o un XBox.
Console di gioco palmare
Un sistema di gioco mobile come un Nintendo Switch.
Voce
Un dispositivo basato sulla voce come Amazon Alexa o un 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, fingono di essere robot come Google, ma non lo sono. Nota: nella maggior parte dei casi, gli imitatori robot sono in effetti robot.
Cloud
Applicazione basata su cloud. Non si tratta né di robot né di hacker, ma di applicazioni che devono connettersi. Ciò include Mastodon server.
Hacker
Questo valore di dispositivo viene utilizzato nel caso in cui venga rilevato uno script in useragent stringa.

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