Guida di riferimento alle funzioni di espressione del flusso di lavoro in App per la logica di Azure e Power Automate

Si applica a: App per la logica di Azure (a consumo e standard)

Per la definizione dei flussi di lavoro in App per la logica di Azure e Power Automate, alcune espressioni ottengono i rispettivi valori da azioni di runtime che potrebbero non esistere all'inizio dell'esecuzione del flusso di lavoro. Per fare riferimento o elaborare i valori in queste espressioni, è possibile usare le funzioni di espressione fornite dal linguaggio di definizione del flusso di lavoro.

È ad esempio possibile calcolare i valori usando le funzioni matematiche, ad esempio la funzione add() quando si desidera la somma di numeri interi o di float. Ecco altri esempi di attività che possono essere eseguite con le funzioni:

Attività	Sintassi della funzione	Risultato
Restituisce una stringa in formato minuscolo.	toLower('<text>') Ad esempio toLower('Hello')	"hello"
Restituisce un identificatore univoco globale (GUID).	guid()	"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

Per trovare le funzioni in base all'utilizzo generico, esaminare le tabelle seguenti. Oppure, per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

Funzioni nelle espressioni

Per capire come usare una funzione in un’espressione, questo esempio mostra come ottenere il valore dal parametro customerName e assegnarlo alla proprietà accountName usando la funzione parameters() in un'espressione:

"accountName": "@parameters('customerName')"

Di seguito sono indicati altri modi generali per l'uso delle funzioni nelle espressioni:

Attività	Sintassi della funzione in un'espressione
Eseguire operazioni con un elemento passandolo a una funzione.	"@<functionName>(<item>)"
1. Ottenere il valore di parameterName usando la funzione nidificata parameters() . 2. Eseguire il lavoro con il risultato passando tale valore a functionName.	"@<functionName>(parameters('<parameterName>'))"
1. Ottenere il risultato dalla funzione interna annidata functionName. 2. Passare il risultato alla funzione esterna functionName2.	"@<functionName2>(functionName>(<<item>))"
1. Ottenere il risultato da functionName. 2. Dato che il risultato è un oggetto con propertyName, ottenere il valore della proprietà.	"@<functionName>(<item).<>propertyName>"

Ad esempio, la funzione concat() può accettare due o più valori di stringa come parametri. Questa funzione combina queste stringhe in un'unica stringa. È possibile passare valori letterali di stringa, ad esempio, "Sophia" e "Owen", in modo da ottenere una stringa combinata, ovvero "SophiaOwen":

"customerName": "@concat('Sophia', 'Owen')"

In alternativa, è possibile ottenere i valori delle stringhe dai parametri. Questo esempio usa la funzione parameters() in ogni parametro concat() e i parametri firstName e lastName. Si passano quindi le stringhe risultanti alla funzione concat() in modo da ottenere una stringa combinata, ad esempio "SophiaOwen":

"customerName": "@concat(parameters('firstName'), parameters('lastName'))"

In entrambi i casi, gli esempi assegnano il risultato alla proprietà customerName.

Considerazioni sull'uso delle funzioni

• La finestra di progettazione non valuta le espressioni di runtime usate come parametri di funzione in fase di progettazione. La finestra di progettazione richiede che tutte le espressioni possano essere valutate completamente in fase di progettazione.

• I parametri della funzione sono valutati da sinistra a destra.

• Nella sintassi per le definizioni dei parametri, un punto interrogativo (?) visualizzato dopo un parametro indica che il parametro è facoltativo. Vedere, ad esempio, getFutureTime().

• Le espressioni di funzione visualizzate inline con testo normale richiedono invece di racchiudere parentesi graffe ({}) per usare il formato interpolato dell'espressione. Questo formato consente di evitare problemi di analisi. Se l'espressione di funzione non viene visualizzata inline con testo normale, non sono necessarie parentesi graffe.

  L'esempio seguente mostra la sintassi corretta e errata:

  Risposta esatta: "<text>/@{<function-name>('<parameter-name>')}/<text>"

  Risposta errata: "<text>/@<function-name>('<parameter-name>')/<text>"

  OK: "@<function-name>('<parameter-name>')"

Le sezioni seguenti organizzano le funzioni in base al loro utilizzo generico, oppure è possibile esplorarle in ordine alfabetico.

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à
blocco	Dividere una stringa o una raccolta in blocchi di lunghezza uguale.
concat	Combina due o più stringhe e restituisce la stringa combinata.
endsWith	Verifica se una stringa termina con la sottostringa specificata.
formatNumber	Restituisce un numero come stringa in base al formato specificato
guid	Generare un identificatore univoco globale (GUID) sotto forma di stringa.
indexOf	Restituisce la posizione iniziale di una sottostringa.
isFloat	Restituisce un valore booleano che indica se una stringa è un numero a virgola mobile.
isInt	Restituisce un valore booleano che indica se una stringa è un numero intero.
lastIndexOf	Restituisce la posizione iniziale o il valore di indice per l'ultima occorrenza di una sottostringa.
length	Restituisce il numero di elementi in una stringa o matrice.
nthIndexOf	Restituisce la posizione iniziale o il valore di indice in cui l'n occorrenza di una sottostringa viene visualizzata in una stringa.
replace	Sostituisce una sottostringa con la stringa specificata e restituisce la stringa aggiornata.
slice	Restituisce una sottostringa specificando la posizione iniziale e finale o il valore. Vedere anche sottostringa.
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. Vedere anche sezione.
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à
blocco	Dividere una stringa o una raccolta in blocchi di lunghezza uguale.
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.
item	Se questa funzione viene visualizzata all'interno di un'azione ripetuta su una matrice, restituire l'elemento corrente nella matrice durante l'iterazione corrente dell'azione.
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.
ordinamento inverso	Invertire l'ordine degli elementi in una matrice.
skip	Rimuove gli elementi dall'inizio di una raccolta e restituisce tutti gli altri elementi.
ordinamento	Ordinare gli elementi in una raccolta.
take	Restituisce gli elementi dall'inizio di una raccolta.
union	Restituisce una raccolta che contiene tutti gli elementi delle raccolte specificate.

Funzioni di confronto logico

Per eseguire operazioni con le condizioni, confrontare i valori e i risultati delle espressioni o valutare vari tipi di logica, è possibile usare queste funzioni di confronto logico. Per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

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.
isFloat	Restituisce un valore booleano che indica se una stringa è un numero a virgola mobile.
isInt	Restituisce un valore booleano che indica se una stringa è un numero intero.
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

Per modificare il tipo o il formato di un valore, è possibile usare queste funzioni di conversione. Ad esempio, è possibile modificare un valore da booleano a intero. Per altre informazioni su come App per la logica di Azure gestisce i tipi di contenuto durante la conversione, vedere Gestire i tipi di contenuto. Per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

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.
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.
decimal	Restituisce il numero decimale per una stringa decimale.
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.

Conversioni implicite del tipo di dati

App per la logica di Azure converte automaticamente o in modo implicito tra alcuni tipi di dati, quindi non è necessario eseguire manualmente queste conversioni. Ad esempio, se si usano valori non stringa in cui le stringhe sono previste come input, App per la logica di Azure converte automaticamente i valori non stringa in stringhe.

Si supponga, ad esempio, che un trigger restituisca un valore numerico come output:

triggerBody()?['123']

Se si usa questo output numerico in cui è previsto l'input stringa, ad esempio un URL, App per la logica di Azure converte automaticamente il valore in una stringa usando la notazione parentesi graffe ({}):

@{triggerBody()?['123']}

Codifica e decodifica Base64

App per la logica di Azure esegue automaticamente o in modo implicito la codifica o la decodifica base64, pertanto non è necessario eseguire manualmente queste conversioni usando le funzioni corrispondenti:

• base64(<value>)
• base64ToBinary(<value>)
• base64ToString(<value>)
• base64(decodeDataUri(<value>))
• concat('data:;base64,',<value>)
• concat('data:,',encodeUriComponent(<value>))
• decodeDataUri(<value>)

Funzioni matematiche

