DocumentationWorkfrontGuide Workfront

Modules JSON

Last update: Thu Sep 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

L’application Adobe Workfront Fusion JSON fournit des modules pour traiter les données au format JSON afin qu’Adobe Workfront Fusion puisse continuer à travailler avec le contenu des données ou créer un nouveau contenu JSON.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences en matière de licences héritées : Workfront Fusion for Work Automation and Integration, Workfront Fusion for Work Automation

Produit

Conditions requises du produit actuel : si vous disposez de la formule Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans 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, voir Licences Adobe Workfront Fusion.

Analyse JSON

Structures des données

La structure des données décrit la manière dont les données JSON sont organisées et permet de mapper des éléments JSON individuels avec d’autres modules de votre scénario. Si vous ne fournissez pas la structure des données, vous pouvez exécuter manuellement le module et Workfront Fusion construira la structure à partir du JSON fourni :

  1. Ajoutez le module Analyse JSON à un scénario.
  2. Dans le champ Chaîne de caractères JSON, saisissez le JSON à partir duquel vous souhaitez créer une structure des données.
  3. Ne connectez pas encore d’autres modules au module Analyse JSON. Comme Workfront Fusion ne connaît pas encore la structure des données JSON, il n’est pas encore possible de mapper les données du module Analyse JSON à d’autres modules de votre scénario.
  4. Exécutez manuellement le scénario. Cela permet au module Analyse JSON d’identifier la structure du JSON à partir du JSON que vous avez fourni.
  5. Vous pouvez maintenant connecter les modules suivants. Les éléments du module Analyse JSON sont maintenant disponibles pour le mappage.

Pour plus d’informations, voir Structures des données dans Adobe Workfront Fusion.

Collection ou tableau

Si le champ Chaîne de caractères JSON contient une collection { ... }, la sortie est un paquet unique contenant les éléments de la collection.

INFO
Exemple :
code language-none 
{
       "name" : "Peter",

Si le champ Chaîne de caractères JSON contient un tableau [ ... ], la sortie est une série de paquets. Chaque paquet contient un élément du tableau.

INFO
Exemple :
code language-none 
[
   {
       "name" : "Peter",
       "ID" : 1
   },

Modules JSON et leurs champs

Lorsque vous configurez les modules JSON, Workfront Fusion affiche les champs énumérés ci-dessous. En plus de ces champs, d’autres champs JSON peuvent s’afficher, en fonction de facteurs tels que votre niveau d’accès à l’application ou au service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mapper des informations d’un module à l’autre dans Adobe Workfront Fusion.

Agrégateurs

Agréger en chaîne JSON

Ce module agrégateur regroupe les résultats d’un module précédent en chaîne JSON.

Source module
Sélectionnez le module qui produit les données que vous souhaitez agréger en chaîne JSON.
Data structure
Sélectionnez la structure de données que vous souhaitez utiliser pour créer la chaîne JSON. La structure des données détermine les autres champs disponibles dans ce module. Pour plus d’informations, voir Structure des données dans cet article.
Indentation
Indiquez si vous souhaitez indenter la chaîne JSON en utilisant des tabulations, deux espaces ou quatre espaces.
Group by
Définissez une expression selon laquelle vous souhaitez regrouper la sortie agrégée. Cette expression peut contenir un ou plusieurs éléments mappés. Les données agrégées sont ensuite séparées en groupes à l’aide de la valeur de cette expression. Chaque groupe se présente sous la forme d’un lot distinct avec une clé (l’expression évaluée) et une valeur (le texte agrégé). Vous pouvez utiliser la clé comme filtre dans les modules suivants.
Stop processing after an empty aggregation
Activez cette option pour arrêter le scénario lorsqu’il n’y a aucun résultat.

Transformateurs

Convertir la chaîne JSON en XML

Ce module d’action convertit une chaîne JSON en XML.

JSON string
Saisissez ou mappez le code JSON que vous souhaitez convertir en XML.

Créer un code JSON

Ce module d’action crée du code JSON à partir d’une structure de données.

Structures des données
Sélectionnez la structure de données que vous souhaitez utiliser pour créer la chaîne JSON. Pour plus d’informations, voir Structure des données dans cet article.

Analyser le code JSON

Ce module d’action analyse une chaîne JSON dans une structure de données, ce qui vous permet d’accéder aux données contenues dans la chaîne JSON.

Data structure
Sélectionnez la structure de données que vous souhaitez utiliser pour créer la chaîne JSON. Pour plus d’informations, voir Structure des données dans cet article.
JSON string
Saisissez ou mappez le code JSON que vous souhaitez analyser.

Transformer une chaîne JSON

Ce module d’action transforme un objet en une chaîne JSON.

Object
Saisissez ou mappez l’objet que vous souhaitez transformer en chaîne JSON.

Transformation des enregistrements de données en chaîne JSON

INFO
Exemple : l’exemple suivant montre comment transformer des enregistrements de données de Google Sheets au format JSON :

  1. 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.

  2. 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.

  3. Connectez JSON > module Créer JSON après le module Agrégateur de tableaux. La configuration du module nécessite une structure de données qui décrit le format JSON. Cliquez sur Ajouter pour ouvrir la configuration de la structure de données. La manière la plus simple de créer cette structure de données est de la générer automatiquement à partir d’un exemple JSON. Cliquez sur Générateur et collez votre exemple JSON dans le champ Données d’exemple  :

Exemple :
code language-none 


 {


"books": [




{




"id": "ID",




"title": "Title",




"author": "Author"




}




]




}

  1. Cliquer sur Enregistrer. Le champ Spécification de la structure de données contient maintenant la structure générée.

  2. Attribuez à votre structure de données un nom plus spécifique et cliquez sur Enregistrer. Un champ correspondant à l’attribut de tableau racine apparaît comme champ mappable dans la configuration du module JSON.

  3. Cliquez sur le bouton Mapper en regard du champ et mappez-y l’élément Array[] de la sortie de l’Agrégateur de tableaux.

  4. Cliquez sur OK pour fermer la configuration du module JSON.

  5. Ouvrez la configuration du module Agrégateur de tableau. Modifiez la structure cible de Personnalisée en champ du module JSON correspondant à l’attribut tableau racine. Mappez les éléments du module Google Sheets aux champs appropriés.

  6. Cliquez sur OK pour fermer la configuration du module Agrégateur de tableau.

  7. Exécutez le scénario.

Le module JSON produit le bon format JSON.
  1. Ouvrez la configuration du module Google Sheets et augmentez le nombre maximal de lignes renvoyées pour que ce nombre soit supérieur au nombre de lignes de votre feuille de calcul afin de traiter toutes les données.

Dépannage

Impossible de mapper les données du module Analyser JSON.

Assurez-vous que le contenu JSON est correctement mappé dans le module Analyser JSON et que la structure des données est correctement définie. Pour plus d’informations, voir Transformer des enregistrements de données en JSON dans cet article.

Le module échoue lors de l’utilisation d’instructions conditionnelles dans JSON.

Lorsque vous utilisez des instructions conditionnelles telles que if dans JSON, mettez les guillemets à l’extérieur de l’instruction conditionnelle.

INFO
Exemple :
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43