app/views/help/vehicle_journeys.textile
---
layout: default
title: Courses et horaires
---
h3. Définition
Une *course* décrit le passage d'un véhicule de transport public sur une _"séquence d'arrêts"_ de la _"ligne"_. La course parcourt les arrêts de la séquence d'arrêts dans l'ordre, sans nécessairement s'arrêter à chacun des arrêts. A chaque arrêt desservi, la course précise l'horaire de passage du véhicule.
La course est rattachée à un nombre variable de "calendriers d'application" qui permettent de déterminer si la course est assurée à une date particulière.
h3. Consulter les courses
h4. Filtrer les courses
L'accès à la page des courses se fait depuis la page de la séquence d'arrêts. Dans le menu latéral, cliquer sur _"horaire des courses"_ affiche la page des courses de la séquence d'arrêts courante. Un tableau présente les horaires de passage aux arrêts pour chacune des courses.
Un filtre de recherche permet de sélectionner les courses en fonction de différents critères :
* La mission
* Les courses sans calendriers
* Par nom de calendrier
* Les courses sans horaires
* Sur l'heure de départ de la course
h4. Changer de séquence d'arrêts
Un bouton _"séquence d'arrêts"_ est positionné au-dessus de la liste des arrêts. Il permet de naviguer vers une autre séquence d'arrêts de la ligne dans l'hypothèse où la séquence ouverte ne corresponde pas à la séquence voulue.
h4. Consulter le détail d'une course
Dans le tableau des courses, le lien en en-tête de colonne permet de sélectionner une autre séquence d'arrêt de la ligne ce qui permet de passer d'une séquence à l'autre directement sans avoir besoin de revenir à la page de la séquence d'arrêt. Cela permet par exemple d'accéder directement à la séquence d'arrêt retour.
L'en-tête de chaque course propose un bouton qui permet d'accéder à des fonctions relative à la course :
* Afficher la page de la course pour en consulter le détail ou l'éditer
* Accéder directement à l'édition des horaires de la course
* Consulter la mission assurée par la course et accéder directement à sa page.
* Consulter les calendriers associés à la course et accéder directement à leur page.
!2014-10-31_113958.png!
Affichage des raccourcis de modification d'une course
h3. Créer une course
Il n'est possible de créer une course qu'à la condition d'avoir créé une mission au préalable.
La création d'une nouvelle course se fait en cliquant _"Ajouter une course"_ dans le menu latéral. Il est également possible de créer de nouvelles courses par l'import d'un fichier .csv édité dans un tableur.
h4. Ajouter une course depuis CHOUETTE
Le bouton ajouter une course affiche un formulaire permettant de décrire la nouvelle course.
Dans le champ calendrier, saisir quelques lettres du nom d'un calendrier à affecter à la ligne permet d'afficher des propositions issues de l'auto-complétion. L'opération peut être renouvelée autant que nécessaire pour affecter plusieurs calendriers à la course.
Dès lors que la mission est sélectionnée, la liste des arrêts à desservir s'affiche en bas de la page. Elle comprend deux rangées d'horaires, l'un pour le départ, l'autre pour l'arrivée. Pour faciliter la saisie, il est possible de passer d'un champ de saisie horaire avec la touche tabulation et de saisir les données horaires avec le pavé numérique du clavier. Dans le cas où les horaires de départ et d'arrivée à l'arrêt sont confondus, les liens _"Copier vers départs"_ et _"Copier vers arrivée"_ permettent de ne saisir les horaires qu'une seule fois.
!2014-10-31_114336.png!
Édition des horaires dans CHOUETTE
h4. Ajouter une course par import .csv
L'export/import de données horaire au format .csv est possible depuis l'interface des horaires. Voir le chapitre ""Exporter et importer des horaires en .csv":vehicle_journeys_import_export
h3. Modifier une course
Il est possible de modifier une course depuis la bulle accessible en cliquant sur l'en-tête de chaque course ou en cliquant sur _"Modifier cette course"_ depuis la page de la course proprement dite.
Comme pour la création, il est également possible de modifier une course par export / import .csv.
h4. Modification d'une course depuis CHOUETTE
La modification de la course affiche le même formulaire que lors de la création avec les informations déjà renseignées dans les champs. Chacun d'entre-eux est éditable.
Un cadre situé au-dessus de la liste des horaires offre une fonction supplémentaire permettant de décaler la course en calant soit l'horaire de départ, soit l'horaire d'arrivée à un horaire précis. Les temps de parcours inter-arrêts ne sont pas modifiés, la course est simplement décalée dans le temps.
h4. Modification d'une course par import .csv
L'import d'un fichier .csv permet de modifier des courses éditées dans un tableur. Cliquer sur _"export des horaires aux arrêts"_ permet de récupérer le fichier des courses. Les modifications ou même les ajouts de courses seront pris en compte après import dans la base. Le séparateur retenu pour le fichier .csv est le point-virgule. Il ne faut pas saisir _"d'id de course"_ lorsque l'on saisit au travers d'un fichier .csv de nouvelles courses. CHOUETTE génrera lui-même un numéro valide à l'import. Saisir un numéro fera échouer l'import.
Supprimer toute la colonne d'une course du fichier n'aura aucun effet. En effet, la course n'apparaissant plus dans le fichier, son réimport n'aura aucune conséquence sur la course existante en base.
Pour supprimer une course depuis le fichier CSV, il convient de supprimer toutes les informations, sauf l'identifiant de la course (id_course).
Attention, contrairement à l'import export de base de données qui passent par des étapes de validation, l'import export de course par fichier CSV ne comporte aucune étape de vérification. Il est donc possible d'intégrer des données incohérentes, comme par exemple des horaires non chronologiques.
!2014-10-31_114639.png!
Saisie d'horaire dans un tableur.
L'export fournit un fichier .zip comprenant le fichier des horaires et les calendriers.
L'import en retour ne concerne que le fichier .csv proprement dit. Importer un fichier .zip identique au fichier exporté, générera une erreur.
h4. Cloner une course
Depuis la page d'une course, il est possible de cloner la course en cliquant dans le menu latéral sur _"Cloner la course"_. Une boite de dialogue s'affiche et permet de choisir les paramètres de clonage. Le clonage n'est pas une duplication à l'identique. Il ne permet pas de créer une deuxième course en tout point identique mais de créer une course ayant les mêmes paramètres, les mêmes temps de trajet inter-arrêts mais à un horaire différent comme le fait la fonction de décalage présente au-dessus des horaires de la course.
Contrairement au décalage qui modifie les horaires de la course existante, le clonage crée une nouvelle course avec des horaires différents. Le premier paramètre permet de choisir si on clone la nouvelle course en fonction de l'horaire de départ ou de l'horaire d'arrivée puis de choisir l'horaire exact de clonage.
Deux autres paramètres facultatifs permettent de répéter l'opération "en rafale" sur des bases régulières en définissant l’intervalle entre deux courses et le nombre de copies à effectuer selon cette modalité.
h3. Supprimer une course
La suppression d'une course se fait depuis la page de la course en cliquant sur _"Supprimer cette course"_ dans le menu latéral.
h3. Attributs
* Mission : La mission assurée par la course
* Numéro : numéro de la course
* Nom public : nom public pour les voyageurs
* Identifiant public : identifiant public
* Commentaire : zone de texte libre
* Mode de transport : mode de transport pour la course; par défaut, c'est le mode de transport de la ligne qui est appliqué
* Accessibilité PMR : précise si la course est équipée PMR
* Transport à la demande : précise si la course est en exploitation à la demande ou pas
* Type d'identifiant du véhicule : type d'identifiant du véhicule