Per eseguire operazioni con numeri interi o float, è possibile usare queste funzioni matematiche. Per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

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.

Funzioni di data e ora

Per eseguire operazioni con date e ore, è possibile usare queste funzioni di data e ora. Per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

Funzione di data e ora	Attività
addDays	Aggiungere giorni a un timestamp.
addHours	Aggiungere ore a un timestamp.
addMinutes	Aggiungere minuti a un timestamp.
addSeconds	Aggiungere secondi a un timestamp.
addToTime	Aggiungere unità di tempo specificate 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).
dateDifference	Restituisce la differenza tra due date come intervallo di tempo.
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 la data di un timestamp.
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.
parseDateTime	Restituisce il timestamp da una stringa contenente un timestamp.
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 del flusso di lavoro

Queste funzioni del flusso di lavoro consentono di eseguire queste operazioni:

• Ottenere dettagli su un'istanza del flusso di lavoro al momento dell'esecuzione.
• Eseguire operazioni con gli input usati per creare istanze di app per la logica o dei flussi.
• Fare riferimento agli output da azioni e trigger.

Ad esempio, è possibile fare riferimento agli output di un'azione e usare i dati in un'azione successiva. Per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

Funzione del flusso di lavoro	Attività
azione	Restituisce l'output dell'azione corrente in fase di esecuzione o i valori di altre coppie di nomi e valori JSON. Vedere anche actions.
actions	Restituisce l'output di un'azione in fase di esecuzione o i valori di altre coppie di nomi e valori JSON. Vedere anche action.
body	Restituisce l'oggetto body di output di un'azione in fase di esecuzione.
formDataMultiValues	Creare una matrice con i valori corrispondenti a un nome chiave negli ouput di azione form-data o form-encoded.
formDataValue	Restituisce un singolo valore corrispondente a un nome di chiave nell'output di dati del modulo o codifica per il modulo di un'azione.
item	Se questa funzione viene visualizzata all'interno di un'azione ripetuta su una matrice, restituire l'elemento corrente nella matrice durante l'iterazione corrente dell'azione.
items	Se questa funzione viene visualizzata all'interno di un ciclo Foreach o Until, restituire l'elemento corrente dal ciclo specificato.
iterationIndexes	Se questa funzione viene visualizzata all'interno di un ciclo Until, restituire il valore di indice per l'iterazione corrente. È possibile usare questa funzione all'interno di cicli Until annidati.
listCallbackUrl	Restituisce l'"URL di callback" che chiama un trigger o un'azione.
multipartBody	Restituisce il corpo per una parte specifica dell'output di un'azione con più parti.
outputs	Restituisce l'output di un'azione in fase di esecuzione.
parameters	Restituisce il valore per un parametro descritto nella definizione del flusso di lavoro.
result	Restituisce gli input e gli output dalle azioni di primo livello all'interno dell'azione con ambito specificata, ad esempio For_each, Untile Scope.
trigger	Restituisce l'output di un trigger in fase di esecuzione o i valori di altre coppie di nomi e valori JSON. Vedere anche triggerOutputs e triggerBody.
triggerBody	Restituisce l'oggetto body di output di un trigger in fase di esecuzione. Vedere trigger.
triggerFormDataValue	Restituisce un singolo valore corrispondente a un nome di chiave negli output form-data o form-encoded del trigger.
triggerMultipartBody	Restituisce il corpo di una parte specifica di un output a più parti di un trigger.
triggerFormDataMultiValues	Crea una matrice i cui valori corrispondono a un nome di chiave negli output form-data o form-encoded di un trigger.
triggerOutputs	Restituisce l'output di un trigger in fase di esecuzione o i valori di altre coppie nome-valore JSON. Vedere trigger.
variables	Restituisce il valore per una variabile specificata.
workflow	Restituisce tutti i dettagli del flusso di lavoro stesso in fase di esecuzione.

Funzioni di analisi URI

Per eseguire operazioni con URI (Uniform Resource Identifier) e ottenere vari valori di proprietà per questi URI, è possibile usare queste funzioni di analisi dell'URI. Per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

Funzione di analisi dell'URI	Attività
uriHost	Restituisce il valore host per un URI (Uniform Resource Identifier).
uriPath	Restituisce il valore path per un URI (Uniform Resource Identifier).
uriPathAndQuery	Restituisce i valori path e query per un URI (Uniform Resource Identifier).
uriPort	Restituisce il valore port per un URI (Uniform Resource Identifier).
uriQuery	Restituisce il valore query per un URI (Uniform Resource Identifier).
uriScheme	Restituisce il valore scheme per un URI (Uniform Resource Identifier).

Funzioni di manipolazione: JSON & XML

Per eseguire operazioni con gli oggetti JSON e i nodi XML, è possibile usare queste funzioni di manipolazione. Per informazioni dettagliate su ogni funzione, vedere l'elenco in ordine alfabetico.

Funzione di manipolazione	Attività
addProperty	Aggiunge una proprietà e il suo valore o una coppia nome-valore a un oggetto JSON e restituisce l'oggetto aggiornato.
coalesce	Restituisce il primo valore non Null da uno o più parametri.
removeProperty	Rimuove una proprietà da un oggetto JSON e restituisce l'oggetto aggiornato.
setProperty	Imposta il valore per la proprietà di un oggetto JSON e restituisce l'oggetto aggiornato.
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.

---------------------------------

Tutte le funzioni in ordine alfabetico

Questa sezione elenca tutte le funzioni disponibili in ordine alfabetico.

Un

action

Restituisce l'output dell'azione corrente in fase di esecuzione oppure i valori di altre coppie nome-valore JSON che è possibile assegnare a un'espressione. Per impostazione predefinita, questa funzione fa riferimento all'intero oggetto azione, ma è possibile specificare una proprietà con il valore desiderato. Vedere anche actions().

È possibile usare la funzione action() solo in queste posizioni:

• Proprietà unsubscribe per un'azione webhook, in modo che sia possibile accedere al risultato dalla richiesta subscribe originale
• Proprietà trackedProperties per un'azione
• Condizione di ciclo do-until per un'azione

action()
action().outputs.body.<property>

Parametro	Richiesto	Type	Descrizione
<property>	No	String	Nome della proprietà dell'oggetto azione con il valore desiderato: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. Nel portale di Azure è possibile trovare queste proprietà esaminando i dettagli di una cronologia di esecuzione specifica. Per altre informazioni, vedere REST API - Workflow Run Actions (API REST - Azioni di esecuzione del flusso di lavoro).

Valore restituito	Tipo	Descrizione
<action-output>	String	Output della proprietà o dell'azione corrente

actions

Restituisce l'output di un'azione in fase di esecuzione oppure i valori di altre coppie nome-valore JSON che è possibile assegnare a un'espressione. Per impostazione predefinita, questa funzione fa riferimento all'intero oggetto azione, ma è possibile specificare una proprietà con il valore desiderato. Per le versioni abbreviate, vedere body().For shorthand versions, see body(). Per l'azione corrente, vedere action().

actions('<actionName>')
actions('<actionName>').outputs.body.<property>

Parametro	Richiesto	Type	Descrizione
<actionName>	Sì	String	Nome per l'oggetto azione di cui si vuole ottenere l'output
<property>	No	String	Nome della proprietà dell'oggetto azione con il valore desiderato: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. Nel portale di Azure è possibile trovare queste proprietà esaminando i dettagli di una cronologia di esecuzione specifica. Per altre informazioni, vedere REST API - Workflow Run Actions (API REST - Azioni di esecuzione del flusso di lavoro).

Valore restituito	Tipo	Descrizione
<action-output>	String	Output dell'azione o della proprietà specificata

Esempio

Questo esempio ottiene il valore della status proprietà dall'azione Get user X in fase di esecuzione:

actions('Get_user').outputs.body.status

E viene restituito questo risultato: "Succeeded"

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

Aggiungere 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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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-15T00:00:00Z', 10)

E viene restituito questo risultato: "2018-03-25T00:00: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:00.0000000Z"

addHours

