Guide de référence sur les fonctions d’expression de workflow dans Azure Logic Apps et Power Automate

Article
12/13/2023

S’applique à : Azure Logic Apps (Consommation + Standard)

Pour les définitions de flux de travail dans Azure Logic Apps et Power Automate, certaines expressions obtiennent leurs valeurs à partir d’actions runtime qui peuvent ne pas encore exister au début de l’exécution de votre flux de travail. Pour référencer ou traiter les valeurs dans ces expressions, vous pouvez faire appel à des fonctions d’expression fournies par le Langage de définition de workflow.

Notes

Cette page de référence s’applique à Azure Logic Apps et à Power Automate, mais apparaît dans la documentation Azure Logic Apps. Bien que cette page se rapporte spécifiquement aux workflows des applications logiques, ces fonctions fonctionnement pour les workflows de flux et d’applications logiques. Pour plus d’informations sur les fonctions et expressions dans Power Automate, consultez Utiliser des expressions dans des conditions.

Par exemple, vous pouvez calculer des valeurs à l’aide de fonctions mathématiques, telles que la fonction add(), lorsque vous souhaitez obtenir la somme d’entiers ou de nombres décimaux. Voici d’autres exemples de tâches que vous pouvez réaliser avec les fonctions :

Tâche	Syntaxe de la fonction	Résultats
Retourne une chaîne en minuscules.	toLower('<text>') Par exemple : toLower('Hello')	"hello"
Renvoyer un identificateur global unique (GUID).	guid()	« c2ecc88d-88c8-4096-912c-d6f2e2b138ce »

Pour rechercher des fonctions selon leur usage général, examinez les tables suivantes. Ou, pour plus d’informations sur chaque fonction, consultez la liste alphabétique.

Fonctions dans les expressions

Pour vous montrer comment utiliser une fonction dans une expression, cet exemple montre comment vous pouvez obtenir la valeur du paramètre customerName et affecter cette valeur à la propriété accountName en utilisant la fonction parameters() dans une expression :

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

Voici quelques autres méthodes générales pour utiliser des fonctions dans des expressions :

Tâche	Syntaxe de la fonction dans une expression
Effectuer une opération avec un élément en transmettant cet élément à une fonction.	« @<functionName>(<item>) »
1. Obtenir la valeur de parameterName en utilisant la fonction imbriquée `parameters()`. 2. Effectuer une opération avec le résultat en transmettant cette valeur à functionName.	« @<functionName>(parameters('<parameterName>')) »
1. Obtenir le résultat de la fonction interne imbriquée functionName. 2. Transmettre le résultat à la fonction externe functionName.	« @<functionName2>(<functionName>(<item>)) »
1. Obtenir le résultat de functionName. 2. Comme le résultat est un objet avec la propriété propertyName, obtenir la valeur de cette propriété.	« @<functionName>(<item>).<propertyName> »

Par exemple, la fonction concat() peut prendre deux valeurs de chaîne ou plus en tant que paramètres. Cette fonction combine ces chaînes dans une seule chaîne. Vous pouvez transmettre des littéraux de chaîne, par exemple « Sophia » et « Owen », afin d’obtenir la chaîne combinée « SophiaOwen » :

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

Vous pouvez également obtenir les valeurs de chaîne à partir des paramètres. Cet exemple utilise la fonction parameters() dans chaque paramètre concat(), ainsi que les paramètres firstName et lastName. Vous transmettez ensuite les chaînes résultantes à la fonction concat() afin d’obtenir une chaîne combinée, par exemple « SophiaOwen » :

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

Dans les deux cas, le résultat est affecté à la propriété customerName.

Considérations relatives à l'utilisation des fonctions

Le concepteur n’évalue pas les expressions de runtime utilisées en tant que paramètres de fonction au moment de la conception. Le concepteur exige que toutes les expressions puissent être entièrement évaluées au moment de la conception.
Les paramètres de fonction sont évalués de gauche à droite.
Dans la syntaxe des définitions de paramètres, un point d’interrogation (?) affiché après un paramètre signifie que ce paramètre est facultatif. Par exemple, consultez getFutureTime().
Les expressions de fonction qui s’affichent en ligne avec du texte brut requièrent des accolades ouvrantes ({}) pour utiliser le format interpolé de l’expression à la place. Ce format permet d’éviter les problèmes d’analyse. Si votre expression de fonction n’apparaît pas en ligne avec du texte brut, aucune accolade n’est nécessaire.

L’exemple suivant illustre la syntaxe correcte et incorrecte :

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

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

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

Les sections suivantes organisent les fonction de langage selon leur objectif général, ou vous pouvez parcourir ces fonctions par ordre alphabétique.

Fonctions de chaînes

Pour travailler avec des chaînes, vous pouvez utiliser ces fonctions de chaîne, ainsi que certaines fonctions de collection. Les fonctions de chaîne sont uniquement utilisables sur des chaînes.

Fonction de chaîne	Tâche
chunk	Fractionne une chaîne ou une collection en blocs de longueur égale.
concat	Combine au moins deux chaînes et retourne la chaîne combinée.
endsWith	Vérifier si une chaîne se termine par la sous-chaîne spécifiée.
formatNumber	Retourne un nombre sous forme de chaîne sur la base du format spécifié
guid	Générer un identificateur global unique (GUID) sous forme de chaîne.
indexOf	Renvoyer la position de départ d’une sous-chaîne.
isFloat	Retourne une valeur booléenne qui indique si une chaîne est un nombre à virgule flottante.
isInt	Retourne une valeur booléenne qui indique si une chaîne est un entier.
lastIndexOf	Retourne la position de départ de la dernière occurrence d’une sous-chaîne.
length	Renvoyer le nombre d’éléments d’une chaîne ou d’un tableau.
nthIndexOf	Retourne la position de départ ou la valeur d’index où la nième occurrence d’une sous-chaîne apparaît dans une chaîne.
replace	Remplacer une sous-chaîne par la chaîne spécifiée et renvoyer la chaîne mise à jour.
slice	Retourne une sous-chaîne en spécifiant la position ou la valeur de début et de fin. Consultez également substring.
split	Retourne un tableau qui contient des sous-chaînes, séparées par des virgules, extraites à partir d’une chaîne plus grande sur la base d’un caractère délimiteur spécifié dans la chaîne d’origine.
startsWith	Vérifie si une chaîne commence par une sous-chaîne spécifique.
substring	Renvoyer les caractères d’une chaîne, en commençant à partir de la position spécifiée. Consultez également slice.
toLower	Retourne une chaîne en minuscules.
toUpper	Retourne une chaîne en majuscules.
trim	Supprime les espaces blancs de début et de fin d’une chaîne et retourne la chaîne mise à jour.

Fonctions de collection

Pour travailler avec des collections, généralement des tableaux, des chaînes et parfois, des dictionnaires, vous pouvez utiliser ces fonctions de collection.

Fonction de collection	Tâche
chunk	Fractionne une chaîne ou une collection en blocs de longueur égale.
contains	Vérifie si une collection contient un élément spécifique.
empty	Vérifie si une collection est vide.
first	Renvoyer le premier élément d’une collection.
intersection	Retourne une collection qui contient uniquement les éléments communs aux collections spécifiées.
item	Si cette fonction apparaît à l’intérieur d’une action répétée sur un tableau, renvoyer l’élément actuel du tableau au cours de l’itération actuelle de l’action.
join	Renvoyer une chaîne qui contient tous les éléments d’un tableau, séparés par le caractère spécifié.
last	Retourne le dernier élément d’une collection.
length	Renvoyer le nombre d’éléments d’une chaîne ou d’un tableau.
reverse	Inverse l’ordre des éléments d’un tableau.
skip	Supprime des éléments du début d’une collection et retourne tous les autres éléments.
sort	Trie les éléments d’une collection.
take	Retourne des éléments du début d’une collection.
union	Retourne une collection qui contient tous les éléments des collections spécifiées.

Fonctions de comparaison logiques

Pour travailler avec des conditions, comparer des valeurs et des résultats d’expressions, ou évaluer différents types de logique, vous pouvez utiliser ces fonctions de comparaison logiques. Pour obtenir des informations complètes sur chaque fonction, consultez la liste alphabétique.

Notes

Si vous utilisez des fonctions ou des conditions logiques pour comparer des valeurs, les valeurs NULL sont converties en valeurs de chaînes vides (""). Le comportement des conditions diffère lorsque vous procédez à une comparaison à l’aide d’une chaîne vide à la place d’une valeur NULL. Pour plus d’informations, consultez la fonction string ().

Fonction de comparaison logique	Tâche
and	Vérifie si toutes les expressions sont vraies.
equals	Vérifier si les deux valeurs sont équivalentes.
greater	Vérifie si la première valeur est supérieure à la seconde.
greaterOrEquals	Vérifie si la première valeur est supérieure ou égale à la seconde.
if	Vérifie si une expression est vraie ou fausse. En fonction du résultat, retourne une valeur spécifiée.
isFloat	Retourne une valeur booléenne qui indique si une chaîne est un nombre à virgule flottante.
isInt	Retourne une valeur booléenne qui indique si une chaîne est un entier.
less	Vérifie si la première valeur est inférieure à la seconde.
lessOrEquals	Vérifie si la première valeur est inférieure ou égale à la seconde.
not	Vérifie si une expression est fausse.
or	Vérifie si au moins une expression est vraie.

Fonctions de conversion

Pour modifier le type ou le format d’une valeur, vous pouvez utiliser ces fonctions de conversion. Par exemple, vous pouvez convertir une valeur booléenne en entier. Pour plus d’informations sur la manière dont Azure Logic Apps gère les types de contenu lors de la conversion, consultez Gérer les types de contenu. Pour obtenir des informations complètes sur chaque fonction, consultez la liste alphabétique.

Notes

Azure Logic Apps effectue automatiquement ou implicitement l’encodage ou le décodage base64, de sorte que vous n’avez pas à effectuer manuellement ces conversions à l’aide des fonctions d’encodage et de décodage. Toutefois, si vous utilisez quand même ces fonctions dans le concepteur, vous pouvez rencontrer des comportements de rendu inattendus. Ces comportements affectent uniquement la visibilité des fonctions et non leur effet, sauf si vous modifiez les valeurs des paramètres des fonctions, ce qui supprime les fonctions et leurs effets de votre code. Pour plus d’informations, consultez Conversions de types de données implicites.

Fonction de conversion	Tâche
array	Retourne un tableau à partir d’une entrée spécifique unique. Pour des entrées multiples, consultez createArray.
base64	Retourne la version encodée en Base64 d’une chaîne.
base64ToBinary	Retourne la version binaire d’une chaîne encodée en Base64.
base64ToString	Renvoyer la version de type chaîne d’une chaîne encodée en base 64.
binary	Renvoyer la version binaire d’une valeur d’entrée.
bool	Renvoyer la version booléenne d’une valeur d’entrée.
createArray	Retourne un tableau à partir de plusieurs entrées.
dataUri	Renvoyer l’URI de données d’une valeur d’entrée.
dataUriToBinary	Renvoyer la version binaire d’un URI de données.
dataUriToString	Renvoyer la version de type chaîne d’un URI de données.
decimal	Retourne le nombre décimal pour une chaîne décimale.
decodeBase64	Renvoyer la version de type chaîne d’une chaîne encodée en base 64.
decodeDataUri	Renvoyer la version binaire d’un URI de données.
decodeUriComponent	Retourne une chaîne qui remplace les caractères d’échappement par des versions décodées.
encodeUriComponent	Renvoyer une chaîne qui remplace les caractères non sécurisés pour les URL par des caractères d'échappement.
float	Renvoyer un nombre à virgule flottante pour une valeur d’entrée.
int	Retourne la version de type entier d’une chaîne.
json	Retourne la valeur ou l’objet de type JavaScript Object Notation (JSON) d’une chaîne ou d’un élément XML.
string	Renvoyer la version de type chaîne d’une valeur d’entrée.
uriComponent	Renvoyer la version encodée dans un URI d’une valeur d’entrée en remplaçant les caractères non sécurisés pour les URL par des caractères d’échappement.
uriComponentToBinary	Renvoyer la version binaire d’une chaîne encodée dans un URI.
uriComponentToString	Renvoyer la version de type chaîne d’une chaîne encodée dans un URI.
xml	Renvoyer la version de type entier d’une chaîne.

Conversions de types de données implicites

Azure Logic Apps effectue automatiquement ou implicitement les conversions entre certains types de données, vous n’avez donc pas à effectuer manuellement ces conversions. Par exemple, si vous utilisez des valeurs qui ne sont pas des chaînes alors que les entrées sont supposées être des chaînes, Azure Logic Apps convertit automatiquement les valeurs non-chaînes en chaînes.

Par exemple, supposons qu’un déclencheur retourne une valeur numérique comme sortie :

triggerBody()?['123']

Si vous utilisez cette sortie numérique là où une entrée de chaîne est attendue, par exemple une URL, Azure Logic Apps convertit automatiquement la valeur en chaîne en utilisant la notation des accolades ({}) :

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

Encodage et décodage base64

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

Notes

Si vous ajoutez manuellement l’une de ces fonctions à votre concepteur, directement avec un déclencheur ou une action ou par le biais de l’éditeur d’expressions, quittez le concepteur puis y revenez, la fonction disparaît du concepteur, ne laissant que les valeurs des paramètres. Ce comportement se produit également si vous sélectionnez un déclencheur ou une action qui utilise cette fonction sans modifier les valeurs des paramètres de la fonction. Ce résultat affecte uniquement la visibilité de la fonction et non son effet. En mode Code, la fonction n’est pas affectée. Toutefois, si vous modifiez les valeurs des paramètres de la fonction, la fonction et ses effets sont supprimés du mode Code, ne laissant que les valeurs des paramètres de la fonction.

Fonctions mathématiques

Pour travailler avec des entiers et des nombres à virgule flottante, vous pouvez utiliser ces fonctions mathématiques. Pour obtenir des informations complètes sur chaque fonction, consultez la liste alphabétique.

Fonction mathématique	Tâche
add	Retourne le résultat de l’addition de deux nombres.
div	Renvoyer le résultat de la division de deux nombres.
max	Renvoyer la valeur la plus élevée d’un ensemble de nombres ou d’un tableau.
min	Retourne la plus petite valeur d’un ensemble de nombres ou d’un tableau.
mod	Retourne le reste de la division de deux nombres.
mul	Retourne le produit de la multiplication de deux nombres.
rand	Renvoyer un entier aléatoire à partir d’une plage spécifique.
range	Retourne un tableau d’entiers qui commence par un entier spécifique.
sub	Retourne le résultat de la soustraction du second nombre du premier.

Fonctions de date et heure

Pour travailler avec des dates et des heures, vous pouvez utiliser ces fonctions de date et heure. Pour obtenir des informations complètes sur chaque fonction, consultez la liste alphabétique.

