Contenu dynamique de flux de travail

Remarque

Catalogue de données Microsoft Purview (classique) et Data Health Insights (classique) n’acceptent plus de nouveaux clients et ces services, précédemment Azure Purview, sont désormais en mode de support client.

Importante

Cette fonctionnalité est actuellement en préversion. Les conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure incluent des conditions juridiques supplémentaires qui s’appliquent aux fonctionnalités Azure qui sont en version bêta, en préversion ou qui ne sont pas encore publiées en disponibilité générale.

Vous pouvez utiliser du contenu dynamique à l’intérieur des flux de travail Microsoft Purview pour associer certaines variables dans le flux de travail ou ajouter d’autres expressions pour traiter ces valeurs.

Lorsque vous ajoutez du contenu dynamique à vos flux de travail, vous créez des expressions à partir des blocs de construction fournis qui référencent et traitent les informations de votre flux de travail afin de pouvoir obtenir les valeurs dont vous avez besoin en temps réel.

Dans le menu de contenu dynamique, les options actuellement disponibles sont les suivantes :

• Variables intégrées : variables qui représentent les valeurs provenant des éléments qui l’ont déclenché dans le flux de travail
• Expressions : formules créées à partir de fonctions et de variables qui peuvent traiter des valeurs dans le flux de travail.

Variables intégrées

Actuellement, les variables suivantes sont disponibles pour un connecteur de workflow dans Microsoft Purview :

Connecteur prérequis	Variable intégrée	Les fonctionnalités	Type	Valeurs possibles
Lors de l’envoi d’une demande d’accès aux données Quand la demande de mise à jour de ressource est envoyée	Workflow.Requestor	ID du demandeur du workflow	chaîne
	Asset.Name	Nom de la ressource	chaîne
	Asset.Description	Description de la ressource	chaîne ou null
	Asset.Type	Type de la ressource	chaîne
	Asset.Fully Qualified Name	Nom complet de la ressource	chaîne
	Asset.Owner	ID des propriétaires de données de la ressource	tableau de chaîness
	Asset.Classification	Noms complets des classifications de la ressource	tableau de chaîness
	Asset.Schema.Classification	Noms complets des classifications appliquées à une colonne dans le schéma de ressource	tableau de chaîness
	Asset.Is Certifié	Indicateur indiquant si l’actif répond aux normes de qualité de votre organization et peut être considéré comme fiable	boolean	true ou false
Lors de l’envoi d’une demande d’accès aux données	Workflow.Request Recipient	ID du destinataire de la demande du flux de travail	chaîne
Démarrer et attendre une approbation	Approval.Outcome	Le résultat de l’approbation	chaîne	'Approved' ou 'Rejected'
	Approval.Assigned To	ID des approbateurs	tableau de chaîness
	Approval.Comments	Le nom des approbateurs et leurs commentaires	chaîne
Vérifier l’inscription de la source de données pour la gouvernance de l’utilisation des données	Gouvernance de l’utilisation des données	Résultat de la case activée de gouvernance de l’utilisation des données	boolean	true ou false
Lors de l’envoi d’une demande de création de terme	Workflow.Requestor	ID du demandeur du workflow	chaîne
	Term.Name	Nom du terme	chaîne
	Term.Formal Name	Nom formel du terme	chaîne
	Term.Definition	Définition du terme	chaîne
	Term.Experts	Les ID des experts du terme	tableau de chaîness
	Term.Stewards	Les ID des intendants du terme	tableau de chaîness
	Term.Parent.Name	Nom du terme parent s’il existe	chaîne
	Nom Term.Parent.Formal	Nom formel du terme parent s’il existe	chaîne
