Espressioni e funzioni in Azure Data Factory e Azure Synapse Analytics

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .

Questo articolo fornisce informazioni dettagliate sulle espressioni e sulle funzioni supportate da Azure Data Factory e Azure Synapse Analytics.

Espressioni

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

"name": "value"

oppure

"name": "@pipeline().parameters.password"

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

Valore JSON 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: "name" : "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 JSON 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 gli elementi sono una matrice: [1, 2, 3], @item() restituisce 1 nella prima iterazione, 2 nella seconda iterazione e 3 nella terza iterazione. È anche possibile usare l'espressione @range(0,10) like per scorrere dieci 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 sottocampo, usare la sintassi [] anziché l'operatore dot(.), come nel caso di subfield1 e subfield2, come parte di un output dell'attività.

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

  1. Accoda data a un nome file: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

  2. Aggiungere DateTime nel fuso orario del cliente: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

  3. Append Trigger Time (Ora trigger di accodamento): @concat('Test_', pipeline().TriggerTime)

  4. Restituisce un nome file personalizzato in un Flusso di dati mapping durante l'output in un singolo file con data :'Test_' + toString(currentDate()) + '.csv'

Nei casi precedenti vengono creati 4 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 contenuto seguente nell'editor di contenuto è un'interpolazione di stringhe con due funzioni di espressione.

{ 
  "type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
  "name": "@{toUpper('myData')}"
}

L'editor di contenuto dinamico converte il contenuto precedente in espressione "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}". Il risultato di questa espressione è una stringa di formato JSON illustrata di seguito.

{
  "type": "Table",
  "name": "MYDATA"
}

Un set di dati con un parametro

Nell'esempio seguente BlobDataset accetta un parametro denominato path. Questo valore viene usato per impostare un valore per la proprietà folderPath usando l'espressione seguente: dataset().path.

{
    "name": "BlobDataset",
    "properties": {
        "type": "AzureBlob",
        "typeProperties": {
            "folderPath": "@dataset().path"
        },
        "linkedServiceName": {
            "referenceName": "AzureStorageLinkedService",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "path": {
                "type": "String"
            }
        }
    }
}

Una pipeline con un parametro

Nell'esempio seguente la pipeline accetta i parametri inputPath e outputPath. Il parametro path per il set di dati del BLOB con parametri viene impostato usando i valori di questi parametri. La sintassi usata è: pipeline().parameters.parametername.

{
    "name": "Adfv2QuickStartPipeline",
    "properties": {
        "activities": [
            {
                "name": "CopyFromBlobToBlob",
                "type": "Copy",
                "inputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.inputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "outputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.outputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "typeProperties": {
                    "source": {
                        "type": "BlobSource"
                    },
                    "sink": {
                        "type": "BlobSink"
                    }
                }
            }
        ],
        "parameters": {
            "inputPath": {
                "type": "String"
            },
            "outputPath": {
                "type": "String"
            }
        }
    }
}

Sostituzione di caratteri speciali

L'editor di contenuto dinamico esegue automaticamente l'escape di caratteri come virgolette doppie, 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:

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

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

Contoso-
Corporation

Escape tra 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 risultato seguente.

Baba's book store

Esercitazione

Questa esercitazione illustra come passare i parametri tra una pipeline e un'attività, nonché tra le attività. L'esercitazione illustra in modo specifico i passaggi per azure Data Factory, anche se i passaggi per un'area di lavoro Synapse sono quasi equivalenti, ma con un'interfaccia utente leggermente diversa.

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 Dividere una stringa in corrispondenza di ogni occorrenza di un delimitatore specificato, restituendo le sottostringhe risultanti come elementi di una matrice.
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.
oppure 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.
json Restituisce il valore o l'oggetto di tipo JSON (JavaScript Object Notation ) per una stringa o un elemento XML.
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 Obbligatorio Type Descrizione
<>summand_1, <summand_2> 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<days> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<hours> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<minutes> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<seconds> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<interval> Intero Numero di unità di tempo specificate da aggiungere
<timeUnit> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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

Controllare se entrambe le espressioni sono true. Restituisce true quando entrambe le espressioni sono true o restituiscono false quando almeno un'espressione è false.

