Actions XML

Power Automate offre la possibilité d’utiliser des flux de bureau pour gérer les attributs et les éléments XML.

Pour lire un fichier XML, utilisez l’action Lire le format XML depuis le fichier. Spécifiez le chemin ou recherchez le fichier et sélectionnez l’une des options de codage.

Après avoir sélectionné un fichier, pour exécuter une requête Xpath, sélectionnez l’action Exécuter l’expression XPath expression. L’exemple suivant utilise une variable produite à partir de l’action Lire le format XML depuis le fichier pour spécifier le document.

Pour récupérer un attribut d’un fichier XML, utilisez l’action Obtenir l’attribut XML. Dans l’exemple suivant, statut est un attribut de client, qui est un élément de clientlist. La valeur sera obtenue sous forme de valeur de texte.

De même, pour récupérer les valeurs des éléments, utilisez l’action Obtenir la valeur de l’élément XML. Vous pouvez gérer les éléments et les attributs en utilisant l’action respective pour obtenir, définir ou supprimer des attributs ou des éléments XML.

Lire le format XML depuis le fichier

Lire le contenu d’un fichier XML dans une variable.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Chemin d’accès au fichier	Non	Fichier		Fichier contenant le document XML à lire
Encodage	S.O.	Valeur système par défaut, ASCII, Unicode, Unicode big endian, UTF-8	Valeur système par défaut	Codage à utiliser pour le fichier spécifié

Variables produites

Argument	Type	Description
XmlDocument	Nœud XML	Variable qui contient le document XML à lire

Exceptions

Exception	Description
Répertoire introuvable	Indique que le répertoire n’existe pas.
Fichier introuvable	Indique que le fichier n’existe pas.
Impossible de lire depuis le fichier	Indique un problème de lecture du fichier.
Le fichier ne contient pas de document XML valide.	Indique que le fichier ne contient pas de document XML valide.

Écrire au format XML dans le fichier

Écrire le contenu d’une variable de nœud XML en un fichier.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Chemin d’accès au fichier	Non	Fichier		Fichier dans lequel écrire le document XML
XML à écrire	Non	Valeur de texte		Nœud ou document XML à écrire dans le fichier
Encodage	S.O.	Valeur système par défaut, ASCII, Unicode, Unicode big endian, UTF-8	Valeur système par défaut	Codage à utiliser pour le fichier spécifié
Format XML	S.O.	Valeur booléenne	True	Indique s’il faut formater ou non en XML
Indentation par niveau	Oui	Valeur numérique	2	Indique le nombre d’espaces pour mettre en retrait chaque niveau du format XML

Variables produites

Cette action ne produit aucune variable.

Exceptions

Exception	Description
Répertoire spécifié non valide	Indique que le répertoire spécifié n’est pas valide.
Impossible d’écrire en XML vers le fichier	Indique un problème d’écriture XML vers le fichier

Exécuter l’expression XPath

Extraire les valeurs d’un document XML en fonction de la requête XPath fournie.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML à analyser	Non	Valeur de texte		XML sous forme de texte ou d’une variable définie précédemment qui contient le document XML à analyser
Requête XPath	Non	Valeur de texte		Expression XPath à exécuter par rapport au document XML
Obtenir la première valeur uniquement	S.O.	Valeur booléenne	False	Indique s’il convient de récupérer une seule valeur (la première valeur uniquement) ou toutes les valeurs qui correspondent à l’expression XPath fournie

Variables produites

Argument	Type	Description
XPathResult	Nœud XML	Nœuds extraits sous la forme d’un nœud XML
XPathResults	Liste des nœuds XML	Nœuds extraits sous la forme d’une liste de nœuds XML

Exceptions

Exception	Description
Document XML fourni non valide	Indique que le document XML fourni n’est pas valide
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide

Obtenir l’attribut de l’élément XML

Obtenir la valeur d’un attribut d’un élément XML.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML	Non	Nœud XML		Document XML ou élément XML pour lequel récupérer son attribut
Requête XPath	Oui	Valeur de texte		Expression XPath permettant de localiser le sous-élément et de récupérer son attribut
Nom de l’attribut	Non	Valeur de texte		Nom du champ d’attribut pour récupérer sa valeur
Obtenir la valeur en tant que	S.O.	Valeur texte, Valeur numérique, Valeur DateHeure, Valeur booléenne	Valeur de texte	Spécifie le type de données de la valeur d’attribut.

Variables produites

Argument	Type	Description
XmlAttributeValue	Valeur booléenne	Valeur récupérée de l’attribut XML
XmlAttributeValue	DateHeure	Valeur récupérée de l’attribut XML
XmlAttributeValue	Valeur numérique	Valeur récupérée de l’attribut XML
XmlAttributeValue	Valeur de texte	Valeur récupérée de l’attribut XML

Exceptions