Aggiungere 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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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: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:00.0000000Z"

addMinutes

Aggiungere 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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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"

addProperty

Aggiunge una proprietà e il suo valore o una coppia nome-valore a un oggetto JSON e restituisce l'oggetto aggiornato. Se la proprietà esiste già nel runtime, la funzione ha esito negativo e genera un errore.

addProperty(<object>, '<property>', <value>)

Parametro	Richiesto	Type	Descrizione
<object>	Sì	Object	Oggetto JSON a cui si vuole aggiungere una proprietà
<property>	Sì	String	Nome della proprietà da aggiungere
<value>	Sì	Qualsiasi	Valore per la proprietà

Valore restituito	Tipo	Descrizione
<updated-object>	Object	Oggetto JSON aggiornato con la proprietà specificata

Per aggiungere una proprietà padre a una proprietà esistente, usare la setProperty() funzione , non la addProperty() funzione . Altrimenti, la funzione restituisce solo l'oggetto figlio come output.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)

Parametro	Richiesto	Type	Descrizione
<object>	Sì	Object	Oggetto JSON a cui si vuole aggiungere una proprietà
<parent-property>	Sì	String	Nome della proprietà padre in cui si desidera aggiungere la proprietà figlio
<child-property>	Sì	String	Nome della proprietà figlio da aggiungere
<value>	Sì	Qualsiasi	Valore da impostare per la proprietà specificata

Valore restituito	Tipo	Descrizione
<updated-object>	Object	Oggetto JSON aggiornato di cui si imposta la proprietà

Esempio 1

Questo esempio aggiunge la proprietà middleName all'oggetto JSON, di cui viene eseguita la conversione da stringa a JSON con la funzione JSON(). L'oggetto include già le proprietà firstName e surName. La funzione assegna il valore specificato alla nuova proprietà e restituisce l'oggetto aggiornato:

addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')

Ecco l'oggetto JSON corrente:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Ecco l'oggetto JSON aggiornato:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Esempio 2

Questo esempio aggiunge la proprietà figlio middleName alla proprietà customerName esistente in un oggetto JSON, di cui viene eseguita la conversione da stringa a JSON con la funzione JSON(). La funzione assegna il valore specificato alla nuova proprietà e restituisce l'oggetto aggiornato:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))

Ecco l'oggetto JSON corrente:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

Ecco l'oggetto JSON aggiornato:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

addSeconds

Aggiungere 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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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

Aggiungere le unità di tempo specificate 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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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 tutte le espressioni sono true. Restituisce true se tutte le espressioni sono true o 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 se tutte le espressioni sono true. Restituisce false se almeno un'espressione è false.

Esempio 1

Questi esempi verificano se i valori booleani specificati sono tutti 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 tutte 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"]

G

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=')

Si supponga, ad esempio, di usare un'azione HTTP per inviare una richiesta. È possibile usare base64ToBinary() per convertire una stringa con codifica Base64 in dati binari e inviare tali dati usando il application/octet-stream tipo di contenuto nella richiesta.

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(), che è deprecata.

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 con codifica Base64 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 con codifica Base64 per la stringa specificata

Esempio

Ad esempio, si usa un'azione HTTP che restituisce un'immagine o un file video. È possibile usare binary() per convertire il valore in un modello di busta di contenuto con codifica base 64. È quindi possibile riutilizzare la busta contenuto in altre azioni, ad esempio Compose. È possibile usare questa espressione di funzione per inviare i byte stringa con il application/octet-stream tipo di contenuto nella richiesta.

body

Restituisce l'oggetto body di output di un'azione in fase di esecuzione. Sintassi abbreviata per actions('<actionName>').outputs.body. Vedere actions().

body('<actionName>')

Parametro	Richiesto	Type	Descrizione
<actionName>	Sì	String	Nome per l'oggetto body di output dell'azione desiderato

Valore restituito	Tipo	Descrizione
<action-body-output>	String	Oggetto body di output dell'azione specificata

Esempio

Questo esempio ottiene l'output body dall'azione Get user X:

body('Get_user')

E viene restituito questo risultato:

"body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

bool

Restituisce la versione booleana di un valore.

bool(<value>)

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

Se si usa bool() con un oggetto , il valore dell'oggetto deve essere una stringa o un numero intero che può essere convertito in booleano.

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

Output

Questi esempi mostrano i diversi tipi di input supportati per bool():

Valore di input	Type	Valore restituito
bool(1)	Intero	true
bool(0)	Intero	false
bool(-1)	Intero	true
bool('true')	String	true
bool('false')	String	false

A

blocco

Dividere una stringa o una matrice in blocchi di lunghezza uguale.

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

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	String o array	Raccolta da dividere
<length>	Sì	Lunghezza di ogni blocco

Valore restituito	Tipo	Descrizione
<collection>	Array	Matrice di blocchi con la lunghezza specificata

Esempio 1

Questo esempio suddivide una stringa in blocchi di lunghezza 10:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

E viene restituito questo risultato: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Esempio 2

Questo esempio suddivide una matrice in blocchi di lunghezza 5.

chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)

E viene restituito questo risultato: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

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. Nota: la lunghezza del risultato non deve superare 104.857.600 caratteri.

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 del fuso orario, vedere Fusi orari predefiniti di Microsoft Windows.
<format>	No	String	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

Valore restituito	Tipo	Descrizione
<converted-timestamp>	String	Timestamp convertito nel fuso orario di destinazione senza l'offset UTC del fuso orario.

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:00.0000000"

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 del fuso orario, vedi Fusi orari predefiniti di Microsoft Windows, ma potrebbe essere necessario rimuovere qualsiasi punteggiatura dal nome del fuso orario.
<destinationTimeZone>	Sì	String	Nome del fuso orario di destinazione. Per i nomi del fuso orario, vedi Fusi orari predefiniti di Microsoft Windows, ma potrebbe essere necessario rimuovere qualsiasi punteggiatura dal nome del fuso orario.
<format>	No	String	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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-01T80: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 del fuso orario, vedi Fusi orari predefiniti di Microsoft Windows, ma potrebbe essere necessario rimuovere qualsiasi punteggiatura dal nome del fuso orario.
<format>	No	String	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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"]

D

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"

dateDifference

Restituisce la differenza tra due timestamp come intervallo di tempo. Questa funzione sottrae startDate da endDatee restituisce il risultato come timestamp in formato stringa.

dateDifference('<startDate>', '<endDate>')

Parametro	Richiesto	Type	Descrizione
<startDate>	Sì	String	Stringa contenente un timestamp
<endDate>	Sì	String	Stringa contenente un timestamp

Valore restituito	Tipo	Descrizione
<timespan>	String	Differenza tra i due timestamp, ovvero un timestamp in formato stringa. Se startDate è più recente di endDate, il risultato è un valore negativo.

Esempio

In questo esempio viene sottratto il primo valore dal secondo valore:

dateDifference('2015-02-08', '2018-07-30')

E viene restituito questo risultato: "1268.00:00:00"

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: 4

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

decimale

Restituisce un numero decimale in una stringa come numero decimale. È possibile usare questa funzione quando si usano dati che richiedono precisione decimale e anche come input per funzioni di confronto logiche e funzioni matematiche. Per acquisire e mantenere la precisione quando si usa il risultato della funzione decimal(), eseguire il wrapping di qualsiasi output decimale con la funzione stringa. Questo utilizzo è illustrato negli esempi seguenti in cui è possibile perdere precisione se si usa il risultato decimale come numero.