and(<expression1>, <expression2>)
Parametro Obbligatorio Type Descrizione
<expression1>, <expression2> 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 controllano 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 controllano se le espressioni specificate sono entrambe vere:

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 Obbligatorio Type Descrizione
<value> String Stringa per la creazione di una matrice
Valore restituito Tipo Descrizione
[<valore>] Matrice 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<>object_1, <object_2>, ... 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 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 Obbligatorio Type Descrizione
<text1>, <text2>, ... 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 Obbligatorio Type Descrizione
<collection> String, array o dictionary Raccolta da verificare
<value> 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<destinationTimeZone> String Nome del fuso orario di destinazione. Per i nomi del fuso orario, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere qualsiasi punteggiatura dal 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<sourceTimeZone> String Nome del fuso orario di origine. Per i nomi del fuso orario, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere qualsiasi punteggiatura dal nome del fuso orario.
<destinationTimeZone> String Nome del fuso orario di destinazione. Per i nomi del fuso orario, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere qualsiasi punteggiatura dal 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<sourceTimeZone> String Nome del fuso orario di origine. Per i nomi del fuso orario, vedere Valori del fuso orario Microsoft, ma potrebbe essere necessario rimuovere qualsiasi punteggiatura dal 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<object1>, <object2>, ... Qualsiasi, ma non sono possibili combinazioni di tipi Almeno due elementi per creare la matrice
Valore restituito Tipo Descrizione
[<object1>, <object2>, ...] Matrice 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<timestamp> 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 Obbligatorio Type Descrizione
<timestamp> 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 Obbligatorio Type Descrizione
<timestamp> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')
Parametro Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<dividend> Integer o float Numero da dividere per l'oggetto divisor
<divisor> Integer o float Numero che divide l'oggetto dividend, 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<collection> 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. Questa funzione non fa distinzione tra maiuscole e minuscole.

endsWith('<text>', '<searchText>')
Parametro Obbligatorio Type Descrizione
<Testo> String Stringa da verificare
<searchText> 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

uguale a

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 Obbligatorio Type Descrizione
<object1>, <object2> 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 Obbligatorio Type Descrizione
<collection> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<timestamp> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<interval> Intero Numero di unità di tempo specificate da aggiungere
<timeUnit> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<interval> Intero Numero di unità di tempo specificate da sottrarre
<timeUnit> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<value> Integer, float o string Primo valore da verificare per determinare se è maggiore del secondo
<compareTo> 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 Obbligatorio Type Descrizione
<value> Integer, float o string Primo valore da verificare per determinare se è maggiore o uguale al secondo
<compareTo> 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 Obbligatorio 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 Obbligatorio Type Descrizione
<expression> Booleano Espressione da verificare
<valueIfTrue> Qualsiasi Valore da restituire se l'espressione è true
<valueIfFalse> 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 Obbligatorio Type Descrizione
<Testo> String Stringa che contiene la sottostringa da trovare
<searchText> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<collection1>, <collection2>, ... 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 Obbligatorio Type Descrizione
<collection> Matrice Matrice contenente gli elementi da aggiungere
<delimiter> String Separatore visualizzato tra ogni carattere nella stringa risultante
Valore restituito Tipo Descrizione
<delimitatore char1><delimitatore><> char2...>< 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 Obbligatorio Type Descrizione
<collection> 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 Obbligatorio Type Descrizione
<Testo> String Stringa che contiene la sottostringa da trovare
<searchText> 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 Obbligatorio Type Descrizione
<collection> 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 Obbligatorio Type Descrizione
<value> Integer, float o string Primo valore da verificare per determinare se è minore del secondo
<compareTo> 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 Obbligatorio Type Descrizione
<value> Integer, float o string Primo valore da verificare per determinare se è minore o uguale al secondo
<compareTo> 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 Obbligatorio Type Descrizione
<number1>, <number2>, ... Integer, float o entrambi Set di numeri da cui si vuole ottenere il valore più alto
[<number1>, <number2>, ...] 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 Obbligatorio Type Descrizione
<number1>, <number2>, ... Integer, float o entrambi Set di numeri da cui si vuole ottenere il valore più basso
[<number1>, <number2>, ...] 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 Obbligatorio Type Descrizione
<dividend> Integer o float Numero da dividere per l'oggetto divisor
<divisor> Integer o float Numero che divide l'oggetto dividend, 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 Obbligatorio Type Descrizione
<multiplicand1> Integer o float Numero da moltiplicare per multiplicand2
<multiplicand2> 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 Obbligatorio Type Descrizione
<expression> 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.

oppure

Verifica se almeno un'espressione è true. Restituisce true quando almeno un'espressione è true o restituisce false quando entrambe sono false.

