JSON Lines
JSON Lines (http://jsonlines.org/) est un format texte qui étend JSON. Il peut s'avérer pratique pour stocker ou traiter des données JSON lorsque les sauts de ligne jouent un rôle important, comme dans les fichiers journaux. Chaque ligne d'un fichier JSON Lines contient une valeur JSON, par exemple :
{"name":"Alethia Alonso","email":"alethia@example.org"} {"name":"Klaus Mauer","email":"klaus@example.org"} {"name":"Natsuo Shinohara","email":"natsuo@example.org"} |
Avec MapForce Enterprise Edition, vous pouvez lire des données au format JSON Lines et les convertir vers n'importe quel autre format pris en charge par MapForce. De même, vous pouvez convertir des données depuis n'importe quel format pris en charge par MapForce vers le format JSON Lines.
Note : dans les appels de services Web créés avec MapForce, vous pouvez utiliser le format JSON standard comme structure de requête ou de réponse ; les structures JSON Lines ou JSON5 ne sont pas prises en charge.
Pour lire ou écrire des données au format JSON Lines, MapForce a besoin d’un schéma JSON, comme pour les fichiers JSON standard. La différence réside dans le fait que, dans le cas de JSON Lines, chaque ligne est traitée comme un fichier JSON distinct à des fins de validation. Le schéma que vous fournissez à MapForce valide donc chaque ligne individuellement en tant que document JSON.
L’extension de fichier recommandée par les auteurs du format JSON Lines est .jsonl.
Comment mapper des données vers ou depuis le format JSON Lines
1.Dans le menu Insérer, cliquez sur JSON, puis sélectionnez le fichier d’instance .jsonl. Vous pouvez également cliquer sur le bouton 
de la barre d’outils. Si vous disposez déjà d’un fichier de schéma JSON et préférez fournir le fichier d’instance ultérieurement, sélectionnez un schéma JSON valide. Cela fonctionne de la même manière qu’avec les fichiers JSON classiques (voir Ajouter des fichiers JSON en tant que composants de mappage). Gardez simplement à l’esprit que, dans le cas du format JSON Lines, le schéma JSON doit décrire le contenu de chaque ligne du fichier d’instance, et non le fichier dans son ensemble.
2.Une fois le composant JSON ajouté au mappage, cliquez avec le bouton droit sur sa barre de titre, sélectionnez Propriétés, puis cochez la case JSON Lines.
Pour définir ou modifier le fichier d’instance JSON à partir duquel le mappage lit les données, saisissez le chemin d’accès dans la zone de texte Fichier JSON d’entrée. Il n’est pas nécessaire de remplir cette zone de texte si le mappage écrit des données dans un fichier JSON.
Pour définir ou modifier le nom du fichier généré, saisissez le nom de fichier souhaité (par exemple, « somefile.jsonl ») dans la zone de texte Fichier JSON de sortie du dialogue ci-dessus. Il n’est pas nécessaire de remplir cette zone de texte si le mappage lit des données à partir d’un fichier JSON. Pour plus d’informations sur les autres paramètres, voir Paramètres de composant JSON.
Lorsque la case à cocher JSON Lines est sélectionnée, le composant JSON dispose d’un nouveau nœud d’élément dans le mappage. En y connectant n’importe quelle séquence de valeurs (par exemple, l’élément Rows d’un composant source CSV), vous pouvez créer plusieurs lignes dans le fichier Lignes JSON (une ligne pour chaque élément de la séquence). Dans le mappage ci-dessous, les données source sont un fichier JSON standard et la cible est un fichier JSON Lines. Grâce à la connexion située tout en haut, une nouvelle ligne JSON sera créée dans le fichier cible People.jsonl pour chaque objet du fichier source People.json lors de l’exécution du mappage :
De même, si votre mappage doit lire des données à partir d’un fichier JSON Lines, vous pouvez connecter le nœud d’élément à l’élément cible souhaité (par exemple, un élément XML). Cela créerait autant d’éléments XML dans la cible qu’il y a de lignes JSON dans la source.