É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.
Rôles et disponibilité
Disponible en tant qu’étape d’action Concepteur d'action . 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 Pagination et actions de 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 sources , sélectionnez ou faites glisser une pastille de données qui contient les données XML sources. Par exemple, une pastille de données Corps de la réponse d’é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 d’une étape d’API REST qui renvoie une liste d’utilisateurs, saisissez le XML attendu pour un seul utilisateur. Ce champ accepte les fichiers XML avec les limitations suivantes :
|
| Vue de charge utile structurée | Sélectionnez une vue pour l’exemple de charge utile.
|
| 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 apparaît 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 :
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 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 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. |
) pour ajouter un élément enfant imbriqué.
) pour afficher l’option