Quand la demande de mise à jour de terme est envoyée Lors de l’envoi d’une demande de suppression de terme	Workflow.Requestor	Demandeur du workflow	chaîne
	Term.Name	Nom du terme	chaîne
	Term.Formal Name	Nom formel du terme	chaîne
	Term.Definition	Définition du terme	chaîne ou null
	Term.Experts	Les ID des experts du terme	tableau de chaîness
	Term.Stewards	Les ID des intendants du terme	tableau de chaîness
	Term.Parent.Name	Nom du terme parent s’il existe	chaîne
	Nom Term.Parent.Formal	Nom formel du terme parent s’il existe	chaîne
	Term.Created By	ID du créateur du terme	chaîne
	Term.Last Updated By	ID de la dernière mise à jour du terme	chaîne
Lors de l’envoi d’une demande d’importation de terme	Workflow.Requestor	ID du demandeur du workflow	chaîne
	Importer File.Name	Nom du fichier à importer	chaîne
Http	Http.Body	Corps de la réponse HTTP	objet ou chaîne
	Http.Headers	En-têtes de réponse HTTP	object
	Http.Status Code	Code d’état HTTP	chaîne
Appliquer à chaque	Option	L’élément actuel de l’action Appliquer à chaque	N’importe lequel
Jusqu’à	Index	Index d’itération actuel de l’action Until	entier
Créer un enregistrement Supprimer un enregistrement Obtenir l’enregistrement Mettre à jour l’enregistrement	Résultat	Résultat de l’action ServiceNow	object
Obtenir les types d’enregistrements Répertorier les enregistrements	Résultat	Résultat de l’action ServiceNow	tableaud’objetss

Expressions

Les définitions de flux de travail dans Microsoft Purview vous permettent d’utiliser des fonctions dans vos expressions pour traiter des valeurs dans vos workflows.

Pour rechercher des fonctions en fonction de leur usage général, passez en revue les tableaux suivants. Ou, pour plus d’informations sur chaque fonction, consultez la liste alphabétique.

Lorsque vous créez un workflow et que vous souhaitez ajouter une fonction à vos expressions, procédez comme suit :

1. Sélectionnez la valeur que vous allez modifier.
2. Sélectionnez le bouton Ajouter du contenu dynamique qui s’affiche sous la zone de texte.
3. Sélectionnez l’onglet Expressions dans la fenêtre de contenu dynamique et faites défiler pour sélectionner votre valeur.
4. Mettez à jour votre expression et sélectionnez OK pour l’ajouter.

Considérations

• Les paramètres de fonction sont évalués de gauche à droite.

• Les fonctions qui apparaissent inline avec du texte brut nécessitent des accolades englobantes ({}) 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 avec du texte brut, aucune accolades n’est nécessaire.

  L’exemple suivant montre la syntaxe correcte et incorrecte :

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

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

• Les fonctions peuvent avoir des surcharges, qui sont plusieurs versions d’une fonction portant le même nom, mais différentes façons d’effectuer une tâche, en fonction de l’entrée que vous leur donnez.

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

Fonctions de chaîne

Pour utiliser des chaînes, vous pouvez utiliser ces fonctions de chaîne ainsi que certaines fonctions de collection. Les fonctions de chaîne fonctionnent uniquement sur les chaînes.

Fonction de chaîne	Tâche
endsWith	Vérifiez si une chaîne se termine par la sous-chaîne spécifiée.
startsWith	Vérifiez si une chaîne commence par une sous-chaîne spécifique.

Fonctions de collection

Pour utiliser 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
Contient	Vérifiez si une collection a un élément spécifique.
length	Retourne le nombre d’éléments d’une collection ou la longueur d’une chaîne.

Fonctions de comparaison logique

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

Fonction de comparaison logique	Tâche
pas	Vérifiez si une expression est false. Retourne true lorsque l’expression a la valeur false, ou retourne false si true.
et	Vérifiez si toutes les expressions sont vraies. Retourne true lorsque toutes les expressions ont la valeur true, ou retourne false quand au moins une expression a la valeur false.
ou	Vérifiez si au moins une expression est vraie. Retourne true quand au moins une expression a la valeur true, ou retourne false quand toutes ont la valeur false.
Égale	Vérifiez si les deux valeurs sont équivalentes.
Plus	Vérifiez si la première valeur est supérieure à la deuxième.
greaterOrEquals	Vérifiez si la première valeur est supérieure ou égale à la deuxième valeur.
moins	Vérifiez si la première valeur est inférieure à la deuxième.
lessOrEquals	Vérifiez si la première valeur est inférieure ou égale à la deuxième valeur.

