Documentation

  1. Accueil
  2. Docs
  3. Documentation
  4. Commencer avec LODEX
  5. Importer des données

Importer des données

L’import d’un jeu de données est la première étape vers la publication avec LODEX.

L’import peut intervenir :

  • à la création d’une instance
  • pour ajouter de nouvelles données à une instance créée précédemment.

Dans ce second cas, la structure du nouveau jeu de données doit être identique à celle du fichier chargé initialement.

Pour importer des données dans une instance, il faut se connecter en mode administrateur.

Importer des données dans une instance vide

L’ajout de données à nouvelle instance peut se faire 3 façons : via l’import d’un fichier présent en local (1), par le renseignement d’une URL correspondant à un fichier distant (2) ou encore par l’interrogation d’une API tierce (3) prise en charge par LODEX (HAL, Conditor, ISTEX, OpenAlex…).

Téléversement d’un fichier stocké en local

  • La fenêtre qui s’ouvre lorsqu’on accède à la partie « Admin » d’une instance vide présente le menu visible ci-dessous dont l’onglet nommé « FICHIER » 1) permet de glisser-déposer un fichier ou de parcourir l’arborescence d’un dispositif de stockage pour le sélectionner
  • Une fois le fichier déposé (2), il convient de sélectionner le loader (3) adéquat (cf. liste non-exhaustive ci-après)

  • dans la liste qui s’ouvre, sélectionner un « loader » en cliquant sur la ligne correspondante

 

 

Un loader est un fichier de configuration permettant de charger / importer, dans une instance, un jeu de données. LODEX propose plusieurs loaders, qui correspondent à différents formats pour le jeu de données à charger. Le choix du loader dépend de l’origine et du format des données à importer.

Les loaders disponibles pour LODEX sont décrits ici : https://www.lodex.fr/docs/partie-2-2/les-loaders/

  • Il est à noter qu’une fois le « loader » sélectionné, celui-ci est « customisable » c’est à dire éditable via le cadre logiciel ezs faisant office d’ETL (pour « Extract, Transform, Load ») afin de réaliser des traitements particuliers sur le jeu de données à charger
  • Enfin, cliquer sur « IMPORTER LES DONNÉES » pour procéder au chargement dans la base mongodb déclarée dans le fichier de configuration de l’instance globale dont dépend l’instance dans laquelle les données viennent d’être chargées

Chargement d’un fichier distant via le renseignement d’URL

L’onglet « LIEN WEB » permet d’indiquer à LODEX l’URL d’une page où se trouvent les données à importer.

 

 

 

 

Chargement de données via l’interrogation d’une API tierce directement à partir de LODEX

Il est aussi possible d’interroger une API tierce grâce à une requête au format « text » via l’onglet « SAISIE LIBRE ». L’exemple présenté ci-dessous correspond à la récupération de données de la base OpenAlex (cf. section « Exploitation de données requêtées via la base OpenAlex » pour découvrir le modèle associé à cet exemple).

Ajouter des données à une instance en contenant déjà

Dans l’onglet Données, cliquer sur le bouton « AJOUTER » en haut de page pour accéder à l’interface d’import.

Si l’instance contient déjà des données avant cet import, un message d’alerte indique que les nouvelles données remplaceront celles déjà chargées si elles possèdent les mêmes identifiants. Il faut cliquer soit sur ACCEPTER soit sur ANNULER.

 

Affichage des données après import

Le jeu de données s’affiche dans le menu « DONNÉES ».

La ligne affichée en bas de l’écran données détaille l’état des colonnes chargées et permet la navigation dans le tableau (aussi appelé « datagrid »).

Comment pouvons-nous aider ?