or(<expression1>, <expression2>)
Parametro Obbligatorio Type Descrizione
<expression1>, <expression2> Booleano Espressioni da verificare
Valore restituito Tipo Descrizione
true o false Booleano Restituisce true se almeno un'espressione è true. Restituisce false quando 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 Obbligatorio Type Descrizione
<minValue> Intero Valore intero più basso nell'intervallo
<maxValue> Intero Valore intero che segue il valore intero più alto nell'intervallo che la funzione può restituire
Valore restituito Tipo Descrizione
<random-result> Intero Intero casuale restituito dall'intervallo specificato. Si noti che ogni chiamata di produrrà un risultato univoco, ovvero il valore osservato nel monitoraggio dell'output rand() potrebbe non essere lo stesso in fase di esecuzione effettiva.

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 Obbligatorio Type Descrizione
<startIndex> Intero Valore intero che rappresenta il primo elemento da cui inizia la matrice
<count> Intero Numero di valori interi nella matrice
Valore restituito Tipo Descrizione
[<range-result>] Matrice 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 Obbligatorio Type Descrizione
<Testo> String Stringa che contiene la sottostringa da sostituire
<oldText> String Sottostringa da sostituire
<newText> 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 Obbligatorio Type Descrizione
<collection> Matrice Raccolta da cui rimuovere gli elementi
<count> Intero Valore intero positivo per il numero di elementi da rimuovere nella parte iniziale
Valore restituito Tipo Descrizione
[<updated-collection>] Matrice 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

Dividere una stringa in corrispondenza di ogni occorrenza di un delimitatore specificato, restituendo le sottostringhe risultanti come elementi di una matrice. Un delimitatore è in genere un singolo carattere, ma sono supportati delimitatori multicaracter.

split('<text>', '<delimiter>')
Parametro Obbligatorio Type Descrizione
<Testo> String Stringa da separare in sottostringhe
<delimiter> String Stringa da usare come delimitatore
Valore restituito Tipo Descrizione
[<substring1,substring2><>,...] Matrice Matrice che contiene sottostringhe della stringa originale

Esempio

In questo esempio viene restituita una matrice contenente sottostringhe della stringa "a_b_c" in base al delimitatore "_":

split('a_b_c', '_')

La matrice restituita è: ["a","b","c"]

startOfDay

Restituisce l'inizio del giorno per un timestamp.

startOfDay('<timestamp>', '<format>'?)
Parametro Obbligatorio Type Descrizione
<timestamp> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<timestamp> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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. Questa funzione non fa distinzione tra maiuscole e minuscole.

startsWith('<text>', '<searchText>')
Parametro Obbligatorio Type Descrizione
<Testo> String Stringa da verificare
<searchText> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<minuend> Integer o float Numero da cui sottrarre l'oggetto subtrahend
<subtrahend> 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 Obbligatorio Type Descrizione
<Testo> String Stringa da cui ottenere i caratteri
<startIndex> Intero Numero positivo maggiore o uguale a 0 che si desidera usare come posizione iniziale o valore di indice
<length> 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 Obbligatorio Type Descrizione
<timestamp> String Stringa contenente il timestamp
<interval> Intero Numero di unità di tempo specificate da sottrarre
<timeUnit> 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-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<collection> String o array Raccolta da cui ottenere gli elementi
<count> Intero Valore intero positivo per il numero di elementi da ottenere dalla parte iniziale
Valore restituito Tipo Descrizione
<subset> o [<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 Obbligatorio Type Descrizione
<timestamp> 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 Obbligatorio Type Descrizione
<Testo> 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 Obbligatorio Type Descrizione
<Testo> 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 Obbligatorio Type Descrizione
<Testo> 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 Obbligatorio Type Descrizione
<collection1>, <collection2>, ... 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<value> 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 Obbligatorio Type Descrizione
<format> No String Identificatore di formato singolo o modello di formato personalizzato. Il formato predefinito per il timestamp è "o" (aaaa-MM-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le 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 Obbligatorio Type Descrizione
<value> String Stringa con l'oggetto JSON da convertire

L'oggetto JSON deve avere una sola proprietà radice, che non può essere una matrice.
Usare il carattere barra rovesciata (\) 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 Obbligatorio Type Descrizione
<xml> Qualsiasi Stringa XML per eseguire la ricerca di nodi o valori che corrispondono a un valore dell'espressione XPath
<xpath> 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>, ...]
Matrice 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 un elenco di variabili di sistema che è possibile usare nelle espressioni, vedere Variabili di sistema.