decimal('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Numero decimale in una stringa

Valore restituito	Tipo	Descrizione
<decimal>	Numero decimale	Numero decimale per la stringa di input

Esempio 1

In questo esempio viene creato un separatore decimale usato come numero:

decimal('1.2345678912312131') // Returns 1.234567891231213.

Esempio 2

Questo esempio crea un decimale e quindi converte il risultato in una stringa per la conservazione della precisione:

string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".

Esempio 3

Questo esempio usa una funzione matematica su due numeri decimali e usa il risultato come numero:

add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.

Esempio 4

Questo esempio usa una funzione matematica su due numeri decimali e converte il risultato in una stringa per la conservazione della precisione:

string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".

decodeBase64 (deprecata)

Questa funzione è deprecata, quindi usare invece base64ToString().

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:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

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('https%3A%2F%2Fcontoso.com')

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

div

Restituisce il risultato 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 il dividendo, ma non può essere zero

Valore restituito	Tipo	Descrizione
<quotient-result>	Integer o float	Risultato della divisione del primo numero per il secondo numero. Se il dividendo o il divisore ha tipo Float, il risultato ha tipo Float. Nota: per convertire il risultato float in un numero intero, provare a creare e chiamare una funzione in Azure dall'app per la logica.

Esempio 1

Entrambi gli esempi restituiscono questo valore con tipo Integer: 2

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

Esempio 2

Entrambi gli esempi restituiscono questo valore con tipo Float: 2.2

div(11,5.0)
div(11.0,5)

E

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: "https%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.

F

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. È possibile usare questa funzione solo quando si passano parametri personalizzati a un'app, ad esempio un flusso di lavoro dell'app per la logica o un flusso di Power Automate. Per convertire stringhe a virgola mobile rappresentate in formati specifici delle impostazioni locali, è possibile specificare facoltativamente un codice delle impostazioni locali RFC 4646.

float('<value>', '<locale>'?)

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa con un numero a virgola mobile valido da convertire. I valori minimo e massimo corrispondono ai limiti per il tipo di dati float.
<impostazioni locali>	No	String	Codice delle impostazioni locali RFC 4646 da usare. Se non specificato, vengono utilizzate le impostazioni locali predefinite. Se le impostazioni locali non sono un valore valido, viene generato un errore che indica che le impostazioni locali specificate non sono valide o non hanno impostazioni locali associate.

Valore restituito	Tipo	Descrizione
<float-value>	Float	Numero a virgola mobile per la stringa specificata. I valori minimo e massimo corrispondono ai limiti per il tipo di dati float.

Esempio 1

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

float('10,000.333')

E viene restituito questo risultato: 10000.333

Esempio 2

In questo esempio viene creata una versione stringa per questo numero a virgola mobile in stile tedesco:

float('10.000,333', 'de-DE')

E viene restituito questo risultato: 10000.333

formatDateTime

Restituisce un timestamp nel formato specificato.

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

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<format>	No	String	Stringa di formato numerico che è un singolo identificatore di formato o un 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.
<impostazioni locali>	No	String	Impostazioni locali da usare. Se non specificato, il valore è en-us. Se le impostazioni locali non sono un valore valido, viene generato un errore.

Valore restituito	Tipo	Descrizione
<reformatted-timestamp>	String	Timestamp aggiornato nel formato e nelle impostazioni locali specificate, se specificato.

Esempi

formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.

formDataMultiValues

Restituisce una matrice con i valori corrispondenti a un nome di chiave nell'output di dati del modulo o codifica per il modulo di un'azione.

formDataMultiValues('<actionName>', '<key>')

Parametro	Richiesto	Type	Descrizione
<actionName>	Sì	String	Azione il cui output include il valore della chiave desiderato
<key>	Sì	String	Nome della chiave di cui si vuole ottenere il valore

Valore restituito	Tipo	Descrizione
[<array-with-key-values>]	Array	Matrice con tutti i valori che corrispondono alla chiave specificata

Esempio

Questo esempio crea una matrice dal valore della chiave "Subject" nell'output di dati del modulo o codifica per il modulo dell'azione specificata:

formDataMultiValues('Send_an_email', 'Subject')

E restituisce il testo dell'oggetto in una matrice, ad esempio: ["Hello world"]

formDataValue

Restituisce un singolo valore corrispondente a un nome di chiave nell'output di dati del modulo o codifica per il modulo di un'azione. Se la funzione trova più corrispondenze, genera un errore.

formDataValue('<actionName>', '<key>')

Parametro	Richiesto	Type	Descrizione
<actionName>	Sì	String	Azione il cui output include il valore della chiave desiderato
<key>	Sì	String	Nome della chiave di cui si vuole ottenere il valore

Valore restituito	Tipo	Descrizione
<key-value>	String	Valore nella chiave specificata

Esempio

Questo esempio crea una stringa dal valore della chiave "Subject" nell'output di dati del modulo o codifica per il modulo dell'azione specificata:

formDataValue('Send_an_email', 'Subject')

E restituisce il testo dell'oggetto come stringa, ad esempio: "Hello world"

formatNumber

Restituisce un numero come stringa in base al formato specificato.

formatNumber(<number>, <format>, <locale>?)

Parametro	Richiesto	Type	Descrizione
<number>	Sì	Intero o doppio	Valore che si desidera per il formato.
<format>	Sì	String	Stringa in formato composto che specifica il formato che si desidera usare. Per le stringhe in formato numerico supportate, vedere Stringhe in formato numerico standard, che sono supportate da number.ToString(<format>, <locale>).
<impostazioni locali>	No	String	Impostazioni locali da usare come supportate da number.ToString(<format>, <locale>). Se non specificato, il valore è en-us. Se le impostazioni locali non sono un valore valido, viene generato un errore.

Valore restituito	Tipo	Descrizione
<formatted-number>	String	Numero specificato come stringa nel formato specificato. È possibile eseguire il cast di questo valore restituito in int o float.

Esempio 1

Si supponga di voler formattare il numero 1234567890. Questo esempio formatta il numero come stringa "1.234.567.890,00".

formatNumber(1234567890, '0,0.00', 'en-us')

*Esempio 2"

Si supponga di voler formattare il numero 1234567890. Questo esempio formatta il numero come stringa "1.234.567.890,00".

formatNumber(1234567890, '0,0.00', 'is-is')

Esempio 3

Si supponga di voler formattare il numero 17.35. Questo esempio formatta il numero come stringa "$17,35".

formatNumber(17.35, 'C2')

Esempio 4

Si supponga di voler formattare il numero 17.35. Questo esempio formatta il numero come stringa "17,35 kr".

formatNumber(17.35, 'C2', 'is-is')

G

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 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. Se il formato non è un valore valido, viene generato un errore che indica che il formato specificato non è valido e deve essere una stringa di formato numerico.

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. Se il formato non è un valore valido, viene generato un errore che indica che il formato specificato non è valido e deve essere una stringa di formato numerico.

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)"

I

if

Verifica se un'espressione è true o false. In base al risultato, restituisce un valore specificato. I parametri sono valutati da sinistra a destra.

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

Convertire la versione stringa per un numero intero in un numero intero effettivo.

int('<value>')

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Versione stringa per l'intero da convertire. I valori minimo e massimo corrispondono ai limiti per il tipo di dati Integer.

Valore restituito	Tipo	Descrizione
<integer-result>	Intero	Versione integer per la stringa specificata. I valori minimo e massimo corrispondono ai limiti per il tipo di dati Integer.

Esempio

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

int('10')

E viene restituito questo risultato: 10

isFloat

Restituisce un valore booleano che indica se una stringa è un numero a virgola mobile. Per impostazione predefinita, questa funzione usa le impostazioni cultura invarianti per il formato a virgola mobile. Per identificare i numeri a virgola mobile rappresentati in altri formati specifici delle impostazioni locali, è possibile specificare facoltativamente un codice delle impostazioni locali RFC 4646.

isFloat('<string>', '<locale>'?)

Parametro	Richiesto	Type	Descrizione
<value>	Sì	String	Stringa da esaminare
<impostazioni locali>	No	String	Codice delle impostazioni locali RFC 4646 da usare

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Valore booleano che indica se la stringa è un numero a virgola mobile

Esempio 1

In questo esempio viene verificato se una stringa è un numero a virgola mobile nelle impostazioni cultura invarianti:

isFloat('10,000.00')

E viene restituito questo risultato: true

Esempio 2

In questo esempio viene verificato se una stringa è un numero a virgola mobile nelle impostazioni locali tedesche:

isFloat('10.000,00', 'de-DE')

E viene restituito questo risultato: true

