Modules JSON

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

Conditions d’accès

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

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 **

Actuel : aucune exigence de licence Workfront Fusion

Ou

Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Nouveau :

  • Sélectionnez ou le package Prime Workfront : votre entreprise doit acheter Adobe Workfront Fusion.
  • Package Ultimate Workfront : Workfront Fusion est inclus.

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.

Remarques concernant l’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 de données, vous pouvez exécuter manuellement le module et Workfront Fusion créera la structure à partir du fichier 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 Parse 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.

recommendation-more-help

Exemple :

{
    "name" : "Peter",

    "ID" : 1>}

Collection JSON

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.

Exemple :

[
  {
    "name" : "Peter",
    "ID" : 1
  },

  {
    "name" : "Mike",
    "ID" : 2
  }
]

Tableau JSON

Modules JSON et leurs champs

Lorsque vous configurez les modules JSON, Workfront Fusion affiche les champs répertorié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 Mappage des informations d’un module à un autre.

Basculement de carte

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.
Mise en retrait
Sélectionnez la mise en retrait à utiliser pour ce fichier JSON.

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.

Mise en retrait
Sélectionnez la mise en retrait à utiliser pour ce fichier 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

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"
    }
    ]
    }
    
  4. Cliquer sur Enregistrer. Le champ Spécification de la structure de données contient maintenant la structure générée.

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

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

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

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

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

  10. Exécutez le scénario.

    Le module JSON produit le bon format JSON.

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

Exemple :

Citations dans JSON

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3