Le funzioni di preparazione dei dati possono essere utilizzate per calcolare e calcolare i valori in base a quanto immesso nei campi di origine.
Campi
Un nome campo può essere un qualsiasi identificatore legale, ovvero 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 sono sensibili all’uso di maiuscole e minuscole.
Se il nome di un campo non segue questa convenzione, è necessario racchiudere il nome del campo con ${}. Quindi, ad esempio, se il nome del campo è "Nome" o "Nome.Nome", il nome deve essere racchiuso come ${First Name} o ${First.Name} rispettivamente.
Inoltre, se il nome di un campo è qualsiasi 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
È possibile accedere ai dati contenuti nei campi secondari utilizzando la notazione del punto. Ad esempio, se era presente un name per accedere all'oggetto firstName campo, 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/destra per visualizzare il contenuto completo della tabella.
Funzione
Descrizione
Parametri
Sintassi
Espressione
Output di esempio
concat
Concatena le stringhe specificate.
STRINGA: 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 divisione viene risolta in ",". I seguenti delimitatori necessità deve essere evitato con \: +, ?, ^, |, ., [, (, {, ), *, $, \ Se si includono più caratteri come delimitatore, questo viene considerato come un delimitatore a più caratteri.
STRINGA: Obbligatorio Stringa da dividere.
REGEX: Facoltativo Espressione regolare che può essere utilizzata per dividere la stringa.
esplode(STRINGA, REGEX)
esplode("Ciao!", " ")
["Hi,", "there"]
instr
Restituisce la posizione/indice di una sottostringa.
INGRESSO: Obbligatorio Stringa in corso di ricerca.
SOTTOSTRINGA: Obbligatorio Sottostringa alla quale viene eseguita la ricerca all’interno della stringa.
AVVIO_POSIZIONE: Facoltativo La posizione in cui iniziare a cercare nella stringa.
OCCORRENZA: Facoltativo L'ennesima occorrenza da cercare dalla posizione iniziale. Per impostazione predefinita, è 1.
Sostituisce la stringa di ricerca se presente nella stringa originale.
INGRESSO: Obbligatorio Stringa di input.
TO_TROVA: Obbligatorio Stringa da cercare all’interno dell’input.
TO_SOSTITUISCI: Obbligatorio Stringa che sostituirà il valore all'interno di "TO_FIND".
replace(INPUT, TO_FIND, TO_REPLACE)
replace("Questa è una stringa ri test", "re", "replace")
"Questo è un test di sostituzione stringa"
substr
Restituisce una sottostringa di una lunghezza specificata.
INGRESSO: 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("This is a substring test", 7, 8)
"a subst"
Lower / cassa
Converte una stringa in minuscolo.
INGRESSO: Obbligatorio Stringa che verrà convertita in minuscolo.
Lower(INPUT)
lower("HeTo") lcase("HeTo")
"hello"
superiore / ucasi
Converte una stringa in maiuscolo.
INGRESSO: Obbligatorio Stringa che verrà convertita in maiuscolo.
Upper(INPUT)
Upper("HeTo") ucase("HeTo")
"CIAO"
split
Divide una stringa di input su un separatore. Il seguente separatore esigenze deve essere evitato con \: \. Se si includono più delimitatori, la stringa verrà suddivisa in qualsiasi dei delimitatori presenti nella stringa.
INGRESSO: Obbligatorio Stringa di input da dividere.
SEPARATORE: Obbligatorio Stringa utilizzata per dividere l'input.
split(INGRESSO, SEPARATORE)
split("Ciao mondo", " ")
["Hello", "world"]
join
Unisce un elenco di oggetti utilizzando il separatore.
SEPARATORE: Obbligatorio Stringa che verrà utilizzata per unire gli oggetti.
OGGETTI: Obbligatorio Matrice di stringhe da unire.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Ciao a tutti"
lembo
Aggiunge il lato sinistro di una stringa con l'altra stringa specificata.
INGRESSO: Obbligatorio Stringa da eliminare. Questa stringa può essere null.
CONTEGGIO: Obbligatorio Dimensione della stringa da eliminare.
AGGIUNTA: Obbligatorio Stringa con cui incollare l’input. Se null o empty, verrà trattato come un singolo spazio.
Lpad(INPUT, COUNT, PADDING)
lpad("bat", 8, "yz")
"yzyzybat"
tappetino
Aggiunge il lato destro di una stringa all'altra stringa specificata.
INGRESSO: Obbligatorio Stringa da eliminare. Questa stringa può essere null.
CONTEGGIO: Obbligatorio Dimensione della stringa da eliminare.
AGGIUNTA: Obbligatorio Stringa con cui incollare l’input. Se null o empty, verrà trattato come un singolo spazio.
rpad(INPUT, COUNT, PADDING)
rpad("bat", 8, "yz")
"batyzyzy"
sinistra
Ottiene i primi caratteri "n" della stringa specificata.
STRINGA: Obbligatorio Stringa per la quale si ottengono i primi caratteri "n".
CONTEGGIO: Obbligatorio I caratteri "n" che si desidera ottenere dalla stringa.
left(STRING, COUNT)
left("abcde", 2)
"ab"
right
Ottiene gli ultimi caratteri "n" della stringa specificata.
STRINGA: Obbligatorio Stringa per la quale si ricevono gli ultimi caratteri "n".
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 si desidera rimuovere lo spazio vuoto.
ltrim(STRING)
ltrim(" hello")
"hello"
trim
Rimuove lo spazio vuoto dalla fine della stringa.
STRINGA: Obbligatorio Stringa da cui si desidera rimuovere lo spazio vuoto.
rtrim(STRING)
rtrim("hello ")
"hello"
trim
Rimuove lo spazio vuoto dall’inizio e dalla fine della stringa.
STRINGA: Obbligatorio Stringa da cui si desidera rimuovere lo spazio vuoto.
trim(STRING)
trim(" hello ")
"hello"
è uguale a
Confronta due stringhe per confermare se sono uguali. Questa funzione distingue tra maiuscole e minuscole.
STRINGA1: Obbligatorio La prima stringa da confrontare.
STRINGA2: Obbligatorio Seconda stringa da confrontare.
STRING1. equals( STRING2)
"string1". è uguale a ("STRING1")
false
equalsIgnoreCase
Confronta due stringhe per confermare se sono uguali. Questa funzione è not sensibile a maiuscole e minuscole.
STRINGA1: Obbligatorio La prima stringa da confrontare.
STRINGA2: Obbligatorio Seconda stringa da confrontare.
STRING1. equalsIgnoreCase (STRING2)
"string1". equalsIgnoreCase ("STRING1)
true
Funzioni con espressione regolare
Funzione
Descrizione
Parametri
Sintassi
Espressione
Output di esempio
extract_regex
Estrae i gruppi dalla stringa di input, in base a un'espressione regolare.
STRINGA: Obbligatorio Stringa da cui si stanno estraendo i gruppi.
REGEX: Obbligatorio L'espressione regolare a cui si desidera associare il gruppo.
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 Un valore booleano che determina se viene restituito il percorso completo. Se è impostato su false, viene restituita solo la fine del percorso.
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 URL da cui si sta tentando di ottenere la stringa di query.
ANCORAGGIO: Obbligatorio Determina l’operazione che verrà eseguita con l’ancoraggio nella stringa di query. Può essere uno dei tre valori seguenti: "keep", "remove" o "append".
Se il valore è "keep", l’ancoraggio viene associato al valore restituito. Se il valore è "remove", l’ancoraggio viene rimosso dal valore restituito. Se il valore è "append", l’ancoraggio viene restituito come valore separato.
Scorri verso sinistra/destra per visualizzare il contenuto completo della tabella. Ulteriori informazioni sulle date si trova nella sezione date del guida alla gestione del formato 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
format
Formatta la data di input in base a un formato specificato.
DATA: Obbligatorio La data di input, sotto forma di oggetto ZoningDateTime, che si desidera formattare.
FORMATO: Obbligatorio Formato in cui si desidera modificare la data.
Converte una stringa data in un oggetto ZoningDateTime (formato ISO 8601).
DATA: Obbligatorio Stringa che rappresenta la data.
FORMATO: Obbligatorio Stringa che rappresenta il formato della data di origine.Nota: Questo not rappresenta il formato in cui si desidera convertire la stringa di data.
DEFAULT_DATE: Obbligatorio La data predefinita restituita, se la data fornita è null.
Converte una stringa data in un oggetto ZoningDateTime (formato ISO 8601).
DATA: Obbligatorio Stringa che rappresenta la data.
FORMATO: Obbligatorio Stringa che rappresenta il formato della data di origine.Nota: Questo not rappresenta il formato in cui si desidera convertire la stringa di data.
date(DATA, FORMATO)
date("2019-10-23 11:24", "aaaa-MM-gg HH:mm")
2019-10-23T11:24:00Z
data
Converte una stringa data in un oggetto ZoningDateTime (formato ISO 8601).
DATA: Obbligatorio Stringa che rappresenta la data.
data(DATA)
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" Sì
"trimestre" "qq" "q"
"mese" "mm" "m"
"giorno dell'anno" "dy" "y"
"day" "dd" "d"
"week" "ww" "w"
"giorno feriale" "dw" "w"
"ora" "hh" "hh24" "hh12"
"minuto" "mi" "n"
"secondo" "ss" "s"
"millisecondo" "ms"
COMPONENTE: Obbligatorio Una 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 data specificata. Sono accettati i seguenti componenti:
"anno" "aaaa" Sì
"mese" "mm" "m"
"day" "dd" "d"
"ora" "hh"
"minuto" "mi" "n"
"secondo" "ss" "s"
COMPONENTE: Obbligatorio Una 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.
Controlla se l'oggetto esiste all'interno dei dati di origine. Nota: Questa funzione sostituisce la funzione obsoleta is_set() funzione .
INGRESSO: Obbligatorio Percorso da verificare se esiste all’interno dei dati di origine.
contains_key(INPUT)
contains_key("evar.evar.field1")
true
annullare
Imposta il valore dell'attributo su null. Da utilizzare quando non si desidera copiare il campo nello schema di destinazione.
nullify()
nullify()
null
get_keys
Analizza le coppie chiave/valore e restituisce tutte le chiavi.
OGGETTO: Obbligatorio L'oggetto da cui verranno estratte le chiavi.
get_keys(OBJECT)
get_keys({"book1"): "Orgoglio e pregiudizio", "libro2": "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 cui estrarre il valore.
VALUE_DELIMITER: Obbligatorio Il delimitatore che separa il campo e il valore. Se null oppure viene fornita una stringa vuota, questo valore è :.
FIELD_DELIMITER: Facoltativo Il delimitatore che separa le coppie di campi e valori. Se null oppure viene fornita una stringa vuota, questo valore è ,.
INGRESSO: Obbligatorio Matrice di cui si desidera trovare l’ultimo elemento.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Aggiunge elementi alla fine della matrice.
ARRAY: Obbligatorio Matrice a cui si aggiungono gli elementi.
VALORI: Gli elementi che si desidera 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 aggiungono gli elementi.
VALORI: Matrice da aggiungere alla matrice padre.
join_array (ARRAY, VALUES)
join_array (["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 Un valore booleano per indicare se includere o meno i valori Null nell'array di risposta.
VALORI: Obbligatorio Gli elementi da convertire in una matrice.
to_array (INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Restituisce le dimensioni dell’input.
INGRESSO: 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 Profile. Questa funzione è only applicabile durante gli aggiornamenti. Se utilizzata nel contesto di inserti, questa funzione restituisce l'input così come è.
ARRAY: Obbligatorio Matrice da aggiungere all'array nel profilo.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[123, 456]
upsert_array_replace
Questa funzione viene utilizzata per sostituire gli elementi di una matrice. Questa funzione è only applicabile durante gli aggiornamenti. Se utilizzata nel contesto di inserti, questa funzione restituisce l'input così come è.
ARRAY: Obbligatorio Matrice per sostituire la matrice nel profilo.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123, 456]
Operatori logici
NOTA
Scorri verso sinistra/destra per visualizzare il contenuto completo 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 key viene trovato o restituisce un valore predefinito se presente nell'array.
CHIAVE: Obbligatorio Chiave a cui deve corrispondere.
OPTIONS: Obbligatorio Matrice appiattita di coppie chiave/valore. Facoltativamente, è possibile inserire un valore predefinito alla fine.
Se il codice di stato specificato è "ca", "California". Se lo statoCode 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 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")
"True"
Aggregazione
NOTA
Scorri verso sinistra/destra per visualizzare il contenuto completo della tabella.
Funzione
Descrizione
Parametri
Sintassi
Espressione
Output di esempio
min
Restituisce il minimo degli argomenti specificati. Utilizza l'ordine naturale.
OPTIONS: Obbligatorio Uno o più oggetti confrontabili tra loro.
min(OPTIONS)
min(3, 1, 4)
1
max
Restituisce il massimo degli argomenti specificati. Utilizza l'ordine naturale.
OPTIONS: Obbligatorio Uno o più oggetti confrontabili tra loro.
max(OPTIONS)
max(3, 1, 4)
4
Conversioni di tipo
NOTA
Scorri verso sinistra/destra per visualizzare il contenuto completo della tabella.
Funzione
Descrizione
Parametri
Sintassi
Espressione
Output di esempio
to_bigint
Converte una stringa in un BigInteger.
STRINGA: Obbligatorio Stringa da convertire in BigInteger.
to_bigint(STRING)
to_bigint ("100000.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 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
NOTA
Scorri verso sinistra/destra per visualizzare il contenuto completo 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.
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.
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.
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 dell'agente utente.
ua_os_name_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")
iOS 5.1.1
ua_agent_version
Estrae la versione dell'agente dalla stringa dell'agente utente.
ua_agent_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
ua_agent_version_major
Estrae il nome dell'agente e la versione principale dalla stringa dell'agente utente.
ua_agent_version_major ("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")
Safari 5
ua_agent_name
Estrae il nome dell'agente dalla stringa dell'agente utente.
ua_agent_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")
Safari
ua_device_class
Estrae la classe dispositivo dalla stringa dell'agente utente.
ua_device_class ("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")
Telefono
Copia oggetto
SUGGERIMENTO
La funzione di copia dell'oggetto viene applicata automaticamente quando un oggetto nell'origine viene mappato a un oggetto in XDM. Non sono necessarie ulteriori azioni da parte degli utenti.
È possibile utilizzare la funzione di copia dell’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
}
Poi la mappatura diventa:
address -> addr
address.line1 -> addr.addrLine1
Nell’esempio precedente, il city e state gli attributi vengono inoltre acquisiti automaticamente in fase di runtime perché il address oggetto mappato su addr. Se doveste creare un line2 nella struttura XDM e i dati di input contengono anche un line2 in address e viene acquisito automaticamente senza la necessità di modificare manualmente la mappatura.
Per garantire il funzionamento della mappatura automatica, è necessario soddisfare i seguenti prerequisiti:
È necessario mappare gli oggetti a livello principale;
È necessario creare nuovi attributi nello schema XDM;
I nuovi attributi devono avere nomi corrispondenti nello schema di origine e nello schema XDM.
Se uno dei prerequisiti non è soddisfatto, è necessario mappare manualmente lo schema di origine allo schema XDM utilizzando la preparazione dati.
