Schema del linguaggio di definizione del flusso di lavoro per App per la logica di AzureWorkflow Definition Language schema for Azure Logic Apps

Una definizione del flusso di lavoro contiene la logica effettiva che viene eseguita come parte dell'app per la logica.A workflow definition contains the actual logic that executes as a part of your logic app. Questa definizione include uno o più trigger che avviano l'app per la logica e una o più azioni che devono essere eseguite dall'app per la logica.This definition includes one or more triggers that start the logic app, and one or more actions for the logic app to take.

Struttura di base della definizione del flusso di lavoroBasic workflow definition structure

Ecco la struttura di base di una definizione del flusso di lavoro:Here is the basic structure of a workflow definition:

{
    "$schema": "<schema-of the-definition>",
    "contentVersion": "<version-number-of-definition>",
    "parameters": { <parameter-definitions-of-definition> },
    "triggers": [ { <definition-of-flow-triggers> } ],
    "actions": [ { <definition-of-flow-actions> } ],
    "outputs": { <output-of-definition> }
}

Nota

La documentazione su Workflow Management REST API (API REST per la gestione dei flussi di lavoro) include informazioni su come creare e gestire i flussi di lavoro delle app per la logica.The Workflow Management REST API documentation has information on how to create and manage logic app workflows.

Nome dell'elementoElement name ObbligatorioRequired DescrizioneDescription
$schema$schema NoNo Specifica il percorso del file dello schema JSON che descrive la versione del linguaggio della definizione.Specifies the location for the JSON schema file that describes the version of the definition language. Questo percorso è obbligatorio quando si fa riferimento esternamente a una definizione.This location is required when you reference a definition externally. Per questo documento il percorso è:For this document, the location is:

https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2015-08-01-preview/workflowdefinition.json#

contentVersioncontentVersion NoNo Specifica la versione della definizione.Specifies the definition version. Quando si distribuisce un flusso di lavoro tramite la definizione, è possibile usare questo valore per assicurarsi che venga usata la definizione corretta.When you deploy a workflow using the definition, you can use this value to make sure that the right definition is used.
parametersparameters NoNo Specifica i parametri usati per inserire dati nella definizione.Specifies parameters used to input data into the definition. È possibile definire un massimo di 50 parametri.A maximum of 50 parameters can be defined.
triggertriggers NoNo Specifica le informazioni per i trigger che avviano il flusso di lavoro.Specifies information for the triggers that initiate the workflow. È possibile definire un massimo di 10 trigger.A maximum of 10 triggers can be defined.
Azioniactions NoNo Specifica le azioni effettuate durante l'esecuzione del flusso.Specifies actions that are taken as the flow executes. È possibile definire un massimo di 250 azioni.A maximum of 250 actions can be defined.
outputsoutputs NoNo Specifica le informazioni sulla risorsa distribuita.Specifies information about the deployed resource. È possibile definire un massimo di 10 output.A maximum of 10 outputs can be defined.

ParametriParameters

Questa sezione specifica tutti i parametri che vengono usati nella definizione del flusso di lavoro in fase di distribuzione.This section specifies all the parameters that are used in the workflow definition at deployment time. Tutti i parametri devono essere dichiarati in questa sezione prima di potere essere usati in altre sezioni della definizione.All parameters must be declared in this section before they can be used in other sections of the definition.

L'esempio seguente illustra la struttura di una definizione di parametro:The following example shows the structure of a parameter definition:

"parameters": {
    "<parameter-name>" : {
        "type" : "<type-of-parameter-value>",
        "defaultValue": <default-value-of-parameter>,
        "allowedValues": [ <array-of-allowed-values> ],
        "metadata" : { "key": { "name": "value"} }
    }
}
Nome dell'elementoElement name ObbligatorioRequired DescrizioneDescription
typetype Yes Tipo: stringType: string