Fonctions utilisateur

Pour travailler avec les utilisateurs, leurs relations avec d’autres utilisateurs et groupes, et les ressources auxquelles ils accèdent, par exemple leurs courriers, calendriers, fichiers, rôles d’administration, appartenances à un groupe. Pour obtenir des informations de référence complètes sur chaque fonction, consultez la liste alphabétique.

Fonction utilisateur	Tâche
getUserName	Obtient le nom de l’utilisateur.
getManager	Obtenez l’ID du responsable de l’utilisateur.
memberOfGroup	Vérifiez si l’utilisateur est membre du groupe.

Fonctions de conversion

Pour modifier le type ou le format d’une valeur, vous pouvez utiliser ces fonctions de conversion. Pour obtenir des informations de référence complètes sur chaque fonction, consultez la liste alphabétique.

Fonction de conversion	Tâche
createArray	Retourne un tableau à partir d’un nombre quelconque d’entrées.
createObject	Retourne un objet vide.
chaîne	Retourne la version de chaîne d’une valeur.
int	Essayez de convertir la valeur d’entrée en nombre entier.
float	Essayez de convertir la valeur d’entrée en nombre flottant..
bool	Essayez de convertir la valeur d’entrée en valeur booléenne.
object	Essayez de convertir la valeur d’entrée en objet .
tableau	Essayez de convertir la valeur d’entrée en tableau.
nullOrElse	Donnez une valeur par défaut à une valeur nullable.

Toutes les fonctions - liste alphabétique

et

Vérifiez si toutes les expressions sont vraies. Retourne true lorsque toutes les expressions ont la valeur true, ou retourne false quand au moins une expression a la valeur false.

Paramètre	Type	Description
value	boolean	Première expression à case activée
Valeurs...	boolean	Expressions rest à case activée

Type de valeur de retour	Description
boolean	Retourne true lorsque toutes les expressions ont la valeur true. Retourne false quand au moins une expression a la valeur false.

Exemples

Ces exemples case activée si les expressions spécifiées sont false :

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

Et retourne les résultats suivants :

• Premier exemple : les deux expressions ont la valeur true, donc retourne true.
• Deuxième exemple : une expression a la valeur false. Retourne falsedonc .
• Troisième exemple : l’expression est false, donc retourne false.

tableau

Cette fonction tente de convertir la valeur d’entrée en tableau. Il est utilisé pour convertir la valeur d’un type plus large en tableau. Pour créer un tableau à partir d’éléments, consultez createArray.

Paramètre	Type	Description
value	N’importe lequel	Valeur à convertir

Type de valeur de retour	Description
tableau	Valeur de tableau convertie

Exemple

Cet exemple montre comment déclarer Item d’une action « Appliquer à chaque » comme étant de type tableau :

array(items('Appy to each'))

bool

Cette fonction tente de convertir la valeur d’entrée en valeur booléenne. Il est utilisé pour convertir la valeur d’un type plus large en valeur booléenne.

Paramètre	Type	Description
value	N’importe lequel	Valeur à convertir

Type de valeur de retour	Description
boolean	Valeur booléenne convertie

Exemple

Cet exemple montre comment déclarer Item d’une action « Appliquer à chaque » comme étant de type booléen :

bool(items('Appy to each'))

contains

Vérifiez si une collection a un élément spécifique. Retourne true lorsque l’élément est trouvé, ou retourne false lorsqu’il est introuvable.

Surcharge 1 : chaîne pour rechercher une sous-chaîne

Cette surcharge respecte la casse.

Paramètre	Type	Description
collection	chaîne	Chaîne à case activée
valeur	chaîne	Sous-chaîne à rechercher

Type de valeur de retour	Description
boolean	Retourne true lorsque la sous-chaîne est trouvée. Retourne la valeur false lorsqu’elle est introuvable.

