Funzioni generali
Variabili
Puoi utilizzare queste variabili generali per identificare i dettagli di un’esecuzione:
executionID: ID dell’esecuzione dello scenariotriggerTimestamp: ora in cui è stata attivata l’esecuzionescenarioID: ID dello scenario attualmente apertoscenarioName: nome dello scenario attualmente in esecuzioneoperationsConsumed: numero di operazioni utilizzate in quel punto dello scenario.
get (oggetto o array; percorso)
Restituisce il percorso del valore di un oggetto o di una matrice. Per accedere agli oggetti nidificati, utilizzare la notazione del punto. Il primo elemento di un array è l’indice 1.
Esempi:
get( array ; 1 + 1 )get( array ; 5.raw_name )get( object ; raw_name )get( object ; raw_name.sub_raw_name )
if (espressione; valore1; valore2)
Restituisce value1 se l’espressione viene valutata come true, altrimenti restituisce value2.
Per creare un’istruzione if che restituisca un valore solo se due o più espressioni vengono valutate come true, utilizzare la parola chiave and.
Per combinare if istruzioni, utilizzare gli operatori and e or.
Esempi:
-
if( 1 = 1 ; A ; B )Restituisce Un
-
if( 1 = 2 ; A ; B )Restituisce B
-
if( 1 = 2 and 1 = 2 ; A ; B )Restituisce B
ifempty (valore1; valore2)
Restituisce value1 se questo valore non è vuoto, altrimenti restituisce value2.
Esempi:
-
ifempty(A;B)Restituisce Un
-
ifempty(unknown;B)Restituisce B
-
ifempty("";B)Restituisce B
opzione (espressione; valore1; risultato1; [valore2; risultato2; …]; [altro])
Valuta un valore (denominato espressione) rispetto a un elenco di valori; restituisce il risultato corrispondente al primo valore corrispondente. Per includere un valore else, aggiungerlo dopo l’espressione o il valore finale.
Esempi:
-
switch( B ; A ; 1 ; B ; 2 ; C ; 3 )Restituisce 2
-
switch( C ; A ; 1 ; B ; 2 ; C ; 3 )Restituisce 3
-
switch( X ; A ; 1 ; B ; 2 ; C ; 3 ; 4 )Restituisce 4
In questa funzione, 4 è il valore da restituire se non viene applicata alcuna espressione (il valore
else).
omit(object; key1; [key2; …])
Omette le chiavi specificate dell’oggetto e restituisce il resto.
Esempio:
omit( Utente ; password )
Restituisce una raccolta delle informazioni dell’utente, esclusa la password.
scegli(oggetto; chiave1; [chiave2; …])
Seleziona dall’oggetto solo le chiavi specificate.
Esempio:
pick( Utente ; password ; e-mail )
Restituisce una raccolta contenente solo la password e l’indirizzo e-mail dell’utente.
mergeCollections(collection1; collection2)
Unisce due raccolte combinando le rispettive coppie chiave-valore. Se entrambi gli insiemi contengono la stessa chiave, il valore della seconda raccolta sovrascrive quello della prima raccolta.
isBlank(value)
Restituisce true se il valore è null o una stringa vuota, altrimenti restituisce false. A differenza di ifEmpty, questa funzione non considera il numero 0 o le stringhe solo spazi vuoti come vuoti.
Esempio:
-
isBlank("")Restituisce true
-
isBlank(null)Restituisce true
-
isBlank("Hello")Restituisce false
-
isBlank(0)Restituisce false
-
isBlank(" ")Restituisce false
in(valore; valore1; valore2; …)
Restituisce true se il valore è uguale a uno dei valori specificati (uguaglianza rigorosa, nessuna coercizione del tipo).
Esempio:
-
in("B"; "A"; "B"; "C")Restituisce true
-
in("D"; "A"; "B"; "C")Restituisce false
-
in(2; 1; 2; 3)Restituisce true
-
in("2"; 1; 2; 3)Restituisce false
ifin(value; value1; value2; …; trueExpression; falseExpression)
Restituisce trueExpression se il valore corrisponde a uno qualsiasi dei valori di corrispondenza forniti, altrimenti restituisce falseExpression. Richiede almeno 3 argomenti (valore, un valore di corrispondenza e trueExpression + falseExpression).
Esempio:
-
ifin("B"; "A"; "B"; "yes"; "no")Restituisce sì
-
ifin("D"; "A"; "B"; "yes"; "no")Restituisce no
-
ifin("X"; "X"; "found"; "not found")Restituzioni trovate
case(indexNumber; value1; value2; …)
Restituisce il valore nella posizione specificata dal numero di indice (basato su 1). Restituisce null se l’indice non è compreso nei limiti o è 0.
Esempio:
-
case(1; "Sun"; "Mon"; "Tue")Restituisce il sole
-
case(2; "Sun"; "Mon"; "Tue")Restituisce il lunedì
-
case(3; "Sun"; "Mon"; "Tue")Restituisce Mar
-
case(5; "a"; "b")Restituisce null
case(dayOfWeek(date); "Sun"; "Mon"; "Tue"; "Wed"; "Thu"; "Fri"; "Sat")