Fonction de date ou heure	Tâche
addDays	Ajoute des jours à un timestamp.
addHours	Ajoute des heures à un timestamp.
addMinutes	Ajoute des minutes à un timestamp.
addSeconds	Ajoute des secondes à un timestamp.
addToTime	Ajoute des unités de temps spécifiées à un timestamp. Voir aussi getFutureTime.
convertFromUtc	Convertit un horodatage du temps universel coordonné (UTC) au fuseau horaire cible.
convertTimeZone	Convertit un horodatage du fuseau horaire source au fuseau horaire cible.
convertToUtc	Convertit un horodatage du fuseau horaire source en temps universel coordonné (UTC).
dateDifference	Retourne la différence entre deux dates sous forme d’intervalle de temps (timespan).
dayOfMonth	Renvoyer le jour du composant mois d’un timestamp.
dayOfWeek	Renvoyer le jour du composant semaine d’un timestamp.
dayOfYear	Renvoyer le jour du composant année d’un timestamp.
formatDateTime	Renvoyer la date d’un timestamp.
getFutureTime	Retourne l’horodatage actuel plus les unités de temps spécifiées. Voir aussi addToTime.
getPastTime	Retourne l’horodatage actuel moins les unités de temps spécifiées. Voir aussi subtractFromTime.
parseDateTime	Retourne le timestamp d’une chaîne qui contient un timestamp.
startOfDay	Retourne le début du jour d’un horodatage.
startOfHour	Retourne le début de l’heure d’un horodatage.
startOfMonth	Retourne le début du mois pour un horodatage.
subtractFromTime	Soustrait un nombre d’unités de temps d’un horodatage. Voir aussi getPastTime.
ticks	Retourne la valeur de la propriété `ticks` pour un horodatage spécifique.
utcNow	Renvoyer le timestamp actuel sous forme de chaîne.

Fonctions de flux de travail

Grâce à ces fonctions de flux de travail, vous pouvez :

Obtenir des informations sur une instance de flux de travail au moment de l’exécution
Travaillez avec les entrées utilisées pour l’instanciation de flux ou applications logiques.
Référencer les sorties de déclencheurs et d’actions

Par exemple, vous pouvez référencer les sorties d’une action et utiliser ces données lors d’une action ultérieure. Pour obtenir des informations complètes sur chaque fonction, consultez la liste alphabétique.

Fonction de flux de travail	Tâche
action	Renvoyer la sortie de l’action lors de l’exécution ou les valeurs d’autres paires nom-valeur JSON. Voir aussi actions.
actionBody	Retourne la sortie `body` d’une action lors de l’exécution. Voir aussi body.
actionOutputs	Retourne la sortie d’une action lors de l’exécution. Consultez les sorties et les actions.
actions	Renvoyer la sortie d’une action lors de l’exécution ou les valeurs d’autres paires nom-valeur JSON. Voir aussi action.
body	Retourne la sortie `body` d’une action lors de l’exécution. Voir aussi actionBody.
formDataMultiValues	Créer un tableau contenant les valeurs qui correspondent à un nom de clé dans la sortie form-data ou form-encoded d’une action.
formDataValue	Renvoyer une valeur unique qui correspond à un nom de clé dans la sortie form-data ou form-encoded output d’une action.
item	Si cette fonction apparaît à l’intérieur d’une action répétée sur un tableau, renvoyer l’élément actuel du tableau au cours de l’itération actuelle de l’action.
items	Si cette fonction apparaît à l’intérieur d’une boucle Foreach ou Until, retourne l’élément actuel de la boucle spécifiée.
iterationIndexes	Si cette fonction apparaît à l’intérieur d’une boucle Until, retourne la valeur d’index de l’itération actuelle. Vous pouvez utiliser cette fonction à l’intérieur de boucles Until imbriquées.
listCallbackUrl	Renvoyer l’« URL de rappel » qui appelle un déclencheur ou une action.
multipartBody	Renvoyer le corps correspondant à une partie spécifique de la sortie d’une action qui comporte plusieurs parties.
outputs	Retourne la sortie d’une action lors de l’exécution.
parameters	Retourne la valeur d’un paramètre décrit dans la définition de votre flux de travail.
result	Retourne les entrées et les sorties des actions de niveau supérieur à l’intérieur de l’action délimitée spécifiée, comme `For_each`, `Until` et `Scope`.
trigger	Renvoyer la sortie d’un déclencheur lors de l’exécution ou d’autres paires nom-valeur JSON. Voir aussi triggerOutputs et triggerBody.
triggerBody	Renvoyer la sortie `body` d’un déclencheur lors de l’exécution. Voir trigger.
triggerFormDataValue	Renvoyer une valeur unique correspondant à un nom de clé dans la sortie form-data ou form-encoded d’un déclencheur.
triggerMultipartBody	Renvoyer le corps d’une partie spécifiée dans la sortie en plusieurs parties d’un déclencheur.
triggerFormDataMultiValues	Créer un tableau dont les valeurs correspondent à un nom de clé dans la sortie form-data ou form-encoded d’un déclencheur.
triggerOutputs	Renvoyer la sortie d’un déclencheur lors de l’exécution ou les valeurs d’autres paires nom-valeur JSON. Voir trigger.
variables	Renvoyer la valeur d’une variable spécifiée.
workflow	Renvoyer tous les détails sur le flux de travail proprement dit pendant l’exécution.

Fonctions d’analyse d’URI

Pour travailler avec des URI (Uniform Resource Identifier) et obtenir différentes valeurs de propriétés pour ces URI, vous pouvez utiliser ces fonctions d’analyse d’URI. Pour obtenir des informations complètes sur chaque fonction, consultez la liste alphabétique.

Fonction d’analyse d’URI	Tâche
uriHost	Renvoyer la valeur `host` pour un URI (Uniform Resource Identifier).
uriPath	Renvoyer la valeur `path` pour un URI (Uniform Resource Identifier).
uriPathAndQuery	Renvoyer les valeurs `path` et `query` pour un URI (Uniform Resource Identifier).
uriPort	Renvoyer la valeur `port` pour un URI (Uniform Resource Identifier).
uriQuery	Renvoyer la valeur `query` pour un URI (Uniform Resource Identifier).
uriScheme	Renvoyer la valeur `scheme` pour un URI (Uniform Resource Identifier).

Fonctions de manipulation : JSON et XML

Pour travailler avec des objets JSON et des nœuds XML, vous pouvez utiliser ces fonctions de manipulation. Pour obtenir des informations complètes sur chaque fonction, consultez la liste alphabétique.

Fonction de manipulation	Tâche
addProperty	Ajouter une propriété et sa valeur, ou paire nom-valeur, à un objet JSON et renvoyer l’objet mis à jour.
coalesce	Retourne la première valeur autre que Null d’un ou plusieurs paramètres.
removeProperty	Supprimer une propriété d’un objet JSON et renvoyer l’objet mis à jour.
setProperty	Définir la valeur d’une propriété d’un objet JSON et renvoyer l’objet mis à jour.
xpath	Vérifie si le code XML contient des valeurs ou des nœuds qui correspondent à une expression de langage XPath et retourne les valeurs ou les nœuds correspondants.

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

Toutes les fonctions (liste alphabétique)

Cette section répertorie toutes les fonctions disponibles par ordre alphabétique.

Un

action

Retourne la sortie de l’action en cours lors de l’exécution ou les valeurs d’autres paires nom-valeur JSON que vous pouvez attribuer à une expression. Par défaut, cette fonction fait référence à l’objet d’action dans son intégralité, mais vous pouvez éventuellement spécifier une propriété dont vous souhaitez la valeur. Voir aussi actions().

Vous pouvez utiliser la fonction action() uniquement dans les emplacements suivants :

La propriété unsubscribe pour une action de Webhook afin de pouvoir accéder au résultat de la demande subscribe d’origine
La propriété trackedProperties d’une action
La condition de boucle do-until d’une action

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

Paramètre	Obligatoire	Type	Description
<property>	Non	String	Nom de propriété de l’objet d’action dont vous souhaitez la valeur : name, startTime, endTime, inputs, outputs, status, code, trackingId et clientTrackingId. Vous trouverez ces propriétés dans le portail Azure en passant en revue les détails d’un historique des exécutions spécifique. Pour plus d’informations, consultez API REST - Actions d’exécution du workflow.

Valeur retournée	Type	Description
<action-output>	String	Sortie de la propriété ou de l’action en cours

actionBody

Retourne la sortie body d’une action lors de l’exécution. Raccourci de actions('<actionName>').outputs.body. Voir body() et actions().

actionBody('<actionName>')

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Nom de la sortie `body` de l’action souhaitée

Valeur retournée	Type	Description
<action-body-output>	String	Sortie `body` de l’action spécifiée

Exemple

Cet exemple illustre l’obtention de la sortie body de l’action Twitter Get user :

actionBody('Get_user')

Et retourne ce résultat :

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

actionOutputs

Retourne la sortie d’une action lors de l’exécution. Raccourci de actions('<actionName>').outputs. Voir actions(). La fonction actionOutputs() est résolue enoutputs() dans le concepteur. Pensez donc à utiliser outputs(), plutôt que actionOutputs(). Bien que les deux fonctions agissent de manière identique, la fonction outputs() est préférée.

actionOutputs('<actionName>')

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Nom de la sortie de l’action souhaitée

Valeur retournée	Type	Description
<output>	String	Sortie de l’action spécifiée

Exemple

Cet exemple illustre l’obtention de la sortie de l’action Twitter Get user :

actionOutputs('Get_user')

Et retourne ce résultat :

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

actions

Retourne la sortie d’une action lors de l’exécution ou les valeurs d’autres paires nom-valeur JSON que vous pouvez attribuer à une expression. Par défaut, la fonction fait référence à l’objet d’action dans son intégralité, mais vous pouvez éventuellement spécifier une propriété dont vous souhaitez la valeur. Pour les versions raccourcies, consultez actionBody(), actionOutputs() et body(). Pour l’action actuelle, consultez action().

Conseil

La fonction actions() retourne la sortie sous forme de chaîne. S’il vous faut une valeur retournée sous forme d’objet JSON, vous devez d’abord convertir la valeur de chaîne. Pour la transformer en objet JSON, utilisez l’action Analyser le code JSON.

Notes

Auparavant, vous pouviez utiliser la fonction actions() ou l’élément conditions pour spécifier qu’une action était exécutée en fonction de la sortie d’une autre action. Toutefois, pour déclarer explicitement des dépendances entre des actions, vous devez maintenant utiliser la propriété runAfter de l’action dépendante. Pour en savoir plus sur la propriété runAfter, consultez Intercepter et gérer les échecs avec la propriété runAfter.

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

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Nom de l’objet d’action dont vous souhaitez la sortie
<property>	Non	String	Nom de propriété de l’objet d’action dont vous souhaitez la valeur : name, startTime, endTime, inputs, outputs, status, code, trackingId et clientTrackingId. Vous trouverez ces propriétés dans le portail Azure en passant en revue les détails d’un historique des exécutions spécifique. Pour plus d’informations, consultez API REST - Actions d’exécution du workflow.

Valeur retournée	Type	Description
<action-output>	String	Sortie de l’action ou de la propriété spécifiée

Exemple

Cet exemple illustre l’obtention de la valeur de la propriété status de l’action Twitter Get user lors de l’exécution :

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

Et retourne ce résultat : "Succeeded"

add

Retourne le résultat de l’addition de deux nombres.

add(<summand_1>, <summand_2>)

Paramètre	Obligatoire	Type	Description
<summand_1>, <summand_2>	Oui	Entier, flottant ou mixte	Nombres à ajouter

Valeur retournée	Type	Description
<result-sum>	Entier ou flottant	Résultat de l’addition des nombres spécifiés

Exemple

Cet exemple illustre l’addition des nombres spécifiés :

add(1, 1.5)

Et retourne ce résultat : 2.5

addDays

Ajoute des jours à un timestamp.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<days>	Oui	Integer	Nombre de jours positif ou négatif à ajouter
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage plus le nombre de jours spécifié

Exemple 1

Cet exemple illustre l’ajout de 10 jours à l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-25T00:00:00.0000000Z"

Exemple 2

Cet exemple illustre le retrait de cinq jours de l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-10T00:00:00.0000000Z"

addHours

Ajoute des heures à un timestamp.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<hours>	Oui	Integer	Nombre d’heures positif ou négatif à ajouter
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage plus le nombre d’heures spécifié

Exemple 1

Cet exemple illustre l’ajout de 10 heures à l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-15T10:00:00.0000000Z"

Exemple 2

Cet exemple illustre le retrait de cinq heures de l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-15T10:00:00.0000000Z"

addMinutes

Ajoute des minutes à un timestamp.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<minutes>	Oui	Integer	Nombre de minutes positif ou négatif à ajouter
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage plus le nombre de minutes spécifié

Exemple 1

Cet exemple illustre l’ajout de 10 minutes à l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-15T00:20:00.0000000Z"

Exemple 2

Cet exemple illustre le retrait de cinq minutes de l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-15T00:15:00.0000000Z"

addProperty

Ajouter une propriété et sa valeur, ou paire nom-valeur, à un objet JSON et renvoyer l’objet mis à jour. Si la propriété existe déjà lors de l’exécution, la fonction échoue et génère une erreur.

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

Paramètre	Obligatoire	Type	Description
<object>	Oui	Object	Objet JSON dans lequel vous souhaitez ajouter une propriété
<property>	Oui	String	Nom de la propriété à ajouter
<value>	Oui	Quelconque	Valeur de la propriété

Valeur retournée	Type	Description
<updated-object>	Object	Objet JSON mis à jour avec la propriété spécifiée

Pour ajouter une propriété parente à une propriété existante, utilisez la fonction setProperty(), non la fonction addProperty(). Sinon, la fonction retourne seulement l’objet enfant comme sortie.

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

Paramètre	Obligatoire	Type	Description
<object>	Oui	Object	Objet JSON dans lequel vous souhaitez ajouter une propriété
<parent-property>	Oui	String	Nom de la propriété parente où vous voulez ajouter la propriété enfant
<child-property>	Oui	String	Nom de la propriété enfant à ajouter
<value>	Oui	Quelconque	Valeur à définir pour la propriété spécifiée

Valeur retournée	Type	Description
<updated-object>	Object	Objet JSON mis à jour dont vous définissez la propriété

Exemple 1

Cet exemple ajoute la propriété middleName à un objet JSON, qui est converti d’une chaîne en un format JSON avec la fonction JSON(). L’objet contient déjà les propriétés firstName et surName. La fonction affecte la valeur spécifiée à la nouvelle propriété et retourne l’objet mis à jour :

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

Voici l’objet JSON actuel :

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

Voici l’objet JSON mis à jour :

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

Exemple 2

Cet exemple ajoute la propriété enfant middleName à la propriété customerName existante dans un objet JSON, qui est converti d’une chaîne en un format JSON avec la fonction JSON(). La fonction affecte la valeur spécifiée à la nouvelle propriété et retourne l’objet mis à jour :

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

Voici l’objet JSON actuel :

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

Voici l’objet JSON mis à jour :

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

addSeconds

Ajoute des secondes à un timestamp.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<seconds>	Oui	Integer	Nombre de secondes positif ou négatif à ajouter
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage plus le nombre de secondes spécifié

Exemple 1

Cet exemple illustre l’ajout de 10 secondes à l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-15T00:00:10.0000000Z"

Exemple 2

Cet exemple illustre le retrait de cinq secondes de l’horodatage spécifié :

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

