Fichiers JSON

JSON est un format standard ouvert qui utilise du texte lisible par l'homme pour transmettre des objets de données constitués de paires clé-valeur. C'est le format de données le plus courant pour créer des API Web.

Comme les documents JSON peuvent avoir de nombreuses formes différentes, la plate-forme peut extraire des données à partir de fichiers JSON, de fichiers Lignes JSON et de dictionnaires JSON.

Si la plateforme n'extrait pas complètement un document avec une structure complexe, utilisez l'un des processeurs JSON pour terminer l'extraction.

Vous pouvez utiliser un fichier JSON comme source. A partir de ce fichier, la plateforme extrait un document JSON valide (tableau ou objet) en un jeu de données de plusieurs enregistrements :

• Si le document est un tableau JSON, un enregistrement sera créé pour chaque objet à l'intérieur du tableau (les clés seront utilisées comme noms de colonne).

• Si le document est un objet JSON, le paramètre "Racine JSON" doit contenir un chemin séparé par des points vers le tableau à l'intérieur de votre objet. S'il n'est pas fourni, la plate-forme essaie items .

Pour chaque élément à l'intérieur du tableau, la plateforme peut suivre un autre chemin avant d'extraire les enregistrements avec le paramètre "objet JSON".

• Champs normaux (décimal, booléen, chaîne)

• Objet JSON : utilisé tel quel

• Tableau:

  • Si le tableau contient des objets JSON, il est utilisé tel quel.

  • Si le tableau contient des chaînes, un champ à plusieurs valeurs est créé avec toutes les chaînes séparées par un point-virgule ( ; ).

Pour plus d'informations sur l'ajout d'une source de fichier, voir Récupération d'un fichier.

[
 {
 "name": "Agra Express",
 "origin": "Agra Cantt",
 "destination": "New Delhi"
 },
 {
 "name": "Gour Express",
 "origin": "Balurghat",
 "destination": "Sealdah"
 }
 ]

Dans ce fichier JSON, le tableau JSON est directement à la racine. Vous pouvez laisser la zone racine JSON vide.

Le jeu de données résultant sera :

L'ordre des colonnes peut varier.

{
 "filename": "trains.json",
 "content": {
 "trains": [
 {
 "id": 123,
 "info": {
 "name": "Agra Express",
 "origin": "Agra Cantt",
 "destination": "New Delhi"
 }
 },
 {
 "id": 555,
 "info": {
 "name": "Gour Express",
 "origin": "Balurghat",
 "destination": "Sealdah"
 }
 }
 ]
 }
 }

Pour ce fichier JSON complexe, la racine JSON correcte est content.trains . Si content.trains est défini comme racine JSON, le jeu de données résultant sera :

Pour extraire uniquement les objets JSON info et ignorer le numéro d' id , l'objet JSON correct est info . Si info st défini en tant qu'objet JSON, le jeu de données résultant sera :

Vous pouvez utiliser un fichier Lignes JSON comme source. Dans les fichiers Lignes JSON, chaque ligne est un document JSON d'une ligne. L'ensemble du fichier n'est pas un document JSON valide, mais chaque ligne l'est.

Deux modes sont pris en charge :

• Un tableau JSON sur chaque ligne (ou un tableau globa)

• Un objet JSON sur chaque ligne

• Champs normaux (décimal, chaîne de caractères)

• Tableau : utilisé tel quel

• Objet JSON : utilisé tel quel

Pour plus d'informations sur l'ajout d'une source de fichier, voir Récupération d'un fichier .

Vous pouvez utiliser un dictionnaire JSON comme source. La plateforme extrait un document JSON valide (tableau ou objet) dans un jeu de données de plusieurs enregistrements.

La plateforme attend un objet JSON où chaque clé contient un enregistrement. La plateforme crée alors des enregistrements avec :

• une colonne pour contenir la clé

• une colonne pour chaque attribut de l'objet correspondant (ou une colonne unique nommée "value" si la valeur est une chaîne de caractères au lieu d'un objet).

• Champs normaux (décimal, booléen, chaîne de caractères)

• Objet JSON : sera utilisé tel quel

• Tableau:

  • Si le tableau contient des objets JSON, il est utilisé tel quel.

  • Si le tableau contient des chaînes de caractères, un champ à plusieurs valeurs est créé avec toutes les chaînes séparées par un point-virgule ( ; ).

Pour plus d'informations sur l'ajout d'une source de fichier, voir Récupération d'un fichier .

{
 "2016": {
 "type1": {
 "price": 10,
 "color": "blue",
 "available": true
 },
 "type2": {
 "price": 9,
 "color": "red",
 "available": true
 }
 },
 "2015": {
 "type1": {
 "price": 10.5,
 "color": "teal",
 "available": true
 },
 "type2": {
 "price": 9.1,
 "color": "crimson",
 "available": true
 }
 }
 }

Si vous laissez la zone racine JSON vide, le jeu de données résultant sera :

{
 "results": {
 "datasets": [{
 "abc": {
 "title": "AB C",
 "description": "A description about ABC"
 }
 },
 {
 "xyz": {
 "title": "DE F",
 "description": "Another description"
 }
 }
 ]
 }
 }

Pour ce fichier JSON complexe, la racine JSON correcte est results.datasets.item .

• results.datasets mène au tableau

• item itère à l'intérieur du tableau et récupère chaque objet