Espressioni e funzioni per Data Factory in Microsoft Fabric

Articolo
10/15/2024

Questo articolo offre informazioni dettagliate sulle espressioni e funzioni supportate da Data Factory in Microsoft Fabric.

Espressioni

I valori di espressione nella definizione possono essere letterali o espressioni che vengono valutate in fase di esecuzione. Ad esempio:

"value"

"@pipeline().parameters.password"

Le espressioni possono trovarsi in qualsiasi punto in un valore stringa e restituiscono sempre un altro valore di stringa. Se un valore è un'espressione, il corpo dell'espressione viene estratto rimuovendo il simbolo di chiocciola (@). Se è necessaria una stringa letterale che inizia con @, occorre che la stringa sia preceduta da un carattere di escape usando @@. L'esempio seguente illustra la modalità di valutazione delle espressioni.

Valore dell'espressione	Risultato
"parameters"	Vengono restituiti i caratteri di tipo 'parameters'.
"parameters[1]"	Vengono restituiti i caratteri di tipo 'parameters[1]'.
"@@"	Viene restituita una stringa da 1 carattere che contiene \'\@\'.
" @"	Viene restituita una stringa da 2 caratteri che contiene '\@\'.

Tramite una funzionalità denominata interpolazione delle stringhe, è possibile inserire le espressioni anche all'interno delle stringhe in cui viene eseguito il wrapping delle espressioni in @{ ... }. Ad esempio: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Usando l'interpolazione delle stringhe, il risultato è sempre una stringa. Si supponga di aver definito myNumber come 42 e myString come foo:

Valore dell'espressione	Risultato
"@pipeline().parameters.myString"	Restituisce `foo` come stringa.
"@{pipeline().parameters.myString}"	Restituisce `foo` come stringa.
"@pipeline().parameters.myNumber"	Restituisce `42` come numero.
"@{pipeline().parameters.myNumber}"	Restituisce `42` come stringa.
"Answer is: @{pipeline().parameters.myNumber}"	Restituisce la stringa `Answer is: 42`.
"@concat('Answer is: ', string(pipeline().parameters.myNumber))"	Restituisce la stringa `Answer is: 42`.
"Answer is: @@{pipeline().parameters.myNumber}"	Restituisce la stringa `Answer is: @{pipeline().parameters.myNumber}`.

Nelle attività del flusso di controllo, ad esempio l'attività ForEach, è possibile fornire una matrice su cui eseguire l'iterazione per gli elementi della proprietà e usare @item() per scorrere una singola enumerazione nell'attività ForEach. Ad esempio, se items è una matrice: [1, 2, 3], @item() restituisce 1 nella prima iterazione, 2 nella seconda iterazione e 3 nella terza iterazione. È anche possibile usare @range(0,10) come espressione per scorrere 10 volte a partire da 0 terminando con 9.

È possibile usare @activity( "nome attività") per acquisire l'output dell'attività e prendere decisioni. Si consideri un'attività Web denominata Web1. Per inserire l'output della prima attività nel corpo del secondo, l'espressione è in genere simile alla seguente: @activity('Web1').output o @activity('Web1').output.data o qualcosa di simile a seconda dell'output della prima attività.

Esempi

Esempio di espressione complessa

Nell'esempio seguente viene illustrato un esempio complesso che fa riferimento a un campo secondario avanzato dell'output dell'attività. Per fare riferimento a un parametro della pipeline che restituisce un campo secondario, usare la sintassi [] anziché l'operatore punto (.) (come nel caso di subfield1 e subfield2), come parte di un’attività di output.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

La creazione di file in modo dinamico e la denominazione di tali file è un modello comune. Verranno esaminati alcuni esempi di denominazione dei file dinamici.

Accodare data a un nome file: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Accodare DateTime nel fuso orario del cliente: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Accodare Ora trigger: @concat('Test_', pipeline().TriggerTime)
Output di un nome file personalizzato in un Flusso di dati per mapping durante l'output in un singolo file con data: 'Test_' + toString(currentDate()) + '.csv'

Nei casi precedenti vengono creati quattro nomi file dinamici a partire da Test_.

Editor di contenuto dinamico

L'editor di contenuto dinamico esegue automaticamente l'escape dei caratteri nel contenuto al termine della modifica. Ad esempio, il seguente contenuto nell'editor di contenuto è un'interpolazione di stringhe con una funzione di espressione.

"@{toUpper('myData')}"

L'editor di contenuto dinamico converte il contenuto precedente nell’espressione "@{toUpper('myData')}". Il risultato di questa espressione è la stringa formattata mostrata di seguito.

"MYDATA"

Sostituzione di caratteri speciali

L'editor di contenuto dinamico esegue automaticamente l'escape dei caratteri, come le doppie virgolette, la barra rovesciata, nel contenuto al termine della modifica. Ciò causa problemi se si desidera sostituire il feed di riga o la scheda usando \n, \t nella funzione replace(). È possibile modificare il contenuto dinamico nella visualizzazione codice per rimuovere l'elemento aggiuntivo \ nell'espressione oppure seguire questa procedura per sostituire caratteri speciali usando il linguaggio delle espressioni:

Codifica dell'URL rispetto al valore stringa originale
Sostituire la stringa con codifica URL, ad esempio avanzamento riga (%0A), ritorno a capo(%0D), tabulazioni orizzontali (%09).
Decodifica URL

Ad esempio, variabile companyName con un carattere di nuova riga nel relativo valore, espressione @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) può rimuovere il carattere di nuova riga.

Contoso- Corporation

Carattere di escape virgolette singole

Le funzioni di espressione usano virgolette singole per i parametri di valore stringa. Usare due virgolette singole per eseguire l'escape di un carattere ' nelle funzioni stringa. Ad esempio, l'espressione @concat('Baba', '''s ', 'book store') restituirà il seguente risultato.

Baba's book store

Variabili dell'ambito della pipeline

È possibile fare riferimento a queste variabili di sistema in un punto qualsiasi della pipeline.

Nome variabile	Descrizione
@pipeline().DataFactory	Nome dei dati o dell’area di lavoro Synapse in cui è in esecuzione la pipeline
@pipeline().Pipeline	Nome della pipeline
@pipeline().RunId	ID dell'esecuzione della pipeline specifica
@pipeline().TriggerId	ID del trigger che ha richiamato la pipeline
@pipeline().TriggerName	Nome del trigger che richiama la pipeline
@pipeline().TriggerTime	Ora dell’esecuzione del trigger che ha richiamato la pipeline. Questo è il momento in cui il trigger viene effettivamente attivato per richiamare l'esecuzione della pipeline e può differire leggermente dall'ora pianificata del trigger.
@pipeline().GroupId	ID del gruppo a cui appartiene l'esecuzione della pipeline.
@pipeline()?.TriggeredByPipelineName	Nome della pipeline che attiva l’esecuzione della pipeline. Applicabile quando l'esecuzione della pipeline viene attivata da un'attività ExecutePipeline. Restituisce Null se usato in altre circostanze. Notare il punto interrogativo dopo @pipeline()
@pipeline()?.TriggeredByPipelineRunId	Eseguire l’ID della pipeline che attiva l'esecuzione della pipeline. Applicabile quando l'esecuzione della pipeline viene attivata da un'attività ExecutePipeline. Restituisce Null se usato in altre circostanze. Notare il punto interrogativo dopo @pipeline()

Nota

Le variabili di sistema di data/ora correlate al trigger (sia negli ambiti della pipeline che dei trigger) restituiscono date UTC in formato ISO 8601, ad esempio 2017-06-01T22:20:00.4061448Z.

Funzioni

È possibile chiamare le funzioni all'interno delle espressioni. Le sezioni seguenti forniscono informazioni sulle funzioni che è possibile usare in un'espressione.

Funzioni di data

Funzione di data e ora	Attività
addDays	Aggiunge un numero di giorni a un timestamp.
addHours	Aggiunge un numero di ore a un timestamp.
addMinutes	Aggiunge un numero di minuti a un timestamp.
addSeconds	Aggiunge un numero di secondi a un timestamp.
addToTime	Aggiunge un numero di unità di tempo a un timestamp. Vedere anche getFutureTime.
convertFromUtc	Converte un timestamp da UTC (Universal Time Coordinated) al fuso orario di destinazione.
convertTimeZone	Converte un timestamp dal fuso orario di origine al fuso orario di destinazione.
convertToUtc	Converte un timestamp dal fuso orario di origine a UTC (Universal Time Coordinated).
dayOfMonth	Restituisce il giorno del componente di mese di un timestamp.
dayOfWeek	Restituisce il giorno del componente settimana di un timestamp.
dayOfYear	Restituisce il giorno del componente anno di un timestamp.
formatDateTime	Restituisce il timestamp come stringa in formato facoltativo.
getFutureTime	Restituisce il timestamp corrente più le unità di tempo specificate. Vedere anche addToTime.
getPastTime	Restituisce il timestamp corrente meno le unità di tempo specificate. Vedere anche subtractFromTime.
startOfDay	Restituisce l'inizio del giorno per un timestamp.
startOfHour	Restituisce l'inizio dell'ora per un timestamp.
startOfMonth	Restituisce l'inizio del mese per un timestamp.
subtractFromTime	Sottrae un numero di unità di tempo da un timestamp. Vedere anche getPastTime.
ticks	Restituisce il valore della proprietà `ticks` per un timestamp specificato.
utcNow	Restituisce il timestamp corrente come stringa.

