DocumentationWorkfrontGuide Workfront

JSON modules

Last update: Wed Jun 28 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Le Adobe Workfront Fusion JSON L’application fournit des modules pour traiter les données au format JSON de sorte que Adobe Workfront Fusion peut continuer à utiliser le contenu des données ou créer du contenu JSON.

Exigences d’accès

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

Adobe Workfront plan*
Pro ou version ultérieure
Adobe Workfront license*
Plan, Work
Adobe Workfront Fusion license**

Exigences de licence actuelles : Non Workfront Fusion conditions requises pour obtenir une licence.

Ou

Exigences de licence héritées : Workfront Fusion pour l’automatisation et l’intégration du travail, Workfront Fusion pour l’automatisation du travail

Produit

Exigences actuelles du produit : Si vous disposez de Select ou Prime Adobe Workfront Planifiez, 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 l’Ultimate Workfront planifiez.

Ou

Exigences de produit héritées : Votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître le plan, le type de licence ou l’accès dont vous disposez, contactez votre Workfront administrateur.

Pour plus d’informations sur Adobe Workfront Fusion licences, voir Adobe Workfront Fusion licences.

Analyse JSON

Structure des données

La structure de données décrit l’organisation des données JSON et permet le mappage de différents éléments JSON à d’autres modules dans votre scénario. Si vous ne fournissez pas la structure de données, vous pouvez exécuter manuellement le module et Workfront Fusion crée la structure à partir du fichier JSON fourni :

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

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

Collection vs. Array

Si le champ de chaîne JSON contient une collection { ... }, la sortie est un lot unique contenant les éléments de la collection.

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

Si le champ de chaîne JSON contient un tableau [ ... ], la sortie est une série de lots. chaque lot contient un élément du tableau .

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

JSON modules et leurs champs

Lorsque vous configurez JSON modules, Workfront Fusion affiche les champs répertoriés ci-dessous. En outre, d’autres champs JSON peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton de mappage situé au-dessus d’un champ ou d’une fonction s’affiche, 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 dans Adobe Workfront Fusion.

Agrégation vers JSON

Ce module d’agrégation regroupe la sortie d’un module précédent dans JSON.

Module source
Sélectionnez le module qui génère les données que vous souhaitez agréger au format JSON.
Structure de données
Sélectionnez la structure de données à utiliser pour créer JSON. La structure de 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 mettre le fichier JSON en retrait à l’aide d’onglets, de deux espaces ou de quatre espaces.
Groupe par
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 génère 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.
Arrêter le traitement après une agrégation vide
Activez cette option pour arrêter le scénario lorsqu’il n’y a aucun résultat.

Convertir JSON en XML

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

Chaîne JSON
Saisissez ou mappez le fichier JSON que vous souhaitez convertir en XML.

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

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

Création de JSON

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

Structure des données
Sélectionnez la structure de données à utiliser pour créer JSON. Pour plus d’informations, voir Structure des données dans cet article.

Transformer JSON

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

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

Transformation des enregistrements de données en JSON

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

  1. Placez le 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 Google feuille de calcul. Définissez la ​ Nombre maximal de lignes renvoyées à un petit nombre, mais plus grand qu’un à des fins de test (par exemple, trois). Exécutez le 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 Agrégateur de tableau après l’événement Google Sheets module . Dans la configuration du module, sélectionnez la variable Google Sheets du module Noeud source champ . Laissez les autres champs tels quels pour le moment.

  3. Connexion JSON > Création de JSON après l’événement Agrégateur de tableau module . 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 méthode la plus simple pour créer cette structure de données consiste à la générer automatiquement à partir d’un exemple JSON. Cliquez sur Générateur et collez votre exemple JSON dans le Exemples de données field :

Exemple:
code language-none 
{


"books": [




{




"id": "ID",




"title": "Title",




"author": "Author"




}




]

  1. Cliquer sur Enregistrer. Le Spécification dans la structure de données contient désormais la structure générée.

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

  3. Cliquez sur le bouton Carte en regard du champ et mappez le Array[] de la sortie de l’agrégateur Array vers celui-ci.

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

  5. Ouvrez la configuration du Agrégateur de tableau module . Modifiez la variable Structure cible de Personnalisé au JSON champ du module correspondant à l’attribut du tableau racine. Mappage d’éléments à partir de Google Sheets aux champs appropriés.

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

  7. Exécutez le scénario.

Le JSON génère le format JSON correct.
  1. Ouvrez la configuration du Google Sheets et augmentez la variable Nombre maximal de lignes renvoyées pour traiter toutes les données.

Dépannage

Impossible de mapper les données de la variable Analyse JSON module

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

Échec du module lors de l’utilisation d’instructions conditionnelles dans JSON

Lorsque vous utilisez des instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets en dehors de l’instruction conditionnelle.

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