Surcharge 2 : tableau pour rechercher une valeur

Paramètre	Type	Description
collection	tableau	Collection à case activée
valeur	N’importe lequel	Élément à rechercher

Type de valeur de retour	Description
boolean	Retourne true lorsque l’élément est trouvé. Retourne la valeur false lorsqu’elle est introuvable.

Exemple 1

Cet exemple vérifie la chaîne « hello world » pour la sous-chaîne « world » et retourne true:

contains('hello world', 'world')

Exemple 2

Cet exemple montre comment vérifier que la variable Asset.Owner recherche l’élément égal à la variable Workflow.Requestor :

contains(runInput()['asset']['dataOwner'], runInput()['requestor'])

createArray

Retourne un tableau à partir d’un nombre quelconque d’entrées. Cette fonction ne nécessite pas que les valeurs d’entrée soient du même type.

Paramètre	Type	Description
Valeurs...	N’importe lequel	Valeurs pour créer le tableau.

Type de valeur de retour	Description
tableau	Tableau créé à partir de tous les éléments d’entrée

Exemples

Ces exemples créent un tableau à partir d’entrées :

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

createObject

Retourne un objet vide.

Type de valeur de retour	Description
object	Objet vide

Exemple

Cet exemple crée un tableau à partir d’entrées et retourne {}.

createObject()

endsWith

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

Paramètre	Type	Description
text	chaîne	Chaîne à case activée
searchText	chaîne	Sous-chaîne de fin à rechercher

Type de valeur de retour	Description
boolean	Retourne true lorsque la sous-chaîne de fin est trouvée. Retourne la valeur false lorsqu’elle est introuvable.

Exemple 1

Cet exemple montre comment vérifier 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 montre comment vérifier si la chaîne « hello world » se termine par la chaîne « universe » :

endsWith('hello world', 'universe')

Et retourne ce résultat : false

Égale

Vérifiez si les valeurs, expressions ou objets sont équivalents. Retourne true lorsque les deux sont équivalents, ou retourne false lorsqu’ils ne sont pas équivalents.

Paramètre	Type	Description
value	N’importe lequel	Valeurs, expressions ou objets à comparer
compareTo	N’importe lequel	Valeurs, expressions ou objets de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque les deux sont équivalents. Retourne la valeur false si elle n’est pas équivalente.

Exemples

Ces exemples case activée si les entrées spécifiées sont équivalentes.

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

Et retourne les résultats suivants :

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

float

Cette fonction tente de convertir la valeur d’entrée en nombre flottant. Il est utilisé pour convertir la valeur d’un type plus large en float.

Paramètre	Type	Description
value	N’importe lequel	Valeur à convertir

Type de valeur de retour	Description
float	Valeur float convertie

Exemple

Cet exemple montre comment déclarer Item d’une action « Appliquer à chaque » comme étant de type float :

float(items('Appy to each'))

getManager

Obtenez l’ID du responsable de l’utilisateur dans Microsoft Entra ID.

Surcharge 1 : Obtenir pour un seul utilisateur

Paramètre	Type	Description
userId	chaîne	ID de l’utilisateur d’entrée

Type de valeur de retour	Description
chaîne ou null	ID du gestionnaire de l’utilisateur d’entrée ou null s’il n’existe pas

Surcharge 2 : Obtenir pour plusieurs utilisateurs

Paramètre	Type	Description
userId	tableau	ID des utilisateurs d’entrée

Type de valeur de retour	Description
tableau	Union des ID des responsables des utilisateurs d’entrée

Exemples

Ces exemples obtiennent le ou les responsables du ou des utilisateurs d’entrée :

getManager(runInput()['requestor'])
getManager(runInput()['term']['stewards'])

• Premier exemple : le paramètre d’entrée étant une chaîne, retourne l’ID du gestionnaire de Workflow.Requestor
• Deuxième exemple : le paramètre d’entrée étant un tableau, retourne l’ensemble d’ID d’union des responsables de Term.Stewards.

getUserName

Obtenez le nom de l’utilisateur dans Microsoft Entra ID.

