---
layout: default
title: Imports
---

* "Rôle":#rol
* "Validation":#val
* "Formats disponibles":#fmt
* "Paramètres communs":#com
* "Options des formats":#opt
* "l’onglet IMPORTS":#imp
* "Nouvel Import":#new
* "Paramètres de validation":pvl
* "Consultation des résultats":#res
* "Résultats de validation":#rvl


h3(#rol). Rôle

p. L’import permet d’enregistrer dans la base un jeu de données d'offre TC, selon un format au choix. 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). Il est possible d'importer sans sauver en base, uniquement pour jouer les tests de vérification de conformité. Dans ce cas les tests en base de données (auxquels sont associés les jeux de paramètres) ne seront pas exécutés (et donc aucun test ne sera exécuté, pour des données CSV, GTFS, ou Netex).

h3(#val). Validation

p. 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é

p(olnext). - nécessite la fourniture d'un jeu de paramètres définissant les seuils (cf "Validation":validations) 

p(note). Les tests de niveau 1 et 2 ne sont actuellement implémentés que pour le format Neptune

h3(#fmt). Formats disponibles

- Neptune := format normalisé des échanges de données de transport en commun pour la France (cf "Normalisation":normalisation)
- NeTEx := format d'échange de données de transport en commun expérimental sur la norme européenne ["NeTEx":http://www.normes-donnees-tc.org/format-dechange/donnees-theoriques/] mais limité au sous-ensemble des données définies dans la norme Neptune
- CSV := format tabulaire spécifique à Chouette  (cf "CSV":csv)
- GTFS := 
format originaire de ["Google Transit":https://support.google.com/transitpartners/], à condition que le fichier soit préalablement validé avec l'outil Feed Validator =:

p(olnext). - les données exportées en GTFS sont explicités ["ICI":http://www.normes-donnees-tc.org/format-dechange/autres-normes/] 

h3(#com). Paramètres communs

- Pas de sauvegarde := permet d'effectuer une simulation de l'import sans enregistrer les données

p(ddnext). - active donc les tests de validation de niveau 1 et 2

- Jeu de paramètres pour validation := paramètres définissant les seuils des tests de niveau 3 (indisponible si l'option 'pas de sauvegarde' est cochée)

p(ddnext). - les jeux de paramètres sont créés via le lien ["Jeux de paramètres":parametersets] disponible sur les vues des listes d'imports et de validations

- Fichier à importer := fichier (plat ou zip selon format)

h3(#opt). Options des formats

Les options des différents formats apparaissent en fonction de celui qui a été choisi.

* *Neptune* : pas d'option particulière

* *NeTex* : pas d'option particulière

* *GTFS* :

- Préfixe d'identifiants := 
préfixe à utiliser pour générer les identifiants Neptune des objets importés,
initialisé à la valeur définie pour l'espace de données =:
- Distance max pour créer les zones := 
distance maximale entre deux arrêts homonymes pour les regrouper au sein d'un arrêt commercial de même nom,
ces zones viennent en supplément de celles définies dans GTFS, 
une distance de 0 ne génère aucune zone =:
- ignorer le dernier mot := 
lors de la comparaison des noms d'arrêts, cette option permet de ne pas prendre en compte le dernier mot du nom de l'arrêt (sauf si celui-ci n'est composé que d'un seul mot) =:
- ignorer les n derniers caractères := 
lors de la comparaison des noms d'arrêts, cette option permet de ne pas prendre en compte les derniers caractères du nom de l'arrêt (sauf si celui-ci n'a pas assez de caractères pour cela) =:
- Distance max pour créer les correspondances := 
distance maximale entre deux arrêts pour les lier par une correspondance,
ces correspondances sont hors zone d'arrêt;
elles viennent en supplément de celles définies dans GTFS (ce mécanisme tient compte des correspondances exclues), 
une distance de 0 ne génère aucune correspondance =:

* *CSV* : 

- Préfixe d'identifiants := 
préfixe à utiliser pour générer les identifiants Neptune des objets importés,
initialisé à la valeur définie pour l'espace de données =:

h3(#imp). l'onglet IMPORTS

p. L'onglet IMPORTS contient les objets Import de l'espace de données courant.

p. Chaque objet Import est représenté par une vignette comprenant : sa date, l'utilisateur qui l'a créé, son état (bleu : en cours ; vert : terminé correctement ; rouge : terminé en échec), un lien pour télécharger le fichier importé, un lien vers le détail de l'objet, un lien vers l'objet Validation associé).

p=. !import.png!

p. Comme les fichiers importés restent stockés en base, il est opportun que  l'utilisateur supprime périodiquement les objets Imports devenus inutiles. La suppression supprimera aussi les objets Validation associés.

p. Dans la partie droite de l'écran, 

* créer un nouvel Import
* Jeu de paramètres

h3(#new). Nouvel Import

p. Il est possible de modifier le jeu de paramètres par défaut ou de créer un nouveau Jeu de paramètres. Il est possible de ne choisir aucun jeu de paramètres.

p. L’import est lancé en différé, son résultat n'est pas immédiat. Le résultat est conservé tant que l’import n’est pas supprimé. L'import lance également la validation (avec ou sans jeu de paramètres associés), ce qui crée un objet Validation associé. La suppression d’un import également l'objet Validation associé à cet import ; néanmoins si les données ont été sauvegardées en base, elles seront conservées.

p. Si les données ne sont pas sauvées en base, il faut relancer un import avec sauvegarde si on souhaite effectivement importer ces données en base après une première validation « à blanc ».

h3(#pvl). Paramètres de validation

p. Il est possible de modifier le jeu de paramètres par défaut ou de créer un nouveau Jeu de paramètres. Les paramètres de vitesses et durée entre arrêts successifs sont définis mode par mode.

h3(#res). Consultation des résultats : détail de l'objet Import

p=. !import_result.png!

p. Le résultat d'import fournit 2 synthèses : 

# Synthèse des fichiers analysés (à gauche)
# Synthèse des lignes lues (à droite)

p. Le bouton « Fichier Importé » permet de télécharger le fichier sur son poste.

p. Le bouton « Validation » permet de basculer vers la validation des données.

p. _1 - La synthèse des fichiers analysés affiche 3 secteurs_

p(border_image). !import_file_result.png!

* en vert les fichiers correctement traités 
* en rouge les fichiers comportant des erreurs qui empêche leur traitement
* en gris les fichiers ignorés

p. En passant la souris sur chaque partie, le nombre de fichiers correspondant est affiché.

p. La sélection (clic souris) d'un des secteurs affiche la liste des fichiers concernés :

p(border_image). !import_file_detail.png!

p. _2 - La synthèse des lignes lues affiche le compte des objets extraits des fichiers correctement traités_

p(border_image). !import_line_result.png!

* lignes
* séquences d'arrêts
* correspondances
* calendriers
* zones d'arrêt
* accès
* courses
* missions

p. La sélection de l'histogramme affiche le détail des lignes lues :

p(border_image). !import_line_detail.png!

p. un survol affiche le nombre de données concernées par type.

p. la sélection du graphique affiche le détail par ligne

h3(#rvl). Résultats de validation

p. Les résultats de validation des niveaux 1, 2 et 3 sont consolidés dans un même formulaire de résultat.
voir "Validation":validations


