Partager via


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

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

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

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

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 abrégées, consultez 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 obtient la valeur de propriété status de l’action Get user X au moment 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

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 Encodage et décodage base64.

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

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 Encodage et décodage base64.

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 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 obtient la body sortie de l’action Get user X :

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

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 Encodage et décodage base64.

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 :

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

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

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 Encodage et décodage base64.

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.

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 obtient la sortie de l’action Get userX :

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 Integer 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