isInt

Restituisce un valore booleano che indica se una stringa è un numero intero.

isInt('<string>')

Parametro	Richiesto	Type	Descrizione
<string>	Sì	String	Stringa da esaminare

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Valore booleano che indica se la stringa è un numero intero

Esempio

In questo esempio viene verificato se una stringa è un numero intero:

isInt('10')

E viene restituito questo risultato: true

oggetto

Quando la funzione viene usata all'interno di un'azione ripetuta su una matrice, restituisce l'elemento corrente nella matrice durante l'iterazione corrente dell'azione. È anche possibile ottenere i valori dalle proprietà dell'elemento.

item()

Valore restituito	Tipo	Descrizione
<current-array-item>	Any	Elemento corrente nella matrice per l'iterazione corrente dell'azione

Esempio

Questo esempio ottiene l'elemento body dal messaggio corrente per l'azione "Send_an_email" all'interno dell'iterazione corrente di un ciclo for-each:

item().body

articoli

Restituisce l'elemento corrente da ogni ciclo in un ciclo for-each. Usare questa funzione all'interno del ciclo for-each.

items('<loopName>')

Parametro	Richiesto	Type	Descrizione
<loopName>	Sì	String	Nome del ciclo for-each

Valore restituito	Tipo	Descrizione
<item>	Any	Elemento del ciclo corrente nel ciclo for-each specificato

Esempio

Questo esempio ottiene l'elemento corrente dal ciclo for-each specificato:

items('myForEachLoopName')

iterationIndexes

Restituisce il valore di indice per l'iterazione corrente all'interno del ciclo Until. È possibile usare questa funzione all'interno di cicli Until annidati.

iterationIndexes('<loopName>')

Parametro	Richiesto	Type	Descrizione
<loopName>	Sì	String	Nome del ciclo Until

Valore restituito	Tipo	Descrizione
<index>	Intero	Il valore di indice per l'iterazione corrente all'interno del ciclo Until specificato

Esempio

Questo esempio crea una variabile contatore e la incrementa di uno durante ogni iterazione in un ciclo Until fino a quando il valore del contatore non raggiunge cinque. L'esempio crea anche una variabile che tiene traccia dell'indice corrente per ogni iterazione. Durante ogni iterazione nel ciclo Until, l'esempio incrementa il valore del contatore e quindi assegna il valore del contatore al valore di indice corrente e quindi incrementa il valore del contatore. Nel ciclo questo esempio fa riferimento all'indice di iterazione corrente usando la funzione iterationIndexes:

iterationIndexes('Until_Max_Increment')

{
   "actions": {
      "Create_counter_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [ 
               {
                  "name": "myCounter",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {}
      },
      "Create_current_index_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [
               {
                  "name": "myCurrentLoopIndex",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {
            "Create_counter_variable": [ "Succeeded" ]
         }
      },
      "Until_Max_Increment": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "Compose": {
               "inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
               "runAfter": {
                  "Assign_current_index_to_counter": [
                     "Succeeded"
                    ]
                },
                "type": "Compose"
            },           
            "Increment_variable": {
               "type": "IncrementVariable",
               "inputs": {
                  "name": "myCounter",
                  "value": 1
               },
               "runAfter": {}
            }
         },
         "expression": "@equals(variables('myCounter'), 5)",
         "limit": {
            "count": 60,
            "timeout": "PT1H"
         },
         "runAfter": {
            "Create_current_index_variable": [ "Succeeded" ]
         }
      }
   }
}

J

JSON

Restituisce il valore del tipo JSON (JavaScript Object Notation), l'oggetto o la matrice di oggetti per una stringa o XML.

json('<value>')
json(xml('value'))

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

Valore restituito	Tipo	Descrizione
<JSON-result>	Tipo nativo JSON, oggetto o matrice	Valore del tipo nativo JSON, oggetto o matrice di oggetti della stringa di input o XML. - Se si passa xml con un singolo elemento figlio nell'elemento radice, la funzione restituisce un singolo oggetto JSON per tale elemento figlio. - Se si passa xml con più elementi figlio nell'elemento radice, la funzione restituisce una matrice che contiene oggetti JSON per tali elementi figlio. - Se la stringa è Null, la funzione restituisce un oggetto vuoto.

Esempio 1

Questo esempio converte questa stringa in un 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 usa le json() funzioni e xml() per convertire xml con un singolo elemento figlio nell'elemento radice in un oggetto JSON denominato person per l'elemento figlio:

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"
      }
   }
}

Esempio 4

Questo esempio usa le json() funzioni e xml() per convertire xml con più elementi figlio nell'elemento radice in una matrice denominata person che contiene oggetti JSON per tali elementi figlio:

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

E viene restituito questo risultato:

