Documentazione Experience Platform Guida alla preparazione dei dati

Funzioni di mappatura della preparazione dati

Ultimo aggiornamento: 5 maggio 2025

Argomenti:
Preparazione dei dati

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.

SUGGERIMENTO

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

NOTA

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

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")

c3599c11e47719df18a2448690840c5dfcce3c80

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")

7330d2b39ca35eaf4cb95fc846c21ee6a39af698154a83a586ee270a0d372104

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")

a3d7e45a0d9be4e4b9a3b8c9c2163c21ef708bf11b4232bb21d2a8704ada2cdcd7b367dd0788a89a5c908cfe377aceb1072a7b38 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")

d3b96ce8c9fb4e9bd0198d03ba6852c7

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

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

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()

2021-10-26T10:10:24Z

timestamp

Recupera l’ora Unix corrente.

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:

"anno"
"aaaa"
"aa"

"trimestre"
"qq"
"q"

"mese"
"mm"
"m"

"dayofyear"
"dy"
"y"

"giorno"
"dd"
"d"

"settimana"
"ww"
"w"

"giorno feriale"

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

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()

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

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 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 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 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 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

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

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

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

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

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

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()

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

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 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/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_majors("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")

IOS 5

ua_os_version

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 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")

5.1.1.

ua_os_name_version

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 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")

iOS 5.1.1

ua_agent_version

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 like Mac OS X) AppleWebKit/534.46 (KHTML, like 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

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;;eVar1=valore merchandising", "eVar1")

["Valore merchandising"]

Copia oggetto

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

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

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

map_get_values

Seleziona per visualizzare l’esempio

 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

Seleziona per visualizzare l’esempio

 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

Seleziona per visualizzare l’esempio

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

Sintassi 1

Seleziona per visualizzare l’esempio

example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Sintassi 2

Seleziona per visualizzare l’esempio

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

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

Seleziona per visualizzare l’esempio

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