Et retourne ce résultat : "2018-03-15T00:00:25.0000000Z"

addToTime

Ajoute les unités de temps spécifiées à un timestamp. Voir aussi getFutureTime().

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<interval>	Oui	Integer	Nombre d’unités de temps spécifiées à ajouter
<timeUnit>	Oui	String	L’unité de temps à utiliser avec interval : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage plus nombre d’unités de temps spécifié

Exemple 1

Cet exemple illustre l’ajout d’un jour à l’horodatage spécifié :

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

Et retourne ce résultat : "2018-01-02T00:00:00.0000000Z"

Exemple 2

Cet exemple illustre l’ajout d’un jour à l’horodatage spécifié :

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

Et retourne le résultat en utilisant le format « D » facultatif : "Tuesday, January 2, 2018"

and

Vérifie si toutes les expressions sont vraies. Retourne la valeur true lorsque toutes les expressions sont vraies ou la valeur false lorsque au moins une expression est fausse.

and(<expression1>, <expression2>, ...)

Paramètre	Obligatoire	Type	Description
<expression1>, <expression2>, …	Oui	Boolean	Expressions à vérifier

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true si toutes les expressions sont vraies. Retourne la valeur false si au moins une expression est fausse.

Exemple 1

Ces exemples vérifient si toutes les valeurs booléennes spécifiées sont vraies :

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

Et retournent les résultats suivants :

Premier exemple : comme les deux expressions sont vraies, la valeur true est retournée.
Deuxième exemple : comme une des expressions est fausse, la valeur false est retournée.
Troisième exemple : comme les deux expressions sont fausses, la valeur false est retournée.

Exemple 2

Ces exemples vérifient si toutes les expressions spécifiées sont vraies :

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

Et retournent les résultats suivants :

Premier exemple : comme les deux expressions sont vraies, la valeur true est retournée.
Deuxième exemple : comme une des expressions est fausse, la valeur false est retournée.
Troisième exemple : comme les deux expressions sont fausses, la valeur false est retournée.

tableau

Retourne un tableau à partir d’une entrée spécifique unique. Pour des entrées multiples, consultez createArray().

