Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Funzioni del trasformatore dati
Questa pagina descrive il set aggiuntivo di funzioni Jsonnet predefinite per l'attività Script per la trasformazione dei dati disponibile in Application Integration.
Per utilizzare le seguenti funzioni predefinite, devi importare la libreria functions nello script. L'importazione della libreria functions consente di utilizzare sia le funzioni Jsonnet standard sia le funzioni predefinite di Data Transformer.
Application Integration supporta la libreria di funzioni Jsonnet v0.20.0. Per informazioni sulle funzioni standard Jsonnet, consulta JSON Standard Library.
Funzioni di array
Average
Sintassi
avg(arr)
Descrizione
Calcola la media numerica di tutti i valori in una matrice.
Parametro di input
arr: l'array di input.
Tipo restituito
DOUBLE
Output
Restituisce la media di tutti i valori nella matrice.
Contains
Sintassi
contains(arr, elem)
Descrizione
Controlla l'occorrenza dell'elemento specificato in un array.
Parametro di input
arr: l'array di input.
elem: l'elemento array in cui cercare.
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se viene trovata una corrispondenza, FALSE in caso contrario.
Max Array
Sintassi
maxArray(arr)
Descrizione
Trova il valore più alto in una matrice.
Parametro di input
arr: l'array di input.
Tipo restituito
Il tipo di dati dell'array di input.
Output
Restituisce il valore più alto trovato nell'array.
Min Array
Sintassi
minArray(arr)
Descrizione
Trova il valore più basso in un array.
Parametro di input
arr: l'array di input.
Tipo restituito
Il tipo di dati dell'array di input.
Uscita/°>
Restituisce il valore più basso trovato nell'array.
Remove
Sintassi
remove(arr, elem)
Descrizione
Rimuove l'elemento specificato da un array.
Parametro di input
arr: l'array di input.
elem: l'elemento array da rimuovere.
Tipo restituito
Il tipo di dati dell'array di input.
Output
Restituisce l'array aggiornato dopo la rimozione dell'elemento specificato.
Remove At
Sintassi
removeAt(arr, index)
Descrizione
Rimuove un elemento da un array nell'indice specificato.
Parametro di input
arr: l'array di input.
indice: l'indice array dell'elemento da rimuovere.
Tipo restituito
Il tipo di dati dell'array di input.
Output
Restituisce l'array aggiornato dopo la rimozione dell'elemento specificato.
Sum
Sintassi
sum(arr)
Descrizione
Somma tutti i valori in un array.
Parametro di input
arr: l'array di input.
Tipo restituito
Il tipo di dati dell'array di input.
Output
Restituisce la somma di tutti gli elementi nell'array.
GroupBy
Sintassi
groupBy(array, function)
Descrizione
Crea un oggetto composto da chiavi generate dai risultati dell'esecuzione di ciascun elemento dell'array tramite la funzione di iterazione. Ad esempio, f.groupBy([1,1.3,1.8],std.floor) genererà {"1": [1,1.3,1.8]}.
Parametro di input
array: la raccolta su cui viene eseguita l'iterazione del metodo.
function: la funzione che viene richiamata per ogni elemento dell'array.
Tipo restituito
JSON
Output
Restituisce l'oggetto aggregato composto.
Zip
Sintassi
zip([arrays])
Descrizione
Crea un array di elementi raggruppati, il primo dei quali contiene i primi elementi degli array indicati, il secondo contiene il secondo elemento degli array dati e così via. Ad esempio, f.zip([[1, "one", "I"],[2, "two", "II"],[3, "three", "III"]]) genererà [[1,2,3],["one", "two", "three"],["I", "II", "III"]].
Parametro di input
[arrays]: questo parametro contiene gli array da elaborare.
Tipo restituito
array
Output
Restituisce il nuovo array di elementi raggruppati.
Unzip
Sintassi
unzip(array)
Descrizione
Crea un array di elementi raggruppati. Accetta un array di elementi raggruppati e crea anche un array che raggruppa gli elementi nella relativa configurazione pre-zip. Ad esempio, f.unzip([[1, "one", "I"],[2, "two", "II"],[3, "three", "III"]]) genererà [[1,2,3],["one", "two", "three"],["I", "II", "III"]].
Parametro di input
array: questo parametro contiene l'array di elementi raggruppati da elaborare.
Tipo restituito
array
Output
Restituisce il nuovo array di elementi raggruppati.
Funzioni di aggregazione
XNOR
Sintassi
xnor(a, b)
Descrizione
Esegue un'operazione XMOR logica sui valori booleani specificati.
Parametro di input
a: un valore booleano.
b: un valore booleano.
Tipo restituito
BOOLEAN
Output
Restituisce l'Prenditore dai due valori booleani specificati.
Xor
Sintassi
xor(a, b)
Descrizione
Esegue un'operazione XOR logica sui valori booleani specificati.
Parametro di input
a: un valore booleano.
b: un valore booleano.
Tipo restituito
BOOLEAN
Output
Restituisce lo XOR dei due valori booleani specificati.
Analizza la stringa CSV di input specificata come json. La prima riga viene considerata come intestazione. Ad esempio, f.parseCsvWithHeader("index,product,company\n1,Application Integration,Google\n2,Pubsub,Google") genererà [{"index": "1", "product": "Application Integration", "company": "Google"},{"index": "2", "product": "Pubsub", "company": "Google"}].
Parametro di input
input: la stringa CSV da analizzare.
delimitatore:stringa di delimitazione da utilizzare. Il valore predefinito è ",".
overwrite_duplicate_headers: opzione per sovrascrivere i valori delle intestazioni duplicate. Se impostato su false, l'intestazione duplicata viene rinominata. Il valore predefinito è true.
Tipo restituito
JSON
Output
Restituisce la rappresentazione JSON della stringa csv specificata.
Manifest CSV
Sintassi
manifestCsv(json, headers = null)
Descrizione
Converti il json specificato in una stringa CSV. Ad esempio, f.manifestCsv([{"index": "1", "product": "Application Integration", "company": "Google"},{"index": "2", "product": "Pubsub", "company": "Google"}]) genererà index,product,company\n1,Application Integration,Google\n2,Pubsub,Google.
Parametro di input
json: JSON da convertire in CSV.
headers: elenco di intestazioni per l'output in formato CSV. Se non viene fornito alcun valore, vengono utilizzate tutte le intestazioni.
Tipo restituito
STRING
Output
Restituisce la stringa csv da json nel formato specificato.
Funzioni matematiche
Is Decimal
Sintassi
isDecimal(num)
Descrizione
Verifica se il numero specificato è un decimale.
Parametro di input
num: il numero inserito.
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se il numero è un decimale e FALSE in caso contrario.
Is Even
Sintassi
isEven(num)
Descrizione
Verifica se il numero specificato è pari.
Parametro di input
num: il numero inserito.
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se il numero è pari e FALSE in caso contrario.
Is Integer
Sintassi
isInteger(num)
Descrizione
Verifica se il numero specificato è un numero intero.
Parametro di input
num: il numero inserito.
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se il numero è un numero intero, altrimenti FALSE.
Is Odd
Sintassi
isOdd(num)
Descrizione
Controlla se il numero specificato è dispari.
Parametro di input
num: il numero inserito.
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se il numero è dispari e FALSE in caso contrario.
Random Number
Sintassi
randomNumber(lowerBound, upperBound)
Descrizione
Genera un numero reale casuale compreso tra un intervallo specificato.
Parametro di input
lowerBound: valore dell'intervallo inferiore (incluso). Il valore predefinito è 0.
upperBound: valore dell'intervallo più alto (escluso). Il valore predefinito è 1.
Tipo restituito
Un numero reale.
Output
Restituisce un numero reale casuale compreso tra lowerBound e upperBound.
Round
Sintassi
round(input)
Descrizione
Arrotonda un numero al numero intero più vicino.
Parametro di input
input: un valore da arrotondare.
Tipo restituito
INTEGER
Valore restituito
Restituisce il numero intero arrotondato più vicino.
Funzioni di stringa
Equals Ignore Case
Sintassi
equalsIgnoreCase(str1, str2)
Descrizione
Confronta i due valori di stringa specificati indipendentemente dall'uso delle maiuscole e delle maiuscole della stringa.
Parametro di input
str1: una stringa di input.
str2: una stringa di input.
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se il valore specificato corrisponde al valore esistente (senza distinzione tra maiuscole e minuscole) e FALSE in caso contrario.
Is Empty
Sintassi
isEmpty(str)
Descrizione
Verifica se la lunghezza della stringa specificata è 0.
Parametro di input
str: la stringa di input.
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se la stringa è vuota e FALSE in caso contrario.
Match
Sintassi
match(str, regexp)
Descrizione
Recupera il risultato della corrispondenza di una stringa con un'espressione regolare.
Restituisce un array di tutte le sottostringhe di str corrispondenti all'espressione regolare regexp. Restituisce un array vuoto in assenza di corrispondenze.
Trim
Sintassi
trim(str)
Descrizione
Rimuove tutti gli spazi iniziali e finali di una determinata stringa.
Parametro di input
str: la stringa di input.
Tipo restituito
STRING
Output
Restituisce una copia della stringa, con gli spazi vuoti iniziali e finali rimossi.
Formatta un timestamp in base al format_string specificato.
Parametro di input
timestamp: il timestamp di input.
format_string: il nuovo formato del timestamp. Consulta Elementi di formato timestamp supportati per un elenco di elementi di formato che possono essere utilizzati per formare la nuova stringa di formato timestamp.
timezone:il fuso orario del timestamp di input fornito. Il valore predefinito è UTC.
current_format: il formato che verrà utilizzato per analizzare il timestamp di input fornito. Il valore predefinito è E (epoca).
Tipo restituito
STRING
Output
Restituisce una nuova stringa dopo aver convertito l'input timestamp in base al valore format_string specificato.
Elementi del formato timestamp supportato
Nella tabella seguente sono elencati gli elementi di formato supportati per la funzione dateFormat():
Formatta elemento
Descrizione
Esempio
YYYY
Anno a 4 cifre.
2023
YY
Ultime due cifre dell'anno.
23
MMMM
Nome del mese in iniziali maiuscole.
March
MMM
Nome abbreviato del mese in iniziali maiuscole.
Mar
MM
Mese da 01 a 12.
03
M
Mese da 1 a 12.
3
DDDD
Nome del giorno in iniziali maiuscole.
Monday
DDD
Nome abbreviato del giorno.
Mon
DD
Giorno da 01 a 31.
06
D
Giorno da 1 a 31.
6
HH
Ora nel formato 24 ore da 00 a 23.
15
hh
Ora nel formato 12 ore da 01 a 12.
03
h
Ora nel formato 12 ore da 1 a 12.
3
mm
Minuto da 00 a 59.
04
m
Minuto da 0 a 59.
4
ss
Secondi da 00 a 59.
08
s
Secondi da 0 a 59.
8
FFFFFFFFF
Frazioni di secondi con nove cifre, inclusi gli zero, a destra delle cifre specificate.
00.123456789
FFFFFFFF
Frazioni di secondi con 8 cifre, inclusi gli zero, a destra delle cifre specificate.
00.12345678
FFFFFFF
Frazioni di secondi con sette cifre, inclusi gli zero, a destra delle cifre specificate.
00.1234567
FFFFFF
Frazioni di secondi con 6 cifre, inclusi gli zero, a destra delle cifre specificate.
00.123456
FFFFF
Frazioni di secondi con cinque cifre, inclusi gli zero, a destra delle cifre specificate.
00.12345
FFFF
Frazioni di secondi con 4 cifre, inclusi gli zero, a destra delle cifre specificate.
00.1234
FFF
Frazioni di secondi con 3 cifre, inclusi gli zero, a destra delle cifre specificate.
00.123
FF
Frazioni di secondi con due cifre, inclusi gli zero, a destra delle cifre specificate.
00.12
F
Frazioni di secondi con una cifra, inclusi gli zero, a destra delle cifre specificate.
00.1
fffffffff
Frazioni di secondi con 9 cifre.
987654321
ffffffff
Frazioni di secondi con 8 cifre.
98765432
fffffff
Frazioni di secondi con sette cifre.
9876543
ffffff
Frazioni di secondi con 6 cifre.
987654
fffff
Frazioni di secondi con 5 cifre.
98765
ffff
Frazioni di secondi con 4 cifre.
9876
fff
Frazioni di secondi con 3 cifre.
987
ff
Frazioni di secondi con 2 cifre.
98
f
Frazioni di secondi con 1 cifra.
9
tt
Indicatore del meridiano di Greenwich (mattina o sera). Durante la formattazione, è AM o PM.
PM
t
Indicatore del meridiano breve (mattina o sera). Viene mappata con le lettere minuscole am o pm.
pm
K
Nome del fuso orario.
PST
kk
Fuso orario in formato ±xx:xx.
-8:00:00
k
Fuso orario in formato ±xxxx.
-8000
Is Leap Year
Sintassi
isLeapYear(year)
Descrizione
Consente di verificare se l'anno specificato è bisestile.
Parametro di input
year: l'anno di input (numero reale).
Tipo restituito
BOOLEAN
Output
Restituisce TRUE se l'anno è bisestile e FALSE in caso contrario.
Now In Millis
Sintassi
nowInMillis()
Descrizione
Restituisce l'ora corrente del periodo Unix di un'integrazione in millisecondi.
Parametro di input
N/D
Tipo restituito
INT64
Output
Restituisce l'ora corrente del periodo Unix in millisecondi.
Funzioni di utilità
UUID
Sintassi
uuid()
Descrizione
Genera un UUID (Universally Unique Identifier) casuale come STRING. Il valore STRING restituito è composto da 32 cifre esadecimali in cinque gruppi separati da trattini nel formato 8-4-4-4-12. Le cifre esadecimali rappresentano 122 bit casuali e 6 bit fissi, in conformità con la sezione 4.4 di RFC 4122. Il valore STRING restituito è minuscolo.
Parametro di input
N/D
Tipo restituito
STRING
Output
Restituisce l'UUID generato in formato stringa.
Integration name
Sintassi
getIntegrationName()
Descrizione
Recupera il nome dell'integrazione attuale.
Parametro di input
N/D
Tipo restituito
STRING
Output
Restituisce il nome dell'integrazione corrente.
Integration region
Sintassi
getIntegrationRegion()
Descrizione
Ottieni la regione dell'integrazione attuale.
Parametro di input
N/D
Tipo restituito
STRING
Output
Restituisce la regione dell'integrazione corrente.
Integration version ID
Sintassi
getIntegrationVersionId()
Descrizione
Recupera l'ID versione dell'integrazione attuale.
Parametro di input
N/D
Tipo restituito
STRING
Output
Restituisce l'ID versione dell'integrazione corrente.
Integration version number
Sintassi
getIntegrationVersionNumber()
Descrizione
Recupera il numero di versione dell'integrazione attuale.
Parametro di input
N/D
Tipo restituito
NUMBER
Output
Restituisce il numero di versione dell'integrazione corrente.