É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, consultez Données complexes.

Remarque :

Cette étape nécessite un abonnement Hub d'intégration. Pour plus d’informations, voir Calendriers juridiques : Hub 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 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 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 script, 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 REST API qui renvoie une liste d’utilisateurs, saisissez le code XML attendu pour un seul utilisateur. Ce champ accepte XML avec les limitations suivantes : Les espaces de noms XML ne sont pas appliqués à l’objet complexe. Plus d’un espace de noms dans un fichier XML n’est pas pris en charge et génère 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 le trait d’union et le point. Les deux-points doubles ( ::) 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 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. La structure de vos 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 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 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 d’accès à l’élément. Modifiez le XPath pour modifier la façon dont les éléments de données sources sont mappés aux 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.