{
   "?xml": {
      "@version": "1.0"
   },
   "root": {
      "person": [
         {
            "@id": "1",
            "name": "Sophia Owen",
            "occupation": "Engineer"
         },
         {
            "@id": "2",
            "name": "John Doe",
            "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. Nota: la lunghezza del risultato non deve superare 104.857.600 caratteri.

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"

L

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 il valore stringa o sottostringa è vuoto, si verifica il comportamento seguente:

• Se solo il valore stringa è vuoto, la funzione restituisce -1.

• Se i valori stringa e sottostringa sono entrambi vuoti, la funzione restituisce 0.

• Se solo il valore della sottostringa è vuoto, la funzione restituisce la lunghezza della stringa meno 1.

Esempi

In questo esempio viene trovato il valore di indice iniziale per l'ultima occorrenza della sottostringa della sottostringa world nella stringa hello world hello world. Il risultato restituito è 18:

lastIndexOf('hello world hello world', 'world')

In questo esempio manca il parametro di sottostringa e restituisce un valore perché 22 il valore della stringa di input (23) meno 1 è maggiore di 0.

lastIndexOf('hello world hello world', '')

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

listCallbackUrl

Restituisce l'"URL di callback" che chiama un trigger o un'azione. Questa funzione può essere usata solo con i trigger e le azioni per i tipi di connettore HttpWebhook e ApiConnectionWebhook, ma non con i tipi Manual, Recurrence, HTTP e APIConnection.

listCallbackUrl()

Valore restituito	Tipo	Descrizione
<callback-URL>	String	URL di callback per un trigger o un'azione

Esempio

Questo esempio mostra un URL di callback di esempio che questa funzione potrebbe restituire:

"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"

M

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 il dividendo, ma non può essere zero

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

Esempio 1

Questo esempio divide il primo numero per il secondo numero:

mod(3, 2)

E viene restituito questo risultato: 1

Esempio 2

Questo esempio mostra che se uno o entrambi i valori sono negativi, il risultato corrisponde al segno del dividendo:

mod(-5, 2)
mod(4, -3)

L'esempio restituisce questi risultati:

• Primo esempio: -1
• Secondo esempio: 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

multipartBody

Restituisce il corpo per una parte specifica dell'output di un'azione con più parti.

multipartBody('<actionName>', <index>)

Parametro	Richiesto	Type	Descrizione
<actionName>	Sì	String	Nome per l'azione che ha un output con più parti
<index>	Sì	Intero	Valore di indice per la parte desiderata

Valore restituito	Tipo	Descrizione
<body>	String	Corpo per la parte specificata

N

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.

nthIndexOf

Restituisce la posizione iniziale o il valore di indice in cui l'n occorrenza di una sottostringa viene visualizzata in una stringa.

nthIndexOf('<text>', '<searchText>', <occurrence>)

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa contenente la sottostringa da trovare
<searchText>	Sì	String	Sottostringa da trovare
<occurrence>	Sì	Intero	Numero che specifica l'n occorrenza della sottostringa da trovare. Se l'occorrenza è negativa, iniziare la ricerca dalla fine.

Valore restituito	Tipo	Descrizione
<index-value>	Intero	Posizione iniziale o valore di indice per l'n occorrenza della sottostringa specificata. Se la sottostringa non viene trovata o minore di n occorrenze della sottostringa, restituire -1.

Esempi

nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.

O

or

Verifica se almeno un'espressione è true. Restituisce true se almeno un'espressione è true o false se tutte 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 tutte 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.

outputs

Restituisce l'output di un'azione nel runtime.

outputs('<actionName>')

Parametro	Richiesto	Type	Descrizione
<actionName>	Sì	String	Nome per l'output dell'azione desiderato

Valore restituito	Tipo	Descrizione
<output>	String	Output dell'azione specificata

Esempio

Questo esempio ottiene l'output dall'azione Get userX :

outputs('Get_user')

E viene restituito questo risultato:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

P

parameters

Restituisce il valore per un parametro descritto nella definizione del flusso di lavoro.

parameters('<parameterName>')

Parametro	Richiesto	Type	Descrizione
<parameterName>	Sì	String	Nome del parametro di cui si vuole ottenere il valore

Valore restituito	Tipo	Descrizione
<parameter-value>	Any	Valore del parametro specificato

Esempio

Si supponga di avere questo valore JSON:

{
  "fullName": "Sophia Owen"
}

Questo esempio ottiene il valore per il parametro specificato:

parameters('fullName')

E viene restituito questo risultato: "Sophia Owen"

parseDateTime

Restituisce il timestamp da una stringa contenente un timestamp.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)

Parametro	Richiesto	Type	Descrizione
<timestamp>	Sì	String	Stringa contenente il timestamp
<impostazioni locali>	No	String	Impostazioni locali da usare. Se non specificato, le impostazioni locali predefinite sono en-us. Se le impostazioni locali non sono un valore valido, viene generato un errore.
<format>	No	String	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è specificato, provare ad analizzare con più formati compatibili con le impostazioni locali specificate. Se il formato non è un valore valido, viene generato un errore.

Valore restituito	Tipo	Descrizione
<parsed-timestamp>	String	Timestamp analizzato in formato "o" (aaaa-MM-ggTHH:mm:ss.fffffffK), conforme a ISO 8601 e mantiene le informazioni sul fuso orario.

Esempi

parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

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 della matrice. Il valore del count parametro deve essere un numero intero positivo che non supera 100.000. Nota: la somma dei startIndex valori e count non deve superare 2.147.483.647.

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]

removeProperty

Rimuove una proprietà da un oggetto e restituisce l'oggetto aggiornato. Se la proprietà che si tenta di rimuovere non esiste, la funzione restituisce l'oggetto originale.

removeProperty(<object>, '<property>')

Parametro	Richiesto	Type	Descrizione
<object>	Sì	Object	Oggetto JSON da cui si vuole rimuovere una proprietà
<property>	Sì	String	Nome della proprietà da rimuovere

Valore restituito	Tipo	Descrizione
<updated-object>	Object	Oggetto JSON aggiornato senza la proprietà specificata

Per rimuovere una proprietà figlio da una proprietà esistente, usare questa sintassi:

removeProperty(<object>['<parent-property>'], '<child-property>')

Parametro	Richiesto	Type	Descrizione
<object>	Sì	Object	Oggetto JSON di cui si vuole rimuovere la proprietà
<parent-property>	Sì	String	Nome della proprietà padre con la proprietà figlio che si desidera rimuovere
<child-property>	Sì	String	Nome della proprietà figlio da rimuovere

Valore restituito	Tipo	Descrizione
<updated-object>	Object	Oggetto JSON aggiornato la cui proprietà figlio è stata rimossa

Esempio 1

Questo esempio rimuove la proprietà middleName da un oggetto JSON, di cui viene eseguita la conversione da stringa a JSON con la funzione JSON() e restituisce l'oggetto aggiornato:

removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')

Ecco l'oggetto JSON corrente:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Ecco l'oggetto JSON aggiornato:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Esempio 2

Questo esempio rimuove la proprietà figlio middleName da una proprietà padre customerName in un oggetto JSON, di cui viene eseguita la conversione da stringa a JSON con la funzione JSON() e restituisce l'oggetto aggiornato:

removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')

Ecco l'oggetto JSON corrente:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

Ecco l'oggetto JSON aggiornato:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

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"

result

Restituisce i risultati delle azioni di primo livello nell'azione con ambito specificata, ad esempio un'azione For_each, Untilo Scope . La result() funzione accetta un singolo parametro, ovvero il nome dell'ambito, e restituisce una matrice che contiene informazioni dalle azioni di primo livello nell'ambito. Questi oggetti azione includono gli stessi attributi degli attributi restituiti dalla actions() funzione, ad esempio l'ora di inizio dell'azione, l'ora di fine, lo stato, gli input, gli ID di correlazione e gli output.

Ad esempio, è possibile usare questa funzione per ottenere i risultati da azioni non riuscite in modo da poter diagnosticare e gestire le eccezioni. Per altre informazioni, vedere Ottenere il contesto e i risultati per gli errori.

result('<scopedActionName>')

Parametro	Richiesto	Type	Descrizione
<scopedActionName>	Sì	String	Nome dell'azione con ambito in cui si desidera che gli input e gli output delle azioni di primo livello all'interno di tale ambito

Valore restituito	Tipo	Descrizione
<array-object>	Oggetto matrice	Matrice che contiene matrici di input e output di ogni azione di primo livello all'interno dell'ambito specificato

Esempio

Questo esempio restituisce gli input e gli output di ogni iterazione di un'azione HTTP all'interno di un For_each ciclo usando la result() funzione nell'azione Compose :

{
   "actions": {
      "Compose": {
         "inputs": "@result('For_each')",
         "runAfter": {
            "For_each": [
               "Succeeded"
            ]
         },
         "type": "compose"
      },
      "For_each": {
         "actions": {
            "HTTP": {
               "inputs": {
                  "method": "GET",
                  "uri": "https://httpstat.us/200"
               },
               "runAfter": {},
               "type": "Http"
            }
         },
         "foreach": "@triggerBody()",
         "runAfter": {},
         "type": "Foreach"
      }
   }
}

Ecco come può apparire la matrice restituita di esempio, dove l'oggetto outputs esterno contiene gli input e gli output di ogni iterazione delle azioni all'interno dell'azione For_each.

[
   {
      "name": "HTTP",
      "outputs": [
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
               "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         },
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
            "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         }
      ]
   }
]

ordinamento inverso

Invertire l'ordine degli elementi in una raccolta. Quando si usa questa funzione con sort(), è possibile ordinare una raccolta in ordine decrescente.

reverse([<collection>])

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	Array	Raccolta da invertire

Valore restituito	Tipo	Descrizione
[<updated-collection>]	Array	Raccolta invertita

Esempio

Questo esempio inverte una matrice di numeri interi:

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

E restituisce questa matrice: [3,2,1,0]

S

setProperty

Imposta il valore per la proprietà dell'oggetto JSON e restituisce l'oggetto aggiornato. Se la proprietà che si tenta di impostare non esiste,viene aggiunta all'oggetto. Per aggiungere una nuova proprietà, usare la funzione addProperty().

setProperty(<object>, '<property>', <value>)

Parametro	Richiesto	Type	Descrizione
<object>	Sì	Object	Oggetto JSON di cui si vuole impostare la proprietà
<property>	Sì	String	Nome per la proprietà nuova o esistente da impostare
<value>	Sì	Qualsiasi	Valore da impostare per la proprietà specificata

Per impostare la proprietà figlio in un oggetto figlio, usare invece una chiamata setProperty() annidata. Altrimenti, la funzione restituisce solo l'oggetto figlio come output.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))

Parametro	Richiesto	Type	Descrizione
<object>	Sì	Object	Oggetto JSON di cui si vuole impostare la proprietà
<parent-property>	Sì	String	Nome della proprietà padre con la proprietà figlio che si desidera impostare
<child-property>	Sì	String	Nome della proprietà figlio da impostare
<value>	Sì	Qualsiasi	Valore da impostare per la proprietà specificata

Valore restituito	Tipo	Descrizione
<updated-object>	Object	Oggetto JSON aggiornato di cui si imposta la proprietà

Esempio 1

Questo esempio imposta la proprietà surName in un oggetto JSON, di cui viene eseguita la conversione da stringa a JSON con la funzione JSON(). La funzione assegna il valore specificato alla proprietà e restituisce l'oggetto aggiornato:

setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')

Ecco l'oggetto JSON corrente:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Ecco l'oggetto JSON aggiornato:

{
   "firstName": "Sophia",
   "surName": "Hartnett"
}

Esempio 2

Questo esempio imposta la proprietà figlio surName per la proprietà padre customerName in un oggetto JSON, di cui viene eseguita la conversione da stringa a JSON con la funzione JSON(). La funzione assegna il valore specificato alla proprietà e restituisce l'oggetto aggiornato:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))

Ecco l'oggetto JSON corrente:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Owen"
   }
}