Surcharge 1 : Obtenir pour un seul utilisateur

Paramètre	Type	Description
userId	chaîne	ID de l’utilisateur d’entrée

Type de valeur de retour	Description
chaîne	Nom de l’utilisateur d’entrée

Surcharge 2 : Obtenir pour plusieurs utilisateurs

Paramètre	Type	Description
userId	tableau	ID des utilisateurs d’entrée

Type de valeur de retour	Description
tableau	Noms des utilisateurs d’entrée

Exemples

Ces exemples obtiennent le ou les noms des utilisateurs d’entrée :

getUserName(runInput()['requestor'])
getUserName(runInput()['term']['stewards'])

• Premier exemple : le paramètre d’entrée étant une chaîne, retourne le nom de Workflow.Requestor
• Deuxième exemple : le paramètre d’entrée étant un tableau, retourne un tableau de noms de Term.Stewards.

Plus

Vérifiez si la première valeur est supérieure à la deuxième. Retourne true lorsque la première valeur est plus, ou retourne false quand elle est inférieure.

Surcharge 1 : comparer des nombres

Paramètre	Type	Description
value	entier ou float	La première valeur à case activée si supérieure à la deuxième valeur
compareTo	entier ou float	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est supérieure à la deuxième valeur. Retourne false lorsque la première valeur est égale ou inférieure à la deuxième valeur.

Surcharge 2 : comparer des chaînes

Paramètre	Type	Description
value	chaîne	La première valeur à case activée si supérieure à la deuxième valeur
compareTo	chaîne	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est supérieure à la deuxième valeur. Retourne false lorsque la première valeur est égale ou inférieure à la deuxième valeur.

Exemples

Ces exemples case activée si la première valeur est supérieure à la deuxième valeur :

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

Retournez les résultats suivants :

• Premier exemple : true
• Deuxième exemple : false

greaterOrEquals

Vérifiez si la première valeur est supérieure ou égale à la deuxième valeur. Retourne true lorsque la première valeur est supérieure ou égale, ou retourne false lorsque la première valeur est inférieure.

Surcharge 1 : comparer des nombres

Paramètre	Type	Description
value	entier ou float	La première valeur à case activée si elle est supérieure ou égale à la deuxième valeur
compareTo	entier ou float	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est supérieure ou égale à la deuxième valeur. Retourne false lorsque la première valeur est inférieure à la deuxième valeur.

Surcharge 2 : comparer des chaînes

Paramètre	Type	Description
value	chaîne	La première valeur à case activée si elle est supérieure ou égale à la deuxième valeur
compareTo	chaîne	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est supérieure ou égale à la deuxième valeur. Retourne false lorsque la première valeur est inférieure à la deuxième valeur.

Exemples

Ces exemples case activée si la première valeur est supérieure ou égale à la deuxième valeur :

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

Retournez les résultats suivants :

• Premier exemple : true
• Deuxième exemple : false

int

Cette fonction tente de convertir la valeur d’entrée en nombre entier. Il est utilisé pour convertir la valeur d’un type plus large en entier.

Paramètre	Type	Description
value	N’importe lequel	Valeur à convertir

Type de valeur de retour	Description
entier	Valeur entière convertie

Exemple

Cet exemple montre comment déclarer Item d’une action « Appliquer à chaque » comme étant de type entier :

int(items('Appy to each'))

longueur

Retourne le nombre d’éléments d’une collection ou la longueur d’une chaîne.

Paramètre	Type	Description
value	chaîne ou tableau	Chaîne ou collection avec les éléments à compter

Type de valeur de retour	Description
boolean	Nombre d’éléments dans la collection ou longueur de la chaîne

Exemples

Ces exemples comptent le nombre d’éléments dans ces collections :

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

Et les deux retournent ce résultat : 4

moins

Vérifiez si la première valeur est inférieure à la deuxième. Retourne true lorsque la première valeur est inférieure, ou retourne false lorsque la première valeur est supérieure.

Surcharge 1 : comparer des nombres