Funzioni di stringa

Per eseguire operazioni con le stringhe, è possibile usare queste funzioni di stringa e alcune funzioni di raccolta. Le funzioni di stringa funzionano solo sulle stringhe.

Funzione di stringa	Attività
concat	Combina due o più stringhe e restituisce la stringa combinata.
endsWith	Verifica se una stringa termina con la sottostringa specificata.
guid	Generare un identificatore univoco globale (GUID) sotto forma di stringa.
indexOf	Restituisce la posizione iniziale di una sottostringa.
lastIndexOf	Restituisce la posizione iniziale o il valore di indice per l'ultima occorrenza di una sottostringa.
replace	Sostituisce una sottostringa con la stringa specificata e restituisce la stringa aggiornata.
split	Restituisce una matrice che contiene le sottostringhe, separate da virgole, da una stringa più grande in base al carattere delimitatore specificato nella stringa originale.
startsWith	Verifica se una stringa inizia con una sottostringa specifica.
substring	Restituisce i caratteri di una stringa, partendo dalla posizione specificata.
toLower	Restituisce una stringa in formato minuscolo.
toUpper	Restituisce una stringa in formato maiuscolo.
Trim	Rimuove gli spazi iniziali e finali da una stringa e restituisce la stringa aggiornata.

Funzioni di raccolta

Per eseguire operazioni con le raccolte, generalmente matrici, stringhe e talvolta dizionari, è possibile usare queste funzioni di raccolta.

Funzione di raccolta	Attività
contains	Verifica se una raccolta include un elemento specifico.
empty	Verifica se una raccolta è vuota.
first	Restituisce il primo elemento di una raccolta.
intersection	Restituisce una raccolta che contiene solo gli elementi comuni alle raccolte specificate.
join	Restituisce una stringa con tutti gli elementi di una matrice, separati dal carattere specificato.
last	Restituisce l'ultimo elemento di una raccolta.
length	Restituisce il numero di elementi in una stringa o matrice.
skip	Rimuove gli elementi dall'inizio di una raccolta e restituisce tutti gli altri elementi.
take	Restituisce gli elementi dall'inizio di una raccolta.
union	Restituisce una raccolta che contiene tutti gli elementi delle raccolte specificate.

Funzioni logiche

Queste funzioni sono utili all'interno delle condizioni e possono essere usate per valutare qualsiasi tipo di logica.

Funzione di confronto logico	Attività
e	Verifica se tutte le espressioni sono true.
equals	Verifica se entrambi i valori sono equivalenti.
greater	Verifica se il primo valore è maggiore del secondo valore.
greaterOrEquals	Verifica se il primo valore è maggiore o uguale al secondo valore.
if	Verifica se un'espressione è true o false. In base al risultato, restituisce un valore specificato.
less	Verifica se il primo valore è minore del secondo valore.
lessOrEquals	Verifica se il primo valore è minore o uguale al secondo valore.
not	Verifica se un'espressione è false.
or	Verifica se almeno un'espressione è true.

Funzioni di conversione

Queste funzioni vengono usate per la conversione tra ogni tipo nativo nel linguaggio:

string
integer
float
boolean
matrici
dizionari

Funzione di conversione	Attività
array	Restituisce una matrice da un singolo input specificato. Per più input, vedere createArray.
base64	Restituisce la versione di una stringa con codifica base64.
base64ToBinary	Restituisce la versione binaria di una stringa con codifica base64.
base64ToString	Restituisce la versione stringa di una stringa con codifica base64.
binary	Restituisce la versione binaria di un valore di input.
bool	Restituisce la versione booleana di un valore di input.
coalesce	Restituisce il primo valore non Null da uno o più parametri.
createArray	Restituisce una matrice da più input.
dataUri	Restituisce l'URI dati di un valore di input.
dataUriToBinary	Restituisce la versione binaria di un URI dati.
dataUriToString	Restituisce la versione stringa di un URI dati.
decodeBase64	Restituisce la versione stringa di una stringa con codifica base64.
decodeDataUri	Restituisce la versione binaria di un URI dati.
decodeUriComponent	Restituisce una stringa che sostituisce i caratteri di escape con le versioni decodificate.
encodeUriComponent	Restituisce una stringa che sostituisce i caratteri non sicuri dell'URL con caratteri di escape.
float	Restituisce un numero a virgola mobile per un valore di input.
int	Restituisce la versione integer di una stringa.
string	Restituisce la versione stringa di un valore di input.
uriComponent	Restituisce la versione codificata in formato URI per un valore di input sostituendo i caratteri non sicuri dell'URL con caratteri di escape.
uriComponentToBinary	Restituisce la versione binaria di una stringa con codifica URI.
uriComponentToString	Restituisce la versione stringa di una stringa con codifica URI.
xml	Restituisce la versione XML di una stringa.
xpath	Verifica nel codice XML la presenza di nodi o valori che corrispondono a un'espressione XPath (XML Path Language) e restituisce i nodi o i valori corrispondenti.

Funzioni matematiche

Queste funzioni possono essere usate per qualsiasi tipo di numero, ovvero numeri interi e numeri a virgola mobile.

Funzione matematica	Attività
add	Restituisce il risultato della somma di due numeri.
div	Restituisce il risultato della divisione di due numeri.
max	Restituisce il valore più alto di un set di numeri o una matrice.
min	Restituisce il valore più basso di un set di numeri o una matrice.
mod	Restituisce il resto della divisione di due numeri.
mul	Restituisce il prodotto della moltiplicazione di due numeri.
rand	Restituisce un numero intero casuale da un intervallo specificato.
range	Restituisce una matrice di valori interi che inizia da un valore intero specificato.
sub	Restituisce il risultato della sottrazione del secondo numero dal primo.

Riferimento di funzione

Questa sezione elenca tutte le funzioni disponibili in ordine alfabetico.

add (aggiungi)

Restituisce il risultato della somma di due numeri.

add(<summand_1>, <summand_2>)

Parametro	Richiesto	Type	Descrizione
<summand_1>, <summand_2>	Sì	Integer, float o misto	Numeri da sommare

Valore restituito	Tipo	Descrizione
<result-sum>	Integer o float	Risultato della somma dei numeri specificati

Esempio

Questo esempio somma i numeri specificati:

add(1, 1.5)

E viene restituito questo risultato: 2.5

addDays

Aggiunge un numero di giorni a un timestamp.