Ecco l'oggetto JSON aggiornato:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Hartnett"
   }
}

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]

slice

Restituisce una sottostringa specificando la posizione iniziale e finale o il valore. Vedere anche sottostring().

slice('<text>', <startIndex>, <endIndex>?)

Parametro	Richiesto	Type	Descrizione
<Testo>	Sì	String	Stringa contenente la sottostringa da trovare
<startIndex>	Sì	Intero	Posizione iniziale o valore in base zero per cui iniziare la ricerca della sottostringa - Se startIndex è maggiore della lunghezza della stringa, restituisce una stringa vuota. - Se startIndex è negativo, iniziare a cercare il valore di indice che corrisponde alla somma della lunghezza della stringa e di startIndex.
<endIndex>	No	Intero	Posizione finale in base zero o valore per dove terminare la ricerca della sottostringa. Il carattere che si trova in corrispondenza del valore dell'indice finale non è incluso nella ricerca. - Se endIndex non è specificato o maggiore della lunghezza della stringa, cercare fino alla fine della stringa. - Se endIndex è negativo, terminare la ricerca nel valore di indice che la somma della lunghezza della stringa e dell'endIndex.

Valore restituito	Tipo	Descrizione
<slice-result>	String	Nuova stringa contenente la sottostringa trovata

Esempi

slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.

ordinamento

Ordinare gli elementi in una raccolta. È possibile ordinare gli oggetti raccolta usando qualsiasi chiave contenente un tipo semplice.

sort([<collection>], <sortBy>?)

Parametro	Richiesto	Type	Descrizione
<collection>	Sì	Array	Raccolta con gli elementi da ordinare
<sortBy>	No	String	Chiave da utilizzare per l'ordinamento degli oggetti raccolta

Valore restituito	Tipo	Descrizione
[<updated-collection>]	Array	Raccolta ordinata

Esempio 1

In questo esempio viene ordinata una matrice di numeri interi:

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

E restituisce questa matrice: [0,1,2,3]

Esempio 2

In questo esempio viene ordinata una matrice di oggetti in base alla chiave:

sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')

E restituisce questa matrice: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

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 1

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"]

Esempio 2

Questo esempio crea una matrice con un singolo elemento quando non esiste alcun delimitatore nella stringa:

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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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

Esempio 1

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"

Esempio 2

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

startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')

E viene restituito questo risultato: "2018-03-01"

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. Se questo valore è Null o restituisce null, il valore viene convertito in una stringa vuota (""). Ad esempio, se si assegna una variabile stringa a una proprietà inesistente, accessibile con l'operatore ? , il valore Null viene convertito in una stringa vuota. Tuttavia, il confronto di un valore Null non equivale al confronto di una stringa vuota.

Valore restituito	Tipo	Descrizione
<string-value>	String	Versione stringa per il valore specificato. Se il parametro value è null o restituisce null, questo valore viene restituito come valore stringa vuota ("").

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. Vedere anche slice().

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>	No	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	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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"