Paramètre	Type	Description
value	entier ou float	La première valeur à case activée si elle est inférieure à la deuxième valeur
compareTo	entier ou float	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est inférieure à la deuxième valeur. Retourne false lorsque la première valeur est égale ou supérieure à la deuxième valeur.

Surcharge 2 : comparer des chaînes

Paramètre	Type	Description
value	chaîne	La première valeur à case activée si supérieure à la deuxième valeur
compareTo	chaîne	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est inférieure à la deuxième valeur. Retourne false lorsque la première valeur est égale ou supérieure à la deuxième valeur.

Exemples

Ces exemples case activée si la première valeur est inférieure à la deuxième valeur.

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

Retournez les résultats suivants :

• Premier exemple : true
• Deuxième exemple : false

lessOrEquals

Vérifiez si la première valeur est inférieure ou égale à la deuxième valeur. Retourne true lorsque la première valeur est inférieure ou égale, ou retourne false lorsque la première valeur est supérieure.

Surcharge 1 : comparer des nombres

Paramètre	Type	Description
value	entier ou float	La première valeur à case activée si elle est inférieure ou égale à la deuxième valeur
compareTo	entier ou float	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est inférieure ou égale à la deuxième valeur. Retourne false lorsque la première valeur est supérieure à la deuxième valeur.

Surcharge 2 : comparer des chaînes

Paramètre	Type	Description
value	chaîne	La première valeur à case activée si elle est inférieure ou égale à la deuxième valeur
compareTo	chaîne	Valeur de comparaison

Type de valeur de retour	Description
boolean	Retourne true lorsque la première valeur est inférieure ou égale à la deuxième valeur. Retourne false lorsque la première valeur est supérieure à la deuxième valeur.

Exemples

Ces exemples case activée si la première valeur est inférieure ou égale à la deuxième valeur.

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

Retournez les résultats suivants :

• Premier exemple : true
• Deuxième exemple : false

memberOfGroup

Vérifiez si l’utilisateur est membre du groupe dans Microsoft Entra ID. L’ID de groupe est disponible sur Microsoft Entra page de gestion de groupe.

Paramètre	Type	Description
userId	chaîne	ID de l’utilisateur d’entrée
groupId	chaîne	ID du groupe à case activée

Type de valeur de retour	Description
boolean	Retourne true lorsque l’utilisateur est membre du groupe. Retourne false lorsque l’utilisateur n’est pas membre du groupe ou que le groupe n’existe pas.

Exemple

Cet exemple case activée si Workflow.Requestor est membre du groupe spécifié :

memberOfGroup(runInput()['requestor'], '00000000-0000-0000-0000-111111111111')

not

Vérifiez si une expression est false. Retourne true lorsque l’expression a la valeur false, ou retourne false si true.

Paramètre	Type	Description
value	boolean	Expression à case activée

Type de valeur de retour	Description
boolean	Retourne true lorsque l’expression a la valeur false. Retourne false lorsque l’expression a la valeur true.

Exemples

Ces exemples case activée si les expressions spécifiées sont false :

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

Retournez les résultats suivants :

• Premier exemple : l’expression étant false, la fonction retourne true.
• Deuxième exemple : l’expression étant true, la fonction retourne false.

nullOrElse

Donnez une valeur par défaut à une valeur nullable. Retourne une valeur non nullable.

Surcharge 1 : Version de chaîne

Paramètre	Type	Description
value	chaîne ou null	Valeur nullable
defaultValue	chaîne	Valeur de secours

Type de valeur de retour	Description
chaîne	Retourne la valeur d’entrée si elle n’est pas null. Retourne la valeur par défaut si la valeur d’entrée est null.

Surcharge 2 : version entière

Paramètre	Type	Description
value	entier ou null	Valeur nullable
defaultValue	entier	Valeur de secours

Type de valeur de retour	Description
entier	Retourne la valeur d’entrée si elle n’est pas null. Retourne la valeur par défaut si la valeur d’entrée est null.

Surcharge 3 : version float

Paramètre	Type	Description
value	float ou null	Valeur nullable
defaultValue	float	Valeur de secours