addDays('<timestamp>', <days>, '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<days>	Sì	Intero	Numero positivo o negativo di giorni da aggiungere
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp con l'aggiunta del numero di giorni specificato

Esempio 1

Questo esempio aggiunge 10 giorni al timestamp specificato:

addDays('2018-03-15T13:00:00Z', 10)

E viene restituito questo risultato: "2018-03-25T00:00:0000000Z"

Esempio 2

Questo esempio sottrae cinque giorni dal timestamp specificato:

addDays('2018-03-15T00:00:00Z', -5)

E viene restituito questo risultato: "2018-03-10T00:00:0000000Z"

addHours

Aggiunge un numero di ore a un timestamp.

addHours('<timestamp>', <hours>, '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<hours>	Sì	Intero	Numero positivo o negativo di ore da aggiungere
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp con l'aggiunta del numero di ore specificato

Esempio 1

Questo esempio aggiunge 10 ore al timestamp specificato:

addHours('2018-03-15T00:00:00Z', 10)

E viene restituito questo risultato: "2018-03-15T10:00:0000000Z"

Esempio 2

Questo esempio sottrae cinque ore dal timestamp specificato:

addHours('2018-03-15T15:00:00Z', -5)

E viene restituito questo risultato: "2018-03-15T10:00:0000000Z"

addMinutes

Aggiunge un numero di minuti a un timestamp.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<minutes>	Sì	Intero	Numero positivo o negativo di minuti da aggiungere
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp con l'aggiunta del numero di minuti specificato

Esempio 1

Questo esempio aggiunge 10 minuti al timestamp specificato:

addMinutes('2018-03-15T00:10:00Z', 10)

E viene restituito questo risultato: "2018-03-15T00:20:00.0000000Z"

Esempio 2

Questo esempio sottrae cinque minuti dal timestamp specificato:

addMinutes('2018-03-15T00:20:00Z', -5)

E viene restituito questo risultato: "2018-03-15T00:15:00.0000000Z"

addSeconds

Aggiunge un numero di secondi a un timestamp.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<seconds>	Sì	Intero	Numero positivo o negativo di secondi da aggiungere
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp con l'aggiunta del numero di secondi specificato

Esempio 1

Questo esempio aggiunge 10 secondi al timestamp specificato:

addSeconds('2018-03-15T00:00:00Z', 10)

E viene restituito questo risultato: "2018-03-15T00:00:10.0000000Z"

Esempio 2

Questo esempio sottrae cinque secondi dal timestamp specificato:

addSeconds('2018-03-15T00:00:30Z', -5)

E viene restituito questo risultato: "2018-03-15T00:00:25.0000000Z"

addToTime

Aggiunge un numero di unità di tempo a un timestamp. Vedere anche getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<interval>	Sì	Intero	Numero di unità di tempo specificate da aggiungere
<timeUnit>	Sì	String	Unità di tempo da usare con interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp con l'aggiunta del numero di unità di tempo specificato

Esempio 1

Questo esempio aggiunge un giorno al timestamp specificato:

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

E viene restituito questo risultato: "2018-01-02T00:00:00.0000000Z"

Esempio 2

Questo esempio aggiunge un giorno al timestamp specificato:

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

E restituisce il risultato usando il formato "D" facoltativo: "Tuesday, January 2, 2018"

e

Verifica se entrambe le espressioni sono true. Restituisce true se entrambe le espressioni sono true oppure false se almeno un'espressione è false.

and(<expression1>, <expression2>)

Parametro	Richiesto	Type	Descrizione
<expression1>, <expression2>	Sì	Booleano	Espressioni da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true quando entrambe le espressioni sono true. Restituisce false se almeno un'espressione è false.

Esempio 1

Questi esempi verificano se i valori booleani specificati sono entrambi true:

and(true, true)
and(false, true)
and(false, false)

E vengono restituiti questi risultati:

Primo esempio: entrambe le espressioni sono true, quindi restituisce true.
Secondo esempio: una espressione è false, quindi restituisce false.
Terzo esempio: entrambe le espressioni sono false, quindi restituisce false.

Esempio 2

Questi esempi verificano se le espressioni specificate sono entrambe true:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

E vengono restituiti questi risultati:

Primo esempio: entrambe le espressioni sono true, quindi restituisce true.
Secondo esempio: una espressione è false, quindi restituisce false.
Terzo esempio: entrambe le espressioni sono false, quindi restituisce false.

array

Restituisce una matrice da un singolo input specificato. Per più input, vedere createArray().

array('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa per la creazione di una matrice

Valore restituito	Tipo	Descrizione
[<value>]	Array	Matrice che contiene il singolo input specificato

Esempio

Questo esempio crea una matrice dalla stringa "hello":

array('hello')

E viene restituito questo risultato: ["hello"]

base64

Restituisce la versione di una stringa con codifica base64.

base64('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa di input

Valore restituito	Tipo	Descrizione
<base64-string>	String	Versione della stringa di input con codifica base64

Esempio

Questo esempio converte la stringa "hello" in una stringa con codifica base64:

base64('hello')

E viene restituito questo risultato: "aGVsbG8="

base64ToBinary

Restituisce la versione binaria di una stringa con codifica base64.

base64ToBinary('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con codifica base64 da convertire

Valore restituito	Tipo	Descrizione
<binary-for-base64-string>	String	Versione binaria della stringa con codifica base64

Esempio

Questo esempio converte la stringa "aGVsbG8=" con codifica base64 in una stringa binaria:

base64ToBinary('aGVsbG8=')

E viene restituito questo risultato:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Restituisce la versione stringa di una stringa con codifica base64, decodificando in modo efficace la stringa base64. Usare questa funzione al posto di decodeBase64(). Anche se entrambe le funzioni hanno un comportamento analogo, è preferibile usare base64ToString().

base64ToString('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con codifica base64 da decodificare

Valore restituito	Tipo	Descrizione
<decoded-base64-string>	String	Versione stringa di una stringa con codifica base64

Esempio

Questo esempio converte la stringa "aGVsbG8=" con codifica base64 in una semplice stringa:

base64ToString('aGVsbG8=')

E viene restituito questo risultato: "hello"

binary

Restituisce la versione binaria di una stringa.

binary('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa da convertire

Valore restituito	Tipo	Descrizione
<binary-for-input-value>	String	Versione binaria della stringa specificata

Esempio

Questo esempio converte la stringa "hello" in una stringa binaria:

binary('hello')

E viene restituito questo risultato:

"0110100001100101011011000110110001101111"

bool

Restituisce la versione booleana di un valore.

bool(<value>)

Parametro	Richiesto	Type	Descrizione
<value>	Sì	Qualsiasi	Valore da convertire

Valore restituito	Tipo	Descrizione
true o false	Booleano	Versione booleana del valore specificato

Esempio

Questi esempi convertono i valori specificati in valori booleani:

bool(1)
bool(0)

E vengono restituiti questi risultati:

Primo esempio: true
Secondo esempio: false

coalesce

Restituisce il primo valore non Null da uno o più parametri. Stringhe vuote, matrici vuote e oggetti vuoti sono non null.

coalesce(<object_1>, <object_2>, ...)

Parametro	Richiesto	Type	Descrizione
<object_1>, <object_2>, ...	Sì	Qualsiasi, è possibile una combinazione di tipi	Uno o più elementi da verificare per determinare se sono Null

Valore restituito	Tipo	Descrizione
<first-non-null-item>	Any	Primo elemento o valore che è non Null. Se tutti i parametri sono Null, questa funzione restituisce Null.

Esempio

Questi esempi restituiscono il primo valore non Null dai valori specificati oppure Null quando tutti i valori sono Null:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

E vengono restituiti questi risultati:

Primo esempio: true
Secondo esempio: "hello"
Terzo esempio: null

concat

Combina due o più stringhe e restituisce la stringa combinata.

concat('<text1>', '<text2>', ...)

Parametro	Richiesto	Type	Descrizione
<text1>, <text2>, ...	Sì	String	Almeno due stringhe da combinare

Valore restituito	Tipo	Descrizione
<text1text2...>	String	Stringa creata dalle stringhe di input combinate

Esempio

Questo esempio combina le stringhe "Hello" e "World":

concat('Hello', 'World')

E viene restituito questo risultato: "HelloWorld"

contains

Verifica se una raccolta include un elemento specifico. Restituisce true se l'elemento viene trovato o false se non viene trovato. Questa funzione fa distinzione tra maiuscole e minuscole.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

In particolare, questa funzione può essere usata con questi tipi di raccolta:

Una stringa per trovare una sottostringa
Una matrice per trovare un valore
Un dizionario per trovare una chiave

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	String, array o dictionary	Raccolta da verificare
<value>	Sì	String, array o dictionary, rispettivamente	Elemento da trovare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se l'elemento viene trovato. Restituisce false se l'elemento non viene trovato.

Esempio 1

Questo esempio verifica la stringa "hello world" per cercare la sottostringa "world" e restituisce true:

contains('hello world', 'world')

Esempio 2

Questo esempio verifica la stringa "hello world" per cercare la sottostringa "universe" e restituisce false:

contains('hello world', 'universe')

convertFromUtc

Converte un timestamp da UTC (Universal Time Coordinated) al fuso orario di destinazione.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<destinationTimeZone>	Sì	String	Nome del fuso orario di destinazione. Per i nomi dei fusi orari, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere la punteggiatura nel nome del fuso orario.
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<converted-timestamp>	String	Timestamp convertito nel fuso orario di destinazione

Esempio 1

Questo esempio converte un timestamp nel fuso orario specificato:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

E viene restituito questo risultato: "2018-01-01T00:00:00Z"

Esempio 2

Questo esempio converte un timestamp nel fuso orario e nel formato specificati:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

E viene restituito questo risultato: "Monday, January 1, 2018"

convertTimeZone

Converte un timestamp dal fuso orario di origine al fuso orario di destinazione.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<sourceTimeZone>	Sì	String	Nome del fuso orario di origine. Per i nomi dei fusi orari, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere la punteggiatura nel nome del fuso orario.
<destinationTimeZone>	Sì	String	Nome del fuso orario di destinazione. Per i nomi dei fusi orari, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere la punteggiatura nel nome del fuso orario.
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<converted-timestamp>	String	Timestamp convertito nel fuso orario di destinazione

Esempio 1

Questo esempio converte il fuso orario di origine nel fuso orario di destinazione:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

E viene restituito questo risultato: "2018-01-01T00:00:00.0000000"

Esempio 2

Questo esempio converte un fuso orario nel fuso orario e nel formato specificati:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

E viene restituito questo risultato: "Monday, January 1, 2018"

convertToUtc

Converte un timestamp dal fuso orario di origine a UTC (Universal Time Coordinated).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<sourceTimeZone>	Sì	String	Nome del fuso orario di origine. Per i nomi dei fusi orari, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere la punteggiatura nel nome del fuso orario.
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<converted-timestamp>	String	Timestamp convertito nell'ora UTC

Esempio 1

Questo esempio converte un timestamp nell'ora UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

E viene restituito questo risultato: "2018-01-01T08:00:00.0000000Z"

Esempio 2

Questo esempio converte un timestamp nell'ora UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

E viene restituito questo risultato: "Monday, January 1, 2018"

createArray

Restituisce una matrice da più input. Per le matrici con input singolo, vedere array().

createArray('<object1>', '<object2>', ...)

Parametro	Richiesto	Type	Descrizione
<object1>, <object2>, ...	Sì	Qualsiasi, ma non sono possibili combinazioni di tipi	Almeno due elementi per creare la matrice

Valore restituito	Tipo	Descrizione
[<object1>, <object2>, ...]	Array	Matrice creata da tutti gli elementi di input

Esempio

Questo esempio crea una matrice da questi input:

createArray('h', 'e', 'l', 'l', 'o')

E viene restituito questo risultato: ["h", "e", "l", "l", "o"]

dataUri

Restituisce un URI (Uniform Resource Identifier) di dati per una stringa.

dataUri('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa da convertire

Valore restituito	Tipo	Descrizione
<data-uri>	String	URI di dati per la stringa di input

Esempio

Questo esempio crea un URI di dati per la stringa "hello":

dataUri('hello')

E viene restituito questo risultato: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Restituisce la versione binaria di un URI (Uniform Resource Identifier) di dati. Usare questa funzione al posto di decodeDataUri(). Anche se entrambe le funzioni hanno un comportamento analogo, è preferibile usare dataUriBinary().

dataUriToBinary('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	URI di dati da convertire

Valore restituito	Tipo	Descrizione
<binary-for-data-uri>	String	Versione binaria dell'URI di dati

Esempio

Questo esempio crea una versione binaria di questo URI di dati:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E viene restituito questo risultato:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Restituisce la versione stringa di un URI (Uniform Resource Identifier) di dati.

dataUriToString('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	URI di dati da convertire

Valore restituito	Tipo	Descrizione
<string-for-data-uri>	String	Versione stringa dell'URI di dati

Esempio

Questo esempio crea una stringa per questo URI di dati:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E viene restituito questo risultato: "hello"

dayOfMonth

Restituisce il giorno del mese da un timestamp.

dayOfMonth('<timestamp>')

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<day-of-month>	Intero	Giorno del mese dal timestamp specificato

Esempio

Questo esempio restituisce il numero del giorno del mese da questo timestamp:

dayOfMonth('2018-03-15T13:27:36Z')

E viene restituito questo risultato: 15

dayOfWeek

Restituisce il giorno della settimana da un timestamp.

dayOfWeek('<timestamp>')

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<day-of-week>	Intero	Giorno della settimana dal timestamp specificato, dove domenica corrisponde a 0, lunedì a 1 e così via

Esempio

Questo esempio restituisce il numero del giorno della settimana da questo timestamp:

dayOfWeek('2018-03-15T13:27:36Z')

E viene restituito questo risultato: 3

dayOfYear

Restituisce il giorno dell'anno da un timestamp.

dayOfYear('<timestamp>')

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<day-of-year>	Intero	Giorno dell'anno dal timestamp specificato

Esempio

Questo esempio restituisce il numero del giorno dell'anno da questo timestamp:

dayOfYear('2018-03-15T13:27:36Z')

E viene restituito questo risultato: 74

decodeBase64

Restituisce la versione stringa di una stringa con codifica base64, decodificando in modo efficace la stringa base64. Usare base64ToString() al posto di decodeBase64(). Anche se entrambe le funzioni hanno un comportamento analogo, è preferibile usare base64ToString().

decodeBase64('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con codifica base64 da decodificare

Valore restituito	Tipo	Descrizione
<decoded-base64-string>	String	Versione stringa di una stringa con codifica base64

Esempio

Questo esempio crea una stringa per una stringa con codifica base64:

decodeBase64('aGVsbG8=')

E viene restituito questo risultato: "hello"

decodeDataUri

Restituisce la versione binaria di un URI (Uniform Resource Identifier) di dati. Usare dataUriToBinary() al posto di decodeDataUri(). Anche se entrambe le funzioni hanno un comportamento analogo, è preferibile usare dataUriToBinary().

decodeDataUri('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa dell'URI di dati da decodificare

Valore restituito	Tipo	Descrizione
<binary-for-data-uri>	String	Versione binaria di una stringa di URI di dati

Esempio

Questo esempio crea la versione binaria per questo URI di dati:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E viene restituito questo risultato:

decodeUriComponent

Restituisce una stringa che sostituisce i caratteri di escape con le versioni decodificate.

decodeUriComponent('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con i caratteri di escape da decodificare

Valore restituito	Tipo	Descrizione
<decoded-uri>	String	Stringa aggiornata con i caratteri di escape decodificati

Esempio

Questo esempio sostituisce i caratteri di escape in questa stringa con le versioni decodificate:

decodeUriComponent('http%3A%2F%2Fcontoso.com')

E viene restituito questo risultato: "https://contoso.com"

div

Restituisce il risultato intero della divisione di due numeri. Per ottenere il resto, vedere mod().

div(<dividend>, <divisor>)

Parametro	Richiesto	Type	Descrizione
<dividend>	Sì	Integer o float	Numero da dividere per l'oggetto divisor
<divisor>	Sì	Integer o float	Numero che divide l'oggetto dividendo, ma che non può essere 0

Valore restituito	Tipo	Descrizione
<quotient-result>	Intero	Risultato intero della divisione del primo numero per il secondo numero

Esempio

Entrambi gli esempi dividono il primo numero per il secondo numero:

div(10, 5)
div(11, 5)

E viene restituito questo risultato: 2

encodeUriComponent

Restituisce la versione con codifica URI (Uniform Resource Identifier) per una stringa sostituendo i caratteri non sicuri per gli URL con caratteri di escape. Usare uriComponent() al posto di encodeUriComponent(). Anche se entrambe le funzioni hanno un comportamento analogo, è preferibile usare uriComponent().

encodeUriComponent('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa da convertire nel formato con codifica URI

Valore restituito	Tipo	Descrizione
<encoded-uri>	String	Stringa con codifica URI con i caratteri di escape

Esempio

Questo esempio crea una versione con codifica URI per questa stringa:

encodeUriComponent('https://contoso.com')

E viene restituito questo risultato: "http%3A%2F%2Fcontoso.com"

empty

Verifica se una raccolta è vuota. Restituisce true se la raccolta è vuota o false se non lo è.

empty('<collection>')
empty([<collection>])

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	String, array o object	Raccolta da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se la raccolta è vuota. Restituisce false se non è vuota.

Esempio

Questi esempi verificano se le raccolte specificate sono vuote:

empty('')
empty('abc')

E vengono restituiti questi risultati:

Primo esempio: passa una stringa vuota, quindi la funzione restituisce true.
Secondo esempio: passa la stringa "abc", quindi la funzione restituisce false.

endsWith

Verifica se una stringa termina con una sottostringa specifica. Restituisce true se la sottostringa viene trovata o false se non viene trovata. Per questa funzione non viene applicata la distinzione tra maiuscole e minuscole.

endsWith('<text>', '<searchText>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa da verificare
<searchText>	Sì	String	Sottostringa finale da trovare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se la sottostringa finale viene trovata. Restituisce false se l'elemento non viene trovato.

Esempio 1

Questo esempio verifica se la stringa "hello world" termina con la stringa "world":

endsWith('hello world', 'world')

E viene restituito questo risultato: true

Esempio 2

Questo esempio verifica se la stringa "hello world" termina con la stringa "universe":

endsWith('hello world', 'universe')

E viene restituito questo risultato: false

equals

Verifica se entrambi i valori, le espressioni o gli oggetti sono equivalenti. Restituisce true se entrambi gli elementi sono equivalenti o false se non lo sono.

equals('<object1>', '<object2>')

Parametro	Richiesto	Type	Descrizione
<object1>, <object2>	Sì	Varie	Valori, espressioni o oggetti da confrontare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se entrambi gli elementi sono equivalenti. Restituisce false se gli elementi non sono equivalenti.

Esempio

Questi esempi verificano se gli input specificati sono equivalenti.

equals(true, 1)
equals('abc', 'abcd')

E vengono restituiti questi risultati:

Primo esempio: entrambi i valori sono equivalenti, quindi la funzione restituisce true.
Secondo esempio: entrambi i valori non sono equivalenti, quindi la funzione restituisce false.

primo

Restituisce il primo elemento di una stringa o una matrice.

first('<collection>')
first([<collection>])

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	String o array	Raccolta in cui trovare il primo elemento

Valore restituito	Tipo	Descrizione
<first-collection-item>	Any	Primo elemento nella raccolta

Esempio

Questi esempi trovano il primo elemento in queste raccolte:

first('hello')
first(createArray(0, 1, 2))

E vengono restituiti questi risultati:

Primo esempio: "h"
Secondo esempio: 0

float

Converte una versione stringa per un numero a virgola mobile in un numero a virgola mobile effettivo.

float('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con un numero a virgola mobile valido da convertire

Valore restituito	Tipo	Descrizione
<float-value>	Float	Numero a virgola mobile per la stringa specificata

Esempio

Questo esempio crea una versione stringa per questo numero a virgola mobile:

float('10.333')

E viene restituito questo risultato: 10.333

formatDateTime

Restituisce un timestamp nel formato specificato.

formatDateTime('<timestamp>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<reformatted-timestamp>	String	Timestamp aggiornato nel formato specificato

Esempio

Questo esempio converte un timestamp nel formato specificato:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

E viene restituito questo risultato: "2018-03-15T12:00:00"

getFutureTime

Restituisce il timestamp corrente più le unità di tempo specificate.

getFutureTime(<interval>, <timeUnit>, <format>?)

Parametro	Richiesto	Type	Descrizione
<interval>	Sì	Intero	Numero di unità di tempo specificate da aggiungere
<timeUnit>	Sì	String	Unità di tempo da usare con interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp corrente con l'aggiunta del numero di unità di tempo specificato

Esempio 1

Si supponga che il timestamp corrente sia "2018-03-01T00:00:00.0000000Z". Questo esempio aggiunge cinque giorni al timestamp:

getFutureTime(5, 'Day')

E viene restituito questo risultato: "2018-03-06T00:00:00.0000000Z"

Esempio 2

Si supponga che il timestamp corrente sia "2018-03-01T00:00:00.0000000Z". Questo esempio aggiunge cinque giorni e converte il risultato nel formato "D":

getFutureTime(5, 'Day', 'D')

E viene restituito questo risultato: "Tuesday, March 6, 2018"

getPastTime

Restituisce il timestamp corrente meno le unità di tempo specificate.

getPastTime(<interval>, <timeUnit>, <format>?)

Parametro	Richiesto	Type	Descrizione
<interval>	Sì	Intero	Numero di unità di tempo specificate da sottrarre
<timeUnit>	Sì	String	Unità di tempo da usare con interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp corrente meno il numero di unità di tempo specificato

Esempio 1

Si supponga che il timestamp corrente sia "2018-02-01T00:00:00.0000000Z". Questo esempio sottrae cinque giorni dal timestamp:

getPastTime(5, 'Day')

E viene restituito questo risultato: "2018-01-27T00:00:00.0000000Z"

Esempio 2

Si supponga che il timestamp corrente sia "2018-02-01T00:00:00.0000000Z". Questo esempio sottrae cinque giorni e converte il risultato nel formato "D":

getPastTime(5, 'Day', 'D')

E viene restituito questo risultato: "Saturday, January 27, 2018"

greater

Verifica se il primo valore è maggiore del secondo valore. Restituisce true se il primo valore è maggiore o false se è minore.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è maggiore del secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Valore di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è maggiore del secondo. Restituisce false se il primo valore è minore o uguale al secondo.

Esempio

Questi esempi verificano se il primo valore è maggiore del secondo:

greater(10, 5)
greater('apple', 'banana')

E vengono restituiti questi risultati:

Primo esempio: true
Secondo esempio: false

greaterOrEquals

Verifica se il primo valore è maggiore o uguale al secondo valore. Restituisce true se il primo valore è maggiore o uguale o false se è minore.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è maggiore o uguale al secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Valore di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è maggiore o uguale al secondo. Restituisce false se il primo valore è minore del secondo.

Esempio

Questi esempi verificano se il primo valore è maggiore o uguale al secondo:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

E vengono restituiti questi risultati:

Primo esempio: true
Secondo esempio: false

guid

Genera un identificatore univoco globale (GUID) sotto forma di stringa, ad esempio "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

È anche possibile specificare un formato per il GUID diverso da quello predefinito, "D", che è costituito da 32 cifre separate da trattini.

guid('<format>')

Parametro	Richiesto	Type	Descrizione
<format>	No	String	Identificatore di formato singolo per il GUID restituito. Per impostazione predefinita, il formato è "D", ma è possibile usare "N", "D", "B", "P" o "X".

Valore restituito	Tipo	Descrizione
<GUID-value>	String	GUID generato in modo casuale

Esempio

Questo esempio genera lo stesso GUID, ma in formato a 32 cifre, separate da trattini e racchiuse tra parentesi:

guid('P')

E viene restituito questo risultato: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Verifica se un'espressione è true o false. In base al risultato, restituisce un valore specificato.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Parametro	Richiesto	Type	Descrizione
<expression>	Sì	Booleano	Espressione da verificare
<valueIfTrue>	Sì	Qualsiasi	Valore da restituire se l'espressione è true
<valueIfFalse>	Sì	Qualsiasi	Valore da restituire se l'espressione è false

Valore restituito	Tipo	Descrizione
<specified-return-value>	Any	Valore specificato restituito a seconda del fatto che l'espressione sia true o false

Esempio

Questo esempio restituisce "yes" perché l'espressione specificata restituisce true. In caso contrario, l'esempio restituisce "no":

if(equals(1, 1), 'yes', 'no')

indexOf

Restituisce la posizione iniziale o il valore di indice di una sottostringa. Questa funzione non fa distinzione tra maiuscole e minuscole e gli indici iniziano con il numero 0.

indexOf('<text>', '<searchText>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa che contiene la sottostringa da trovare
<searchText>	Sì	String	Sottostringa da trovare

Valore restituito	Tipo	Descrizione
<index-value>	Intero	Posizione iniziale o valore di indice per la sottostringa specificata. Se la stringa non viene trovata, viene restituito il numero -1.

Esempio

Questo esempio trova il valore di indice iniziale della sottostringa "world" nella stringa "hello world":

indexOf('hello world', 'world')

E viene restituito questo risultato: 6

int

Restituisce la versione integer di una stringa.

int('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa da convertire

Valore restituito	Tipo	Descrizione
<integer-result>	Intero	Versione integer della stringa specificata

Esempio

Questo esempio crea una versione integer per la stringa "10":

int('10')

E viene restituito questo risultato: 10

JSON

Restituisce il valore o l'oggetto di tipo JSON (JavaScript Object Notation ) per una stringa o un elemento XML.

json('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	Stringa o elemento XML	Stringa o elemento XML da convertire

Valore restituito	Tipo	Descrizione
<JSON-result>	Oggetto o tipo nativo JSON	Oggetto o valore del tipo nativo JSON per la stringa o l'elemento XML specificato. Se la stringa è Null, la funzione restituisce un oggetto vuoto.

Esempio 1

Questo esempio converte questa stringa nel valore JSON:

json('[1, 2, 3]')

E viene restituito questo risultato: [1, 2, 3]

Esempio 2

Questo esempio converte questa stringa in JSON:

json('{"fullName": "Sophia Owen"}')

E viene restituito questo risultato:

{
  "fullName": "Sophia Owen"
}

Esempio 3

Questo esempio converte questo elemento XML in JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

E viene restituito questo risultato:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

intersection

Restituisce una raccolta che contiene solo gli elementi comuni alle raccolte specificate. Per essere incluso nel risultato, un elemento deve essere presente in tutte le raccolte passate alla funzione. Se uno o più elementi hanno lo stesso nome, nel risultato viene incluso l'ultimo elemento con tale nome.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Parametro	Richiesto	Type	Descrizione
<collection1>, <collection2>, ...	Sì	Array o object, ma non entrambi i tipi	Raccolte da cui ottenere solo gli elementi comuni

Valore restituito	Tipo	Descrizione
<common-items>	Array o object, rispettivamente	Raccolta che contiene solo gli elementi comuni alle raccolte specificate

Esempio

Questo esempio trova gli elementi comuni tra queste matrici:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

E restituisce una matrice con solo questi elementi: [1, 2]

join

Restituisce una stringa con tutti gli elementi di una matrice, in cui ogni carattere è separato da un delimitatore.

join([<collection>], '<delimiter>')

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	Array	Matrice contenente gli elementi da aggiungere
<delimiter>	Sì	String	Separatore visualizzato tra ogni carattere nella stringa risultante

Valore restituito	Tipo	Descrizione
<char1><delimiter><char2><delimiter>...	String	Stringa risultante creata da tutti gli elementi nella matrice specificata

Esempio

Questo esempio crea una stringa da tutti gli elementi in questa matrice usando il carattere specificato come delimitatore:

join(createArray('a', 'b', 'c'), '.')

E viene restituito questo risultato: "a.b.c"

ultimo

Restituisce l'ultimo elemento di una raccolta.

last('<collection>')
last([<collection>])

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	String o array	Raccolta dove trovare l'ultimo elemento

Valore restituito	Tipo	Descrizione
<last-collection-item>	String o array, rispettivamente	Ultimo elemento nella raccolta

Esempio

Questi esempi trovano l'ultimo elemento in queste raccolte:

last('abcd')
last(createArray(0, 1, 2, 3))

E vengono restituiti questi risultati:

Primo esempio: "d"
Secondo esempio: 3

lastIndexOf

Restituire la posizione iniziale o il valore di indice per l'ultima occorrenza di una sottostringa. Questa funzione non fa distinzione tra maiuscole e minuscole e gli indici iniziano con il numero 0.

lastIndexOf('<text>', '<searchText>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa che contiene la sottostringa da trovare
<searchText>	Sì	String	Sottostringa da trovare

Valore restituito	Tipo	Descrizione
<ending-index-value>	Intero	La posizione iniziale o il valore di indice per l'ultima occorrenza della sottostringa specificata. Se la stringa non viene trovata, viene restituito il numero -1.

Esempio

Questo esempio trova il valore di indice iniziale per l'ultima occorrenza della sottostringa "world" nella stringa "hello world":

lastIndexOf('hello world', 'world')

E viene restituito questo risultato: 6

length

Restituisce il numero di elementi in una raccolta.

length('<collection>')
length([<collection>])

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	String o array	Raccolta con gli elementi da contare

Valore restituito	Tipo	Descrizione
<length-or-count>	Intero	Numero di elementi nella raccolta

Esempio

Questi esempi contano il numero di elementi in queste raccolte:

length('abcd')
length(createArray(0, 1, 2, 3))

E viene restituito questo risultato: 4

less

Verifica se il primo valore è minore del secondo valore. Restituisce true se il primo valore è minore o false se è maggiore.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è minore del secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Elemento di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è minore del secondo. Restituisce false se il primo valore è maggiore o uguale al secondo.

Esempio

Questi esempi verificano se il primo valore è minore del secondo.

less(5, 10)
less('banana', 'apple')

E vengono restituiti questi risultati:

Primo esempio: true
Secondo esempio: false

lessOrEquals

Verifica se il primo valore è minore o uguale al secondo valore. Restituisce true se il primo valore è minore o uguale o false se è maggiore.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è minore o uguale al secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Elemento di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è minore o uguale al secondo. Restituisce false se il primo valore è maggiore del secondo.

Esempio

Questi esempi verificano se il primo valore è minore o uguale al secondo valore.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

E vengono restituiti questi risultati:

Primo esempio: true
Secondo esempio: false

max

Restituisce il valore più alto di un elenco o una matrice con numeri che includono gli estremi.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Parametro	Richiesto	Type	Descrizione
<number1>, <number2>, ...	Sì	Integer, float o entrambi	Set di numeri da cui si vuole ottenere il valore più alto
[<number1>, <number2>, ...]	Sì	Matrice - Integer, float o entrambi	Matrice di numeri da cui si vuole ottenere il valore più alto

Valore restituito	Tipo	Descrizione
<max-value>	Integer o float	Valore più alto nella matrice o nel set di numeri specificato

Esempio

Questi esempi ottengono il valore più alto dal set di numeri e dalla matrice:

max(1, 2, 3)
max(createArray(1, 2, 3))

E viene restituito questo risultato: 3

min

Restituisce il valore più basso di un set di numeri o una matrice.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Parametro	Richiesto	Type	Descrizione
<number1>, <number2>, ...	Sì	Integer, float o entrambi	Set di numeri da cui si vuole ottenere il valore più basso
[<number1>, <number2>, ...]	Sì	Matrice - Integer, float o entrambi	Matrice di numeri da cui si vuole ottenere il valore più basso

Valore restituito	Tipo	Descrizione
<min-value>	Integer o float	Valore più basso nella matrice o nel set di numeri specificato

Esempio

Questi esempi ottengono il valore più basso nel set di numeri e nella matrice:

min(1, 2, 3)
min(createArray(1, 2, 3))

E viene restituito questo risultato: 1

mod

Restituisce il resto della divisione di due numeri. Per ottenere il risultato intero, vedere div().

mod(<dividend>, <divisor>)

Parametro	Richiesto	Type	Descrizione
<dividend>	Sì	Integer o float	Numero da dividere per l'oggetto divisor
<divisor>	Sì	Integer o float	Numero che divide l'oggetto dividendo, ma che non può essere 0.

Valore restituito	Tipo	Descrizione
<modulo-result>	Integer o float	Resto della divisione del primo numero per il secondo numero

Esempio

Questo esempio divide il primo numero per il secondo numero:

mod(3, 2)

E viene restituito questo risultato: 1

mul

Restituisce il prodotto della moltiplicazione di due numeri.

mul(<multiplicand1>, <multiplicand2>)

Parametro	Richiesto	Type	Descrizione
<multiplicand1>	Sì	Integer o float	Numero da moltiplicare per multiplicand2
<multiplicand2>	Sì	Integer o float	Numero che moltiplica multiplicand1

Valore restituito	Tipo	Descrizione
<product-result>	Integer o float	Prodotto della moltiplicazione del primo numero per il secondo numero

Esempio

Questi esempi moltiplicano il primo numero per il secondo numero:

mul(1, 2)
mul(1.5, 2)

E vengono restituiti questi risultati:

Primo esempio: 2
Secondo esempio: 3

not

Verifica se un'espressione è false. Restituisce true se l'espressione è false o false se è true.

not(<expression>)

Parametro	Richiesto	Type	Descrizione
<expression>	Sì	Booleano	Espressione da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se l'espressione è false. Restituisce false se l'espressione è true.

Esempio 1

Questi esempi verificano se le espressioni specificate sono false:

not(false)
not(true)

E vengono restituiti questi risultati:

Primo esempio: l'espressione è false, quindi la funzione restituisce true.
Secondo esempio: l'espressione è true, quindi la funzione restituisce false.

Esempio 2

Questi esempi verificano se le espressioni specificate sono false:

not(equals(1, 2))
not(equals(1, 1))

E vengono restituiti questi risultati:

Primo esempio: l'espressione è false, quindi la funzione restituisce true.
Secondo esempio: l'espressione è true, quindi la funzione restituisce false.

or

Verifica se almeno un'espressione è true. Restituisce true se almeno un'espressione è true o false se entrambe le espressioni sono false.

or(<expression1>, <expression2>)

Parametro	Richiesto	Type	Descrizione
<expression1>, <expression2>	Sì	Booleano	Espressioni da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se almeno un'espressione è true. Restituisce false se entrambe le espressioni sono false.

Esempio 1

Questi esempi verificano se almeno un'espressione è true:

or(true, false)
or(false, false)

E vengono restituiti questi risultati:

Primo esempio: almeno un'espressione è true, quindi la funzione restituisce true.
Secondo esempio: entrambe le espressioni sono false, quindi la funzione restituisce false.

Esempio 2

Questi esempi verificano se almeno un'espressione è true:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

E vengono restituiti questi risultati:

Primo esempio: almeno un'espressione è true, quindi la funzione restituisce true.
Secondo esempio: entrambe le espressioni sono false, quindi la funzione restituisce false.

rand

Restituisce un valore intero casuale da un intervallo specificato, che include solo l'estremo inziale.

rand(<minValue>, <maxValue>)

Parametro	Richiesto	Type	Descrizione
<minValue>	Sì	Intero	Valore intero più basso nell'intervallo
<maxValue>	Sì	Intero	Valore intero che segue il valore intero più alto nell'intervallo che la funzione può restituire

Valore restituito	Tipo	Descrizione
<random-result>	Intero	Valore intero casuale restituito dall'intervallo specificato

Esempio

Questo esempio ottiene un valore intero casuale dall'intervallo specificato, escluso il valore massimo:

rand(1, 5)

E restituisce uno di questi numeri come risultato: 1, 2, 3 o 4

range

Restituisce una matrice di valori interi che inizia da un valore intero specificato.

range(<startIndex>, <count>)

Parametro	Richiesto	Type	Descrizione
<startIndex>	Sì	Intero	Valore intero che rappresenta il primo elemento da cui inizia la matrice
<count>	Sì	Intero	Numero di valori interi nella matrice

Valore restituito	Tipo	Descrizione
[<range-result>]	Array	Matrice di valori interi a partire dall'indice specificato

Esempio

Questo esempio crea una matrice di valori interi che inizia dall'indice specificato e include il numero di valori interi specificato:

range(1, 4)

E viene restituito questo risultato: [1, 2, 3, 4]

replace

Sostituisce una sottostringa con la stringa specificata e restituisce la stringa risultante. Questa funzione fa distinzione tra maiuscole e minuscole.

replace('<text>', '<oldText>', '<newText>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa che contiene la sottostringa da sostituire
<oldText>	Sì	String	Sottostringa da sostituire
<newText>	Sì	String	Stringa da usare per la sostituzione

Valore restituito	Tipo	Descrizione
<updated-text>	String	Stringa aggiornata dopo la sostituzione della sottostringa Se la sottostringa non viene trovata, viene restituita la stringa originale.

Esempio

Questo esempio trova la sottostringa "old" in "the old string" e sostituisce "old" con "new":

replace('the old string', 'old', 'new')

E viene restituito questo risultato: "the new string"

skip

Rimuove gli elementi dall'inizio di una raccolta e restituisce tutti gli altri elementi.

skip([<collection>], <count>)

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	Array	Raccolta da cui rimuovere gli elementi
<count>	Sì	Intero	Valore intero positivo per il numero di elementi da rimuovere nella parte iniziale

Valore restituito	Tipo	Descrizione
[<updated-collection>]	Array	Raccolta aggiornata dopo la rimozione degli elementi specificati

Esempio

Questo esempio rimuove un elemento, il numero 0, dall'inizio della matrice specificata:

skip(createArray(0, 1, 2, 3), 1)

E restituisce la matrice con gli elementi rimanenti: [1,2,3]

split

Restituisce una matrice che contiene le sottostringhe, separate da virgole, in base al carattere delimitatore specificato nella stringa originale.

split('<text>', '<delimiter>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa da suddividere in sottostringhe in base al delimitatore specificato nella stringa originale
<delimiter>	Sì	String	Carattere nella stringa originale da usare come delimitatore

Valore restituito	Tipo	Descrizione
[<substring1>,<substring2>,...]	Array	Matrice che contiene le sottostringhe della stringa originale, separate da virgole

Esempio

Questo esempio crea una matrice con le sottostringhe della stringa specificata in base al carattere specificato come delimitatore:

split('a_b_c', '_')

E restituisce questa matrice come risultato: ["a","b","c"]

startOfDay

Restituisce l'inizio del giorno per un timestamp.

startOfDay('<timestamp>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp specificato, che inizia in corrispondenza della mezzanotte esatta per il giorno

Esempio

Questo esempio trova l'inizio del giorno per questo timestamp:

startOfDay('2018-03-15T13:30:30Z')

E viene restituito questo risultato: "2018-03-15T00:00:00.0000000Z"

startOfHour

Restituisce l'inizio dell'ora per un timestamp.

startOfHour('<timestamp>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp specificato, che inizia in corrispondenza dei minuti esatti per l'ora

Esempio

Questo esempio trova l'inizio dell'ora per questo timestamp:

startOfHour('2018-03-15T13:30:30Z')

E viene restituito questo risultato: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Restituisce l'inizio del mese per un timestamp.

startOfMonth('<timestamp>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp specificato, che inizia il primo giorno del mese in corrispondenza della mezzanotte esatta

Esempio

Questo esempio restituisce l'inizio del mese per questo timestamp:

startOfMonth('2018-03-15T13:30:30Z')

E viene restituito questo risultato: "2018-03-01T00:00:00.0000000Z"

startsWith

Verifica se una stringa inizia con una sottostringa specifica. Restituisce true se la sottostringa viene trovata o false se non viene trovata. Per questa funzione non viene applicata la distinzione tra maiuscole e minuscole.

startsWith('<text>', '<searchText>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa da verificare
<searchText>	Sì	String	Stringa iniziale da trovare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se la sottostringa iniziale viene trovata. Restituisce false se l'elemento non viene trovato.

Esempio 1

Questo esempio verifica se la stringa "hello world" inizia con la sottostringa "hello":

startsWith('hello world', 'hello')

E viene restituito questo risultato: true

Esempio 2

Questo esempio verifica se la stringa "hello world" inizia con la sottostringa "greetings":

startsWith('hello world', 'greetings')

E viene restituito questo risultato: false

string

Restituisce la versione stringa di un valore.

string(<value>)

Parametro	Richiesto	Type	Descrizione
<value>	Sì	Qualsiasi	Valore da convertire

Valore restituito	Tipo	Descrizione
<string-value>	String	Versione stringa del valore specificato

Esempio 1

Questo esempio crea la versione stringa per questo numero:

string(10)

E viene restituito questo risultato: "10"

Esempio 2

Questo esempio crea una stringa per l'oggetto JSON specificato e usa il carattere barra rovesciata () come carattere di escape per le virgolette doppie (").

string( { "name": "Sophie Owen" } )

E viene restituito questo risultato: "{ \\"name\\": \\"Sophie Owen\\" }"

secondario

Restituisce il risultato della sottrazione del secondo numero dal primo.

sub(<minuend>, <subtrahend>)

Parametro	Richiesto	Type	Descrizione
<minuend>	Sì	Integer o float	Numero da cui sottrarre l'oggetto subtrahend
<subtrahend>	Sì	Integer o float	Numero da sottrarre dall'oggetto minuend

Valore restituito	Tipo	Descrizione
<result>	Integer o float	Risultato della sottrazione del secondo numero dal primo

Esempio

Questo esempio sottrae il secondo numero dal primo:

sub(10.3, .3)

E viene restituito questo risultato: 10

substring

Restituisce i caratteri di una stringa, partendo dalla posizione o dall'indice specificato. I valori di Indice iniziano con il numero 0.

substring('<text>', <startIndex>, <length>)

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa da cui ottenere i caratteri
<startIndex>	Sì	Intero	Numero positivo maggiore o uguale a 0 che si desidera usare come posizione iniziale o valore di indice
<length>	Sì	Intero	Numero positivo di caratteri da includere nella sottostringa

Valore restituito	Tipo	Descrizione
<substring-result>	String	Sottostringa con il numero di caratteri specificato, che inizia in corrispondenza della posizione di indice specificata nella stringa di origine

Esempio

Questo esempio crea una sottostringa di cinque caratteri dalla stringa specificata, a partire dal valore di indice 6:

substring('hello world', 6, 5)

E viene restituito questo risultato: "world"

subtractFromTime

Sottrae un numero di unità di tempo da un timestamp. Vedere anche getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<interval>	Sì	Intero	Numero di unità di tempo specificate da sottrarre
<timeUnit>	Sì	String	Unità di tempo da usare con interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	String	Timestamp meno il numero di unità di tempo specificato

Esempio 1

Questo esempio sottrae un giorno dal timestamp:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

E viene restituito questo risultato: "2018-01-01T00:00:00:0000000Z"

Esempio 2

Questo esempio sottrae un giorno dal timestamp:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

E restituisce questo risultato usando il formato "D" facoltativo: "Monday, January, 1, 2018"

take

Restituisce gli elementi dall'inizio di una raccolta.

take('<collection>', <count>)
take([<collection>], <count>)

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	String o array	Raccolta da cui ottenere gli elementi
<count>	Sì	Intero	Valore intero positivo per il numero di elementi da ottenere dalla parte iniziale

Valore restituito	Tipo	Descrizione
<subset> or [<subset>]	String o array, rispettivamente	Stringa o matrice con il numero specificato di elementi presi dall'inizio della raccolta originale

Esempio

Questi esempi ottengono il numero specificato di elementi presi dall'inizio di queste raccolte:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

E vengono restituiti questi risultati:

Primo esempio: "abc"
Secondo esempio: [0, 1, 2]

ticks

Restituisce il valore della proprietà ticks per un timestamp specificato. Un tick è un intervallo di 100 nanosecondi.

ticks('<timestamp>')

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa per un timestamp

Valore restituito	Tipo	Descrizione
<ticks-number>	Intero	Numero di tick trascorsi dalle 12:00:00 mezzanotte, 1 gennaio 0001 nel calendario gregoriano dal timestamp di input

toLower

Restituisce una stringa in formato minuscolo. Se un carattere nella stringa non ha un equivalente minuscolo, viene incluso senza modifiche nella stringa restituita.

toLower('<text>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa da restituire in formato minuscolo

Valore restituito	Tipo	Descrizione
<lowercase-text>	String	Stringa originale in formato minuscolo

Esempio

Questo esempio converte questa stringa in caratteri minuscoli:

toLower('Hello World')

E viene restituito questo risultato: "hello world"

toUpper

Restituisce una stringa in formato maiuscolo. Se un carattere nella stringa non ha un equivalente maiuscolo, viene incluso senza modifiche nella stringa restituita.

toUpper('<text>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa da restituire in formato maiuscolo

Valore restituito	Tipo	Descrizione
<uppercase-text>	String	Stringa originale in formato maiuscolo

Esempio

Questo esempio converte questa stringa in caratteri maiuscoli:

toUpper('Hello World')

E viene restituito questo risultato: "HELLO WORLD"

Trim

Rimuove gli spazi iniziali e finali da una stringa e restituisce la stringa aggiornata.

trim('<text>')

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa da cui rimuovere gli spazi iniziali e finali

Valore restituito	Tipo	Descrizione
<updatedText>	String	Versione aggiornata della stringa originale senza spazi iniziali o finali

Esempio

Questo esempio rimuove gli spazi iniziali e finali dalla stringa " Hello World ":

trim(' Hello World  ')

E viene restituito questo risultato: "Hello World"

union

Restituisce una raccolta che contiene tutti gli elementi delle raccolte specificate. Per essere incluso nel risultato, un elemento può essere presente in qualsiasi raccolta passata alla funzione. Se uno o più elementi hanno lo stesso nome, nel risultato viene incluso l'ultimo elemento con tale nome.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Parametro	Richiesto	Type	Descrizione
<collection1>, <collection2>, ...	Sì	Array o object, ma non entrambi i tipi	Raccolte da cui ottenere tutti gli elementi

Valore restituito	Tipo	Descrizione
<updatedCollection>	Array o object, rispettivamente	Raccolta con tutti gli elementi delle raccolte specificate e senza duplicati

Esempio

Questo esempio ottiene tutti gli elementi da queste raccolte:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

E viene restituito questo risultato: [1, 2, 3, 10, 101]

uriComponent

Restituisce la versione con codifica URI (Uniform Resource Identifier) per una stringa sostituendo i caratteri non sicuri per gli URL con caratteri di escape. Usare questa funzione al posto di encodeUriComponent(). Anche se entrambe le funzioni hanno un comportamento analogo, è preferibile usare uriComponent().

uriComponent('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa da convertire nel formato con codifica URI

Valore restituito	Tipo	Descrizione
<encoded-uri>	String	Stringa con codifica URI con i caratteri di escape

Esempio

Questo esempio crea una versione con codifica URI per questa stringa:

uriComponent('https://contoso.com')

E viene restituito questo risultato: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Restituisce la versione binaria di un componente di un URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con codifica URI da convertire

Valore restituito	Tipo	Descrizione
<binary-for-encoded-uri>	String	Versione binaria della stringa con codifica URI. Il contenuto binario è con codifica base64 e rappresentato da `$content`.

Esempio

Questo esempio crea la versione binaria per questa stringa con codifica URI:

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

E viene restituito questo risultato:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Restituisce la versione stringa di una stringa con codifica URI (Uniform Resource Identifier), decodificando in modo efficace la stringa con codifica URI.

uriComponentToString('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con codifica URI da decodificare

Valore restituito	Tipo	Descrizione
<decoded-uri>	String	Versione decodificata della stringa con codifica URI

Esempio

Questo esempio crea la versione stringa decodificata per questa stringa con codifica URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

E viene restituito questo risultato: "https://contoso.com"

utcNow

Restituisce il timestamp corrente.

utcNow('<format>')

Facoltativamente, è possibile specificare un formato diverso con il parametro <format>.

Parametro	Richiesto	Type	Descrizione
<format>	No	String	Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ddTHH:mm:ss:fffffffK), conforme a ISO 8601 e con informazioni sul fuso orario.

Valore restituito	Tipo	Descrizione
<current-timestamp>	String	Data e ora correnti

Esempio 1

Si supponga che oggi sia il 15 aprile 2018 alle ore 13:00. Questo esempio ottiene il timestamp corrente:

utcNow()

E viene restituito questo risultato: "2018-04-15T13:00:00.0000000Z"

Esempio 2

Si supponga che oggi sia il 15 aprile 2018 alle ore 13:00. Questo esempio ottiene il timestamp corrente usando il formato "D" facoltativo:

utcNow('D')

E viene restituito questo risultato: "Sunday, April 15, 2018"

xml

Restituisce la versione XML di una stringa contenente un oggetto JSON.

xml('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con l'oggetto JSON da convertire L'oggetto JSON deve avere una sola proprietà radice, che non può essere una matrice. Il carattere barra rovesciata (\) viene usato come carattere di escape per le virgolette doppie (").

Valore restituito	Tipo	Descrizione
<xml-version>	Object	Elemento XML codificato per la stringa o l'oggetto JSON specificato

Esempio 1

Questo esempio crea la versione XML per questa stringa, che contiene un oggetto JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

E viene restituito questo elemento XML:

<name>Sophia Owen</name>

Esempio 2

Si supponga di avere questo oggetto JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Questo esempio crea la versione XML per una stringa contenente questo oggetto JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

E viene restituito questo elemento XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

Verifica nel codice XML la presenza di nodi o valori che corrispondono a un'espressione XPath (XML Path Language) e restituisce i nodi o i valori corrispondenti. Un'espressione XPath, o semplicemente "XPath", aiuta a spostarsi nella struttura del documento XML in modo che sia possibile selezionare i nodi o i valori di calcolo nel contenuto XML.

xpath('<xml>', '<xpath>')

Parametro	Richiesto	Type	Descrizione
<xml>	Sì	Qualsiasi	Stringa XML per eseguire la ricerca di nodi o valori che corrispondono a un valore dell'espressione XPath
<xpath>	Sì	Qualsiasi	Espressione XPath usata per trovare i valori o i nodi XML corrispondenti

Valore restituito	Tipo	Descrizione
<xml-node>	XML	Nodo XML, quando solo un singolo nodo corrisponde all'espressione XPath specificata
<value>	Any	Valore di un nodo XML, quando solo un singolo valore corrisponde all'espressione XPath specificata
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Array	Matrice con tutti i valori o i nodi XML che corrispondono all'espressione XPath specificata

Esempio 1

Dopo l'esempio 1, questo esempio trova i nodi che corrispondono al nodo <count></count> e somma i valori di tali nodi con la funzione sum():

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

E viene restituito questo risultato: 30

Esempio 2

Per questo esempio, entrambe le espressioni trovano i nodi che corrispondono al nodo <location></location>, negli argomenti specificati, che includono codice XML con uno spazio dei nomi. Le espressioni usano il carattere barra rovesciata () come carattere di escape per le virgolette doppie (").

Espressione 1

xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Expression 2

xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Ecco gli argomenti:

Codice XML, che include lo spazio dei nomi del documento XML, xmlns="http://contoso.com":

<?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>

Una di queste espressioni XPath:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Ecco il nodo del risultato che corrisponde al nodo <location></location>:

<location xmlns="https://contoso.com">Paris</location>

Esempio 3

Dopo l'esempio 3, questo esempio trova il valore nel nodo <location></location>:

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

E viene restituito questo risultato: "Paris"

Nota

È possibile aggiungere commenti alle espressioni del flusso di dati, ma non nelle espressioni della pipeline.

Per istruzioni sull'utilizzo generale dei parametri, si veda Parametri per Data Factory in Fabric

Condividi tramite

Espressioni e funzioni per Data Factory in Microsoft Fabric

Espressioni

Esempi

Esempio di espressione complessa

Editor di contenuto dinamico

Sostituzione di caratteri speciali

Carattere di escape virgolette singole

Variabili dell'ambito della pipeline

Funzioni

Funzioni di data

Funzioni di stringa

Funzioni di raccolta

Funzioni logiche

Funzioni di conversione

Funzioni matematiche

Riferimento di funzione

add (aggiungi)

addDays

addHours

addMinutes

addSeconds

addToTime

e

array

base64

base64ToBinary

base64ToString

binary

bool

coalesce

concat

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

decodeBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

endsWith

equals

primo

float

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

guid

if

indexOf

int

JSON

intersection

join

ultimo

lastIndexOf

length

less

lessOrEquals

max

min

mod

mul

not

or

rand

range

replace

skip