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 :
Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez Licences Adobe Workfront Fusion.
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 dans Adobe Workfront Fusion.
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 de coercition dans Adobe Workfront Fusion et Types de données d’élément dans Adobe Workfront Fusion.
-
Créez un scénario.
-
Insérez 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 |
>
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 Vous pouvez copier et coller le code de la formule dans le champ : Pour plus d’informations sur les types de données buffer et texte, voir Types de données des éléments dans Adobe Workfront Fusion.
|
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.
<root attr="1">
<node attr="ABC">Hello, World</node>
</root>
est converti en ce lot :
Créer du XML
Le module XML > Créer du XML convertit un lot en texte 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.
- Cliquez sur le bouton Générateur et collez votre exemple XML dans le champ Exemples de données :
- Cliquer sur Enregistrer. Le champ des spécifications de la structure de données contient désormais la structure générée.
- Modifiez le nom de votre structure de données en lui donnant 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.
- 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.
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"
}
]
}
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.