array('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne permettant de créer un tableau

Valeur retournée	Type	Description
[<value>]	Array	Tableau qui contient l’entrée spécifiée unique

Exemple

Cet exemple illustre la création d’un tableau à partir de la chaîne « hello » :

array('hello')

Et retourne ce résultat : ["hello"]

B

base64

Retourne la version encodée en Base64 d’une chaîne.

Notes

Azure Logic Apps effectue automatiquement ou implicitement l’encodage ou le décodage base64, de sorte que vous n’avez pas à effectuer manuellement ces conversions à l’aide des fonctions d’encodage et de décodage. Toutefois, si vous utilisez quand même ces fonctions, vous pouvez rencontrer des comportements de rendu inattendus. Ces comportements affectent uniquement la visibilité des fonctions et non leur effet, sauf si vous modifiez les valeurs des paramètres des fonctions, ce qui supprime les fonctions et leurs effets de votre code. Pour plus d’informations, consultez Encodage et décodage base64.

base64('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne d’entrée

Valeur retournée	Type	Description
<base64-string>	String	Retourne la version encodée en Base64 de la chaîne d’entrée

Exemple

Cet exemple illustre la conversion d’une chaîne « hello » en chaîne encodée en Base64 :

base64('hello')

Et retourne ce résultat : "aGVsbG8="

base64ToBinary

Retourne la version binaire d’une chaîne encodée en Base64.

Notes

base64ToBinary('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne encodée en Base64 à convertir

Valeur retournée	Type	Description
<binary-for-base64-string>	String	Version binaire de la chaîne encodée en Base64

Exemple

Cet exemple illustre la conversion d’une chaîne « aGVsbG8= » encodée en Base64 en chaîne binaire :

base64ToBinary('aGVsbG8=')

Par exemple, supposons que vous utilisez une action HTTP pour envoyer une demande. Vous pouvez utiliser base64ToBinary() pour convertir une chaîne encodée en base64 en données binaires et envoyer ces données en utilisant le type de contenu application/octet-stream dans la demande.

base64ToString

Retourne la version de type chaîne d’une chaîne encodée en Base64, en décodant efficacement la chaîne Base64. Utilisez cette fonction plutôt que la fonction decodeBase64(), qui est déconseillée.

Notes

base64ToString('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne encodée en Base64 à décoder

Valeur retournée	Type	Description
<decoded-base64-string>	String	Version de type chaîne d’une chaîne encodée en Base64

Exemple

Cet exemple illustre la conversion d’une chaîne « aGVsbG8= » encodée en Base64 en chaîne :

base64ToString('aGVsbG8=')

Et retourne ce résultat : "hello"

binary

Retourne la version binaire encodée en base64 d’une chaîne.

binary('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne à convertir

Valeur retournée	Type	Description
<binary-for-input-value>	String	Version binaire encodée en Base64 de la chaîne spécifiée

Exemple

Par exemple, vous utilisez une action HTTP qui retourne un fichier image ou vidéo. Vous pouvez utiliser binary() pour convertir la valeur en modèle d’enveloppe de contenu encodé en Base64. Ensuite, vous pouvez réutiliser l’enveloppe de contenu dans d’autres actions, comme Compose. Vous pouvez utiliser cette expression de fonction pour envoyer les octets de la chaîne avec le type de contenu application/octet-stream dans la demande.

body

Retourne la sortie body d’une action lors de l’exécution. Raccourci de actions('<actionName>').outputs.body. Voir actionBody() et actions().

body('<actionName>')

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Nom de la sortie `body` de l’action souhaitée

Valeur retournée	Type	Description
<action-body-output>	String	Sortie `body` de l’action spécifiée

Exemple

Cet exemple illustre l’obtention de la sortie body de l’action Twitter Get user :

body('Get_user')

Et retourne ce résultat :

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

bool

Retourne la version booléenne d’une valeur.

bool(<value>)

Paramètre	Obligatoire	Type	Description
<value>	Oui	Quelconque	Valeur à convertir en valeur booléenne.

Si vous utilisez bool() avec un objet, la valeur de l'objet doit être une chaîne ou un entier qui peut être converti en valeur booléenne.

Valeur retournée	Type	Description
`true` ou `false`	Boolean	Version booléenne de la valeur spécifiée.

Sorties

Ces exemples illustrent les différents types d'entrée pris en charge pour bool() :

Valeur d'entrée	Type	Valeur de retour
`bool(1)`	Integer	`true`
`bool(0)`	Integer	`false`
`bool(-1)`	Integer	`true`
`bool('true')`	String	`true`
`bool('false')`	String	`false`

C

segment

Fractionne une chaîne ou un tableau en blocs de longueur égale.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Chaîne ou tableau	La collection à fractionner
<length>	Oui	La longueur de chaque bloc

Valeur retournée	Type	Description
<collection>	Array	Tableau de blocs avec la longueur spécifiée

Exemple 1

Cet exemple fractionne une chaîne en blocs d’une longueur de 10 :

chunk('abcdefghijklmnopqrstuvwxyz', 10)

Et retourne ce résultat : ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Exemple 2

Cet exemple fractionne une tableau en blocs d’une longueur de 5.

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

Et retourne ce résultat : [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

coalesce

Retourne la première valeur autre que Null d’un ou plusieurs paramètres. Les chaînes vides, les tableaux vides et les objets vides ne sont pas null.

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

Paramètre	Obligatoire	Type	Description
<object_1>, <object_2>, ...	Oui	N’importe lequel, possibilité de combiner plusieurs types	Recherche de la valeur Null dans un ou plusieurs éléments

Valeur retournée	Type	Description
<first-non-null-item>	Quelconque	Premier élément ou valeur autre que Null. Si tous les paramètres ont la valeur Null, cette fonction retourne la valeur Null.

Exemple

Ces exemples retournent la première valeur autre que Null à partir des valeurs spécifiées ou la valeur Null lorsque toutes les valeurs le sont :

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

Et retournent les résultats suivants :

Premier exemple : true
Second exemple : "hello"
Troisième exemple : null

concat

Combine au moins deux chaînes et retourne la chaîne combinée.

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

Paramètre	Obligatoire	Type	Description
<text1>, <text2>, ...	Oui	String	Au moins deux chaînes à combiner

Valeur retournée	Type	Description
<text1text2...>	String	Chaîne créée à partir des chaînes d'entrée combinées. Remarque : La longueur du résultat ne doit pas dépasser 104 857 600 caractères.

Notes

Azure Logic Apps effectue automatiquement ou implicitement l’encodage ou le décodage base64, de sorte que vous n’avez pas à effectuer manuellement ces conversions lorsque vous utilisez la fonction concat() nécessitant un encodage ou un décodage :

concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))

Toutefois, si vous utilisez quand même cette fonction dans le concepteur, vous pouvez rencontrer des comportements de rendu inattendus. Ces comportements affectent uniquement la visibilité de la fonction et non son effet, sauf si vous modifiez les valeurs des paramètres de la fonction, ce qui supprime la fonction et ses effets de votre code. Pour plus d'informations, consultez Encodage et décodage base64.

Exemple

Cet exemple illustre la combinaison des chaînes « Hello » et « World » :

concat('Hello', 'World')

Et retourne ce résultat : "HelloWorld"

contains

Vérifie si une collection contient un élément spécifique. Retourne la valeur true lorsque l’élément est trouvé ou la valeur false lorsqu’il est introuvable. Cette fonction respecte la casse.

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

Plus précisément, cette fonction agit sur ces types de collection :

Une chaîne pour y rechercher une sous-chaîne
Un tableau pour y rechercher une valeur
Un ensemble de clés pour y rechercher une clé

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Chaîne, tableau ou ensemble de clés	Collection à vérifier
<value>	Oui	Respectivement, chaîne, tableau ou ensemble de clés	Élément à rechercher

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true lorsque l’élément est trouvé. Retourne la valeur false lorsqu’elle est introuvable.

Exemple 1

Cet exemple recherche dans la chaîne « hello world » la sous-chaîne « world » et retourne la valeur true :

contains('hello world', 'world')

Exemple 2

Cet exemple recherche dans la chaîne « hello world » la sous-chaîne « universe » et retourne la valeur false :

contains('hello world', 'universe')

convertFromUtc

Convertit un horodatage du temps universel coordonné (UTC) au fuseau horaire cible.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<destinationTimeZone>	Oui	String	Nom du fuseau horaire cible. Pour les noms de fuseaux horaires, consultez : Fuseaux horaires par défaut de Microsoft Windows.
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<converted-timestamp>	String	Horodatage converti en fuseau horaire cible sans décalage UTC du fuseau horaire.

Exemple 1

Cet exemple illustre la conversion d’un horodatage au fuseau horaire spécifié :

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

Et retourne ce résultat : "2018-01-01T00:00:00.0000000"

Exemple 2

Cet exemple illustre la conversion d’un horodatage au fuseau horaire et au format spécifiés :

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

Et retourne ce résultat : "Monday, January 1, 2018"

convertTimeZone

Convertit un horodatage du fuseau horaire source au fuseau horaire cible.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<sourceTimeZone>	Oui	String	Nom du fuseau horaire source. Pour les noms de fuseau horaire, consultez Fuseaux horaires Microsoft Windows par défaut, mais vous devrez peut-être supprimer les signes de ponctuation du nom de fuseau horaire.
<destinationTimeZone>	Oui	String	Nom du fuseau horaire cible. Pour les noms de fuseau horaire, consultez Fuseaux horaires Microsoft Windows par défaut, mais vous devrez peut-être supprimer les signes de ponctuation du nom de fuseau horaire.
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<converted-timestamp>	String	Horodatage converti au fuseau horaire cible

Exemple 1

Cet exemple illustre la conversion du fuseau horaire source au fuseau horaire cible :

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

Et retourne ce résultat : "2018-01-01T00:00:00.0000000"

Exemple 2

Cet exemple illustre la conversion d’un fuseau horaire au format et au fuseau horaire spécifiés :

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

Et retourne ce résultat : "Monday, January 1, 2018"

convertToUtc

Convertit un horodatage du fuseau horaire source en temps universel coordonné (UTC).

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<sourceTimeZone>	Oui	String	Nom du fuseau horaire source. Pour les noms de fuseau horaire, consultez Fuseaux horaires Microsoft Windows par défaut, mais vous devrez peut-être supprimer les signes de ponctuation du nom de fuseau horaire.
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<converted-timestamp>	String	Horodatage converti en heure UTC

Exemple 1

Cet exemple illustre la conversion d’un horodatage en heure UTC :

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

Et retourne ce résultat : "2018-01-01T08:00:00.0000000Z"

Exemple 2

Cet exemple illustre la conversion d’un horodatage en heure UTC :

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

Et retourne ce résultat : "Monday, January 1, 2018"

createArray

Retourne un tableau à partir de plusieurs entrées. Pour les tableaux à entrée unique, consultez array().

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

Paramètre	Obligatoire	Type	Description
<object1>, <object2>, ...	Oui	N’importe lequel, mais pas de combinaison	Au moins deux éléments pour créer le tableau

Valeur retournée	Type	Description
[<object1>, <object2>, ...]	Array	Tableau créé à partir de tous les éléments d’entrée

Exemple

Cet exemple illustre la création d’un tableau à partir de ces entrées :

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

Et retourne ce résultat : ["h", "e", "l", "l", "o"]

D

dataUri

Retourne un URI de données pour une chaîne.

dataUri('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne à convertir

Valeur retournée	Type	Description
<data-uri>	String	URI de données de la chaîne d’entrée

Exemple

Cet exemple illustre la création d’un URI de données à partir de la chaîne « hello » :

dataUri('hello')

Et retourne ce résultat : "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Retourne la version binaire d’un URI (Uniform Resource Identifier) de données. Utilisez cette fonction plutôt que la fonction decodeDataUri(). Bien que les deux fonctions agissent de manière identique, la fonction dataUriBinary() est préférée.

dataUriToBinary('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	URI de données à convertir

Valeur retournée	Type	Description
<binary-for-data-uri>	String	Version binaire de l’URI de données

Exemple

Cet exemple illustre la création d’une version binaire pour cet URI de données :

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

Et retourne ce résultat :

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retourne la version de type chaîne d’un URI de données.

dataUriToString('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	URI de données à convertir

Valeur retournée	Type	Description
<string-for-data-uri>	String	Version de type chaîne de l’URI de données

Exemple

Cet exemple illustre la création d’une chaîne pour cet URI de données :

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

Et retourne ce résultat : "hello"

dateDifference

Retourne la différence entre deux horodatages (timestamps) sous forme d’intervalle de temps (timespan). Cette fonction soustrait startDate de endDate et retourne le résultat sous forme d’horodatages au format chaîne.

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

Paramètre	Obligatoire	Type	Description
<startDate>	Oui	String	Chaîne qui contient un horodatage
<endDate>	Oui	String	Chaîne qui contient un horodatage

Valeur retournée	Type	Description
<timespan>	String	Différence entre les deux horodatages, qui est un horodatage au format chaîne. Si la date `startDate` est plus récente que `endDate`, le résultat est une valeur négative.

Exemple

Cet exemple soustrait la première valeur de la deuxième :

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

Et retourne ce résultat : "1268.00:00:00"

dayOfMonth

Retourne le jour du mois d’un horodatage.

dayOfMonth('<timestamp>')

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage

Valeur retournée	Type	Description
<day-of-month>	Integer	Jour du mois de l’horodatage spécifié

Exemple

Cet exemple retourne le numéro du jour du mois à partir de cet horodatage :

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

Et retourne ce résultat : 15

dayOfWeek

Retourne le jour de la semaine à partir d’un horodatage.

dayOfWeek('<timestamp>')

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage

Valeur retournée	Type	Description
<day-of-week>	Integer	Jour de la semaine à partir de l’horodatage spécifié où dimanche représente 0, lundi représente 1, etc.

Exemple

Cet exemple retourne le numéro du jour de la semaine à partir de cet horodatage :

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

Et retourne ce résultat : 4

dayOfYear

Retourne le jour de l’année à partir d’un horodatage.

dayOfYear('<timestamp>')

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage

Valeur retournée	Type	Description
<day-of-year>	Integer	Jour de l’année à partir de l’horodatage spécifié

Exemple

Cet exemple retourne le numéro du jour de l’année à partir de cet horodatage :

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

Et retourne ce résultat : 74

Décimal

Retourne un nombre décimal dans une chaîne sous la forme d’un nombre décimal. Vous pouvez utiliser cette fonction lorsque vous travaillez avec des données qui requièrent une précision décimale et également comme entrée pour les fonctions de comparaison logique et mathématiques. Pour capturer et conserver la précision lorsque vous utilisez le résultat de la fonction decimal(), encapsulez toute sortie décimale avec la fonction de chaîne. Cette utilisation est illustrée dans les exemples ci-dessous, où vous pouvez perdre de la précision si vous utilisez le résultat décimal comme nombre.

Notes

La précision décimale décrite dans le contexte de cette fonction et du runtime Azure Logic Apps est identique à la précision décimale de .NET.

decimal('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Nombre décimal dans une chaîne

Valeur retournée	Type	Description
<decimal>	Nombre décimal	Nombre décimal pour la chaîne d’entrée

Exemple 1

Cet exemple crée une valeur décimale qui est utilisée comme nombre :

decimal('1.2345678912312131') // Returns 1.234567891231213.

Exemple 2

Cet exemple crée une valeur décimale, puis convertit le résultat en une chaîne pour la préservation de la précision :

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

Exemple 3

Cet exemple utilise une fonction mathématique sur deux nombres décimaux et utilise le résultat comme nombre :

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

Exemple 4

Cet exemple utilise une fonction mathématique sur deux nombres décimaux et convertit le résultat en une chaîne pour la préservation de la précision :

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

decodeBase64 (déconseillée)

Cette fonction est déconseillée, utilisez base64ToString() à la place.

decodeDataUri

Retourne la version binaire d’un URI (Uniform Resource Identifier) de données. Pensez à utiliser la fonction dataUriToBinary() plutôt que la fonction decodeDataUri(). Bien que les deux fonctions agissent de manière identique, la fonction dataUriToBinary() est préférée.

Notes

decodeDataUri('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne d’URI de données à décoder

Valeur retournée	Type	Description
<binary-for-data-uri>	String	Version binaire d’une chaîne d’URI de données

Exemple

Cet exemple retourne la version binaire de cet URI de données :

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

Et retourne ce résultat :

decodeUriComponent

Retourne une chaîne qui remplace les caractères d’échappement par des versions décodées.

decodeUriComponent('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne contenant les caractères d’échappement à décoder

Valeur retournée	Type	Description
<decoded-uri>	String	Chaîne mise à jour contenant les caractères d’échappement décodés

Exemple

Cet exemple illustre le remplacement des caractères d’échappement de cette chaîne par des versions décodées :

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

Et retourne ce résultat : "https://contoso.com"

div

Renvoyer le résultat de la division de deux nombres. Pour obtenir le reste, consultez mod().

div(<dividend>, <divisor>)

Paramètre	Obligatoire	Type	Description
<dividend>	Oui	Entier ou flottant	Nombre à diviser par le diviseur
<divisor>	Oui	Entier ou flottant	Nombre qui divise le dividende, mais qui ne peut pas être égal à 0

Valeur retournée	Type	Description
<quotient-result>	Entier ou flottant	Résultat de la division du premier nombre par le second. Si le dividende ou le diviseur est de type flottant, le résultat est de type flottant. Remarque : Pour convertir le résultat de type flottant en entier, essayez de créer et appeler une fonction dans Azure à partir de votre application logique.

Exemple 1

Les deux exemples retournent cette valeur avec un type entier : 2

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

Exemple 2

Les deux exemples retournent cette valeur avec un type flottant : 2.2

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

E

encodeUriComponent

Retourne une version encodée sous forme d’URI d’une chaîne en remplaçant les caractères non sécurisés pour les URL par des caractères d’échappement. Pensez à utiliser la fonction uriComponent() plutôt que la fonction encodeUriComponent(). Bien que les deux fonctions agissent de manière identique, la fonction uriComponent() est préférée.

Notes

encodeUriComponent('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne à convertir au format encodé sous forme d’URI

Valeur retournée	Type	Description
<encoded-uri>	String	Chaîne encodée sous forme d’URI avec des caractères d’échappement

Exemple

Cet exemple illustre la création d’une version encodée sous forme d’URI pour cette chaîne :

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

Et retourne ce résultat : "https%3A%2F%2Fcontoso.com"

empty

Vérifie si une collection est vide. Retourne la valeur true lorsque la collection est vide ou la valeur false dans le cas contraire.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Chaîne, tableau ou objet	Collection à vérifier

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true lorsque la collection est vide. Retourne la valeur false lorsque la collection n’est pas vide.

Exemple

Ces exemples vérifient si les collections spécifiées sont vides :

empty('')
empty('abc')

Et retournent les résultats suivants :

Premier exemple : comme une chaîne vide est passée, la fonction retourne true.
Deuxième exemple : comme la chaîne « abc » est passée, la fonction retourne false.

endsWith

Vérifie si une chaîne se termine par une sous-chaîne spécifique. Retourne la valeur true lorsque la sous-chaîne est trouvée ou la valeur false lorsqu’elle est introuvable. Cette fonction ne respecte pas la casse.

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne à vérifier
<searchText>	Oui	String	Sous-chaîne de fin à rechercher

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true lorsque la sous-chaîne de fin est trouvée. Retourne la valeur false lorsqu’elle est introuvable.

Exemple 1

Cet exemple vérifie si la chaîne « hello world » se termine par la chaîne « world » :

endsWith('hello world', 'world')

Et retourne ce résultat : true

Exemple 2

Cet exemple vérifie si la chaîne « hello world » se termine par la chaîne « universe » :

endsWith('hello world', 'universe')

Et retourne ce résultat : false

equals

Vérifie si les deux valeurs, expressions ou objets sont équivalents. Retourne la valeur true si les deux sont équivalents ou la valeur false s’ils ne le sont pas.

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

Paramètre	Obligatoire	Type	Description
<object1>, <object2>	Oui	Divers	Valeurs, expressions ou objets à comparer

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true lorsque les deux sont équivalents. Retourne la valeur false lorsque les deux ne sont pas équivalents.

Exemple

Ces exemples vérifient si les entrées spécifiées sont équivalentes.

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

Et retournent les résultats suivants :

Premier exemple : comme les deux valeurs sont équivalentes, la fonction retourne true.
Deuxième exemple : comme les deux valeurs ne sont pas équivalentes, la fonction retourne false.

F

first

Retourne le premier élément d’une chaîne ou d’un tableau.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Chaîne ou tableau	Collection dans laquelle rechercher le premier élément

Valeur retournée	Type	Description
<first-collection-item>	Quelconque	Premier élément de la collection

Exemple

Ces exemples illustrent la recherche du premier élément dans ces collections :

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

Et retournent les résultats suivants :

Premier exemple : "h"
Second exemple : 0

float

Convertit une version de type chaîne d’un nombre à virgule flottante en nombre réel à virgule flottante. Vous pouvez utiliser cette fonction uniquement lors de la transmission de paramètres personnalisés à une application, par exemple un workflow d’application logique ou un flux Power Automate. Pour convertir des chaînes à virgule flottante représentées dans des formats propres aux paramètres régionaux, vous pouvez éventuellement spécifier un code de paramètres régionaux RFC 4646.

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

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne qui contient un nombre valide à virgule flottante à convertir Les valeurs minimales et maximales sont les mêmes que les limites du type de données float.
<locale>	Non	String	Code de paramètres régionaux RFC 4646 à utiliser. Si aucune valeur n’est spécifiée, les paramètres régionaux par défaut sont utilisés. Si les paramètres régionaux ne sont pas une valeur valide, une erreur est générée, indiquant que les paramètres régionaux fournis ne sont pas valides ou n’ont pas de paramètres régionaux associés.

Valeur retournée	Type	Description
<float-value>	Float	Nombre à virgule flottante de la chaîne spécifiée Les valeurs minimales et maximales sont les mêmes que les limites du type de données float.

Exemple 1

Cet exemple illustre la création d’une version de type chaîne pour ce nombre à virgule flottante :

float('10,000.333')

Et retourne ce résultat : 10000.333

Exemple 2

Cet exemple illustre la création d’une version de type chaîne pour ce nombre à virgule flottante de style allemand :

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

Et retourne ce résultat : 10000.333

formatDateTime

Retourne un horodatage au format spécifié.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire.
<locale>	Non	String	Paramètres régionaux à utiliser. Si la valeur n’est pas spécifiée, la valeur est `en-us`. Si la locale n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<reformatted-timestamp>	String	Le timestamp est mis à jour dans le format et les paramètres régionaux spécifiés, s’ils sont spécifiés.

Exemples

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

formDataMultiValues

Retourne un tableau contenant les valeurs qui correspondent à un nom de clé dans la sortie form-data ou form-encoded d’une action.

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

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Action dont la sortie contient la valeur de clé souhaitée
<key>	Oui	String	Nom de la clé dont vous souhaitez la valeur

Valeur retournée	Type	Description
[<array-with-key-values>]	Array	Tableau contenant toutes les valeurs qui correspondent à la clé spécifiée

Exemple

Cet exemple illustre la création d’un tableau à partir de la valeur de la clé « Subject » dans la sortie form-data ou form-encoded de l’action spécifiée :

formDataMultiValues('Send_an_email', 'Subject')

Et retourne le texte de l’objet dans un tableau, par exemple : ["Hello world"]

formDataValue

Retourne une valeur unique qui correspond à un nom de clé dans la sortie form-data ou form-encoded d’une action. Si la fonction trouve plusieurs correspondances, elle génère une erreur.

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

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Action dont la sortie contient la valeur de clé souhaitée
<key>	Oui	String	Nom de la clé dont vous souhaitez la valeur

Valeur retournée	Type	Description
<key-value>	String	Valeur de la clé spécifiée

Exemple

Cet exemple illustre la création d’une chaîne à partir de la valeur de la clé « Subject » dans la sortie form-data ou form-encoded de l’action spécifiée :

formDataValue('Send_an_email', 'Subject')

Et retourne le texte de l’objet sous forme de chaîne, par exemple : "Hello world"

formatNumber

Retourne un nombre sous forme de chaîne basée sur le format spécifié.

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

Paramètre	Obligatoire	Type	Description
<number>	Oui	Integer ou Double	La valeur que vous souhaitez formater.
<format>	Oui	String	Chaîne de format composite qui spécifie le format que vous souhaitez utiliser. Pour les chaînes de format numériques prises en charge, consultez Chaînes de format numériques standard, qui sont prises en charge par `number.ToString(<format>, <locale>)`.
<locale>	Non	String	Paramètres régionaux à utiliser tels qu’ils sont pris en charge par `number.ToString(<format>, <locale>)`. Si la valeur n’est pas spécifiée, la valeur est `en-us`. Si la locale n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<formatted-number>	String	Nombre spécifié en tant que chaîne au format que vous avez spécifié. Vous pouvez caster cette valeur renvoyée en `int` ou `float`.

Exemple 1

Supposons que vous souhaitez formater le nombre 1234567890. Dans cet exemple, le nombre est formaté en tant que chaîne « 1,234,567,890.00 ».

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

*Exemple 2"

Supposons que vous souhaitez formater le nombre 1234567890. Dans cet exemple, le nombre est formaté en tant que chaîne « 1.234.567.890,00 ».

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

Exemple 3

Supposons que vous souhaitez formater le nombre 17.35. Dans cet exemple, le nombre est formaté en tant que chaîne « $17.35 ».

formatNumber(17.35, 'C2')

Exemple 4

Supposons que vous souhaitez formater le nombre 17.35. Dans cet exemple, le nombre est formaté en tant que chaîne « 17,35 ».

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

G

getFutureTime

Retourne l’horodatage actuel plus les unités de temps spécifiées.

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

Paramètre	Obligatoire	Type	Description
<interval>	Oui	Integer	Nombre d’unités à ajouter
<timeUnit>	Oui	String	L’unité de temps à utiliser avec interval : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Non	String	Spécificateur de format unique ou modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée, car le format fourni n’est pas valide et doit être une chaîne de format numérique.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage actuel plus nombre d’unités de temps spécifié

Exemple 1

Supposez que l’horodatage actuel soit « 2018-03-01T00:00:00.0000000Z ». Cet exemple illustre l’ajout de cinq jours à cet horodatage :

getFutureTime(5, 'Day')

Et retourne ce résultat : "2018-03-06T00:00:00.0000000Z"

Exemple 2

Supposez que l’horodatage actuel soit « 2018-03-01T00:00:00.0000000Z ». Cet exemple illustre l’ajout de cinq jours et convertit le résultat au format « D » :

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

Et retourne ce résultat : "Tuesday, March 6, 2018"

getPastTime

Retourne l’horodatage actuel moins les unités de temps spécifiées.

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

Paramètre	Obligatoire	Type	Description
<interval>	Oui	Integer	Nombre d’unités de temps spécifiées à soustraire
<timeUnit>	Oui	String	L’unité de temps à utiliser avec interval : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Non	String	Spécificateur de format unique ou modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée, car le format fourni n’est pas valide et doit être une chaîne de format numérique.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage actuel moins nombre d’unités de temps spécifié

Exemple 1

Supposez que l’horodatage actuel soit « 2018-02-01T00:00:00.0000000Z ». Cet exemple illustre le retrait de cinq jours de cet horodatage :

getPastTime(5, 'Day')

Et retourne ce résultat : "2018-01-27T00:00:00.0000000Z"

Exemple 2

Supposez que l’horodatage actuel soit « 2018-02-01T00:00:00.0000000Z ». Cet exemple illustre le retrait de cinq jours et convertit le résultat au format « D » :

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

Et retourne ce résultat : "Saturday, January 27, 2018"

greater

Vérifie si la première valeur est supérieure à la seconde. Retourne la valeur true si la première valeur est supérieure ou la valeur false si elle est inférieure.

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

Paramètre	Obligatoire	Type	Description
<value>	Oui	Entier, flottant ou chaîne	Première valeur à vérifier pour déterminer si elle est supérieure à la seconde
<compareTo>	Oui	Respectivement entier, flottant ou chaîne	Valeur de comparaison

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true si la première valeur est supérieure à la seconde. Retourne la valeur false si la première valeur est égale ou inférieure à la seconde.

Exemple

Ces exemples vérifient si la première valeur est supérieure à la seconde :

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

Et retournent les résultats suivants :

Premier exemple : true
Second exemple : false

greaterOrEquals

Vérifie si la première valeur est supérieure ou égale à la seconde. Retourne la valeur true si la première valeur est supérieure ou égale à la seconde, ou la valeur false si la première valeur est inférieure à la seconde.

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

Paramètre	Obligatoire	Type	Description
<value>	Oui	Entier, flottant ou chaîne	Première valeur à vérifier pour déterminer si elle est supérieure ou égale à la seconde
<compareTo>	Oui	Respectivement entier, flottant ou chaîne	Valeur de comparaison

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true si la première valeur est supérieure ou égale à la seconde. Retourne la valeur false si la première valeur est inférieure à la seconde.

Exemple

Ces exemples vérifient si la première valeur est supérieure ou égale à la seconde :

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

Et retournent les résultats suivants :

Premier exemple : true
Second exemple : false

guid

Génère un identificateur global unique (GUID) sous la forme d’une chaîne, par exemple « c2ecc88d-88c8-4096-912c-d6f2e2b138ce » :

guid()

Vous pouvez également spécifier un format différent pour le GUID autre que le format par défaut, « D », qui correspond à 32 chiffres séparés par des traits d’union.

guid('<format>')

Paramètre	Obligatoire	Type	Description
<format>	Non	String	Un seul spécificateur de format pour le GUID retourné. Par défaut, il s’agit du format « D », mais vous pouvez utiliser « N », « D », « B », « P » ou « X ».

Valeur retournée	Type	Description
<GUID-value>	String	GUID généré de manière aléatoire

Exemple

Cet exemple illustre la génération du même GUID, mais sous forme de 32 chiffres séparés par des traits d’union et placés entre parenthèses :

guid('P')

Et retourne ce résultat : "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

Vérifie si une expression est vraie ou fausse. En fonction du résultat, retourne une valeur spécifiée. Les paramètres sont évalués de gauche à droite.

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

Paramètre	Obligatoire	Type	Description
<expression>	Oui	Boolean	Expression à vérifier
<valueIfTrue>	Oui	Quelconque	Valeur à retourner lorsque l’expression est vraie
<valueIfFalse>	Oui	Quelconque	Valeur à retourner lorsque l’expression est fausse

Valeur retournée	Type	Description
<specified-return-value>	Quelconque	Valeur spécifiée retournée selon que l’expression est vraie ou fausse

Exemple

Cet exemple retourne "yes", car l’expression spécifiée retourne la valeur true. Dans le cas contraire, l’exemple retourne "no" :

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

indexOf

Retourne la position ou la valeur d’index de départ d’une sous-chaîne. Cette fonction ne respecte pas la casse, et les index commencent par 0.

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne comportant la sous-chaîne à rechercher
<searchText>	Oui	String	Sous-chaîne à rechercher

Valeur retournée	Type	Description
<index-value>	Integer	Position ou valeur d’index de départ de la sous-chaîne spécifiée. Si la chaîne est introuvable, retourne le chiffre -1.

Exemple

Cet exemple recherche la valeur d’index de départ de la sous-chaîne « world » dans la chaîne « hello world » :

indexOf('hello world', 'world')

Et retourne ce résultat : 6

int

Convertit la version de chaîne d'un entier en nombre entier réel.

int('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Version de chaîne de l'entier à convertir. Les valeurs minimales et maximales sont les mêmes que les limites du type de données d'entier.

Valeur retournée	Type	Description
<integer-result>	Integer	Version de type entier de la chaîne spécifiée Les valeurs minimales et maximales sont les mêmes que les limites du type de données d'entier.

Exemple

Cet exemple illustre la création d’une version de type entier pour la chaîne « 10 » :

int('10')

Et retourne ce résultat : 10

isFloat

Retourne une valeur booléenne indiquant si une chaîne est un nombre à virgule flottante. Par défaut, cette fonction utilise la culture invariante pour le format à virgule flottante. Pour convertir des nombres à virgule flottante représentées dans d’autres formats propres aux paramètres régionaux, vous pouvez éventuellement spécifier un code de paramètres régionaux RFC 4646.

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

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	La chaîne à examiner
<locale>	Non	String	Code de paramètres régionaux RFC 4646 à utiliser

Valeur retournée	Type	Description
<Boolean-result>	Boolean	Valeur booléenne qui indique si la chaîne est un nombre à virgule flottante

Exemple 1

Cet exemple vérifie si une chaîne est un nombre à virgule flottante dans la culture invariante :

isFloat('10,000.00')

Et retourne ce résultat : true

Exemple 2

Cet exemple vérifie si une chaîne est un nombre à virgule flottante dans les paramètres régionaux Allemand :

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

Et retourne ce résultat : true

isInt

Retourne une valeur booléenne qui indique si une chaîne est un entier.

isInt('<string>')

Paramètre	Obligatoire	Type	Description
<string>	Oui	String	La chaîne à examiner

Valeur retournée	Type	Description
<Boolean-result>	Boolean	Valeur booléenne qui indique si une chaîne est un entier

Exemple

Cet exemple vérifie si une chaîne est un entier :

isInt('10')

Et retourne ce résultat : true

item

Lorsqu’elle est utilisée dans une action répétée d’un tableau, retourne l’élément actuel du tableau au cours de l’itération actuelle de l’action. Vous pouvez également obtenir les valeurs à partir des propriétés de cet élément.

item()

Valeur retournée	Type	Description
<current-array-item>	Quelconque	Élément actuel dans le tableau correspondant à l’itération actuelle de l’action

Exemple

Cet exemple illustre l’obtention de l’élément body à partir du message actuel pour l’action « Send_an_email » au sein de l’itération actuelle d’une boucle for-each :

item().body

items

Retourne l’élément actuel à partir de chaque cycle d’une boucle for-each. Utilisez cette fonction à l’intérieur de la boucle for-each.

items('<loopName>')

Paramètre	Obligatoire	Type	Description
<loopName>	Oui	String	Nom de la boucle for-each

Valeur retournée	Type	Description
<item>	Quelconque	Élément à partir du cycle en cours de la boucle for-each spécifiée

Exemple

Cet exemple illustre l’obtention de l’élément actuel à partir de la boucle for-each spécifiée :

items('myForEachLoopName')

iterationIndexes

Retourne la valeur d’index de l’itération actuelle à l’intérieur d’une boucle Until. Vous pouvez utiliser cette fonction à l’intérieur de boucles Until imbriquées.

iterationIndexes('<loopName>')

Paramètre	Obligatoire	Type	Description
<loopName>	Oui	String	Le nom de la boucle Until

Valeur retournée	Type	Description
<index>	Integer	La valeur d’index de l’itération actuelle à l’intérieur d’une boucle Until spécifique

Exemple

Cet exemple crée une variable de compteur et incrémente cette variable par un au cours de chaque itération dans une boucle Until jusqu’à ce que la valeur du compteur atteigne 5. L’exemple crée également une variable qui assure le suivi de l’index actuel pour chaque itération. Lors de chaque itération de la boucle Until, l’exemple incrémente la valeur du compteur, assigne la valeur du compteur à la valeur d’index actuelle, puis incrémente la valeur du compteur. Dans la boucle, cet exemple fait référence à l’index d’itération actuel à l’aide de la fonction iterationIndexes :

iterationIndexes('Until_Max_Increment')

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

J

json

Retourne la valeur, l’objet ou le tableau d’objets de type JSON (JavaScript Object Notation) d’une chaîne ou d’un élément XML.

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

Important

Sans schéma XML définissant la structure de la sortie, la fonction est susceptible de retourner des résultats dont la structure est très différente du format attendu, en fonction de l’entrée.

Ce comportement rend cette fonction inadaptée aux scénarios dans lesquels la sortie doit être conforme à un contrat bien défini, par exemple dans des systèmes ou solutions métier critiques.

Paramètre	Obligatoire	Type	Description
<value>	Oui	Chaîne ou élément XML	Chaîne ou élément XML à convertir

Valeur retournée	Type	Description
<JSON-result>	Type, objet ou tableau natif JSON	Valeur, objet ou tableau d’objets de type JSON de la chaîne ou de l’élément XML d’entrée. - Si vous transmettez du code XML dont l’élément racine comporte un seul élément enfant, la fonction retourne un seul objet JSON pour cet élément enfant. - Si vous transmettez du code XML dont l’élément racine comporte plusieurs éléments enfants, la fonction retourne un tableau contenant des objets JSON pour ces éléments enfants. - Si la chaîne est Null, la fonction retourne un objet vide.

Exemple 1

Cet exemple illustre la conversion de cette chaîne en valeur JSON :

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

Et retourne ce résultat : [1, 2, 3]

Exemple 2

Cet exemple illustre la conversion de cette chaîne en JSON :

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

Et retourne ce résultat :

{
  "fullName": "Sophia Owen"
}

Exemple 3

Cet exemple utilise les fonctions json() et xml() pour convertir du code XML dont l’élément racine comporte un seul élément enfant en un objet JSON nommé person pour cet élément enfant :

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

Et retourne ce résultat :

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

Exemple 4

Cet exemple utilise les fonctions json() et xml() pour convertir du code XML dont l’élément racine comporte plusieurs éléments enfants en un tableau nommé person contenant des objets JSON pour ces éléments enfants :

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

Et retourne ce résultat :

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

intersection

Retourne une collection qui contient uniquement les éléments communs aux collections spécifiées. Pour qu’il apparaisse dans le résultat, un élément doit apparaître dans toutes les collections transmises à cette fonction. Si un ou plusieurs éléments portent le même nom, le dernier élément de ce nom apparaît dans le résultat.

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

Paramètre	Obligatoire	Type	Description
<collection1>, <collection2>, ...	Oui	Tableau ou objet, mais pas les deux	Collections à partir desquelles vous souhaitez uniquement les éléments communs

Valeur retournée	Type	Description
<common-items>	Tableau ou objet, respectivement	Collection qui contient uniquement les éléments communs aux collections spécifiées

Exemple

Cet exemple recherche les éléments communs dans ces tableaux :

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

Et retourne un tableau comportant uniquement ces éléments : [1, 2]

join

Retourne une chaîne qui contient tous les éléments d’un tableau, et dont tous les caractères sont séparés par un séparateur.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Array	Tableau qui comporte les éléments à joindre
<delimiter>	Oui	String	Séparateur affiché entre chaque caractère de la chaîne obtenue

Valeur retournée	Type	Description
<char1><delimiter><char2><delimiter>...	String	Chaîne obtenue créée à partir de tous les éléments du groupe spécifié Remarque : La longueur du résultat ne doit pas dépasser 104 857 600 caractères.

Exemple

Cet exemple illustre la création d’une chaîne à partir de tous les éléments de ce tableau avec le caractère spécifié comme séparateur :

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

Et retourne ce résultat : "a.b.c"

L

last

Retourne le dernier élément d’une collection.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Chaîne ou tableau	Collection dans laquelle rechercher le dernier élément

Valeur retournée	Type	Description
<last-collection-item>	Chaîne ou tableau, respectivement	Dernier élément de la collection

Exemple

Ces exemples illustrent la recherche du dernier élément dans ces collections :

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

Et retournent les résultats suivants :

Premier exemple : "d"
Second exemple : 3

lastIndexOf

Retourne la position de départ ou la valeur d’index de la dernière occurrence d’une sous-chaîne. Cette fonction ne respecte pas la casse, et les index commencent par 0.

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne comportant la sous-chaîne à rechercher
<searchText>	Oui	String	Sous-chaîne à rechercher

Valeur retournée	Type	Description
<ending-index-value>	Integer	Retourne la position de départ ou la valeur d’index de la dernière occurrence de la sous-chaîne spécifiée.

Si la valeur de la chaîne ou de la sous-chaîne est vide, le comportement suivant se produit :

Si seule la valeur de chaîne est vide, la fonction retourne -1.
Si les valeurs de la chaîne et de la sous-chaîne sont vides, la fonction retourne 0.
Si seule la valeur de sous-chaîne est vide, la fonction retourne la longueur de la chaîne moins 1.

Exemples

Cet exemple recherche la valeur d’index de départ de la dernière occurrence de la sous-chaîne world dans la chaîne hello world hello world. Le résultat retourné est 18 :

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

Cet exemple ne contient pas le paramètre de sous-chaîne et retourne une valeur de 22, car la valeur de la chaîne d’entrée (23) moins 1 est supérieure à 0.

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

length

Retourne le nombre d’éléments d’une collection.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Chaîne ou tableau	Collection contenant les éléments à comptabiliser

Valeur retournée	Type	Description
<length-or-count>	Integer	Nombre d’éléments de la collection

Exemple

Ces exemples illustrent le comptage du nombre d’éléments contenus dans ces collections :

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

Et retourne ce résultat : 4

less

Vérifie si la première valeur est inférieure à la seconde. Retourne la valeur true si la première valeur est inférieure à la seconde, ou la valeur false si la première valeur est supérieure à la seconde.

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

Paramètre	Obligatoire	Type	Description
<value>	Oui	Entier, flottant ou chaîne	Première valeur à vérifier pour déterminer si elle est inférieure à la seconde
<compareTo>	Oui	Respectivement entier, flottant ou chaîne	Élément de comparaison

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true si la première valeur est inférieure à la seconde. Retourne la valeur false si la première valeur est égale ou supérieure à la seconde.

Exemple

Ces exemples vérifient si la première valeur est inférieure à la seconde.

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

Et retournent les résultats suivants :

Premier exemple : true
Second exemple : false

lessOrEquals

Vérifie si la première valeur est inférieure ou égale à la seconde. Retourne la valeur true si la première valeur est inférieure ou égale à la seconde, ou la valeur false si la première valeur est supérieure à la seconde.

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

Paramètre	Obligatoire	Type	Description
<value>	Oui	Entier, flottant ou chaîne	Première valeur à vérifier pour déterminer si elle est inférieure ou égale à la seconde
<compareTo>	Oui	Respectivement entier, flottant ou chaîne	Élément de comparaison

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true si la première valeur est inférieure ou égale à la seconde. Retourne la valeur false si la première valeur est supérieure à la seconde.

Exemple

Ces exemples vérifient si la première valeur est inférieure ou égale à la seconde.

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

Et retournent les résultats suivants :

Premier exemple : true
Second exemple : false

listCallbackUrl

Renvoyer l’« URL de rappel » qui appelle un déclencheur ou une action. Cette fonction fonctionne uniquement avec les déclencheurs et actions pour les types de connecteur HttpWebhook et ApiConnectionWebhook, mais pas les types Manual, Recurrence, HTTP ni APIConnection.

listCallbackUrl()

Valeur retournée	Type	Description
<callback-URL>	String	URL de rappel d’un déclencheur ou d’une action

Exemple

Cet exemple illustre un exemple d’URL de rappel que cette fonction peut retourner :

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

M

max

Retourne la valeur la plus élevée d’une liste ou d’un tableau de nombres incluse aux deux extrémités.

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

Paramètre	Obligatoire	Type	Description
<number1>, <number2>, ...	Oui	Entier, flottant ou les deux	Ensemble de nombres dont vous voulez la valeur la plus élevée
[<number1>, <number2>, ...]	Oui	Tableau : entier, flottant ou les deux	Tableau de nombres dont vous voulez la valeur la plus élevée

Valeur retournée	Type	Description
<max-value>	Entier ou flottant	Valeur la plus élevée dans le tableau ou l’ensemble de nombres spécifié

Exemple

Ces exemples illustrent l’obtention de la valeur la plus élevée de l’ensemble des nombres et du tableau :

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

Et retourne ce résultat : 3

min

Retourne la plus petite valeur d’un ensemble de nombres ou d’un tableau.

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

Paramètre	Obligatoire	Type	Description
<number1>, <number2>, ...	Oui	Entier, flottant ou les deux	Ensemble de nombres dont vous voulez la valeur la plus petite
[<number1>, <number2>, ...]	Oui	Tableau : entier, flottant ou les deux	Tableau de nombres dont vous voulez la valeur la plus petite

Valeur retournée	Type	Description
<min-value>	Entier ou flottant	Valeur la plus petite dans le tableau ou l’ensemble de nombres spécifiés

Exemple

Ces exemples illustrent l’obtention de la valeur la plus petite de l’ensemble des nombres et du tableau :

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

Et retourne ce résultat : 1

mod

Retourne le reste de la division de deux nombres. Pour obtenir le résultat sous forme d’un entier, consultez div().

mod(<dividend>, <divisor>)

Paramètre	Obligatoire	Type	Description
<dividend>	Oui	Entier ou flottant	Nombre à diviser par le diviseur
<divisor>	Oui	Entier ou flottant	Nombre qui divise le dividende, mais qui ne peut pas être égal à 0

Valeur retournée	Type	Description
<modulo-result>	Entier ou flottant	Reste de la division du premier nombre par le second nombre

Exemple 1

Cet exemple illustre la division du premier nombre par le second nombre :

mod(3, 2)

Et retourne ce résultat : 1

Exemple 2

Cet exemple montre que si l’une ou les deux valeurs sont négatives, le résultat correspond au signe du dividende :

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

L’exemple renvoie les résultats suivants :

Premier exemple : -1
Second exemple : 1

mul

Retourne le produit de la multiplication de deux nombres.

mul(<multiplicand1>, <multiplicand2>)

Paramètre	Obligatoire	Type	Description
<multiplicand1>	Oui	Entier ou flottant	Nombre à multiplier par multiplicand2
<multiplicand2>	Oui	Entier ou flottant	Nombre qui multiplie multiplicand1

Valeur retournée	Type	Description
<product-result>	Entier ou flottant	Produit de la multiplication du premier nombre par le second nombre

Exemple

Ces exemples illustrent la multiplication du premier nombre par le second nombre :

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

Et retournent les résultats suivants :

Premier exemple : 2
Second exemple : 3

multipartBody

Renvoyer le corps correspondant à une partie spécifique de la sortie d’une action qui comporte plusieurs parties.

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

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Nom de l’action dont la sortie compte plusieurs parties
<index>	Oui	Integer	Valeur d’index pour la partie que vous souhaitez

Valeur retournée	Type	Description
<body>	String	Corps de la partie spécifiée

N

not

Vérifie si une expression est fausse. Retourne la valeur true lorsque l’expression est fausse, ou la valeur false lorsque l’expression est vraie.

not(<expression>)

Paramètre	Obligatoire	Type	Description
<expression>	Oui	Boolean	Expression à vérifier

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true lorsque l’expression est fausse. Retourne la valeur false lorsque l’expression est vraie.

Exemple 1

Ces exemples vérifient si les expressions spécifiées sont fausses :

not(false)
not(true)

Et retournent les résultats suivants :

Premier exemple : comme l’expression est fausse, la fonction retourne true.
Deuxième exemple : comme l’expression est vraie, la fonction retourne false.

Exemple 2

Ces exemples vérifient si les expressions spécifiées sont fausses :

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

Et retournent les résultats suivants :

Premier exemple : comme l’expression est fausse, la fonction retourne true.
Deuxième exemple : comme l’expression est vraie, la fonction retourne false.

nthIndexOf

Retourne la position de départ ou la valeur d’index où la nième occurrence d’une sous-chaîne apparaît dans une chaîne.

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	La chaîne qui contient la sous-chaîne à trouver
<searchText>	Oui	String	Sous-chaîne à rechercher
<occurrence>	Oui	Integer	Nombre qui spécifie la nième occurrence de la sous-chaîne à rechercher. Si l’occurrence est négative, commence à rechercher à partir de la fin.

Valeur retournée	Type	Description
<index-value>	Integer	Retourne la position de départ ou la valeur d’index de la nième occurrence de la sous-chaîne spécifiée. Si la sous-chaîne est introuvable ou qu’il y a moins de n occurrences de la sous-chaîne, retourne `-1`.

Exemples

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

O

or

Vérifie si au moins une expression est vraie. Retourne la valeur true si au moins une expression est vraie ou la valeur false si toutes les expressions sont fausses.

or(<expression1>, <expression2>, ...)

Paramètre	Obligatoire	Type	Description
<expression1>, <expression2>, …	Oui	Boolean	Expressions à vérifier

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true si au moins une expression est vraie. Retourne la valeur false lorsque toutes les expressions sont fausses.

Exemple 1

Ces exemples vérifient si au moins une expression est vraie :

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

Et retournent les résultats suivants :

Premier exemple : comme au moins une expression est vraie, la fonction retourne true.
Deuxième exemple : comme les deux expressions sont fausses, la fonction retourne false.

Exemple 2

Ces exemples vérifient si au moins une expression est vraie :

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

Et retournent les résultats suivants :

Premier exemple : comme au moins une expression est vraie, la fonction retourne true.
Deuxième exemple : comme les deux expressions sont fausses, la fonction retourne false.

outputs

Retourne les sorties d’une action lors de l’exécution. Utilisez cette fonction plutôt que actionOutputs(), qui correspond à outputs() dans le concepteur. Bien que les deux fonctions agissent de manière identique, la fonction outputs() est préférée.

outputs('<actionName>')

Paramètre	Obligatoire	Type	Description
<actionName>	Oui	String	Nom de la sortie de l’action souhaitée

Valeur retournée	Type	Description
<output>	String	Sortie de l’action spécifiée

Exemple

Cet exemple illustre l’obtention de la sortie de l’action Twitter Get user :

outputs('Get_user')

Et retourne ce résultat :

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

P

parameters

Retourne la valeur d’un paramètre décrit dans la définition de votre flux de travail.

parameters('<parameterName>')

Paramètre	Obligatoire	Type	Description
<parameterName>	Oui	String	Nom du paramètre dont vous voulez la valeur

Valeur retournée	Type	Description
<parameter-value>	Quelconque	Valeur du paramètre spécifié

Exemple

Supposez que la valeur JSON soit la suivante :

{
  "fullName": "Sophia Owen"
}

Cet exemple illustre l’obtention de la valeur du paramètre spécifié :

parameters('fullName')

Et retourne ce résultat : "Sophia Owen"

parseDateTime

Retourne le timestamp d’une chaîne qui contient un timestamp.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<locale>	Non	String	Paramètres régionaux à utiliser. Si aucune valeur n’est spécifiée, les paramètres régionaux par défaut sont `en-us`. Si les paramètres régionaux ne sont pas une valeur valide, une erreur est générée.
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas spécifié, essayez d’analyser plusieurs formats compatibles avec les paramètres régionaux fournis. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<parsed-timestamp>	String	L’horodatage analysé est au format « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire.

Exemples

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

R

rand

Retourne un entier aléatoire à partir d’une plage spécifiée, qui est inclus uniquement au point de départ.

rand(<minValue>, <maxValue>)

Paramètre	Obligatoire	Type	Description
<minValue>	Oui	Integer	Entier le plus petit de la plage
<maxValue>	Oui	Integer	Entier qui suit l’entier le plus élevé dans la plage que la fonction peut retourner

Valeur retournée	Type	Description
<random-result>	Integer	Entier aléatoire retourné à partir de la plage spécifiée

Exemple

Cet exemple illustre l’obtention d’un entier aléatoire à partir de la plage spécifiée, en excluant la valeur maximale :

rand(1, 5)

Et retourne l’un de ces nombres comme résultat : 1, 2, 3 ou 4

range

Retourne un tableau d’entiers qui commence par un entier spécifique.

range(<startIndex>, <count>)

Paramètre	Obligatoire	Type	Description
<startIndex>	Oui	Integer	Une valeur entière qui constitue le premier élément du tableau
<count>	Oui	Integer	Nombre d’entiers dans le tableau. La valeur du paramètre `count` doit être un entier positif qui ne dépasse pas 100 000. Remarque : La somme des valeurs `startIndex` et `count` ne doit pas dépasser 2 147 483 647.

Valeur retournée	Type	Description
[<range-result>]	Array	Tableau dont les entiers commencent à partir de l’index spécifié

Exemple

Cet exemple illustre la création d’un tableau d’entiers qui commence à partir de l’index spécifié et qui possède le nombre spécifié d’entiers :

range(1, 4)

Et retourne ce résultat : [1, 2, 3, 4]

removeProperty

Supprime une propriété dans un objet et retourne l’objet mis à jour. Si la propriété que vous essayez de supprimer n’existe pas, la fonction retourne l’objet d’origine.

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

Paramètre	Obligatoire	Type	Description
<object>	Oui	Object	Objet JSON dont vous souhaitez supprimer une propriété
<property>	Oui	String	Nom de la propriété à supprimer

Valeur retournée	Type	Description
<updated-object>	Object	Objet JSON mis à jour sans la propriété spécifiée

Pour supprimer une propriété enfant d’une propriété existante, utilisez cette syntaxe :

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

Paramètre	Obligatoire	Type	Description
<object>	Oui	Object	Objet JSON dont vous voulez supprimer la propriété
<parent-property>	Oui	String	Nom de la propriété parente avec la propriété enfant que vous voulez supprimer
<child-property>	Oui	String	Nom de la propriété enfant à supprimer

Valeur retournée	Type	Description
<updated-object>	Object	Objet JSON mis à jour dont vous avez supprimé la propriété enfant

Exemple 1

Cet exemple supprime la propriété middleName d’un objet JSON, qui est converti d’une chaîne en un format JSON avec la fonction JSON(), et retourne l’objet mis à jour :

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

Voici l’objet JSON actuel :

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

Voici l’objet JSON mis à jour :

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

Exemple 2

Cet exemple supprime la propriété enfant middleName d’une propriété parente customerName dans un objet JSON, qui est converti d’une chaîne en un format JSON avec la fonction JSON(), et retourne l’objet mis à jour :

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

Voici l’objet JSON actuel :

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

Voici l’objet JSON mis à jour :

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

remplacer

Remplace une sous-chaîne par la chaîne spécifiée et retourne la chaîne de résultat. Cette fonction respecte la casse.

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne comportant la sous-chaîne à remplacer
<oldText>	Oui	String	Sous-chaîne à remplacer
<newText>	Oui	String	Chaîne de remplacement

Valeur retournée	Type	Description
<updated-text>	Chaîne	Chaîne mise à jour après le remplacement de la sous-chaîne Si la sous-chaîne est introuvable, retourne la chaîne d’origine.

Exemple

Cet exemple recherche l’ancienne sous-chaîne dans l’ancienne chaîne, et remplace « old » par « new » :

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

Et retourne ce résultat : "the new string"

result

Retourne les résultats des actions de niveau supérieur à l’intérieur de l’action délimitée spécifiée, comme l’action For_each, Until ou Scope. La fonction result() accepte un seul paramètre, le nom de l’étendue, et elle retourne un tableau contenant les informations des actions de premier niveau dans cette étendue. Ces objets d’action incluent les mêmes attributs que ceux retournés par la fonction actions(), comme l’heure de début, l’heure de fin, l’état, les entrées, les ID de corrélation et les sorties de l’action.

Notes

Cette fonction retourne des informations uniquement à partir des actions de premier niveau dans l’action délimitée, et non pas à partir d’actions imbriquées plus approfondies telles que les actions de condition ou de basculement.

Par exemple, vous pouvez utiliser cette fonction pour obtenir les résultats des actions ayant échoué afin de pouvoir diagnostiquer et gérer les exceptions. Pour plus d’informations, consultez Obtenir le contexte et les résultats des échecs.

result('<scopedActionName>')

Paramètre	Obligatoire	Type	Description
<scopedActionName>	Oui	String	Nom de l’action délimitée dans l’étendue de laquelle vous voulez voir les entrées et les sorties des actions de niveau supérieur

Valeur retournée	Type	Description
<array-object>	Objet tableau	Tableau qui contient des tableaux d’entrées et de sorties de chaque action de niveau supérieur dans l’étendue spécifiée

Exemple

Cet exemple retourne les entrées et les sorties de chaque itération d’une action HTTP qui est à l’intérieur d’une boucle For_each en utilisant la fonction result() dans l’action Compose :

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

Voici comment l’exemple de tableau retourné peut se présenter, où l’objet externe outputs contient les entrées et les sorties de chaque itération des actions à l’intérieur de l’action For_each.

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

reverse

Inverse l’ordre des éléments d’une collection. Quand vous utilisez cette fonction avec sort(), vous pouvez trier une collection par ordre décroissant.

reverse([<collection>])

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Array	La collection à inverser

Valeur retournée	Type	Description
[<updated-collection>]	Array	La collection inversée

Exemple

Cet exemple inverse un tableau d’entiers :

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

Et retourne ce tableau : [3,2,1,0]

S

SetProperty

Définit la valeur d’une propriété d’un objet JSON et retourne l’objet mis à jour. Si la propriété que vous essayez de définir n’existe pas, la propriété est ajoutée à l’objet. Pour ajouter une nouvelle propriété, utilisez la fonction addProperty().

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

Paramètre	Obligatoire	Type	Description
<object>	Oui	Object	Objet JSON dont vous souhaitez définir la propriété
<property>	Oui	String	Nom de la propriété existante ou nouvelle à définir
<value>	Oui	Quelconque	Valeur à définir pour la propriété spécifiée

Pour définir la propriété enfant dans un objet enfant, utilisez à la place un appel setProperty() imbriqué. Sinon, la fonction retourne seulement l’objet enfant comme sortie.

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

Paramètre	Obligatoire	Type	Description
<object>	Oui	Object	Objet JSON dont vous souhaitez définir la propriété
<parent-property>	Oui	String	Nom de la propriété parente avec la propriété enfant que vous voulez définir
<child-property>	Oui	String	Nom de la propriété enfant à définir
<value>	Oui	Quelconque	Valeur à définir pour la propriété spécifiée

Valeur retournée	Type	Description
<updated-object>	Object	Objet JSON mis à jour dont vous définissez la propriété

Exemple 1

Cet exemple définit la propriété surName dans un objet JSON, qui est converti d’une chaîne en un format JSON avec la fonction JSON(). La fonction affecte la valeur spécifiée à la propriété et retourne l’objet mis à jour :

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

Voici l’objet JSON actuel :

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

Voici l’objet JSON mis à jour :

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

Exemple 2

Cet exemple définit la propriété enfant surName pour la propriété parente customerName dans un objet JSON, qui est converti d’une chaîne en un format JSON avec la fonction JSON(). La fonction affecte la valeur spécifiée à la propriété et retourne l’objet mis à jour :

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

Voici l’objet JSON actuel :

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

Voici l’objet JSON mis à jour :

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

skip

Supprime des éléments du début d’une collection et retourne tous les autres éléments.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Array	Collection dont vous voulez supprimer des éléments
<count>	Oui	Integer	Entier positif correspondant au nombre d’éléments à supprimer au début

Valeur retournée	Type	Description
[<updated-collection>]	Array	Collection mise à jour à l’issue de la suppression des éléments spécifiés

Exemple

Cet exemple illustre la suppression d’un élément, le nombre 0, au début du tableau spécifié :

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

Et retourne ce tableau avec les éléments restants : [1,2,3]

slice

Retourne une sous-chaîne en spécifiant la position ou la valeur de début et de fin. Consultez également substring().

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	La chaîne qui contient la sous-chaîne à trouver
<startIndex>	Oui	Entier	Position ou valeur de départ de base zéro pour l’emplacement où commencer la recherche de la sous-chaîne - Si startIndex est supérieur à la longueur de la chaîne, retourne une chaîne vide. - Si startIndex est négatif, commence à rechercher à la valeur d’index qui est la somme de la longueur de la chaîne et de startIndex.
<endIndex>	Non	Integer	Position de fin de base zéro ou valeur pour l’emplacement de fin de la recherche de la sous-chaîne. Le caractère situé à la valeur d’index de fin n’est pas inclus dans la recherche. - Si endIndex n’est pas spécifié ou supérieur à la longueur de chaîne, recherche jusqu’à la fin de la chaîne. - Si endIndex est négatif, termine la recherche à la valeur d’index qui correspond à la somme de la longueur de chaîne et endIndex.

Valeur retournée	Type	Description
<slice-result>	String	Nouvelle chaîne qui contient la sous-chaîne trouvée

Exemples

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

sort

Trie les éléments d’une collection. Vous pouvez trier les objets de la collection en utilisant n’importe quelle clé contenant un type simple.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Array	La collection contenant les éléments à trier
<sortBy>	Non	String	La clé à utiliser pour trier les objets de la collection

Valeur retournée	Type	Description
[<updated-collection>]	Array	La collection triée

Exemple 1

Cet exemple trie un tableau d’entiers :

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

Et retourne ce tableau : [0,1,2,3]

Exemple 2

Cet exemple trie un tableau d’entiers par clé :

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

Et retourne ce tableau : [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

split

Retourne un tableau qui contient des sous-chaînes, séparées par des virgules, extraites sur la base du caractère délimiteur spécifié dans la chaîne d’origine.

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	La chaîne pour séparer les sous-chaînes en fonction du délimiteur spécifié dans la chaîne d’origine
<delimiter>	Oui	String	Le caractère dans la chaîne d’origine à utiliser comme délimiteur

Valeur retournée	Type	Description
[<substring1>,<substring2>,...]	Array	Un tableau qui contient les sous-chaînes extraites de la chaîne d’origine, séparées par des virgules

Exemple 1

Cet exemple crée un tableau avec des sous-chaînes extraites de la chaîne spécifiée selon le caractère spécifié comme délimiteur :

split('a_b_c', '_')

Et retourne ce tableau en tant que résultat : ["a","b","c"]

Exemple 2

Cet exemple crée un tableau avec un seul élément lorsqu’il n’existe aucun délimiteur dans la chaîne :

split('a_b_c', ' ')

Et retourne ce tableau en tant que résultat : ["a_b_c"]

startOfDay

Retourne le début du jour d’un horodatage.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage spécifié, mais commençant à la marque zéro-heure du jour

Exemple

Cet exemple recherche le début du jour pour cet horodatage :

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

Et retourne ce résultat : "2018-03-15T00:00:00.0000000Z"

startOfHour

Retourne le début de l’heure d’un horodatage.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage spécifié, mais commençant à la marque zéro-minute de l’heure

Exemple

Cet exemple recherche le début de l’heure pour cet horodatage :

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

Et retourne ce résultat : "2018-03-15T13:00:00.0000000Z"

startOfMonth

Retourne le début du mois pour un horodatage.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage spécifié, mais démarrant le premier jour du mois à la marque zéro-heure

Exemple 1

Cet exemple retourne le début du mois pour cet horodatage :

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

Et retourne ce résultat : "2018-03-01T00:00:00.0000000Z"

Exemple 2

Cet exemple retourne le début du mois dans le format spécifié pour cet horodatage :

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

Et retourne ce résultat : "2018-03-01"

startsWith

Vérifie si une chaîne commence par une sous-chaîne spécifique. Retourne la valeur true lorsque la sous-chaîne est trouvée ou la valeur false lorsqu’elle est introuvable. Cette fonction ne respecte pas la casse.

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne à vérifier
<searchText>	Oui	String	Chaîne de départ à rechercher

Valeur retournée	Type	Description
True ou False	Boolean	Retourne la valeur true lorsque la sous-chaîne de début est trouvée. Retourne la valeur false lorsqu’elle est introuvable.

Exemple 1

Cet exemple vérifie si la chaîne « hello world » commence par la sous-chaîne « hello » :

startsWith('hello world', 'hello')

Et retourne ce résultat : true

Exemple 2

Cet exemple vérifie si la chaîne « hello world » commence par la sous-chaîne « greetings » :

startsWith('hello world', 'greetings')

Et retourne ce résultat : false

string

Retourne la version de type chaîne d’une valeur.

string(<value>)

Paramètre	Obligatoire	Type	Description
<value>	Oui	Quelconque	La valeur à convertir. Si cette valeur est null ou prend la valeur null, la valeur est convertie en une valeur de chaîne vide (`""`). Par exemple, si vous assignez une variable de chaîne à une propriété inexistante, à laquelle vous pouvez accéder avec l’opérateur `?`, la valeur null est convertie en chaîne vide. Toutefois, la comparaison d’une valeur NULL n’est pas identique à la comparaison d’une chaîne vide.

Valeur retournée	Type	Description
<string-value>	String	Version de type de la chaîne de la valeur spécifiée. Si le paramètre de cette valeur est NULL ou prend la valeur NULL, cette valeur est renvoyée en tant qu’une valeur de chaîne vide (`""`).

Exemple 1

Cet exemple illustre la création de la version de type chaîne pour ce nombre :

string(10)

Et retourne ce résultat : "10"

Exemple 2

Cet exemple illustre la création d’une chaîne pour l’objet JSON spécifié et utilise le caractère de barre oblique inverse (\) comme caractère d’échappement pour le guillemet double (").

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

Et retourne ce résultat : "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Retourne le résultat de la soustraction du second nombre du premier.

sub(<minuend>, <subtrahend>)

Paramètre	Obligatoire	Type	Description
<minuend>	Oui	Entier ou flottant	Nombre à partir duquel soustraire le plus petit terme
<subtrahend>	Oui	Entier ou flottant	Nombre à soustraire du plus petit terme

Valeur retournée	Type	Description
<result>	Entier ou flottant	Résultat de la soustraction du second nombre du premier

Exemple

Cet exemple illustre la soustraction du second nombre du premier :

sub(10.3, .3)

Et retourne ce résultat : 10

substring

Retourne les caractères d’une chaîne, en commençant à partir de la position spécifiée ou de l’index. Les valeurs d’index commencent par le chiffre 0. Consultez également slice().

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

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne dont vous souhaitez les caractères
<startIndex>	Oui	Integer	Une valeur positive supérieure ou égale à 0 que vous souhaitez utiliser comme la valeur de position ou l’index de départ
<length>	Non	Integer	Nombre positif de caractères que vous souhaitez dans la sous-chaîne

Notes

Vérifiez que la somme issue de l’addition des valeurs de paramètre startIndex et length est inférieure à la longueur de la chaîne que vous fournissez pour le paramètre text. Si ce n’est pas le cas, vous obtenez une erreur, à la différence de fonctions similaires dans d’autres langages où le résultat correspond au substring entre startIndex et la fin de la chaîne. Le paramètre length est optionnel et n’est pas fourni, la fonction substring() sélectionne tous les caractères de startIndex jusqu’à la fin de la chaîne.

Valeur retournée	Type	Description
<substring-result>	String	Sous-chaîne contenant le nombre spécifié de caractères, en commençant à la position d’index spécifiée dans la chaîne source

Exemple

Cet exemple illustre la création d’une sous-chaîne de cinq caractères à partir de la chaîne spécifiée, en commençant à partir de la valeur d’index 6 :

substring('hello world', 6, 5)

Et retourne ce résultat : "world"

subtractFromTime

Soustrait un nombre d’unités de temps d’un horodatage. Voir aussi getPastTime.

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

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne qui contient l’horodatage
<interval>	Oui	Integer	Nombre d’unités de temps spécifiées à soustraire
<timeUnit>	Oui	String	L’unité de temps à utiliser avec interval : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<updated-timestamp>	String	Horodatage moins le nombre d’unités de temps spécifié

Exemple 1

Cet exemple soustrait un jour de cet horodatage :

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

Et retourne ce résultat : "2018-01-01T00:00:00.0000000Z"

Exemple 2

Cet exemple soustrait un jour de cet horodatage :

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

Et retourne ce résultat en utilisant le format « D » facultatif : "Monday, January, 1, 2018"

T

take

Retourne des éléments du début d’une collection.

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

Paramètre	Obligatoire	Type	Description
<collection>	Oui	Chaîne ou tableau	Collection dont vous souhaitez des éléments
<count>	Oui	Integer	Entier positif correspondant au nombre d’éléments que vous souhaitez à partir du début

Valeur retournée	Type	Description
<subset> or [<subset>]	Chaîne ou tableau, respectivement	Chaîne ou tableau qui comporte le nombre spécifié d’éléments obtenus à partir du début de la collection d’origine

Exemple

Ces exemples illustrent l’obtention du nombre spécifié d’éléments à partir du début de ces collections :

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

Et retournent les résultats suivants :

Premier exemple : "abc"
Second exemple : [0, 1, 2]

ticks

Retourne le nombre de cycles, soit des intervalles de 100 nanosecondes, depuis le 1er janvier 0001 12:00:00 minuit (ou DateTime.Ticks en C#) jusqu’à l’horodatage spécifié. Pour plus d’informations, consultez la rubrique suivante : Propriété DateTime.Ticks (Système).

ticks('<timestamp>')

Paramètre	Obligatoire	Type	Description
<timestamp>	Oui	String	Chaîne d’un horodatage

Valeur retournée	Type	Description
<ticks-number>	Integer	Nombre de graduations depuis l’horodatage spécifié

toLower

Retourne une chaîne en minuscules. Si un caractère de la chaîne n’a pas de version en minuscules, ce caractère reste tel quel dans la chaîne retournée.

toLower('<text>')

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne à retourner en minuscules

Valeur retournée	Type	Description
<lowercase-text>	String	Chaîne d’origine en minuscules

Exemple

Cet exemple illustre la conversion de cette chaîne en minuscules :

toLower('Hello World')

Et retourne ce résultat : "hello world"

toUpper

Retourne une chaîne en majuscules. Si un caractère de la chaîne n’a pas de version en majuscules, ce caractère reste tel quel dans la chaîne retournée.

toUpper('<text>')

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne à retourner en majuscules

Valeur retournée	Type	Description
<uppercase-text>	String	Chaîne d’origine en majuscules

Exemple

Cet exemple illustre la conversion de cette chaîne en majuscules :

toUpper('Hello World')

Et retourne ce résultat : "HELLO WORLD"

déclencheur

Retourne la sortie d’un déclencheur lors de l’exécution ou les valeurs d’autres paires nom-valeur JSON que vous pouvez attribuer à une expression.

Dans les entrées d’un déclencheur, cette fonction retourne la sortie de l’exécution précédente.
Dans une condition d’un déclencheur, cette fonction retourne la sortie de l’exécution actuelle.

Par défaut, la fonction fait référence à l’objet de déclencheur dans son intégralité, mais vous pouvez éventuellement spécifier une propriété dont vous souhaitez la valeur. En outre, des versions raccourcies sont disponibles pour cette fonction. Voir triggerOutputs() et triggerBody().

trigger()

Valeur retournée	Type	Description
<trigger-output>	String	Sortie d’un déclencheur à l’exécution

triggerBody

Renvoyer la sortie body d’un déclencheur lors de l’exécution. Raccourci de trigger().outputs.body. Voir trigger().

triggerBody()

Valeur retournée	Type	Description
<trigger-body-output>	String	Sortie `body` du déclencheur

triggerFormDataMultiValues

Retourne un tableau contenant les valeurs qui correspondent à un nom de clé dans la sortie form-data ou form-encoded d’un déclencheur.

triggerFormDataMultiValues('<key>')

Paramètre	Obligatoire	Type	Description
<key>	Oui	String	Nom de la clé dont vous souhaitez la valeur

Valeur retournée	Type	Description
[<array-with-key-values>]	Array	Tableau contenant toutes les valeurs qui correspondent à la clé spécifiée

Exemple

Cet exemple illustre la création d’un tableau à partir de la valeur de la clé « feedUrl » dans la sortie form-data ou form-encoded d’un déclencheur RSS :

triggerFormDataMultiValues('feedUrl')

Et retourne ce tableau en tant qu’exemple de résultat : ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Retourne une chaîne contenant une valeur unique qui correspond à un nom de clé dans la sortie form-data ou form-encoded d’un déclencheur. Si la fonction trouve plusieurs correspondances, elle génère une erreur.

triggerFormDataValue('<key>')

Paramètre	Obligatoire	Type	Description
<key>	Oui	String	Nom de la clé dont vous souhaitez la valeur

Valeur retournée	Type	Description
<key-value>	String	Valeur de la clé spécifiée

Exemple

Cet exemple illustre la création d’une chaîne à partir de la valeur de la clé « feedUrl » dans la sortie form-data ou form-encoded d’un déclencheur RSS :

triggerFormDataValue('feedUrl')

Et retourne cette chaîne en tant qu’exemple de résultat : "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Retourne le corps correspondant à une partie spécifique dans la sortie d’un déclencheur qui comporte plusieurs parties.

triggerMultipartBody(<index>)

Paramètre	Obligatoire	Type	Description
<index>	Oui	Integer	Valeur d’index pour la partie que vous souhaitez

Valeur retournée	Type	Description
<body>	String	Corps de la partie spécifiée dans la sortie en plusieurs parties d’un déclencheur

triggerOutputs

Renvoyer la sortie d’un déclencheur lors de l’exécution ou les valeurs d’autres paires nom-valeur JSON. Raccourci de trigger().outputs. Voir trigger().

triggerOutputs()

Valeur retournée	Type	Description
<trigger-output>	String	Sortie d’un déclencheur à l’exécution

trim

Supprime les espaces blancs de début et de fin d’une chaîne et retourne la chaîne mise à jour.

trim('<text>')

Paramètre	Obligatoire	Type	Description
<text>	Oui	String	Chaîne contenant les espaces blancs de début et de fin à supprimer

Valeur retournée	Type	Description
<updatedText>	String	Version mise à jour de la chaîne d’origine sans espace blanc de début ou de fin

Exemple

Dans cet exemple, les espaces blancs de début et de fin sont supprimés de la chaîne " Hello World " :

trim(' Hello World  ')

Et retourne ce résultat : "Hello World"

U

union

Retourne une collection qui contient tous les éléments des collections spécifiées. Pour qu’il apparaisse dans le résultat, un élément peut apparaître dans n’importe quelle collection transmise à cette fonction. Si un ou plusieurs éléments portent le même nom, le dernier élément de ce nom apparaît dans le résultat.

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

Paramètre	Obligatoire	Type	Description
<collection1>, <collection2>, ...	Oui	Tableau ou objet, mais pas les deux	Collections dont vous souhaitez tous les éléments

Valeur retournée	Type	Description
<updatedCollection>	Tableau ou objet, respectivement	Collection qui contient tous les éléments des collections spécifiées (pas de doublons)

Exemple

Cet exemple illustre l’obtention de tous les éléments de ces collections :

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

Et retourne ce résultat : [1, 2, 3, 10, 101]

uriComponent

Retourne une version encodée sous forme d’URI d’une chaîne en remplaçant les caractères non sécurisés pour les URL par des caractères d’échappement. Utilisez cette fonction plutôt que la fonction encodeUriComponent(). Bien que les deux fonctions agissent de manière identique, la fonction uriComponent() est préférée.

uriComponent('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne à convertir au format encodé sous forme d’URI

Valeur retournée	Type	Description
<encoded-uri>	String	Chaîne encodée sous forme d’URI avec des caractères d’échappement

Exemple

Cet exemple illustre la création d’une version encodée sous forme d’URI pour cette chaîne :

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

Et retourne ce résultat : "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

Retourne la version binaire d’un composant d’URI.

uriComponentToBinary('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne encodée sous forme d’URI à convertir

Valeur retournée	Type	Description
<binary-for-encoded-uri>	String	Version binaire de la chaîne encodée sous forme d’URI. Le contenu binaire est encodé en Base64 et représenté par `$content`.

Exemple

Cet exemple illustre la création de la version binaire de cette chaîne encodée sous forme d’URI :

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

Et retourne ce résultat :

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Retourne la version de type chaîne d’une chaîne encodée sous forme d’URI, en décodant efficacement la chaîne encodée sous forme d’URI.

uriComponentToString('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	String	Chaîne encodée sous forme d’URI à décoder

Valeur retournée	Type	Description
<decoded-uri>	String	Version décodée de la chaîne encodée sous forme d’URI

Exemple

Cet exemple illustre la création de la version de type chaîne décodée pour cette chaîne encodée sous forme d’URI :

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

Et retourne ce résultat : "https://contoso.com"

uriHost

Renvoyer la valeur host pour un URI (Uniform Resource Identifier).

uriHost('<uri>')

Paramètre	Obligatoire	Type	Description
<uri>	Oui	String	URI dont vous souhaitez la valeur `host`

Valeur retournée	Type	Description
<host-value>	String	Valeur `host` de l’URI spécifié

Exemple

Cet exemple recherche la valeur host pour cet URI :

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

Et retourne ce résultat : "www.localhost.com"

uriPath

Renvoyer la valeur path pour un URI (Uniform Resource Identifier).

uriPath('<uri>')

Paramètre	Obligatoire	Type	Description
<uri>	Oui	String	URI dont vous souhaitez la valeur `path`

Valeur retournée	Type	Description
<path-value>	String	Valeur `path` de l’URI spécifié. Si `path` n’a pas de valeur, retourne le caractère « / ».

Exemple

Cet exemple recherche la valeur path pour cet URI :

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

Et retourne ce résultat : "/catalog/shownew.htm"

uriPathAndQuery

Renvoyer les valeurs path et query pour un URI (Uniform Resource Identifier).

uriPathAndQuery('<uri>')

Paramètre	Obligatoire	Type	Description
<uri>	Oui	String	URI dont vous souhaitez les valeurs `path` et `query`

Valeur retournée	Type	Description
<path-query-value>	String	Valeur `path` et `query` de l’URI spécifié. Si `path` ne spécifie pas de valeur, retourne le caractère « / ».

Exemple

Cet exemple recherche les valeurs path et query pour cet URI :

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

Et retourne ce résultat : "/catalog/shownew.htm?date=today"

uriPort

Renvoyer la valeur port pour un URI (Uniform Resource Identifier).

uriPort('<uri>')

Paramètre	Obligatoire	Type	Description
<uri>	Oui	String	URI dont vous souhaitez la valeur `port`

Valeur retournée	Type	Description
<port-value>	Integer	Valeur `port` de l’URI spécifié. Si `port` ne spécifie pas de valeur, retourne le port par défaut du protocole.

Exemple

Cet exemple retourne la valeur port pour cet URI :

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

Et retourne ce résultat : 8080

uriQuery

Renvoyer la valeur query pour un URI (Uniform Resource Identifier).

uriQuery('<uri>')

Paramètre	Obligatoire	Type	Description
<uri>	Oui	String	URI dont vous souhaitez la valeur `query`

Valeur retournée	Type	Description
<query-value>	String	Valeur `query` de l’URI spécifié

Exemple

Cet exemple retourne la valeur query pour cet URI :

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

Et retourne ce résultat : "?date=today"

uriScheme

Renvoyer la valeur scheme pour un URI (Uniform Resource Identifier).

uriScheme('<uri>')

Paramètre	Obligatoire	Type	Description
<uri>	Oui	String	URI dont vous souhaitez la valeur `scheme`

Valeur retournée	Type	Description
<scheme-value>	String	Valeur `scheme` de l’URI spécifié

Exemple

Cet exemple retourne la valeur scheme pour cet URI :

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

Et retourne ce résultat : "http"

utcNow

Retourne l’horodatage actuel.

utcNow('<format>')

Si vous le souhaitez, vous pouvez spécifier un autre format avec le paramètre <format>.

Paramètre	Obligatoire	Type	Description
<format>	Non	String	Chaîne de format numérique qui est un spécificateur de format unique ou un modèle de format personnalisé. Le format par défaut de l’horodatage est « o » (aaaa-MM-jjTHH:mm:ss.fffffffK), qui est conforme à la norme ISO 8601 et conserve les informations de fuseau horaire. Si le format n’est pas une valeur valide, une erreur est générée.

Valeur retournée	Type	Description
<current-timestamp>	String	Date et heure actuelles

Exemple 1

Supposons que nous soyons le 15 avril 2018 à 13:00:00. Cet exemple illustre l’obtention de l’horodatage actuel :

utcNow()

Et retourne ce résultat : "2018-04-15T13:00:00.0000000Z"

Exemple 2

Supposons que nous soyons le 15 avril 2018 à 13:00:00. Cet exemple illustre l’obtention de l’horodatage actuel en utilisant le format « D » facultatif :

utcNow('D')

Et retourne ce résultat : "Sunday, April 15, 2018"

V

variables

Renvoyer la valeur d’une variable spécifiée.

variables('<variableName>')

Paramètre	Obligatoire	Type	Description
<variableName>	Oui	String	Nom de la variable dont vous souhaitez la valeur

Valeur retournée	Type	Description
<variable-value>	Quelconque	Valeur de la variable spécifiée

Exemple

Supposons que la valeur actuelle de la variable « numItems » corresponde à 20. Cet exemple illustre l’obtention de la valeur entière de cette variable :

variables('numItems')

Et retourne ce résultat : 20

W

flux de travail

Renvoyer tous les détails sur le flux de travail proprement dit pendant l’exécution.

workflow().<property>

Paramètre	Obligatoire	Type	Description
<property>	Non	Chaîne	Nom de la propriété de flux de travail dont vous souhaitez obtenir la valeur Par défaut, un objet de flux de travail a les propriétés suivantes : `name`, `type`, `id`, `location`, `run` et `tags`. - La valeur de la propriété `run` est un objet JSON qui comprend les propriétés suivantes : `name`, `type` et `id`. - La propriété `tags` est un objet JSON qui contient des balises associées à votre application logique dans Azure Logic Apps ou flux dans Power Automate et les valeurs de ces balises. Pour plus d’informations sur les balises dans les ressources Azure, consultez les ressources de balise, les groupes de ressources et les abonnements pour l’organisation logique dans Azure. Remarque : Par défaut, une application logique n’a pas de balise, mais un flux Power Automate contient les balises `flowDisplayName` et `environmentName`.

Exemple 1

Cet exemple retourne le nom de l’exécution actuelle d’un flux de travail :

workflow().run.name

Exemple 2

Si vous utilisez Power Automate, vous pouvez créer une expression @workflow() qui utilise la propriété de sortie tags pour obtenir les valeurs à partir de la propriété flowDisplayName ou environmentName de votre flux.

Par exemple, vous pouvez envoyer des notifications par e-mail personnalisées à partir du flux lui-même qui renvoie vers votre flux. Ces notifications peuvent inclure un lien HTML qui contient le nom d’affichage du flux dans le titre de l’e-mail et respecte la syntaxe suivante :

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

X

Xml

Retourne la version XML d’une chaîne qui contient un objet JSON.

xml('<value>')

Paramètre	Obligatoire	Type	Description
<value>	Oui	Chaîne	Chaîne contenant l’objet JSON à convertir L’objet JSON ne doit avoir qu’une seule propriété racine, qui ne peut pas être un tableau. Utilisez le caractère de barre oblique inverse (\) comme caractère d’échappement pour le guillemet double (").

Valeur retournée	Type	Description
<xml-version>	Object	Élément XML encodé correspondant à la chaîne ou à l’objet JSON spécifié

Exemple 1

Cet exemple illustre la conversion de la chaîne au format XML :

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

Et retourne le résultat XML suivant :

<name>Sophia Owen</name>

Exemple 2

Cet exemple illustre la création de la version XML de cette chaîne, qui contient un objet JSON :

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

Et retourne le résultat XML suivant :

<name>Sophia Owen</name>

Exemple 3

Supposons que vous disposiez de cet objet JSON :

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

Cet exemple illustre la création d’un élément XML pour une chaîne qui contient l’objet JSON :

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

Et retourne le résultat XML suivant :

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

xpath

Vérifie si le code XML contient des valeurs ou des nœuds qui correspondent à une expression de langage XPath et retourne les valeurs ou les nœuds correspondants. Une expression XPath, ou simplement « XPath », vous permet de parcourir une structure de document XML afin de pouvoir sélectionner des nœuds ou des valeurs de calcul dans le contenu XML.

Notes

Dans les applications logiques Consommation et Standard, toutes les expressions de fonction utilisent la bibliothèque XPath .NET. Les expressions XPath sont compatibles avec la bibliothèque .NET sous-jacente et prennent uniquement en charge l’expression prise en charge par cette dernière.

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

Paramètre	Obligatoire	Type	Description
<xml>	Oui	Quelconque	Chaîne XML pour rechercher des nœuds ou des valeurs qui correspondent à une valeur d’expression XPath
<xpath>	Oui	Quelconque	Expression XPath utilisée pour rechercher des nœuds ou des valeurs XML correspondants

Valeur retournée	Type	Description
<xml-node>	XML	Nœud XML lorsqu’un seul nœud correspond à l’expression XPath spécifiée
<value>	Quelconque	Valeur d’un nœud XML lorsqu’un seul nœud correspond à l’expression XPath spécifiée
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Array	Tableau contenant des nœuds ou valeurs XML qui correspondent à l’expression XPath spécifiée

Exemple 1

Supposons que vous avez la chaîne XML 'items' :

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

Cet exemple transmet l’expression XPath, '/produce/item/name/text()', pour rechercher les nœuds qui correspondent au nœud <name></name> dans la chaîne XML 'items', et retourne un tableau avec ces valeurs de nœud :

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

Cet exemple utilise également la fonction parameters() pour obtenir la chaîne XML à partir de 'items' et convertir la chaîne au format XML à l’aide de la fonction xml().

Voici un tableau de résultats rempli de valeurs des nœuds qui correspondent à <name></name> :

[ Gala, Honeycrisp ]

Exemple 2

Suite à l’exemple 1, cet exemple transmet l’expression XPath, '/produce/item/name[1]', pour rechercher le premier élément name qui est l’enfant de l’élément item.

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

Voici le résultat : Gala

Exemple 3

Suite à l’exemple 1, cet exemple transmet l’expression XPath, '/produce/item/name[last()]', pour rechercher le dernier élément name qui est l’enfant de l’élément item.

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

Voici le résultat : Honeycrisp

Exemple 4

Dans cet exemple, supposons que votre chaîne XML items contient également les attributs expired='true' et expired='false' :

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

Cet exemple transmet l’expression XPath, '//name[@expired]', pour rechercher tous les éléments name dotés de l’attribut expired :

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

Voici le résultat : [ Gala, Honeycrisp ]

Exemple 5

Dans cet exemple, supposons que votre chaîne XML items contient uniquement l’attribut expired = 'true' :

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

Cet exemple transmet l’expression XPath, '//name[@expired = 'true']', pour rechercher tous les éléments name dotés de l’attribut expired = 'true' :

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

Voici le résultat : [ Gala ]

Exemple 6

Dans cet exemple, supposons que votre chaîne XML items contient également les attributs :

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

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

Cet exemple transmet l’expression XPath, '//name[@price>35]', pour rechercher tous les éléments name dotés de price > 35 :

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

Voici le résultat : Honeycrisp

Exemple 7

Dans cet exemple, supposons que votre chaîne XML items est identique à celle de l’exemple 1 :

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

Cet exemple recherche les nœuds qui correspondent au nœud <count></count> et ajoute ces valeurs de nœud avec la fonction sum() :

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

Voici le résultat : 30

Exemple 8

Dans cet exemple, supposons que vous avez cette chaîne XML, qui comprend l’espace de noms du document XML, xmlns="https://contoso.com" :

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

Ces expressions utilisent une expression XPath, /*[name()="file"]/*[name()="location"] ou /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], pour rechercher les nœuds qui correspondent au nœud <location></location>. Ces exemples illustrent la syntaxe que vous utilisez dans le concepteur ou dans l’éditeur d’expressions :

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

Voici le nœud obtenu qui correspond au nœud <location></location> :

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

Important

Si vous travaillez en mode Code, échappez les guillemets doubles (") en utilisant la barre oblique inverse (\). Par exemple, vous devez utiliser des caractères d’échappement quand vous sérialisez une expression sous forme de chaîne JSON. Toutefois, si vous travaillez dans le concepteur ou dans l’éditeur d’expressions, vous n’avez pas besoin d’échapper les guillemets doubles, car la barre oblique inverse est ajoutée automatiquement à la définition sous-jacente. Par exemple :

Mode Code : xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Éditeur d'expression : xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

Exemple 9

Suite à l’exemple 8, cet exemple utilise l’expression XPath, 'string(/*[name()="file"]/*[name()="location"])', pour rechercher la valeur figurant dans le nœud <location></location> :

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

Voici le résultat : Paris

Étapes suivantes

En savoir plus sur le langage de définition du flux de travail