Sujet précédent

Calendriers commerciaux

Sujet suivant

Gestion des Exports

Gestion des imports

Description métier

L’import permet d’enregistrer dans la base un jeu de données, selon un format au choix, pour éviter la saisie manuelle de toutes les données. Des tests de validation des données sont exécutés avant l’import en base de données (plus détaillées dans le cas du format Neptune).

Consulter les Imports

Vous pouvez consulter les imports faits par votre organisation dans les “Espace de travail”.

_images/menu_import.png

Pour chaque import, Etat, Démarrage, Nom de l’import, Opérateur, sont affichés.

_images/import_list.png

Les imports peuvent être filtrées selon :

  • leur nom
  • état
  • démarrage

Pour chaque import, une roue dentée permet de lancer les actions disponibles (consulter, télécharger fichier source).

Vous pouvez lancer l’import d’un fichier Neptune ou GTFS. Chouette détecte automatiquement le type de fichier.

Les données du fichier sont stockées :

  • dans le référentiel d’arrêts et de lignes
  • dans un jeu de donnée créé par l’import

Le jeu de donnée est créé avec :

  • la nom de l’import
  • la liste des lignes référencées dans le fichier
  • une période couvrant du premier jour du dernier jour des calendriers présents dans le fichier

Lancer un import

Pour importer des données dans l’application, il faut cliquer sur “Nouvel import”, remplir le formulaire et choisir un fichier à importer.

_images/import_creation.png

Attention

Vous pouvez demander à l’import que les jeux de données créés soient finalisés automatiquement en cas de succès. Ce lancement automatique n’est pas effectué si l’import est en échec, comme suite à des problèmes dans la lecture de données ou à des erreurs dans la validation automatique.

Lorsque vous lancez une opération d’import ou d’export, une barre de progression permet de suivre l’avancement de l’opération. Cette barre est persistante. Vous pouvez cliquer sur la barre pour retourner sur les informations de l’opération en cours. Vous pouvez aussi fermer la barre (sans perturber l’opération).

Vous pouvez voir les informations sur l’import dans sa fiche.

L’import peut avoir les Status suivants:

  • succès
  • échec
  • en attente
  • warning
_images/import_window.png

Pour que l’import d’un fichier s’effectue avec succès dans Chouette, le contenu du fichier doit passer la validation des données.

Lors de l’import, des tests sont effectués :

  • sur le respect du format (syntaxique et sémantique)
  • sur la complétude et la cohérence des relations exprimées dans le format d’échange
  • optionnellement sur la qualité des données en vue de son exploitation dans une centrale de mobilité

Attention

Si un arrêt, transporteur ou un réseau sont définis plusieurs fois dans les données importées, c’est la dernière version lue par Chouette qui est prise en compte.

Une fois l’import terminé vous recevez une notification par email.

Si l’import échoue, dans la fiche d’import vous pouvez voir les fichiers contenants des erreurs qui ont causé l’échec.

_images/import_error.png

Dans le cas d’échec de l’import causé par les erreurs dans le fichier, le Jeu de données créé va contenir que les données correctes.

Attention

Le Jeu de données ne sera pas créé si les données de l’import sont en conflit avec le Jeu de donnée existant “en édition”.

GTFS

Un “fichier GTFS” est un fichier ZIP contenant des fichiers CSV (un fichier par type de données : arrêts, calendriers, horaires, etc.)

A l’import de fichier GTFS, Chouette va traiter, dans l’ordre, les fichiers csv suivants :

  • agencies.txt
  • stops.txt
  • routes.txt
  • calendars.txt
  • calendar_dates.txt
  • trips.txt
  • stop_times.txt

Chaque fichier csv doit contenir un certain nombre d’attributs, qui doivent être remplis selon le format officiel.

Attention

Si un fichier csv de fichier GTFS est absent ou ne correspond pas aux format officiel, l’import va échouer.

NEPTUNE

Chaque fichier NEPTUNE correspond à la description d’une ligne du réseau de transport. En général, un réseau de transport étant caractérisé par plusieurs lignes de transport, on dispose alors d’un ensemble de fichier .xml regroupés dans un .ZIP. Chouette traite l’ensemble de fichiers xml présents dans la racine du fichier ZIP soumis par l’utilisateur, en les validant un par un.

Supprimer un import

Chouette conserve le fichier de chaque import. Cette conservation est limitée dans le temps. Après une période configurable au niveau du serveur Chouette, les imports restent accessibles dans l’interface mais leur fichier n’est plus disponible.

Ce nettoyage est réalisé après chaque import sur les imports du même espace de travail.