T

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 numero di tick, ovvero intervalli di 100 nanosecondi, a partire dal 1° gennaio, 0001 12:00:00 mezzanotte (o DateTime.Ticks in C#) fino al timestamp specificato. Per altre informazioni, vedere questo argomento: Proprietà DateTime.Ticks (System).

ticks('<timestamp>')

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

Valore restituito	Tipo	Descrizione
<ticks-number>	Intero	Numero di tick dal timestamp specificato

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"

trigger

Restituisce l'output di un trigger in fase di esecuzione oppure i valori di altre coppie nome-valore JSON che è possibile assegnare a un'espressione.

• All'interno degli input di un trigger, questa funzione restituisce l'output dell'esecuzione precedente.

• All'interno di una condizione di un trigger, questa funzione restituisce l'output dell'esecuzione precedente.

Per impostazione predefinita, questa funzione fa riferimento all'intero oggetto trigger, ma è possibile specificare una proprietà con il valore desiderato. Per questa funzione sono anche disponibili le versioni a sintassi abbreviata. Vedere triggerOutputs() e triggerBody().

trigger()

Valore restituito	Tipo	Descrizione
<trigger-output>	String	Output di un trigger in fase di esecuzione

triggerBody

Restituisce l'oggetto body di output di un trigger in fase di esecuzione. Sintassi abbreviata per trigger().outputs.body. Vedere trigger().

triggerBody()

Valore restituito	Tipo	Descrizione
<trigger-body-output>	String	Oggetto body di output del trigger

triggerFormDataMultiValues

Restituisce una matrice con i valori corrispondenti a un nome di chiave nell'output di dati del modulo o codifica per il modulo di un trigger.

triggerFormDataMultiValues('<key>')

Parametro	Richiesto	Type	Descrizione
<key>	Sì	String	Nome della chiave di cui si vuole ottenere il valore

Valore restituito	Tipo	Descrizione
[<array-with-key-values>]	Array	Matrice con tutti i valori che corrispondono alla chiave specificata

Esempio

Questo esempio crea una matrice dal valore della chiave "feedUrl" nell'output di dati del modulo o codifica per il modulo di un trigger RSS:

triggerFormDataMultiValues('feedUrl')

E restituisce questa matrice come risultato di esempio: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Restituisce una stringa con un singolo valore corrispondente a un nome di chiave nell'output di dati del modulo o codifica per il modulo di un trigger. Se la funzione trova più corrispondenze, genera un errore.

triggerFormDataValue('<key>')

Parametro	Richiesto	Type	Descrizione
<key>	Sì	String	Nome della chiave di cui si vuole ottenere il valore

Valore restituito	Tipo	Descrizione
<key-value>	String	Valore nella chiave specificata

Esempio

Questo esempio crea una stringa dal valore della chiave "feedUrl" nell'output di dati del modulo o codifica per il modulo di un trigger RSS:

triggerFormDataValue('feedUrl')

E restituisce questa stringa come risultato di esempio: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Restituisce il corpo per una parte specifica dell'output di un trigger con più parti.

triggerMultipartBody(<index>)

Parametro	Richiesto	Type	Descrizione
<index>	Sì	Intero	Valore di indice per la parte desiderata

Valore restituito	Tipo	Descrizione
<body>	String	Corpo della parte specificata di un output a più parti di un trigger

triggerOutputs

Restituisce l'output di un trigger in fase di esecuzione o i valori di altre coppie nome-valore JSON. Sintassi abbreviata per trigger().outputs. Vedere trigger().

triggerOutputs()

Valore restituito	Tipo	Descrizione
<trigger-output>	String	Output di un trigger in fase di esecuzione

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"

U

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: "https%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('https%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('https%3A%2F%2Fcontoso.com')

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

uriHost

Restituisce il valore host per un URI (Uniform Resource Identifier).

uriHost('<uri>')

Parametro	Richiesto	Type	Descrizione
<uri>	Sì	String	URI di cui restituire il valore host

Valore restituito	Tipo	Descrizione
<host-value>	String	Valore host per l'URI specificato

Esempio

Questo esempio trova il valore host per questo URI:

uriHost('https://www.localhost.com:8080')

E viene restituito questo risultato: "www.localhost.com"

uriPath

Restituisce il valore path per un URI (Uniform Resource Identifier).

uriPath('<uri>')

Parametro	Richiesto	Type	Descrizione
<uri>	Sì	String	URI di cui restituire il valore path

Valore restituito	Tipo	Descrizione
<path-value>	String	Valore path per l'URI specificato. Se path non ha un valore, viene restituito il carattere "/".

Esempio

Questo esempio trova il valore path per questo URI:

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito questo risultato: "/catalog/shownew.htm"

uriPathAndQuery

Restituisce i valori path e query per un URI (Uniform Resource Identifier).

uriPathAndQuery('<uri>')

Parametro	Richiesto	Type	Descrizione
<uri>	Sì	String	URI di cui restituire i valori path e query

Valore restituito	Tipo	Descrizione
<path-query-value>	String	Valori path e query per l'URI specificato. Se path non specifica un valore, viene restituito il carattere "/".

Esempio

Questo esempio trova i valori path e query per questo URI:

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito questo risultato: "/catalog/shownew.htm?date=today"

uriPort

Restituisce il valore port per un URI (Uniform Resource Identifier).

uriPort('<uri>')

Parametro	Richiesto	Type	Descrizione
<uri>	Sì	String	URI di cui restituire il valore port

Valore restituito	Tipo	Descrizione
<port-value>	Intero	Valore port per l'URI specificato. Se port non specifica un valore, viene restituita la porta predefinita per il protocollo.

Esempio

Questo esempio restituisce il valore port per questo URI:

uriPort('https://www.localhost:8080')

E viene restituito questo risultato: 8080

uriQuery

Restituisce il valore query per un URI (Uniform Resource Identifier).

uriQuery('<uri>')

Parametro	Richiesto	Type	Descrizione
<uri>	Sì	String	URI di cui restituire il valore query

Valore restituito	Tipo	Descrizione
<query-value>	String	Valore query per l'URI specificato

Esempio

Questo esempio restituisce il valore query per questo URI:

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito questo risultato: "?date=today"

uriScheme

Restituisce il valore scheme per un URI (Uniform Resource Identifier).

uriScheme('<uri>')

Parametro	Richiesto	Type	Descrizione
<uri>	Sì	String	URI di cui restituire il valore scheme

Valore restituito	Tipo	Descrizione
<scheme-value>	String	Valore scheme per l'URI specificato

Esempio

Questo esempio restituisce il valore scheme per questo URI:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito questo risultato: "http"

utcNow

Restituisce il timestamp corrente.

utcNow('<format>')

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

Parametro	Richiesto	Type	Descrizione
<format>	No	String	Stringa di formato numerico che è un singolo identificatore di formato o un 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. Se il formato non è un valore valido, viene generato un errore.

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"

V

variabili

Restituisce il valore per una variabile specificata.

variables('<variableName>')

Parametro	Richiesto	Type	Descrizione
<variableName>	Sì	String	Nome della variabile di cui si vuole ottenere il valore

Valore restituito	Tipo	Descrizione
<variable-value>	Any	Valore della variabile specificata

Esempio

Si supponga che il valore corrente per una variabile "numItems" sia 20. Questo esempio ottiene il valore intero per questa variabile:

variables('numItems')

E viene restituito questo risultato: 20

W

workflow

Restituisce tutti i dettagli del flusso di lavoro stesso in fase di esecuzione.

workflow().<property>

Parametro	Richiesto	Type	Descrizione
<property>	No	String	Nome della proprietà del flusso di lavoro il cui valore si desidera Per impostazione predefinita, un oggetto flusso di lavoro ha queste proprietà: name, type, idlocation, run, e tags. - Il valore della run proprietà è un oggetto JSON che include queste proprietà: name, typee id. - La tags proprietà è un oggetto JSON che include tag associati all'app per la logica in App per la logica di Azure o flusso in Power Automate e i valori per tali tag. Per altre informazioni sui tag nelle risorse di Azure, vedere Contrassegna risorse, gruppi di risorse e sottoscrizioni per l'organizzazione logica in Azure. Nota: per impostazione predefinita, un'app per la logica non ha tag, ma un flusso di Power Automate ha i flowDisplayName tag e environmentName .

Esempio 1

Questo esempio restituisce il nome dell'esecuzione corrente di un flusso di lavoro:

workflow().run.name

Esempio 2

Se si usa Power Automate, è possibile creare un'espressione @workflow() che usa la tags proprietà di output per ottenere i valori dalla proprietà o environmentName del flowDisplayName flusso.

Ad esempio, è possibile inviare notifiche di posta elettronica personalizzate dal flusso stesso che si collegano di nuovo al flusso. Queste notifiche possono includere un collegamento HTML che contiene il nome visualizzato del flusso nel titolo del messaggio di posta elettronica e segue questa sintassi:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

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

In questo esempio la stringa viene convertita in XML:

xml('<name>Sophia Owen</name>')

E viene restituito questo elemento XML:

<name>Sophia Owen</name>

Esempio 2

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 3

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

Si supponga di avere questa 'items' stringa XML:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

In questo esempio viene passata l'espressione XPath, '/produce/item/name/text()', per trovare i nodi che corrispondono al <name></name> nodo nella 'items' stringa XML e restituisce una matrice con tali valori di nodo:

xpath(xml(parameters('items')), '/produce/item/name/text()')

Nell'esempio viene usata anche la funzione parameters() per ottenere la stringa XML da 'items' e convertire la stringa in formato XML usando la funzione xml().

Ecco la matrice di risultati popolata con i valori dei nodi che corrispondono <name></name>a :

[ Gala, Honeycrisp ]

Esempio 2

Nell'esempio 1 questo esempio passa nell'espressione XPath , '/produce/item/name[1]', per trovare il primo name elemento figlio dell'elemento item .

xpath(xml(parameters('items')), '/produce/item/name[1]')

Ecco il risultato: Gala

Esempio 3

Nell'esempio 1 questo esempio passa l'espressione XPath , '/produce/item/name[last()]', per trovare l'ultimo name elemento figlio dell'elemento item .

xpath(xml(parameters('items')), '/produce/item/name[last()]')

Ecco il risultato: Honeycrisp

Esempio 4

In questo esempio si supponga che la items stringa XML contenga anche gli attributi expired='true' e expired='false':

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

In questo esempio viene passata l'espressione XPath, '//name[@expired]', per trovare tutti gli name elementi con l'attributo expired :

xpath(xml(parameters('items')), '//name[@expired]')

Ecco il risultato: [ Gala, Honeycrisp ]

Esempio 5

In questo esempio si supponga che la items stringa XML contenga solo questo attributo, expired = 'true':

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

In questo esempio viene passata l'espressione XPath, '//name[@expired = 'true']', per trovare tutti gli name elementi con l'attributo , expired = 'true':

xpath(xml(parameters('items')), '//name[@expired = 'true']')

Ecco il risultato: [ Gala ]

Esempio 6

In questo esempio si supponga che la items stringa XML contenga anche questi attributi:

• expired='true' price='12'
• expired='false' price='40'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true' price='12'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false' price='40'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

In questo esempio viene passata l'espressione XPath, '//name[@price>35]', per trovare tutti gli name elementi con price > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

Ecco il risultato: Honeycrisp

Esempio 7

In questo esempio si supponga che la items stringa XML sia uguale a quella dell'esempio 1:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Questo esempio trova nodi che corrispondono al <count></count> nodo e aggiunge tali valori di nodo con la sum() funzione :

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

Ecco il risultato: 30

Esempio 8

In questo esempio si supponga di avere questa stringa XML, che include lo spazio dei nomi del documento XML, xmlns="https://contoso.com":

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

Queste espressioni usano un'espressione XPath o /*[name()="file"]/*[name()="location"] /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], per trovare nodi che corrispondono al <location></location> nodo. Questi esempi illustrano la sintassi usata nella finestra di progettazione o nell'editor di espressioni:

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

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

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

Esempio 9

Nell'esempio 8 questo esempio usa l'espressione XPath , 'string(/*[name()="file"]/*[name()="location"])', per trovare il valore nel <location></location> nodo :

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

Ecco il risultato: Paris

Passaggi successivi

Leggere altre informazioni sul linguaggio di definizione del flusso di lavoro