Dichiarazione: "parameters": {"parameter1": {"type": "string"}Declaration: "parameters": {"parameter1": {"type": "string"}

Specifiche: "parameters": {"parameter1": {"value": "myparamvalue1"}}Specification: "parameters": {"parameter1": {"value": "myparamvalue1"}}

Tipo: securestringType: securestring

Dichiarazione: "parameters": {"parameter1": {"type": "securestring"}}Declaration: "parameters": {"parameter1": {"type": "securestring"}}

Specifiche: "parameters": {"parameter1": {"value": "myparamvalue1"}}Specification: "parameters": {"parameter1": {"value": "myparamvalue1"}}

Tipo: intType: int

Dichiarazione: "parameters": {"parameter1": {"type": "int"}}Declaration: "parameters": {"parameter1": {"type": "int"}}

Specifiche: "parameters": {"parameter1": {"value" : 5}}Specification: "parameters": {"parameter1": {"value" : 5}}

Tipo: boolType: bool

Dichiarazione: "parameters": {"parameter1": {"type": "bool"}}Declaration: "parameters": {"parameter1": {"type": "bool"}}

Specifiche: "parameters": {"parameter1": { "value": true }}Specification: "parameters": {"parameter1": { "value": true }}

Tipo: arrayType: array

Dichiarazione: "parameters": {"parameter1": {"type": "array"}}Declaration: "parameters": {"parameter1": {"type": "array"}}

Specifiche: "parameters": {"parameter1": { "value": [ array-of-values ]}}Specification: "parameters": {"parameter1": { "value": [ array-of-values ]}}

Tipo: objectType: object

Dichiarazione: "parameters": {"parameter1": {"type": "object"}}Declaration: "parameters": {"parameter1": {"type": "object"}}

Specifiche: "parameters": {"parameter1": { "value": { JSON-object } }}Specification: "parameters": {"parameter1": { "value": { JSON-object } }}

Tipo: secureobjectType: secureobject

Dichiarazione: "parameters": {"parameter1": {"type": "object"}}Declaration: "parameters": {"parameter1": {"type": "object"}}

Specifiche: "parameters": {"parameter1": { "value": { JSON-object } }}Specification: "parameters": {"parameter1": { "value": { JSON-object } }}

Nota: i tipi securestring e secureobject non vengono restituiti nelle operazioni GET.Note: The securestring and secureobject types are not returned in GET operations. Tutte le password, le chiavi e i segreti devono usare questo tipo.All passwords, keys, and secrets should use this type.

defaultValuedefaultValue NoNo Specifica il valore predefinito per il parametro quando non viene specificato alcun valore durante la creazione della risorsa.Specifies the default value for the parameter when no value is specified at the time the resource is created.
allowedValuesallowedValues NoNo Specifica una matrice di valori consentiti per il parametro.Specifies an array of allowed values for the parameter.
metadatametadata NoNo Specifica informazioni aggiuntive sul parametro, ad esempio una descrizione leggibile o dati relativi alla fase di progettazione usati da Visual Studio o da altri strumenti.Specifies additional information about the parameter, such as a readable description or design-time data used by Visual Studio or other tools.

Questo esempio mostra come usare un parametro nella sezione del corpo di un'azione:This example shows how you can use a parameter in the body section of an action:

"body" :
{
  "property1": "@parameters('parameter1')"
}

I parametri possono essere usati anche negli output.Parameters can also be used in outputs.

Trigger e azioniTriggers and actions

I trigger e le azioni specificano le chiamate che possono partecipare all'esecuzione del flusso di lavoro.Triggers and actions specify the calls that can participate in workflow execution. Per informazioni dettagliate su questa sezione, vedere Workflow Actions and Triggers (Azioni e trigger dei flussi di lavoro).For details about this section, see Workflow Actions and Triggers.

outputsOutputs

Gli output specificano le informazioni che possono essere restituite da un'esecuzione del flusso di lavoro.Outputs specify information that can be returned from a workflow run. Se ad esempio si vuole tenere traccia di uno stato o di un valore specifico per ogni esecuzione, è possibile includere tali dati negli output dell'esecuzione.For example, if you have a specific status or value that you want to track for each run, you can include that data in the run outputs. I dati vengono visualizzati nell'API REST di gestione per tale esecuzione e nell'interfaccia utente di gestione per l'esecuzione nel portale di Azure.The data appears in the Management REST API for that run, and in the management UI for that run in the Azure portal. È anche possibile passare questi output ad altri sistemi esterni come PowerBI per la creazione di dashboard.You can also flow these outputs to other external systems like PowerBI for creating dashboards. Gli output non vengono usati per rispondere a richieste in ingresso nell'API REST del servizio.Outputs are not used to respond to incoming requests on the Service REST API. Per rispondere a una richiesta in ingresso usando il tipo di azione response, ecco un esempio:To respond to an incoming request using the response action type, here's an example:

"outputs": {  
  "key1": {  
    "value": "value1",  
    "type" : "<type-of-value>"  
  }  
} 
Nome dell'elementoElement name ObbligatorioRequired DescrizioneDescription
key1key1 Yes Specifica l'identificatore chiave per l'output.Specifies the key identifier for the output. Sostituire key1 con un nome da usare per identificare l'output.Replace key1 with a name that you want to use to identify the output.
valuevalue Yes Specifica il valore dell'output.Specifies the value of the output.
typetype Yes Specifica il tipo per il valore specificato.Specifies the type for the value that was specified. Ecco alcuni tipi possibili di valori:Possible types of values are:
  • string
  • securestring
  • int
  • bool
  • array
  • object

EspressioniExpressions

I valori JSON nella definizione possono essere letterali o possono essere espressioni che vengono valutate quando viene usata la definizione.JSON values in the definition can be literal, or they can be expressions that are evaluated when the definition is used. Ad esempio:For example:

"name": "value"

oppureor

"name": "@parameters('password') "

Nota

Alcune espressioni ottengono i rispettivi valori dalle azioni di runtime che potrebbero non esistere all'inizio dell'esecuzione.Some expressions get their values from runtime actions that might not exist at the beginning of the execution. È possibile usare le funzioni per semplificare il recupero di alcuni di questi valori.You can use functions to help retrieve some of these values.

Le espressioni possono trovarsi in qualsiasi punto in un valore stringa JSON e restituiscono sempre un altro valore JSON.Expressions can appear anywhere in a JSON string value and always result in another JSON value. Quando un valore JSON è stato identificato come espressione, il corpo dell'espressione viene estratto rimuovendo il simbolo di chiocciola (@).When a JSON value has been determined to be an expression, the body of the expression is extracted by removing the at-sign (@). Se è necessaria una stringa letterale che inizia con @, occorre che la stringa sia preceduta da un carattere di escape con @@.If a literal string is needed that starts with @, that string must be escaped by using @@. L'esempio seguente illustra la modalità di valutazione delle espressioni.The following examples show how expressions are evaluated.

Valore JSONJSON value RisultatoResult
"parameters""parameters" Vengono restituiti i caratteri di tipo 'parameters'.The characters 'parameters' are returned.
"parameters[1]""parameters[1]" Vengono restituiti i caratteri di tipo 'parameters[1]'.The characters 'parameters[1]' are returned.
"@@"</span><span class="sxs-lookup">"@@" Viene restituita una stringa da 1 carattere che contiene '@'.</span><span class="sxs-lookup"><span data-stu-id="b63e5-221">A 1 character string that contains '@' is returned.
" @"</span><span class="sxs-lookup">" @" Viene restituita una stringa da 2 caratteri che contiene ' @'.</span><span class="sxs-lookup"><span data-stu-id="b63e5-223">A 2 character string that contains ' @' is returned.

Con l'interpolazione della stringa è possibile inserire le espressioni anche all'interno delle stringhe in cui viene eseguito il wrapping delle espressioni in @{ ... }.With string interpolation, expressions can also appear inside strings where expressions are wrapped in @{ ... }. Ad esempio:For example:

"name" : "First Name: @{parameters('firstName')} Last Name: @{parameters('lastName')}"

Il risultato è sempre una stringa. Questa funzionalità è quindi simile alla funzione concat.The result is always a string, which makes this feature similar to the concat function. Si supponga di avere definito myNumber come 42 e myString come sampleString:Suppose you defined myNumber as 42 and myString as sampleString:

Valore JSONJSON value RisultatoResult
"@parameters('myString')""@parameters('myString')" Restituisce sampleString come stringa.Returns sampleString as a string.
"@{parameters('myString')}""@{parameters('myString')}" Restituisce sampleString come stringa.Returns sampleString as a string.
"@parameters('myNumber')""@parameters('myNumber')" Restituisce 42 come numero.Returns 42 as a number.
"@{parameters('myNumber')}""@{parameters('myNumber')}" Restituisce 42 come stringa.Returns 42 as a string.
"Answer is: @{parameters('myNumber')}""Answer is: @{parameters('myNumber')}" Restituisce la stringa Answer is: 42.Returns the string Answer is: 42.
"@concat('Answer is: ', string(parameters('myNumber')))""@concat('Answer is: ', string(parameters('myNumber')))" Restituisce la stringa Answer is: 42.Returns the string Answer is: 42
"Answer is: @@{parameters('myNumber')}""Answer is: @@{parameters('myNumber')}" Restituisce la stringa Answer is: @{parameters('myNumber')}.Returns the string Answer is: @{parameters('myNumber')}.

OperatoriOperators

Gli operatori sono i caratteri che possono essere usati all'interno delle espressioni o delle funzioni.Operators are the characters that you can use inside expressions or functions.

operatoreOperator DescrizioneDescription
.. L'operatore punto consente di fare riferimento alle proprietà di un oggetto.The dot operator allows you to reference properties of an object
?? L'operatore punto interrogativo consente di fare riferimento alle proprietà Null di un oggetto senza un errore di runtime.The question mark operator lets you reference null properties of an object without a runtime error. È ad esempio possibile usare questa espressione per gestire gli output di trigger Null:For example, you can use this expression to handle null trigger outputs:

@coalesce(trigger().outputs?.body?.property1, 'my default value')

'' La virgoletta singola è l'unico modo per eseguire il wrapping dei valori letterali di stringa.The single quotation mark is the only way to wrap string literals. Non è possibile usare le virgolette doppie all'interno delle espressioni perché questo segno di punteggiatura è in conflitto con le virgolette JSON che eseguono il wrapping dell'intera espressione.You cannot use double-quotes inside expressions because this punctuation conflicts with the JSON quote that wraps the whole expression.
[][] Le parentesi quadre possono essere usate per ottenere un valore da una matrice con un indice specifico.The square brackets can be used to get a value from an array with a specific index. Se ad esempio è presente un'azione che passa range(0,10) alla funzione forEach, è possibile usare questa funzione per ottenere gli elementi dalle matrici:For example, if you have an action that passes range(0,10)in to the forEach function, you can use this function to get items out of arrays:

myArray[item()]

FunzioniFunctions

È anche possibile chiamare le funzioni all'interno delle espressioni.You can also call functions within expressions. La tabella seguente mostra le funzioni che possono essere usate in un'espressione.The following table shows the functions that can be used in an expression.

ExpressionExpression Versione di valutazioneEvaluation
"@function('Hello')""@function('Hello')" Chiama il membro funzione della definizione con la stringa letterale Hello come primo parametro.Calls the function member of the definition with the literal string Hello as the first parameter.
"@function('It''s Cool!')""@function('It''s Cool!')" Chiama il membro funzione della definizione con la stringa letterale 'It's Cool!'Calls the function member of the definition with the literal string 'It's Cool!' come primo parametro.as the first parameter
"@function().prop1""@function().prop1" Restituisce il valore della proprietà prop1 del membro myfunction della definizione.Returns the value of the prop1 property of the myfunction member of the definition.
"@function('Hello').prop1""@function('Hello').prop1" Chiama il membro funzione della definizione con la stringa letterale 'Hello' come primo parametro e restituisce la proprietà prop1 dell'oggetto.Calls the function member of the definition with the literal string 'Hello' as the first parameter and returns the prop1 property of the object.
"@function(parameters('Hello'))""@function(parameters('Hello'))" Valuta il parametro Hello e passa il valore alla funzione.Evaluates the Hello parameter and passes the value to function

Funzioni di riferimentoReferencing functions

È possibile usare queste funzioni per fare riferimento agli output da altre azioni nell'app per la logica o a valori passati durante la creazione dell'app per la logica.You can use these functions to reference outputs from other actions in the logic app or values passed in when the logic app was created. È ad esempio possibile fare riferimento ai dati di un passaggio per usarli in un altro.For example, you can reference the data from one step to use it in another.

Nome della funzioneFunction name DescrizioneDescription
parametersparameters Restituisce un valore di parametro definito nella definizione.Returns a parameter value that is defined in the definition.

parameters('password')

Numero di parametro: 1Parameter number: 1

Nome: ParameterName: Parameter

Descrizione: obbligatoria.Description: Required. Nome del parametro di cui si vogliono ottenere i valori.The name of the parameter whose values you want.

actionaction Consente a un'espressione di derivare il rispettivo valore da altre coppie nome/valore JSON o dall'output dell'azione di runtime corrente.Enables an expression to derive its value from other JSON name and value pairs or the output of the current runtime action. La proprietà rappresentata da propertyPath nell'esempio seguente è facoltativa.The property represented by propertyPath in the following example is optional. Se il valore propertyPath non è specificato, il riferimento è relativo all'intero oggetto action.If propertyPath is not specified, the reference is to the whole action object. Questa funzione può essere usata solo all'interno delle condizioni do-until di un'azione.This function can only be used inside do-until conditions of an action.

action().outputs.body.propertyPath

Azioniactions Consente a un'espressione di derivare il rispettivo valore da altre coppie nome/valore JSON o dall'output dell'azione di runtime.Enables an expression to derive its value from other JSON name and value pairs or the output of the runtime action. Queste espressioni dichiarano esplicitamente che un'azione dipende da un'altra azione.These expressions explicitly declare that one action depends on another action. La proprietà rappresentata da propertyPath nell'esempio seguente è facoltativa.The property represented by propertyPath in the following example is optional. Se il valore propertyPath non è specificato, il riferimento è relativo all'intero oggetto action.If propertyPath is not specified, the reference is to the whole action object. È possibile usare questo elemento o l'elemento conditions per specificare le dipendenze, ma non è necessario usare entrambi per la stessa risorsa dipendente.You can use either this element or the conditions element to specify dependencies, but you do not need to use both for the same dependent resource.

actions('myAction').outputs.body.propertyPath

Numero di parametro: 1Parameter number: 1

Nome: ActionNameName: Action name

Descrizione: obbligatoria.Description: Required. Nome dell'azione di cui si vogliono ottenere i valori.The name of the action whose values you want.

Le proprietà disponibili per l'oggetto azione sono:Available properties on the action object are:

  • name
  • startTime
  • endTime
  • inputs
  • outputs
  • status
  • code
  • trackingId
  • clientTrackingId

Per informazioni dettagliate su queste proprietà, vedere Rest API (API REST).See the Rest API for details on those properties.

triggertrigger Consente a un'espressione di derivare il rispettivo valore da altre coppie nome/valore JSON o dall'output del trigger di runtime.Enables an expression to derive its value from other JSON name and value pairs or the output of the runtime trigger. La proprietà rappresentata da propertyPath nell'esempio seguente è facoltativa.The property represented by propertyPath in the following example is optional. Se il valore propertyPath non è specificato, il riferimento è relativo all'intero oggetto trigger.If propertyPath is not specified, the reference is to the whole trigger object.

trigger().outputs.body.propertyPath

Quando viene usata all'interno degli input di un trigger, la funzione restituisce gli output dell'esecuzione precedente.When used inside a trigger's inputs, the function returns the outputs of the previous execution. Quando viene usata all'interno della condizione di un trigger, tuttavia, la funzione trigger restituisce gli output dell'esecuzione corrente.However, when used inside a trigger's condition, the trigger function returns the outputs of the current execution.

Le proprietà disponibili per l'oggetto trigger sono:Available properties on the trigger object are:

  • name
  • scheduledTime
  • startTime
  • endTime
  • inputs
  • outputs
  • status
  • code
  • trackingId
  • clientTrackingId

Per informazioni dettagliate su queste proprietà, vedere Rest API (API REST).See the Rest API for details on those properties.

actionOutputsactionOutputs Questa funzione è la sintassi abbreviata per actions('actionName').outputsThis function is shorthand for actions('actionName').outputs

Numero di parametro: 1Parameter number: 1

Nome: ActionNameName: Action name

Descrizione: obbligatoria.Description: Required. Nome dell'azione di cui si vogliono ottenere i valori.The name of the action whose values you want.

actionBody e bodyactionBody and body Queste funzioni sono la sintassi abbreviata per actions('actionName').outputs.bodyThese functions are shorthand for actions('actionName').outputs.body

Numero di parametro: 1Parameter number: 1

Nome: ActionNameName: Action name

Descrizione: obbligatoria.Description: Required. Nome dell'azione di cui si vogliono ottenere i valori.The name of the action whose values you want.

triggerOutputstriggerOutputs Questa funzione è la sintassi abbreviata per trigger().outputsThis function is shorthand for trigger().outputs
triggerBodytriggerBody Questa funzione è la sintassi abbreviata per trigger().outputs.bodyThis function is shorthand for trigger().outputs.body
itemitem Quando viene usata all'interno di un'azione ripetuta, questa funzione restituisce l'elemento che si trova nella matrice per questa iterazione dell'azione.When used inside a repeating action, this function returns the item that is in the array for this iteration of the action. Se ad esempio è presente un'azione che viene eseguita per ogni elemento in una matrice di messaggi, è possibile usare questa sintassi:For example, if you have an action that runs for each item an array of messages, you can use this syntax:

"input1" : "@item().subject"

Funzioni di raccoltaCollection functions

Queste funzioni operano sulle raccolte e in genere sono applicabili a matrici, stringhe e dizionari.These functions operate over collections and generally apply to Arrays, Strings, and sometimes Dictionaries.

Nome della funzioneFunction name DescrizioneDescription
containscontains Restituisce true se un dizionario contiene una chiave, se un elenco contiene un valore o se una stringa contiene una sottostringa.Returns true if dictionary contains a key, list contains value, or string contains substring. Ad esempio, questa funzione restituisce true:For example, this function returns true:

contains('abacaba','aca')

Numero di parametro: 1Parameter number: 1

Nome: WithinCollectionName: Within collection

Descrizione: obbligatoria.Description: Required. Raccolta in cui eseguire la ricerca.The collection to search within.

Numero di parametro: 2Parameter number: 2

Nome: FindObjectName: Find object

Descrizione: obbligatoria.Description: Required. Oggetto da trovare all'interno di WithinCollection.The object to find inside the Within collection.

lengthlength Restituisce il numero di elementi in una matrice o in una stringa.Returns the number of elements in an array or string. Ad esempio, questa funzione restituisce 3:For example, this function returns 3:

length('abc')

Numero di parametro: 1Parameter number: 1

Nome: CollectionName: Collection

Descrizione: obbligatoria.Description: Required. Raccolta per cui ottenere la lunghezza.The collection for which to get the length.

emptyempty Restituisce true se la matrice, la stringa o l'oggetto è vuoto.Returns true if object, array, or string is empty. Ad esempio, questa funzione restituisce true:For example, this function returns true:

empty('')

Numero di parametro: 1Parameter number: 1

Nome: CollectionName: Collection

Descrizione: obbligatoria.Description: Required. Raccolta da verificare se l'elemento è vuoto.The collection to check if it is empty.

intersezioneintersection Restituisce una singola matrice o un singolo oggetto con elementi comuni tra le matrici o gli oggetti passati.Returns a single array or object that has common elements between arrays or objects passed in. Ad esempio, questa funzione restituisce [1, 2]:For example, this function returns [1, 2]:

intersection([1, 2, 3], [101, 2, 1, 10],[6, 8, 1, 2])

I parametri per la funzione possono essere un set di oggetti o un set di matrici, non una combinazione di entrambi.The parameters for the function can either be a set of objects or a set of arrays (not a mixture of both). Se sono presenti due oggetti con lo stesso nome, l'ultimo oggetto con tale nome viene visualizzato nell'oggetto finale.If there are two objects with the same name, the last object with that name appears in the final object.

Numero parametro: 1 ... nParameter number: 1 ... n

Nome: Collection nName: Collection n

Descrizione: obbligatoria.Description: Required. Raccolte da valutare.The collections to evaluate. Un oggetto deve essere presente in tutte le raccolte passate per essere visualizzato nel risultato.An object must be in all collections passed in to appear in the result.

unionunion Restituisce una singola matrice o un singolo oggetto con tutti gli elementi che si trovano nella matrice o nell'oggetto passato a questa funzione.Returns a single array or object with all the elements that are in either array or object passed to this function. Ad esempio, questa funzione restituisce [1, 2, 3, 10, 101]:For example, this function returns [1, 2, 3, 10, 101]:

union([1, 2, 3], [101, 2, 1, 10])

I parametri per la funzione possono essere un set di oggetti o un set di matrici, non una combinazione di entrambi.The parameters for the function can either be a set of objects or a set of arrays (not a mixture thereof). Se sono presenti due oggetti con lo stesso nome nell'output finale, l'ultimo oggetto con tale nome viene visualizzato nell'oggetto finale.If there are two objects with the same name in the final output, the last object with that name appears in the final object.

Numero parametro: 1 ... nParameter number: 1 ... n

Nome: Collection nName: Collection n

Descrizione: obbligatoria.Description: Required. Raccolte da valutare.The collections to evaluate. Un oggetto che viene visualizzato in una delle raccolte viene visualizzato anche nel risultato.An object that appears in any of the collections also appears in the result.

firstfirst Restituisce il primo elemento nella matrice o nella stringa passata.Returns the first element in the array or string passed in. Ad esempio, questa funzione restituisce 0:For example, this function returns 0:

first([0,2,3])

Numero di parametro: 1Parameter number: 1

Nome: CollectionName: Collection

Descrizione: obbligatoria.Description: Required. Raccolta da cui ottenere il primo oggetto.The collection to take the first object from.

lastlast Restituisce l'ultimo elemento nella matrice o nella stringa passata.Returns the last element in the array or string passed in. Ad esempio, questa funzione restituisce 3:For example, this function returns 3:

last('0123')

Numero di parametro: 1Parameter number: 1

Nome: CollectionName: Collection

Descrizione: obbligatoria.Description: Required. Raccolta da cui ottenere l'ultimo oggetto.The collection to take the last object from.

taketake Restituisce i primi elementi Count dalla matrice o dalla stringa passata.Returns the first Count elements from the array or string passed in. Ad esempio, questa funzione restituisce [1, 2]:For example, this function returns [1, 2]:

take([1, 2, 3, 4], 2)

Numero di parametro: 1Parameter number: 1

Nome: CollectionName: Collection

Descrizione: obbligatoria.Description: Required. Raccolta da cui ottenere i primi oggetti Count.The collection from where to take the first Count objects.

Numero di parametro: 2Parameter number: 2

Nome: CountName: Count

Descrizione: obbligatoria.Description: Required. Numero di oggetti da ottenere da Collection.The number of objects to take from the Collection. Deve essere un intero positivo.Must be a positive integer.

skipskip Restituisce gli elementi nella matrice a partire dall'indice Count.Returns the elements in the array starting at index Count. Ad esempio, questa funzione restituisce [3, 4]:For example, this function returns [3, 4]:

skip([1, 2 ,3 ,4], 2)

Numero di parametro: 1Parameter number: 1

Nome: CollectionName: Collection

Descrizione: obbligatoria.Description: Required. Raccolta di cui ignorare i primi oggetti Count.The collection to skip the first Count objects from.

Numero di parametro: 2Parameter number: 2

Nome: CountName: Count

Descrizione: obbligatoria.Description: Required. Numero di oggetti da rimuovere dalla parte iniziale di Collection.The number of objects to remove from the front of Collection. Deve essere un intero positivo.Must be a positive integer.

joinjoin Restituisce una stringa con ogni elemento di una matrice unito da un delimitatore. Ad esempio questo valore restituisce "1,2,3,4":Returns a string with each item of an array joined by a delimiter, for example this returns "1,2,3,4":

join([1, 2, 3, 4], ',')

Numero di parametro: 1Parameter number: 1

Nome: CollectionName: Collection

Descrizione: obbligatoria.Description: Required. Raccolta di cui unire elementi.The collection to join items from.

Numero di parametro: 2Parameter number: 2

Nome: DelimiterName: Delimiter

Descrizione: obbligatoria.Description: Required. Stringa con cui delimitare gli elementi.The string to delimit items with.

Funzioni stringaString functions

Le funzioni seguenti sono applicabili solo alle stringhe.The following functions only apply to strings. È anche possibile usare alcune funzioni di raccolta sulle stringhe.You can also use some collection functions on strings.

Nome della funzioneFunction name DescrizioneDescription
concatconcat Combina un numero qualsiasi di stringhe.Combines any number of strings together. Se ad esempio il parametro 1 è p1, questa funzione restituisce somevalue-p1-somevalue:For example, if parameter 1 is p1, this function returns somevalue-p1-somevalue:

concat('somevalue-',parameters('parameter1'),'-somevalue')

Numero parametro: 1 ... nParameter number: 1 ... n

Nome: String nName: String n

Descrizione: obbligatoria.Description: Required. Stringhe da combinare in una singola stringa.The strings to combine into a single string.

substringsubstring Restituisce un sottoinsieme di caratteri da una stringa.Returns a subset of characters from a string. Ad esempio, questa funzione restituisce abc:For example, this function returns abc:

substring('somevalue-abc-somevalue',10,3)

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa da cui viene ottenuta la sottostringa.The string from which the substring is taken.

Numero di parametro: 2Parameter number: 2

Nome: StartIndexName: Start index

Descrizione: obbligatoria.Description: Required. Indice da cui inizia la sottostringa nel parametro 1.The index of where the substring begins in parameter 1.

Numero di parametro: 3Parameter number: 3

Nome: LengthName: Length

Descrizione: obbligatoria.Description: Required. Lunghezza della sottostringa.The length of the substring.

replacereplace Sostituisce una stringa con una stringa specifica.Replaces a string with a given string. Ad esempio, questa funzione restituisce the new string:For example, this function returns the new string:

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

Numero di parametro: 1Parameter number: 1

Nome: stringName: string

Descrizione: obbligatoria.Description: Required. Stringa in cui viene eseguita la ricerca del parametro 2 e che viene aggiornata con il parametro 3, quando il parametro 2 viene trovato nel parametro 1.The string that is searched for parameter 2 and updated with parameter 3, when parameter 2 is found in parameter 1.

Numero di parametro: 2Parameter number: 2

Nome: OldStringName: Old string

Descrizione: obbligatoria.Description: Required. Stringa da sostituire con il parametro 3 quando viene trovata una corrispondenza nel parametro 1.The string to replace with parameter 3, when a match is found in parameter 1

Numero di parametro: 3Parameter number: 3

Nome: NewStringName: New string

Descrizione: obbligatoria.Description: Required. Stringa usata per sostituire la stringa nel parametro 2 quando viene trovata una corrispondenza nel parametro 1.The string that is used to replace the string in parameter 2 when a match is found in parameter 1.

guidguid Questa funzione genera una stringa univoca globale (GUID).This function generates a globally unique string (GUID). Ad esempio, questa funzione può generare questo GUID: c2ecc88d-88c8-4096-912c-d6f2e2b138ceFor example, this function can generate this GUID: c2ecc88d-88c8-4096-912c-d6f2e2b138ce

guid()

Numero di parametro: 1Parameter number: 1

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Identificatore di formato singolo che indica come formattare il valore di questo GUID.A single format specifier that indicates how to format the value of this Guid. Il parametro format può essere "N", "D", "B", "P" o "X".The format parameter can be "N", "D", "B", "P", or "X". Se il valore format non viene specificato, viene usato "D".If format is not provided, "D" is used.

toLowertoLower Converte una stringa in lettere minuscole.Converts a string to lowercase. Ad esempio, questa funzione restituisce two by two is four:For example, this function returns two by two is four:

toLower('Two by Two is Four')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa da convertire in lettere minuscole.The string to convert to lower casing. Se un carattere nella stringa non ha un equivalente minuscolo, il carattere viene incluso senza modifiche nella stringa restituita.If a character in the string does not have a lowercase equivalent, the character is included unchanged in the returned string.

toUppertoUpper Converte una stringa in lettere maiuscole.Converts a string to uppercase. Ad esempio, questa funzione restituisce TWO BY TWO IS FOUR:For example, this function returns TWO BY TWO IS FOUR:

toUpper('Two by Two is Four')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa da convertire in lettere maiuscole.The string to convert to upper casing. Se un carattere nella stringa non ha un equivalente maiuscolo, il carattere viene incluso senza modifiche nella stringa restituita.If a character in the string does not have an uppercase equivalent, the character is included unchanged in the returned string.

indexofindexof Consente di trovare l'indice di un valore in una stringa senza distinzione tra maiuscole e minuscole.Find the index of a value within a string case insensitively. Ad esempio, questa funzione restituisce 7:For example, this function returns 7:

indexof('hello, world.', 'world')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa che potrebbe contenere il valore.The string that may contain the value.

Numero di parametro: 2Parameter number: 2

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Valore nel cui indice si vuole eseguire la ricerca.The value to search the index of.

lastindexoflastindexof Consente di trovare l'ultimo indice di un valore in una stringa senza distinzione tra maiuscole e minuscole.Find the last index of a value within a string case insensitively. Ad esempio, questa funzione restituisce 3:For example, this function returns 3:

lastindexof('foofoo', 'foo')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa che potrebbe contenere il valore.The string that may contain the value.

Numero di parametro: 2Parameter number: 2

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Valore nel cui indice si vuole eseguire la ricerca.The value to search the index of.

startswithstartswith Verifica se la stringa inizia con un valore senza distinzione tra maiuscole e minuscole.Checks if the string starts with a value case insensitively. Ad esempio, questa funzione restituisce true:For example, this function returns true:

startswith('hello, world', 'hello')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa che potrebbe contenere il valore.The string that may contain the value.

Numero di parametro: 2Parameter number: 2

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Valore con cui può iniziare la stringa.The value the string may start with.

endswithendswith Verifica se la stringa finisce con un valore senza distinzione tra maiuscole e minuscole.Checks if the string ends with a value case insensitively. Ad esempio, questa funzione restituisce true:For example, this function returns true:

endswith('hello, world', 'world')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa che potrebbe contenere il valore.The string that may contain the value.

Numero di parametro: 2Parameter number: 2

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Valore con cui può finire la stringa.The value the string may end with.

splitsplit Suddivide la stringa usando un separatore.Splits the string using a separator. Ad esempio, questa funzione restituisce ["a", "b", "c"]:For example, this function returns ["a", "b", "c"]:

split('a;b;c',';')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa suddivisa.The string that is split.

Numero di parametro: 2Parameter number: 2

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Separatore.The separator.

Funzioni logicheLogical functions

Queste funzioni sono utili all'interno delle condizioni e possono essere usate per valutare qualsiasi tipo di logica.These functions are useful inside conditions and can be used to evaluate any type of logic.

Nome della funzioneFunction name DescrizioneDescription
equalsequals Restituisce true se due valori sono uguali.Returns true if two values are equal. Se ad esempio parameter1 è someValue, questa funzione restituisce true:For example, if parameter1 is someValue, this function returns true:

equals(parameters('parameter1'), 'someValue')

Numero di parametro: 1Parameter number: 1

Nome: Object 1Name: Object 1

Descrizione: obbligatoria.Description: Required. Oggetto da confrontare a Object 2.The object to compare to Object 2.

Numero di parametro: 2Parameter number: 2

Nome: Object 2Name: Object 2

Descrizione: obbligatoria.Description: Required. Oggetto da confrontare a Object 1.The object to compare to Object 1.

lessless Restituisce true se il primo argomento è inferiore al secondo.Returns true if the first argument is less than the second. Si noti che i valori possono essere solo di tipo intero, a virgola mobile o stringa.Note, values can only be of type integer, float, or string. Ad esempio, questa funzione restituisce true:For example, this function returns true:

less(10,100)

Numero di parametro: 1Parameter number: 1

Nome: Object 1Name: Object 1

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è inferiore a Object 2.The object to check if it is less than Object 2.

Numero di parametro: 2Parameter number: 2

Nome: Object 2Name: Object 2

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è superiore a Object 1.The object to check if it is greater than Object 1.

lessOrEqualslessOrEquals Restituisce true se il primo argomento è inferiore o uguale al secondo.Returns true if the first argument is less than or equal to the second. Si noti che i valori possono essere solo di tipo intero, a virgola mobile o stringa.Note, values can only be of type integer, float, or string. Ad esempio, questa funzione restituisce true:For example, this function returns true:

lessOrEquals(10,10)

Numero di parametro: 1Parameter number: 1

Nome: Object 1Name: Object 1

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è inferiore o uguale a Object 2.The object to check if it is less or equal to Object 2.

Numero di parametro: 2Parameter number: 2

Nome: Object 2Name: Object 2

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è superiore o uguale a Object 1.The object to check if it is greater than or equal to Object 1.

greatergreater Restituisce true se il primo argomento è superiore al secondo.Returns true if the first argument is greater than the second. Si noti che i valori possono essere solo di tipo intero, a virgola mobile o stringa.Note, values can only be of type integer, float, or string. Ad esempio, questa funzione restituisce false:For example, this function returns false:

greater(10,10)

Numero di parametro: 1Parameter number: 1

Nome: Object 1Name: Object 1

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è superiore a Object 2.The object to check if it is greater than Object 2.

Numero di parametro: 2Parameter number: 2

Nome: Object 2Name: Object 2

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è inferiore a Object 1.The object to check if it is less than Object 1.

greaterOrEqualsgreaterOrEquals Restituisce true se il primo argomento è superiore o uguale al secondo.Returns true if the first argument is greater than or equal to the second. Si noti che i valori possono essere solo di tipo intero, a virgola mobile o stringa.Note, values can only be of type integer, float, or string. Ad esempio, questa funzione restituisce false:For example, this function returns false:

greaterOrEquals(10,100)

Numero di parametro: 1Parameter number: 1

Nome: Object 1Name: Object 1

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è superiore o uguale a Object 2.The object to check if it is greater than or equal to Object 2.

Numero di parametro: 2Parameter number: 2

Nome: Object 2Name: Object 2

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per verificare se è inferiore o uguale a Object 1.The object to check if it is less than or equal to Object 1.

eand Restituisce true se entrambi i parametri sono true.Returns true if both parameters are true. Entrambi gli argomenti devono essere valori booleani.Both arguments need to be Booleans. Ad esempio, questa funzione restituisce false:For example, this function returns false:

and(greater(1,10),equals(0,0))

Numero di parametro: 1Parameter number: 1

Nome: Boolean 1Name: Boolean 1

Descrizione: obbligatoria.Description: Required. Primo argomento, che deve essere true.The first argument that must be true.

Numero di parametro: 2Parameter number: 2

Nome: Boolean 2Name: Boolean 2

Descrizione: obbligatoria.Description: Required. Il secondo argomento deve essere true.The second argument must be true.

oppureor Restituisce true se uno dei parametri è true.Returns true if either parameter is true. Entrambi gli argomenti devono essere valori booleani.Both arguments need to be Booleans. Ad esempio, questa funzione restituisce true:For example, this function returns true:

or(greater(1,10),equals(0,0))

Numero di parametro: 1Parameter number: 1

Nome: Boolean 1Name: Boolean 1

Descrizione: obbligatoria.Description: Required. Primo argomento, che può essere true.The first argument that may be true.

Numero di parametro: 2Parameter number: 2

Nome: Boolean 2Name: Boolean 2

Descrizione: obbligatoria.Description: Required. Il secondo argomento può essere true.The second argument may be true.

notnot Restituisce true se i parametri sono false.Returns true if the parameters are false. Entrambi gli argomenti devono essere valori booleani.Both arguments need to be Booleans. Ad esempio, questa funzione restituisce true:For example, this function returns true:

not(contains('200 Success','Fail'))

Numero di parametro: 1Parameter number: 1

Nome: BooleanName: Boolean

Descrizione: restituisce true se i parametri sono false.Description: Returns true if the parameters are false. Entrambi gli argomenti devono essere valori booleani.Both arguments need to be Booleans. Questa funzione restituisce true: not(contains('200 Success','Fail'))This function returns true: not(contains('200 Success','Fail'))

ifif Restituisce un valore specificato in base al valore restituito dall'espressione, ovvero true o false.Returns a specified value based on whether the expression resulted in true or false. Ad esempio, questa funzione restituisce "yes":For example, this function returns "yes":

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

Numero di parametro: 1Parameter number: 1

Nome: ExpressionName: Expression

Descrizione: obbligatoria.Description: Required. Valore booleano che determina il valore che deve essere restituito dall'espressione.A boolean value that determines which value the expression should return.

Numero di parametro: 2Parameter number: 2

Nome: TrueName: True

Descrizione: obbligatoria.Description: Required. Valore da restituire se l'espressione è true.The value to return if the expression is true.

Numero di parametro: 3Parameter number: 3

Nome: FalseName: False

Descrizione: obbligatoria.Description: Required. Valore da restituire se l'espressione è false.The value to return if the expression is false.

Funzioni di conversioneConversion functions

Queste funzioni vengono usate per la conversione tra ogni tipo nativo nel linguaggio:These functions are used to convert between each of the native types in the language:

  • stringstring

  • numero interointeger

  • floatfloat

  • booleanboolean

  • matriciarrays

  • dizionaridictionaries

  • formforms

Nome della funzioneFunction name DescrizioneDescription
intint Converte il parametro in un valore intero.Convert the parameter to an integer. Ad esempio, questa funzione restituisce 100 sotto forma di numero, invece di una stringa:For example, this function returns 100 as a number, rather than a string:

int('100')

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore convertito in un valore intero.The value that is converted to an integer.

stringstring Converte il parametro in una stringa.Convert the parameter to a string. Ad esempio, questa funzione restituisce '10':For example, this function returns '10':

string(10)

È anche possibile convertire un oggetto in una stringa.You can also convert an object to a string. Se ad esempio il parametro myPar è un oggetto con una proprietà abc : xyz, questa funzione restituisce {"abc" : "xyz"}:For example, if the myPar parameter is an object with one property abc : xyz, then this function returns {"abc" : "xyz"}:

string(parameters('myPar'))

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore convertito in una stringa.The value that is converted to a string.

jsonjson Converte il parametro in un valore di tipo JSON ed è l'opposto di string().Convert the parameter to a JSON type value and is the opposite of string(). Ad esempio, questa funzione restituisce [1,2,3] come matrice, invece di una stringa:For example, this function returns [1,2,3] as an array, rather than a string:

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

È analogamente possibile convertire una stringa in un oggetto.Likewise, you can convert a string to an object. Ad esempio, questa funzione restituisce { "abc" : "xyz" }:For example, this function returns { "abc" : "xyz" }:

json('{"abc" : "xyz"}')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa convertita in un valore di tipo nativo.The string that is converted to a native type value.

La funzione json() supporta anche l'input XML.The json() function supports XML input too. Ad esempio, il valore del parametro di:For example, the parameter value of:

<?xml version="1.0"?> <root> <person id='1'> <name>Alan</name> <occupation>Engineer</occupation> </person> </root>

Viene convertito in JSON:is converted to this JSON:

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

floatfloat Converte l'argomento del parametro in un numero a virgola mobile.Convert the parameter argument to a floating-point number. Ad esempio, questa funzione restituisce 10.333:For example, this function returns 10.333:

float('10.333')

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore convertito in un numero a virgola mobile.The value that is converted to a floating-point number.

boolbool Converte il parametro in un valore booleano.Convert the parameter to a Boolean. Ad esempio, questa funzione restituisce false:For example, this function returns false:

bool(0)

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore convertito in un valore booleano.The value that is converted to a boolean.

base64base64 Restituisce la rappresentazione base64 della stringa di input.Returns the base64 representation of the input string. Ad esempio, questa funzione restituisce c29tZSBzdHJpbmc=:For example, this function returns c29tZSBzdHJpbmc=:

base64('some string')

Numero di parametro: 1Parameter number: 1

Nome: String 1Name: String 1

Descrizione: obbligatoria.Description: Required. Stringa da codificare nella rappresentazione con codifica Base64.The string to encode into base64 representation.

base64ToBinarybase64ToBinary Restituisce una rappresentazione binaria di una stringa con codifica Base64.Returns a binary representation of a base64 encoded string. Ad esempio, questa funzione restituisce la rappresentazione binaria di some string:For example, this function returns the binary representation of some string:

base64ToBinary('c29tZSBzdHJpbmc=')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa con codifica Base64.The base64 encoded string.

base64ToStringbase64ToString Restituisce una rappresentazione di stringa di una stringa con codifica Based64.Returns a string representation of a based64 encoded string. Ad esempio, questa funzione restituisce some string:For example, this function returns some string:

base64ToString('c29tZSBzdHJpbmc=')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa con codifica Base64.The base64 encoded string.

BinaryBinary Restituisce una rappresentazione binaria di un valore.Returns a binary representation of a value. Ad esempio, questa funzione restituisce una rappresentazione binaria di some string:For example, this function returns a binary representation of some string:

binary('some string')

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore convertito in un valore binario.The value that is converted to binary.

dataUriToBinarydataUriToBinary Restituisce una rappresentazione binaria di un URI di dati.Returns a binary representation of a data URI. Ad esempio, questa funzione restituisce la rappresentazione binaria di some string:For example, this function returns the binary representation of some string:

dataUriToBinary('data:;base64,c29tZSBzdHJpbmc=')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. URI di dati da convertire in una rappresentazione binaria.The data URI to convert to binary representation.

dataUriToStringdataUriToString Restituisce una rappresentazione di stringa di un URI di dati.Returns a string representation of a data URI. Ad esempio, questa funzione restituisce some string:For example, this function returns some string:

dataUriToString('data:;base64,c29tZSBzdHJpbmc=')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. URI di dati da convertire in una rappresentazione di tipo stringa.The data URI to convert to String representation.

dataUridataUri Restituisce un URI di dati di un valore.Returns a data URI of a value. Ad esempio, questa funzione restituisce questo URI di dati text/plain;charset=utf8;base64,c29tZSBzdHJpbmc=:For example, this function returns this data URI text/plain;charset=utf8;base64,c29tZSBzdHJpbmc=:

dataUri('some string')

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore da convertire in URI di dati.The value to convert to data URI.

decodeBase64decodeBase64 Restituisce una rappresentazione di stringa di una stringa di input con codifica Based64.Returns a string representation of an input based64 string. Ad esempio, questa funzione restituisce some string:For example, this function returns some string:

decodeBase64('c29tZSBzdHJpbmc=')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: restituisce una rappresentazione di stringa di una stringa di input con codifica Based64.Description: Returns a string representation of an input based64 string.

encodeUriComponentencodeUriComponent Aggiunge un URL come escape alla stringa passata.URL-escapes the string that's passed in. Ad esempio, questa funzione restituisce You+Are%3ACool%2FAwesome:For example, this function returns You+Are%3ACool%2FAwesome:

encodeUriComponent('You Are:Cool/Awesome')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa a cui aggiungere caratteri di escape per i caratteri non sicuri per gli URL.The string to escape URL-unsafe characters from.

decodeUriComponentdecodeUriComponent Rimuove i caratteri di escape per l'URL nella stringa passata.Un-URL-escapes the string that's passed in. Ad esempio, questa funzione restituisce You Are:Cool/Awesome:For example, this function returns You Are:Cool/Awesome:

encodeUriComponent('You+Are%3ACool%2FAwesome')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa da cui decodificare i caratteri non sicuri per gli URL.The string to decode the URL-unsafe characters from.

decodeDataUridecodeDataUri Restituisce una rappresentazione binaria di una stringa di URI di dati di input.Returns a binary representation of an input data URI string. Ad esempio, questa funzione restituisce la rappresentazione binaria di some string:For example, this function returns the binary representation of some string:

decodeDataUri('data:;base64,c29tZSBzdHJpbmc=')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Valore dataURI da decodificare in una rappresentazione binaria.The dataURI to decode into a binary representation.

uriComponenturiComponent Restituisce una rappresentazione con codifica URI di un valore.Returns a URI encoded representation of a value. Ad esempio, questa funzione restituisce You+Are%3ACool%2FAwesome:For example, this function returns You+Are%3ACool%2FAwesome:

uriComponent('You Are:Cool/Awesome')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa a cui applicare la codifica URI.The string to be URI encoded.

uriComponentToBinaryuriComponentToBinary Restituisce una rappresentazione binaria di una stringa con codifica URI.Returns a binary representation of a URI encoded string. Ad esempio, questa funzione restituisce una rappresentazione binaria di You Are:Cool/Awesome:For example, this function returns a binary representation of You Are:Cool/Awesome:

uriComponentToBinary('You+Are%3ACool%2FAwesome')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa con codifica URI.The URI encoded string.

uriComponentToStringuriComponentToString Restituisce una rappresentazione di stringa di una stringa con codifica URI.Returns a string representation of a URI encoded string. Ad esempio, questa funzione restituisce You Are:Cool/Awesome:For example, this function returns You Are:Cool/Awesome:

uriComponentToBinary('You+Are%3ACool%2FAwesome')

Numero di parametro: 1Parameter number: 1

Nome: StringName: String

Descrizione: obbligatoria.Description: Required. Stringa con codifica URI.The URI encoded string.

xmlxml Restituisce una rappresentazione XML del valore.Return an XML representation of the value. Ad esempio, questa funzione restituisce contenuto XML rappresentato da '\<name>Alan\</name>':For example, this function returns XML content represented by '\<name>Alan\</name>':

xml('\<name>Alan\</name>')

La funzione xml() supporta anche input di tipo oggetto JSON.The xml() function supports JSON object input too. Ad esempio, il parametro { "abc": "xyz" } viene convertito in contenuto XML: \<abc>xyz\</abc>For example, the parameter { "abc": "xyz" } is converted to XML content: \<abc>xyz\</abc>

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore da convertire in XML.The value to convert to XML.

arrayarray Converte il parametro in una matrice.Convert the parameter to an array. Ad esempio, questa funzione restituisce ["abc"]:For example, this function returns ["abc"]:

array('abc')

Numero di parametro: 1Parameter number: 1

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore convertito in una matrice.The value that is converted to an array.

createArraycreateArray Crea una matrice dai parametri.Creates an array from the parameters. Ad esempio, questa funzione restituisce ["a", "c"]:For example, this function returns ["a", "c"]:

createArray('a', 'c')

Numero parametro: 1 ... nParameter number: 1 ... n

Nome: Any nName: Any n

Descrizione: obbligatoria.Description: Required. Valori da combinare in una matrice.The values to combine into an array.

triggerFormDataValuetriggerFormDataValue Restituisce un singolo valore corrispondente al nome di chiave dall'output del trigger con dati di form o con codifica form.Returns a single value matching the key name from form-data or form-encoded trigger output. Se sono presenti più corrispondenze, verrà generato un errore.If there are multiple matches it will error. Ad esempio, il codice seguente restituirà bar: triggerFormDataValue('foo')For example, the following will return bar: triggerFormDataValue('foo')

Numero di parametro: 1Parameter number: 1

Nome: KeyNameName: Key Name

Descrizione: obbligatoria.Description: Required. Nome di chiave del valore di dati del form da restituire.The key name of the form data value to return.
triggerFormDataMultiValuestriggerFormDataMultiValues Restituisce una matrice di valori corrispondenti al nome di chiave dall'output del trigger con dati di form o con codifica form.Returns an array of values matching the key name from form-data or form-encoded trigger output. Ad esempio, il codice seguente restituirà ["bar"]: triggerFormDataValue('foo')For example, the following will return ["bar"]: triggerFormDataValue('foo')

Numero di parametro: 1Parameter number: 1

Nome: KeyNameName: Key Name

Descrizione: obbligatoria.Description: Required. Nome di chiave dei valori di dati del form da restituire.The key name of the form data values to return.
triggerMultipartBodytriggerMultipartBody Restituisce il corpo per una parte in un output a più parti del trigger.Returns the body for a part in a multipart output of the trigger.

Numero di parametro: 1Parameter number: 1

Nome: IndexName: Index

Descrizione: obbligatoria.Description: Required. Indice della parte da recuperare.The index of the part to retrieve.
formDataValueformDataValue Restituisce un singolo valore corrispondente al nome di chiave dall'output dell'azione con dati di form o con codifica form.Returns a single value matching the key name from form-data or form-encoded action output. Se sono presenti più corrispondenze, verrà generato un errore.If there are multiple matches it will error. Ad esempio, il codice seguente restituirà bar: formDataValue('someAction', 'foo')For example, the following will return bar: formDataValue('someAction', 'foo')

Numero di parametro: 1Parameter number: 1

Nome: ActionNameName: Action Name

Descrizione: obbligatoria.Description: Required. Nome dell'azione con una risposta di tipo con dati di form o con codifica form.The name of the action with a form-data or form-encoded response.

Numero di parametro: 2Parameter number: 2

Nome: KeyNameName: Key Name

Descrizione: obbligatoria.Description: Required. Nome di chiave del valore di dati del form da restituire.The key name of the form data value to return.
formDataMultiValuesformDataMultiValues Restituisce una matrice di valori corrispondenti al nome di chiave dall'output dell'azione con dati di form o con codifica form.Returns an array of values matching the key name from form-data or form-encoded action output. Ad esempio, il codice seguente restituirà ["bar"]: formDataMultiValues('someAction', 'foo')For example, the following will return ["bar"]: formDataMultiValues('someAction', 'foo')

Numero di parametro: 1Parameter number: 1

Nome: ActionNameName: Action Name

Descrizione: obbligatoria.Description: Required. Nome dell'azione con una risposta di tipo con dati di form o con codifica form.The name of the action with a form-data or form-encoded response.

Numero di parametro: 2Parameter number: 2

Nome: KeyNameName: Key Name

Descrizione: obbligatoria.Description: Required. Nome di chiave dei valori di dati del form da restituire.The key name of the form data values to return.
multipartBodymultipartBody Restituisce il corpo per una parte in un output a più parti di un'azione.Returns the body for a part in a multipart output of an action.

Numero di parametro: 1Parameter number: 1

Nome: ActionNameName: Action Name

Descrizione: obbligatoria.Description: Required. Nome dell'azione con una risposta a più parti.The name of the action with a multipart response.

Numero di parametro: 2Parameter number: 2

Nome: IndexName: Index

Descrizione: obbligatoria.Description: Required. Indice della parte da recuperare.The index of the part to retrieve.

Funzioni di manipolazioneManipulation functions

Queste funzioni si applicano a oggetti e XML.These functions apply to XML and objects.

Nome della funzioneFunction name DescrizioneDescription
coalescecoalesce Restituisce il primo oggetto non Null negli argomenti passati.Returns the first non-null object in the arguments passed in. Nota: una stringa vuota non è Null.Note: An empty string is not null. Se ad esempio i parametri 1 e 2 non sono definiti, questa funzione restituisce fallback:For example, if parameters 1 and 2 are not defined, this function returns fallback:

coalesce(parameters('parameter1'), parameters('parameter2') ,'fallback')

Numero parametro: 1 ... nParameter number: 1 ... n

Nome: ObjectnName: Objectn

Descrizione: obbligatoria.Description: Required. Oggetto da controllare per rilevare valori Null.The objects to check for null.

addPropertyaddProperty Restituisce un oggetto con una proprietà aggiuntiva.Returns an object with an additional property. Se la proprietà esiste già in fase di esecuzione verrà generato un errore.If the property already exists at runtime an error will be thrown. Ad esempio, questa funzione restituisce l'oggetto { "abc" : "xyz", "def": "uvw" }:For example, this function returns the object { "abc" : "xyz", "def": "uvw" }:

addProperty(json('{"abc" : "xyz"}'), 'def', 'uvw')

Numero di parametro: 1Parameter number: 1

Nome: ObjectName: Object

Descrizione: obbligatoria.Description: Required. Oggetto a cui aggiungere una nuova proprietà.The object to add a new property to.

Numero di parametro: 2Parameter number: 2

Nome: Property NameName: Property Name

Descrizione: obbligatoria.Description: Required. Nome della nuova proprietà.The name of the new property.

Numero di parametro: 3Parameter number: 3

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore da assegnare alla nuova proprietà.The value to assign to the new property.

setPropertysetProperty Restituisce un oggetto con un'altra proprietà o una proprietà esistente impostata sul valore specificato.Returns an object with an additional property or an existing property set to the given value. Ad esempio, questa funzione restituisce l'oggetto { "abc" : "uvw" }:For example, this function returns the object { "abc" : "uvw" }:

setProperty(json('{"abc" : "xyz"}'), 'abc', 'uvw')

Numero di parametro: 1Parameter number: 1

Nome: ObjectName: Object

Descrizione: obbligatoria.Description: Required. Oggetto in cui impostare la proprietà.The object in which to set the property.

Numero di parametro: 2Parameter number: 2

Nome: Property NameName: Property Name

Descrizione: obbligatoria.Description: Required. Nome della proprietà nuova o esistente.The name of the new or existing property.

Numero di parametro: 3Parameter number: 3

Nome: ValueName: Value

Descrizione: obbligatoria.Description: Required. Valore da assegnare alla proprietà.The value to assign to the property.

removePropertyremoveProperty Restituisce un oggetto con una proprietà rimossa.Returns an object with a property removed. Se la proprietà da rimuovere non esiste viene restituito l'oggetto originale.If the property to remove does not exist the original object is returned. Ad esempio, questa funzione restituisce l'oggetto { "abc" : "xyz" }:For example, this function returns the object { "abc" : "xyz" }:

removeProperty(json('{"abc" : "xyz", "def": "uvw"}'), 'def')

Numero di parametro: 1Parameter number: 1

Nome: ObjectName: Object

Descrizione: obbligatoria.Description: Required. Oggetto da cui rimuovere la proprietà.The object to remove the property from.

Numero di parametro: 2Parameter number: 2

Nome: Property NameName: Property Name

Descrizione: obbligatoria.Description: Required. Nome della proprietà da rimuovere.The name of the property to remove.

xpathxpath Restituisce una matrice di nodi XML corrispondenti all'espressione xpath di un valore restituito dall'espressione xpath.Return an array of XML nodes matching the xpath expression of a value that the xpath expression evaluates to.

Esempio 1Example 1

Si presupponga che il valore del parametro p1 sia una rappresentazione di stringa di questo XML:Assume the value of parameter p1 is a string representation of this XML:

<?xml version="1.0"?> <lab> <robot> <parts>5</parts> <name>R1</name> </robot> <robot> <parts>8</parts> <name>R2</name> </robot> </lab>

Questo codice: xpath(xml(parameters('p1')), '/lab/robot/name')This code: xpath(xml(parameters('p1')), '/lab/robot/name')

Restituiscereturns

[ <name>R1</name>, <name>R2</name> ]

Mentre questo codice:while this code:

xpath(xml(parameters('p1')), ' sum(/lab/robot/parts)')

Restituiscereturns

13

Esempio 2Example 2

Se è disponibile il contenuto XML seguente:Given the following XML content:

<?xml version="1.0"?> <File xmlns="http://foo.com"> <Location>bar</Location> </File>

Questo codice: @xpath(xml(body('Http')), '/*[name()=\"File\"]/*[name()=\"Location\"]')This code: @xpath(xml(body('Http')), '/*[name()=\"File\"]/*[name()=\"Location\"]')

O questo codice:or this code:

@xpath(xml(body('Http')), '/*[local-name()=\"File\" and namespace-uri()=\"http://foo.com\"]/*[local-name()=\"Location\" and namespace-uri()=\"\"]')

Restituiscereturns

<Location xmlns="http://abc.com">xyz</Location>

E questo codice: @xpath(xml(body('Http')), 'string(/*[name()=\"File\"]/*[name()=\"Location\"])')And this code: @xpath(xml(body('Http')), 'string(/*[name()=\"File\"]/*[name()=\"Location\"])')

Restituiscereturns

xyz

Numero di parametro: 1Parameter number: 1

Nome: XmlName: Xml

Descrizione: obbligatoria.Description: Required. Codice XML in base al quale valutare l'espressione XPath.The XML on which to evaluate the XPath expression.

Numero di parametro: 2Parameter number: 2

Nome: XPathName: XPath

Descrizione: obbligatoria.Description: Required. Espressione XPath da valutare.The XPath expression to evaluate.

Funzioni matematicheMath functions

Queste funzioni possono essere usate per qualsiasi tipo di numero, ovvero numeri interi e numeri a virgola mobile.These functions can be used for either types of numbers: integers and floats.

Nome della funzioneFunction name DescrizioneDescription
addadd Restituisce il risultato della somma di due numeri.Returns the result from adding the two numbers. Ad esempio, questa funzione restituisce 20.333:For example, this function returns 20.333:

add(10,10.333)

Numero di parametro: 1Parameter number: 1

Nome: Summand 1Name: Summand 1

Descrizione: obbligatoria.Description: Required. Numero da aggiungere a Summand 2.The number to add to Summand 2.

Numero di parametro: 2Parameter number: 2

Nome: Summand 2Name: Summand 2

Descrizione: obbligatoria.Description: Required. Numero da aggiungere a Summand 1.The number to add to Summand 1.

subsub Restituisce il risultato della sottrazione di due numeri.Returns the result from subtracting two numbers. Ad esempio, questa funzione restituisce -0.333:For example, this function returns -0.333:

sub(10,10.333)

Numero di parametro: 1Parameter number: 1

Nome: MinuendName: Minuend

Descrizione: obbligatoria.Description: Required. Numero da cui viene rimosso Subtrahend.The number that Subtrahend is removed from.

Numero di parametro: 2Parameter number: 2

Nome: SubtrahendName: Subtrahend

Descrizione: obbligatoria.Description: Required. Numero da rimuovere da Minuend.The number to remove from the Minuend.

mulmul Restituisce il risultato della moltiplicazione di due numeri.Returns the result from multiplying the two numbers. Ad esempio, questa funzione restituisce 103.33:For example, this function returns 103.33:

mul(10,10.333)

Numero di parametro: 1Parameter number: 1

Nome: Multiplicand 1Name: Multiplicand 1

Descrizione: obbligatoria.Description: Required. Numero per cui moltiplicare Multiplicand 2.The number to multiply Multiplicand 2 with.

Numero di parametro: 2Parameter number: 2

Nome: Multiplicand 2Name: Multiplicand 2

Descrizione: obbligatoria.Description: Required. Numero per cui moltiplicare Multiplicand 1.The number to multiply Multiplicand 1 with.

divdiv Restituisce il risultato della divisione di due numeri.Returns the result from dividing the two numbers. Ad esempio, questa funzione restituisce 1.0333:For example, this function returns 1.0333:

div(10.333,10)

Numero di parametro: 1Parameter number: 1

Nome: DividendName: Dividend

Descrizione: obbligatoria.Description: Required. Numero da dividere per il Divisor.The number to divide by the Divisor.

Numero di parametro: 2Parameter number: 2

Nome: DivisorName: Divisor

Descrizione: obbligatoria.Description: Required. Numero da dividere per Dividend.The number to divide the Dividend by.

modmod Restituisce il resto dopo la divisione di due numeri (modulo).Returns the remainder after dividing the two numbers (modulo). Ad esempio, questa funzione restituisce 2:For example, this function returns 2:

mod(10,4)

Numero di parametro: 1Parameter number: 1

Nome: DividendName: Dividend

Descrizione: obbligatoria.Description: Required. Numero da dividere per il Divisor.The number to divide by the Divisor.

Numero di parametro: 2Parameter number: 2

Nome: DivisorName: Divisor

Descrizione: obbligatoria.Description: Required. Numero da dividere per Dividend.The number to divide the Dividend by. Dopo la divisione, viene calcolato il resto.After the division, the remainder is taken.

Minmin Sono disponibili due modelli diversi per chiamare questa funzione.There are two different patterns for calling this function.

Il modello min accetta una matrice e la funzione restituisce 0:Here min takes an array, and the function returns 0:

min([0,1,2])

In alternativa, questa funzione può accettare un elenco di valori delimitato da virgole e restituisce 0:Alternatively, this function can take a comma-separated list of values and also returns 0:

min(0,1,2)

Nota: tutti i valori devono essere numeri, quindi se il parametro è una matrice, la matrice deve includere solo numeri.Note: All values must be numbers, so if the parameter is an array, the array has to only have numbers.

Numero di parametro: 1Parameter number: 1

Nome: Collection o ValueName: Collection or Value

Descrizione: obbligatoria.Description: Required. Matrice di valori di cui trovare il valore minimo oppure il primo valore di un set.Either an array of values to find the minimum value, or the first value of a set.

Numero di parametro: 2 ... nParameter number: 2 ... n

Nome: Value nName: Value n

Descrizione: facoltativa.Description: Optional. Se il primo parametro è di tipo Value, è possibile passare valori aggiuntivi e viene restituito il valore minimo tra tutti i valori passati.If the first parameter is a Value, then you can pass additional values and the minimum of all passed values is returned.

maxmax Sono disponibili due modelli diversi per chiamare questa funzione.There are two different patterns for calling this function.

Il modello max accetta una matrice e la funzione restituisce 2:Here max takes an array, and the function returns 2:

max([0,1,2])

In alternativa, questa funzione può accettare un elenco di valori delimitato da virgole e restituisce 2:Alternatively, this function can take a comma-separated list of values and also returns 2:

max(0,1,2)

Nota: tutti i valori devono essere numeri, quindi se il parametro è una matrice, la matrice deve includere solo numeri.Note: All values must be numbers, so if the parameter is an array, the array has to only have numbers.

Numero di parametro: 1Parameter number: 1

Nome: Collection o ValueName: Collection or Value

Descrizione: obbligatoria.Description: Required. Matrice di valori di cui trovare il valore massimo oppure primo valore di un set.Either an array of values to find the maximum value, or the first value of a set.

Numero di parametro: 2 ... nParameter number: 2 ... n

Nome: Value nName: Value n

Descrizione: facoltativa.Description: Optional. Se il primo parametro è di tipo Value, è possibile passare valori aggiuntivi e viene restituito il valore massimo tra tutti i valori passati.If the first parameter is a Value, then you can pass additional values and the maximum of all passed values is returned.

rangerange Genera una matrice di numeri interi a partire da un numero specifico.Generates an array of integers starting from a certain number. È possibile definire la lunghezza della matrice restituita.You define the length of the returned array.

Ad esempio, questa funzione restituisce [3,4,5,6]:For example, this function returns [3,4,5,6]:

range(3,4)

Numero di parametro: 1Parameter number: 1

Nome: StartIndexName: Start index

Descrizione: obbligatoria.Description: Required. Primo numero intero nella matrice.The first integer in the array.

Numero di parametro: 2Parameter number: 2

Nome: CountName: Count

Descrizione: obbligatoria.Description: Required. Numero di valori interi presenti nella matrice.This value is the number of integers that is in the array.

randrand Genera un numero intero casuale entro l'intervallo specificato, compreso solo il primo estremo.Generates a random integer within the specified range (inclusive only on first end). Ad esempio, questa funzione può restituire 0 o "1":For example, this function can return either 0 or '1':

rand(0,2)

Numero di parametro: 1Parameter number: 1

Nome: MinimumName: Minimum

Descrizione: obbligatoria.Description: Required. Numero intero più basso che può essere restituito.The lowest integer that can be returned.

Numero di parametro: 2Parameter number: 2

Nome: MaximumName: Maximum

Descrizione: obbligatoria.Description: Required. Questo valore è il numero intero successivo al numero intero più alto che può essere restituito.This value is the next integer after the highest integer that could be returned.

Funzioni di dataDate functions

Nome della funzioneFunction name DescrizioneDescription
utcnowutcnow Restituisce il timestamp corrente come stringa, ad esempio: 2017-03-15T13:27:36Z:Returns the current timestamp as a string, for example: 2017-03-15T13:27:36Z:

utcnow()

Numero di parametro: 1Parameter number: 1

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.

addsecondsaddseconds Aggiunge un numero intero di secondi a un timestamp di stringa passato.Adds an integer number of seconds to a string timestamp passed in. Il numero di secondi può essere positivo o negativo.The number of seconds can be positive or negative. Per impostazione predefinita, il risultato è una stringa in formato ISO 8601 ("o"), a meno che non venga fornito un identificatore di formato.By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. Ad esempio, 2015-03-15T13:27:00Z:For example: 2015-03-15T13:27:00Z:

addseconds('2015-03-15T13:27:36Z', -36)

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.A string that contains the time.

Numero di parametro: 2Parameter number: 2

Nome: SecondsName: Seconds

Descrizione: obbligatoria.Description: Required. Numero di secondi da aggiungere.The number of seconds to add. Può essere negativo per sottrarre secondi.Can be negative to subtract seconds.

Numero di parametro: 3Parameter number: 3

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.

addminutesaddminutes Aggiunge un numero intero di minuti a un timestamp di stringa passato.Adds an integer number of minutes to a string timestamp passed in. Il numero di minuti può essere positivo o negativo.The number of minutes can be positive or negative. Per impostazione predefinita, il risultato è una stringa in formato ISO 8601 ("o"), a meno che non venga fornito un identificatore di formato.By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. Ad esempio, 2015-03-15T14:00:36Z:For example: 2015-03-15T14:00:36Z:

addminutes('2015-03-15T13:27:36Z', 33)

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.A string that contains the time.

Numero di parametro: 2Parameter number: 2

Nome: MinutesName: Minutes

Descrizione: obbligatoria.Description: Required. Numero di minuti da aggiungere.The number of minutes to add. Può essere negativo per sottrarre minuti.Can be negative to subtract minutes.

Numero di parametro: 3Parameter number: 3

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.

addhoursaddhours Aggiunge un numero intero di ore a un timestamp di stringa passato.Adds an integer number of hours to a string timestamp passed in. Il numero di ore può essere positivo o negativo.The number of hours can be positive or negative. Per impostazione predefinita, il risultato è una stringa in formato ISO 8601 ("o"), a meno che non venga fornito un identificatore di formato.By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. Ad esempio, 2015-03-16T01:27:36Z:For example: 2015-03-16T01:27:36Z:

addhours('2015-03-15T13:27:36Z', 12)

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.A string that contains the time.

Numero di parametro: 2Parameter number: 2

Nome: HoursName: Hours

Descrizione: obbligatoria.Description: Required. Numero di ore da aggiungere.The number of hours to add. Può essere negativo per sottrarre ore.Can be negative to subtract hours.

Numero di parametro: 3Parameter number: 3

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.

adddaysadddays Aggiunge un numero intero di giorni a un timestamp di stringa passato.Adds an integer number of days to a string timestamp passed in. Il numero di giorni può essere positivo o negativo.The number of days can be positive or negative. Per impostazione predefinita, il risultato è una stringa in formato ISO 8601 ("o"), a meno che non venga fornito un identificatore di formato.By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. Ad esempio, 2015-02-23T13:27:36Z:For example: 2015-02-23T13:27:36Z:

adddays('2015-03-15T13:27:36Z', -2)

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.A string that contains the time.

Numero di parametro: 2Parameter number: 2

Nome: DaysName: Days

Descrizione: obbligatoria.Description: Required. Numero di giorni da aggiungere.The number of days to add. Può essere negativo per sottrarre giorni.Can be negative to subtract days.

Numero di parametro: 3Parameter number: 3

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.

formatDateTimeformatDateTime Restituisce una stringa con formato data.Returns a string in date format. Per impostazione predefinita, il risultato è una stringa in formato ISO 8601 ("o"), a meno che non venga fornito un identificatore di formato.By default, the result is a string in ISO 8601 format ("o"), unless a format specifier is provided. Ad esempio, 2015-02-23T13:27:36Z:For example: 2015-02-23T13:27:36Z:

formatDateTime('2015-03-15T13:27:36Z', 'o')

Numero di parametro: 1Parameter number: 1

Nome: DateName: Date

Descrizione: obbligatoria.Description: Required. Stringa contenente la data.A string that contains the date.

Numero di parametro: 2Parameter number: 2

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.

startOfHourstartOfHour Restituisce l'inizio dell'ora a un timestamp di stringa passato.Returns the start of the hour to a string timestamp passed in. Ad esempio, 2017-03-15T13:00:00Z:For example 2017-03-15T13:00:00Z:

startOfHour('2017-03-15T13:27:36Z')

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.This is a string that contains the time.

Numero di parametro: 2Parameter number: 2

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.
startOfDaystartOfDay Restituisce l'inizio della giornata a un timestamp di stringa passato.Returns the start of the day to a string timestamp passed in. Ad esempio, 2017-03-15T00:00:00Z:For example 2017-03-15T00:00:00Z:

startOfDay('2017-03-15T13:27:36Z')

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.This is a string that contains the time.

Numero di parametro: 2Parameter number: 2

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.
startOfMonthstartOfMonth Restituisce l'inizio del mese a un timestamp di stringa passato.Returns the start of the month to a string timestamp passed in. Ad esempio, 2017-03-01T00:00:00Z:For example 2017-03-01T00:00:00Z:

startOfMonth('2017-03-15T13:27:36Z')

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.This is a string that contains the time.

Numero di parametro: 2Parameter number: 2

Nome: FormatName: Format

Descrizione: facoltativa.Description: Optional. Singolo carattere di identificatore formato o modello di formato personalizzato che indica come formattare il valore di questo timestamp.Either a single format specifier character or a custom format pattern that indicates how to format the value of this timestamp. Se il formato non viene specificato, viene usato il formato ISO 8601 ("o").If format is not provided, the ISO 8601 format ("o") is used.
dayOfWeekdayOfWeek Restituisce il componente giorno della settimana di un timestamp di stringa.Returns the day of week component of a string timestamp. Domenica è 0, lunedì è 1 e così via.Sunday is 0, Monday is 1, and so on. Ad esempio, 3:For example 3:

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

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.This is a string that contains the time.
dayOfMonthdayOfMonth Restituisce il componente giorno del mese di un timestamp di stringa.Returns the day of month component of a string timestamp. Ad esempio, 15:For example 15:

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

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.This is a string that contains the time.
dayOfYeardayOfYear Restituisce il componente giorno dell'anno di un timestamp di stringa.Returns the day of year component of a string timestamp. Ad esempio, 74:For example 74:

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

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.This is a string that contains the time.
ticksticks Restituisce la proprietà ticks di un timestamp di stringa.Returns the ticks property of a string timestamp. Ad esempio, 1489603019:For example 1489603019:

ticks('2017-03-15T18:36:59Z')

Numero di parametro: 1Parameter number: 1

Nome: TimestampName: Timestamp

Descrizione: obbligatoria.Description: Required. Stringa contenente l'ora.This is a string that contains the time.

Funzioni del flusso di lavoroWorkflow functions

Queste funzioni consentono di ottenere informazioni sul flusso di lavoro stesso in fase di esecuzione.These functions help you get information about the workflow itself at run time.

Nome della funzioneFunction name DescrizioneDescription
listCallbackUrllistCallbackUrl Restituisce una stringa da chiamare per richiamare il trigger o l'azione.Returns a string to call to invoke the trigger or action.

Nota: questa funzione può essere usata solo in un oggetto httpWebhook e apiConnectionWebhook, non in un oggetto manual, recurrence, http o apiConnection.Note: This function can only be used in an httpWebhook and apiConnectionWebhook, not in a manual, recurrence, http, or apiConnection.

Ad esempio, la funzione listCallbackUrl() restituisce:For example, the listCallbackUrl() function returns:

https://prod-01.westus.logic.azure.com:443/workflows/1235...ABCD/triggers/manual/run?api-version=2015-08-01-preview&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxx...xxx

flusso di lavoroworkflow Questa funzione fornisce tutti i dettagli del flusso di lavoro stesso in fase di esecuzione.This function provides you all the details for the workflow itself at the runtime.

Le proprietà disponibili per l'oggetto flusso di lavoro sono:Available properties on the workflow object are:

  • name
  • type
  • id
  • location
  • run

Il valore della proprietà run è un oggetto con le proprietà seguenti:The value of the run property is an object with following properties:

  • name
  • type
  • id

Per informazioni dettagliate su queste proprietà, vedere Rest API (API REST).See the Rest API for details on those properties.

Ad esempio, per ottenere il nome dell'esecuzione corrente, usare l'espressione "@workflow().run.name".For example, to get the name of the current run, use the "@workflow().run.name" expression.

Passaggi successiviNext steps

Azioni e trigger del flusso di lavoroWorkflow actions and triggers