XML
L’application XML vous permet d’analyser un texte au format XML à l’aide du module XML > Parse XML et de le convertir en un lot afin de rendre les données disponibles pour d’autres modules. Vous pouvez également convertir un lot en texte XML au moyen du module XML > Créer un XML.
Conditions d’accès
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront | Tous |
| Licence Adobe Workfront |
Nouveau : Standard Ou En cours : Travail ou version ultérieure |
| Licence Adobe Workfront Fusion ** | Aucune exigence de licence Workfront Fusion |
| Produit |
Nouveau :
Ou Actuel : votre entreprise doit acheter Adobe Workfront Fusion. |
Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.
Créer du XML
Le module XML > Créer du XML convertit un lot en texte XML.
Exemple :
Un cas d’utilisation type consiste à transformer des données d’une feuille de calcul Google au format XML.
-
Placez le module Google Sheets > Sélectionner des lignes dans votre scénario pour récupérer les données. Configurez le module pour récupérer les lignes de votre feuille de calcul Google. Définissez le Nombre maximal de lignes renvoyées sur un petit nombre, mais plus grand que 1 à des fins de test (par exemple, trois). Exécutez le module Google Sheets en cliquant dessus avec le bouton droit et en choisissant « Exécuter ce module uniquement ». Vérifiez la sortie du module.
-
Connectez-vous au module Agrégateur de tableau après le module Google Sheets. Dans la configuration du module, choisissez le module Google Sheets dans le champ Nœud source. Laissez les autres champs tels quels pour le moment.
-
Connectez le module XML > Créer XML après le module Agrégateur de tableaux.
La configuration du module nécessite une structure de données qui décrit la structure de la sortie XML. Cliquez sur le bouton Ajouter pour ouvrir la configuration de la structure de données. La méthode la plus simple pour créer cette structure de données consiste à la générer automatiquement à partir d’un exemple XML.
-
Cliquez sur le bouton Générateur et collez votre exemple XML dans le champ Données d’exemple :
-
Cliquer sur Enregistrer.
Le champ des spécifications de la structure de données contient désormais la structure générée.
-
Remplacez le nom de votre structure de données par un nom plus spécifique, puis cliquez sur Enregistrer.
Un champ correspondant à l’attribut de tableau racine apparaît comme champ mappable dans la configuration du module JSON.
-
Cliquez sur le bouton Mapper à côté du champ et mappez l’élément
Array[]de la sortie de l’agrégateur de tableaux sur ce champ : -
Cliquez sur OK pour fermer la configuration du module XML.
-
Ouvrez la configuration du module Agrégateur de tableaux. Modifiez la structure cible de « Personnalisé » à un champ de module XML correspondant à des éléments element.Map XML parents, et mappez les éléments du module Google Sheets aux champs appropriés.
-
Cliquez sur OK pour fermer la configuration du module d’agrégation de tableaux.
-
Exécutez le scénario.
Le module XML génère le fichier XML correct.
-
Ouvrez la configuration du module Google Sheets et augmentez le nombre maximum de lignes renvoyées pour qu’il soit supérieur au nombre de lignes de votre feuille de calcul afin de traiter toutes les données.
Le fichier XML obtenu peut être enregistré dans Dropbox, envoyé en tant que pièce jointe par e-mail, chargé via FTP sur un serveur, etc.
Ajouter des attributs XML
Si vous souhaitez ajouter des attributs à un nœud complexe (un nœud qui contiendra d’autres nœuds), vous devez ajouter, pour le nœud complexe, une collection portant le nom _attributes dans votre structure de données personnalisées. Cette collection sera mappée aux attributs du nœud. Si vous souhaitez ajouter des attributs à un nœud de texte (par exemple : <node attr="1">abc</node>), vous devez ajouter une collection _attributes pour les attributs et une propriété de texte _value pour la valeur de ce nœud dans votre structure de données personnalisées.
{
"name": "node",
"type": "collection",
"spec": [
{
"name": "_attributes",
"type": "collection"
"spec": [
{
"name": "attr1",
"type": "text"
}
]
},
{
"name": "_value",
"type": "text"
}
]
}
Parse XML
Le module XML > Parse XML analyse un texte au format XML et génère un seul lot contenant toutes les informations extraites du XML.
La structure de données décrit la structure du XML pour rendre la sortie du module disponible dans le panneau de mappage pour les modules suivants.
Si vous disposez d’un exemple du XML que vous souhaitez analyser, vous pouvez l’utiliser pour générer la structure de données :
-
Cliquez sur le bouton Add.
-
Cliquez sur le bouton Generator.
-
Copiez et collez l’exemple XML dans le champ Sample data.
-
Cliquez sur Save.
-
Vérifiez que la structure de données a bien été générée.
-
Cliquez sur le bouton Save pour enregistrer la structure des données.
Vous pouvez ignorer les étapes 2 à 5 pour fournir une structure de données vide. Si la structure de données est vide, la sortie du module n’est pas disponible dans le panneau de mappage tant que le module n’a pas été exécuté au moins une fois.
Pour plus d’informations, voir Structures de données.
Saisissez ou mappez le texte XML formaté que vous souhaitez analyser.
Si vous utilisez une formule, assurez-vous que son type de valeur de résultat est (ou peut être automatiquement contraint vers) le type de données Text.
Si le type de valeur de résultat est Buffer (données binaires), utilisez la fonction toString() pour la convertir en type de données Texte. Pour plus d’informations, voir Type coercition et Types de données d’élément.
Exemple :
Pour télécharger un fichier XML à partir d’une URL et analyser son contenu :
-
Créez un scénario.
-
Ajoutez le module HTTP > Obtenir un fichier
-
Ouvrez la configuration du module et procédez comme suit :
URL : URL du fichier XML (par exemple,
https://siftrss.com/f/rqLy05ayMBJ)
-
Cliquez sur OK pour enregistrer et fermer la configuration du module.
-
Ajoutez le module XML > Parse XML, connectez-le après le module HTTP > Obtenir un fichier et configurez-le comme suit :
table 0-row-2 1-row-2 layout-auto html-authored no-header Data structure - Cliquez sur le bouton Add.
- Cliquez sur le bouton Generator.
- Dans votre navigateur web, ouvrez un nouvel onglet ou une nouvelle fenêtre.
- Insérez l’URL que vous avez utilisée à la troisième étape dans la barre d’adresse et récupérez le fichier XML.
- Sélectionnez tout le texte XML et copiez-le dans le presse-papiers.
- Fermez l’onglet ou la fenêtre et revenez à votre scénario.
- Collez le texte XML copié dans le champ Données d’exemple.
- Cliquez sur Save.
- Vérifiez que la structure de données a bien été générée.
- Cliquez sur Save pour enregistrer la structure de données.
Vous pouvez ignorer les étapes 2 à 9 pour fournir une structure de données vide. Si la structure de données est vide, la sortie du module n’est pas disponible dans le panneau de mappage tant que le module n’a pas été exécuté au moins une fois.
XML Mappez l’élément
Dataà partir de la sortie du module HTTP > Get a file dans le champ. Utilisez la fonctiontoString()pour convertir sa valeur du type de données Buffer (données binaires) en type de données Text.Vous pouvez copier et coller le code de la formule dans le champ :
{{toString(1.data)}}Pour plus d'informations sur les types de données Tampon et Texte, voir Types de données d'élément.
Analyse des attributs XML
Par défaut, le module XML > Analyser XML place des attributs dans une collection spéciale _attributes en tant qu’enfant du noeud qui possède ces attributs. Si le noeud est un noeud de texte doté d’attributs, deux propriétés spéciales sont ajoutées : _attributes pour les attributs et _value pour le contenu textuel du noeud.
Exemple : cet XML :
<root attr="1">
<node attr="ABC">Hello, World</node>
</root>
est converti en ce lot :
Dépannage : impossible de mapper les données du module Analyse XML.
Assurez-vous que la structure des données est correctement définie. Vous pouvez également utiliser une structure de données vide et exécuter le module au moins une fois pour traiter une entrée XML.