Exception	Description
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide
L’expression XPath ne renvoie aucun élément	Indique que l’expression XPath ne renvoie aucun élément
Attribut introuvable dans l’élément	Indique que l’attribut n’existe pas dans l’élément.
Impossible de convertir la valeur de l’attribut dans le type de données demandé	Indique un problème lors de la conversion de la valeur de l’attribut en type de données demandé.

Définir l’attribut de l’élément XML

Définir la valeur d’un attribut d’un élément XML.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML	Non	Nœud XML		Document XML ou élément XML pour lequel définir son attribut
Requête XPath	Oui	Valeur de texte		Expression XPath permettant de localiser le sous-élément et de définir son attribut
Nom de l’attribut	Non	Valeur de texte		Nom du champ d’attribut pour définir sa valeur
Valeur de l’attribut	Non	Valeur de texte		Nouvelle valeur pour l’attribut

Variables produites

Cette action ne produit aucune variable.

Exceptions

Exception	Description
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide
L’expression XPath ne renvoie aucun élément	Indique que l’expression XPath ne renvoie aucun élément
Échec de la définition de l’attribut XML	Indique un problème de définition de l’attribut XML

Supprimer l’attribut de l’élément XML

Supprimer un attribut d’un élément XML.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML	Non	Nœud XML		Document XML ou élément XML pour lequel supprimer son attribut
Requête XPath	Oui	Valeur de texte		Expression XPath permettant de localiser le sous-élément et de supprimer son attribut
Nom de l’attribut	Non	Valeur de texte		Nom d’attribut de l’attribut à supprimer

Variables produites

Cette action ne produit aucune variable.

Exceptions

Exception	Description
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide
L’expression XPath ne renvoie aucun élément	Indique que l’expression XPath ne renvoie aucun élément
Attribut introuvable dans l’élément	Indique que l’attribut n’existe pas dans l’élément.
Échec de la suppression de l’attribut XML	Indique un problème de suppression de l’attribut XML

Obtenir la valeur de l’élément XML

Obtenir la valeur d’un élément XML.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML	Non	Nœud XML		Document XML ou élément XML pour lequel récupérer sa valeur
Requête XPath	Oui	Valeur de texte		Expression XPath permettant de localiser le sous-élément et de récupérer sa valeur
Obtenir la valeur en tant que	S.O.	Valeur texte, Valeur numérique, Valeur DateHeure, Valeur booléenne	Valeur de texte	Spécifie le type de données de la valeur d’élément XML.

Variables produites

Argument	Type	Description
XmlElementValue	Valeur booléenne	Valeur de l’élément XML
XmlElementValue	DateHeure	Valeur de l’élément XML
XmlElementValue	Valeur numérique	Valeur de l’élément XML
XmlElementValue	Valeur de texte	Valeur de l’élément XML

Exceptions

Exception	Description
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide
L’expression XPath ne renvoie aucun élément	Indique que l’expression XPath ne renvoie aucun élément
Impossible de convertir la valeur de l’élément dans le type de données demandé	Indique un problème lors de la conversion de la valeur de l’élément en type de données demandé.

Définir la valeur de l’élément XML

Définir la valeur d’un élément XML.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML	Non	Nœud XML		Document XML ou élément XML pour lequel récupérer sa valeur
Requête XPath	Oui	Valeur de texte		Expression XPath permettant de localiser le sous-élément et de récupérer sa valeur
Valeur de l’élément XML	Non	Valeur de texte		Nouvelle valeur pour l’élément XML

Variables produites

Cette action ne produit aucune variable.

Exceptions

Exception	Description
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide
L’expression XPath ne renvoie aucun élément	Indique que l’expression XPath ne renvoie aucun élément
Impossible de définir la valeur de l’élément	Indique un problème de définition de la valeur de l’élément

Insérer l’élément XML

Insérer un nouvel élément XML dans un document XML.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML	Non	Nœud XML		Document XML dans lequel insérer le nouvel élément XML
Requête XPath	Non	Valeur de texte		Expression XPath permettant de localiser l’élément XML parent et d’y insérer le nouvel élément
Élément XML à insérer	Non	Nœud XML		Document XML dans lequel insérer le nouveau document XML

Variables produites

Cette action ne produit aucune variable.

Exceptions

Exception	Description
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide
L’expression XPath ne renvoie aucun élément	Indique que l’expression XPath ne renvoie aucun élément
Impossible d’insérer l’élément XML	Indique un problème d’insertion sur l’élément XML.

Supprimer l’élément XML

Supprimer un ou plusieurs éléments XML d’un document XML.

Paramètres d’entrée

Argument	Facultatif	Accepte	Valeur par défaut	Description
Document XML	Non	Nœud XML		Document XML contenant les éléments XML à supprimer
Requête XPath	Non	Valeur de texte		Expression XPath permettant de localiser les éléments à supprimer

Variables produites

Cette action ne produit aucune variable.

Exceptions

Exception	Description
Expression XPath fournie non valide	Indique que l’expression XPath fournie n’est pas valide
Impossible de supprimer l’élément XML	Indique un problème de suppression de l’élément XML.