package JSON

Le package JSON vous permet d\'extraire et d\'analyser des informations à partir de sources de données JSON. Il vous permet de manipuler les données JSON, par exemple l\'ajout ou la mise à jour des valeurs dans une chaîne JSON, l\'analyse de chaînes JSON en objets à l\'aide du chemin de nœud, et la conversion de chaînes JSON en dictionnaires et inversement.

Le package JSON joue un rôle essentiel dans l\'intégration transparente des flux de travail d\'automatisation avec les services Web et les API qui utilisent JSON pour l\'échange de données.

Avantages

  • JavaScript Object Notation (JSON) est un format léger, facile à comprendre et extensible pour stocker, transporter et extraire des données. JSON utilise des paires clé-valeur de données et fournit des échanges de données et des résultats de service Web plus rapides.
  • La plupart des services Web REST (API), certains fichiers de configuration et de nombreuses bases de données NoSQL telles que MongoDB utilisent couramment JSON en raison de son format flexible pour l\'échange de données. Basé sur du texte, léger et avec un format de données facile à analyser, il ne nécessite aucun code supplémentaire pour comprendre et interpréter les données fournies.
  • Les fichiers JSON peuvent être excellents pour stocker et extraire des données de configuration que votre automatisation peut référencer lors de la détermination des détails du serveur, de l\'environnement ou du partage de dossiers.
  • La structure flexible du format JSON s\'adapte efficacement à divers types de données et hiérarchies de données complexes.

Types de données JSON

Les valeurs dans JSON doivent être du type de données suivant :
  • Chaînes
  • Nombres
  • Objet (objet JSON)
  • paramètres
  • Valeurs booléennes
Remarque : La valeur NULL n\'est pas prise en charge dans Automation 360. Par conséquent, lorsque vous extrayez des données JSON et les convertissez en une variable de dictionnaire, les valeurs nulles dans la chaîne JSON ne sont pas converties, car les variables de dictionnaire ne prennent pas en charge les valeurs nulles. Cependant, si le JSON contient une chaîne vide ("") au lieu de null, elle sera convertie avec succès en une variable de dictionnaire.

Comprendre les structures JSON

Avec le format JSON, les données sont principalement stockées dans deux structures :
  • Objets : Avec le format JSON, les objets sont des collections de paires clé-valeur enfermées entre accolades {}. Chaque clé est une chaîne de caractères entourée de guillemets (““) suivie d\'un deux-points (:), et des virgules (,) sont utilisées pour séparer les paires clé, valeur.
    Exemple :
    {"name ": "John", "age": "30", "city": Detroit}
  • Tableaux : Les tableaux sont des listes ordonnées de valeurs, entre crochets []. Les valeurs dans un tableau sont séparées par des virgules (,).
    Exemple :
    ["John", "Annie", "Shane"]

Utilisation du package JSON

Utilisez les actions du package JSON dans l\'ordre suivant :
  1. Démarrez la session JSON à l\'aide de l\'action Démarrer une session. Utilisez ce nom de session pour toutes les actions correspondantes.
  2. Utilisez les différentes actions disponibles dans le package JSON pour automatiser les tâches JSON.
  3. Terminez la session en utilisant l\'action Terminer une session, afin de terminer une tâche.

Actions dans le JSON package

Le package JSON comprend les actions suivantes :
Remarque : Lorsque vous créez une automatisation sur la plateforme macOS, une fenêtre de confirmation vous invite à accorder des autorisations d\'application dans macOS. Consultez cette rubrique pour obtenir une liste de messages d\'invite et d\'instructions sur la gestion des autorisations de l\'application.

Autorisations d\'application sur macOS

Action Description
Démarrer une session Démarrer une nouvelle session JSON basée sur la source de données JSON spécifiée. Voir action Démarrer une session dans JSON.
Ajouter la valeur du nœud Ajouter un nouveau nœud à l\'objet JSON spécifié dans la source de données Démarrer une session. Voir Ajouter la valeur du nœud.
Convertir le dictionnaire en JSON Convertit le contenu d\'une variable Dictionnaire au format JSON. Voir Convertir le dictionnaire en JSON.
Convertir JSON en Dictionnaire Extraire le contenu de la source de données JSON dans une variable Dictionnaire. Voir Convertir JSON en Dictionnaire.
Obtenir la liste des nœuds Extrait la liste des noeuds pour un chemin de noeuds. Voir action Obtenir la liste des nœuds au format JSON.
Obtenir des nœuds Extrait les valeurs des clés depuis la source JSON. Voir Obtenir des nœuds au format JSON
Obtenir la valeur du nœud Extrait la valeur d\'un nœud à partir de la source JSON. Voir action Obtenir la valeur du nœud au format JSON.
Mettre à jour la valeur du nœud Mettre à jour la valeur d\'un nœud dans la source de données JSON. Voir Mettre à jour la valeur du nœud.
Valider Valide la syntaxe, la structure et le schéma de la source de données JSON. Voir Action Valider
Terminer la session Ferme une session JSON. Voir action Terminer une session au format JSON.

Ressources supplémentaires