---
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

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

Dans le tableau des courses, le lien en en-tête de colonne permet de sélectionner un 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 de la séquence d'arrêt courante.

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! Edition des horaires dans CHOUETTE

h4. Ajouter une course par import .csv

L'import d'une ou plusieurs courses par un fichier .csv permet d'ajouter des courses éditées dans un tableur. La forme du tableau étant très spécifique, il convient de récupérer le modèle en cliquant sur _"Export des horaires aux arrêts"_ puis de compléter les horaires dans le tableur. Le séparateur retenu pour le fichier .csv est le point-virgule. L'export fournit un fichier .zip comprenant le fichier des horaires et les calendrier.

!2014-10-31_114422.png! Import des horaires au format .csv

Les données horaires peuvent être rajoutées dans le fichier .csv, en revanche, il convient de laisser le champ _"id course"- vide. CHOUETTE se chargera de lui attribuer un numéro valide lors de l'import. 

L'import du fichier .csv ne concerne que le fichier .csv proprement dit. Importer un fichier .zip identique au fichier exporté, génèrera une erreur. 

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. CHOUETTE génèrera un numéro valide à l'import. Saisir un numéro fera échouer l'import.

!2014-10-31_114639.png! Saisie d'horaire dans un tableur. 

L'export fournit un fichier .zip comprenant le fichier des horaires et les calendrier.

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
* État de trafic : état de trafic [?]
* Équipement : équipement [?]
* Type d'identifiant du véhicule : type d'identifiant du véhicule


