Partager via

Actions XML

  • Article

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.

Capture d’écran de l’action Exécuter l’expression XPath.

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.

Capture d’écran de l’action Obtenir l’attribut XML.

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.