Étape de l’analyseur XML

Rversion finale: Australia

Mis à jour 12 mars 2026

4 minutes de lecture

Identifiez les données structurées à partir d’une charge utile XML sans avoir à écrire de script. Mappez les éléments XML entrants à une sortie d’objet complexe que vous pouvez utiliser dans d’autres étapes ou actions. Lors de l’exécution, les valeurs d’une charge utile XML renseignent la sortie d’objet complexe.

Pour en savoir plus sur les objets complexes, consultez Données complexes.

Remarque :

Cette étape exige un Centre d'intégration abonnement. Pour plus d’informations, voir Calendriers juridiques - Centre d'intégration présentation. Une fois le module d’extension requis activé, l’étape est visible sous Intégrations.

Rôles et disponibilité

Disponible en tant qu’étape d’action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.

Limite de taille de la charge utile

Lors de l’exécution, Étape de l’analyseur XML prend en charge des charges utiles allant jusqu’à 10 Mo. Pour les charges utiles plus importantes, créez une Flux de données action. Pour plus d'informations, consultez Actions de flux de données et pagination.

Au moment de la conception, Étape de l’analyseur XML prend en charge des exemples de charges utiles jusqu’à 64 000 caractères.

Champs


Champ	Description
Source	Dans le champ Données sources , sélectionnez ou faites glisser une pastille de données contenant les données XML sources. Par exemple, une pastille de données Corps de réponse à l’étape REST. Lors de l’exécution, les valeurs de la source de données renseignent la sortie d’objet complexe. Sous Données sources et dans la fenêtre de scripting, saisissez un exemple de charge utile pour générer un objet complexe. Par exemple, si vous analysez la réponse à partir d’une étape de l’API REST qui renvoie une liste d’utilisateurs, saisissez le code XML attendu pour un seul utilisateur. Ce champ accepte le code XML avec les limitations suivantes : Les espaces de noms XML ne sont pas appliqués à l’objet complexe. Plusieurs espaces de noms dans un fichier XML ne sont pas pris en charge et génèrent un message d’erreur. Les tableaux multidimensionnels ne sont pas pris en charge. Certains caractères spéciaux ne sont pas pris en charge, tels que les tirets et les points. Les deux-points ( ::) ne sont pas pris en charge dans les valeurs d’attribut. Les charges utiles supérieures à 2 Mo ne peuvent pas être enregistrées et générer un message d’erreur. Toutefois, si vous utilisez un exemple volumineux, vous pouvez générer l’objet complexe et supprimer la charge utile de l’exemple avant d’enregistrer l’étape.
Vue de charge utile structurée	Sélectionnez une vue pour l’exemple de charge utile. Brut (mode édition) : affiche le XML modifiable. Structuré : affiche XML dans une arborescence. Cliquez sur un élément de l’arborescence pour copier l’élément XPath. Si vous créez manuellement des données complexes dans le champ Cible , vous pouvez coller le XPath dans le champ XPath cible.
Générer la cible	Sélectionnez Générer la cible pour créer la structure de sortie de l’étape à partir de votre exemple de charge utile. Votre structure de données de sortie s’affiche dans le champ Cible . Les éléments enfants de chaque objet sont automatiquement générés en tant que type Chaîne. Vous pouvez également créer manuellement votre objet complexe cible en ajoutant des éléments dans le champ Cible .
Cible	Affichez ou modifiez la structure de sortie de la charge utile XML. Créez une sortie structurée en cliquant sur Générer la cible ou ajoutez manuellement des éléments. Chaque élément contient les informations suivantes dans la vue Edit Object (Edit Object) : Étiquette : étiquette de pastille de données. Par défaut, le système utilise le nom de l’élément XML. Nom : nom interne de l’élément de sortie. Remarque : Les points d’exclamation, les doubles deux-points, le symbole @ ou les chiffres uniquement ne sont pas des valeurs valides pour le nom d’un élément. Type : type de données, qui doit être String, Object, Array.String ou Array.Object. L’élément de niveau supérieur doit être un objet. Obligatoire : basculez pour rendre l’élément obligatoire. Cela ne s’applique qu’aux éléments de type Chaîne. Ajouter un élément enfant : sélectionnez l’icône Ajouter un élément enfant (icône ) pour ajouter un élément enfant imbriqué. Les éléments de type Objet contiennent l’option avancée Enregistrer comme modèle , qui vous permet d’enregistrer la structure de votre objet en tant que modèle d’objet complexe. Vous pouvez ensuite utiliser ce modèle pour définir le schéma d’une sortie d’objet pour votre action. Pour les éléments de type Chaîne, vous pouvez également ajouter une longueur maximale, un conseil et une valeur par défaut en tant qu’options avancées. Dans l’en-tête Cible, sélectionnez Quitter le mode d’édition lorsque vous avez terminé d’apporter des modifications à la structure de votre sortie. Vous pouvez ensuite sélectionner l’icône Activer/désactiver les ) pour afficher l’option XPath . Le XPath est le chemin vers l’élément. Modifiez le XPath pour changer la façon dont les éléments de données sources sont mappés à des variables de données complexes. Si vous ajoutez manuellement des variables de données complexes, vous pouvez copier le XPath à partir du champ Vue de charge utile et le coller dans un champ XPath de variable de données complexe pour garantir la hiérarchie correcte. Les expressions XPath conditionnelles ne sont pas prises en charge.