Étape de l’analyseur XML

Identifiez les données structurées 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, reportez-vous à la rubrique Données complexes.

Remarque :

Cette étape nécessite un abonnement Hub d'intégration. Pour plus d’informations, consultez Calendriers juridiques - Vue d’ensemble du concentrateur d’intégration. 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 et pagination du flux de données.

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 source , sélectionnez ou faites glisser une pastille de données contenant les données XML sources. Par exemple, une pastille de données du corps de la réponse de 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, entrez un exemple de charge utile pour générer un objet complexe. Par exemple, si vous analysez la réponse d’une étape d’API REST qui renvoie une liste d’utilisateurs, entrez le XML attendu pour un utilisateur unique. Ce champ accepte 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, tels que le trait d’union et le point, ne sont pas pris en charge. Les doubles 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èrent un message d’erreur. Toutefois, si vous utilisez un exemple volumineux, vous pouvez générer l’objet complexe et supprimer l’exemple de charge utile avant d’enregistrer l’étape.
Vue de charge utile structurée	Sélectionnez une vue pour l’exemple de charge utile. Raw (mode d’édition) : affiche le code XML modifiable. Structuré : affiche le code 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 chaîne de type. 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 Modifier l’objet : É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 Chaîne, Objet, Tableau.Chaîne ou Tableau.Objet. 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 en tant que 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, une indication 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 entrées avancées (icône ) pour afficher l’option XPath . Le XPath est le chemin d’accès à l’élément. Modifiez le XPath pour modifier la façon dont les éléments de données source 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 de vue 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.