Type de valeur de retour	Description
float	Retourne la valeur d’entrée si elle n’est pas null. Retourne la valeur par défaut si la valeur d’entrée est null.

Surcharge 4 : version booléenne

Paramètre	Type	Description
value	booléen ou null	Valeur nullable
defaultValue	boolean	Valeur de secours

Type de valeur de retour	Description
boolean	Retourne la valeur d’entrée si elle n’est pas null. Retourne la valeur par défaut si la valeur d’entrée est null.

Surcharge 5 : Version du tableau

Paramètre	Type	Description
value	array ou null	Valeur nullable
defaultValue	tableau	Valeur de secours

Type de valeur de retour	Description
tableau	Retourne la valeur d’entrée si elle n’est pas null. Retourne la valeur par défaut si la valeur d’entrée est null.

Surcharge 6 : Version de l’objet

Paramètre	Type	Description
value	objet ou null	Valeur nullable
defaultValue	object	Valeur de secours

Type de valeur de retour	Description
object	Retourne la valeur d’entrée si elle n’est pas null. Retourne la valeur par défaut si la valeur d’entrée est null.

Exemple

Cet exemple donne à la variable Nullable Term.Definition une valeur 'Empty'par défaut :

nullOrElse(runInput()['term']['definition'], 'Empty')

objet

Cette fonction tente de convertir la valeur d’entrée en valeur d’objet. Il est utilisé pour convertir la valeur d’un type plus large en objet.

Paramètre	Type	Description
value	N’importe lequel	Valeur à convertir

Type de valeur de retour	Description
boolean	Valeur de l’objet converti

Exemple

Cet exemple montre comment déclarer Item d’une action « Appliquer à chaque » comme étant de type objet :

object(items('Appy to each'))

ou

Vérifiez si au moins une expression est vraie. Retourne true quand au moins une expression a la valeur true, ou retourne false quand toutes ont la valeur false.

Paramètre	Type	Description
value	boolean	Première expression à case activée
Valeurs...	boolean	Expressions rest à case activée

Type de valeur de retour	Description
boolean	Retourne true quand au moins une expression a la valeur true. Retourne false lorsque toutes les expressions ont la valeur false.

Exemples

Ces exemples case activée si au moins une expression est vraie :

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

Retournez les résultats suivants :

• Premier exemple : Au moins une expression a la valeur true, donc la fonction retourne true.
• Deuxième exemple : les deux expressions étant false, la fonction retourne false.
• Troisième exemple : l’expression étant false, la fonction retourne false.

startsWith

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

Paramètre	Type	Description
text	chaîne	Chaîne à case activée
searchText	chaîne	Sous-chaîne de départ à rechercher

Type de valeur de retour	Description
boolean	Retourne true lorsque la sous-chaîne de départ est trouvée. Retourne la valeur false lorsqu’elle est introuvable.

Exemple 1

Cet exemple montre comment vérifier 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

Cette fonction retourne la version de chaîne de la valeur.

Paramètre	Type	Description
value	N’importe lequel	Valeur à convertir

Type de valeur de retour	Description
chaîne	Version de chaîne pour la valeur spécifiée. Si le paramètre value est null, cette valeur est retournée sous la forme d’une valeur de chaîne vide («  »).

Exemples

Ces exemples convertissent la valeur d’entrée en chaîne :

string('abc')
string(true)
string(createArray())

Retournez les résultats suivants :

• Premier exemple : la valeur d’entrée étant une chaîne, retourne une valeur 'abc'd’identité .
• Deuxième exemple : la version de chaîne des valeurs booléennes étant en majuscule, la fonction retourne 'True'.
• Troisième exemple : les tableaux ou les objets sont convertis au format JSON, de sorte que la fonction retourne '[]'.

Étapes suivantes

Pour plus d’informations sur les flux de travail, consultez les articles suivants :

• Flux de travail dans Microsoft Purview
• Flux de travail d’approbation pour les termes métier
• Gérer les demandes et approbations de flux de travail