20 Sprint #20 - Changelog 31 JANVIER 2019 - enRoute Blog
←
→
Transcription du contenu de la page
Si votre navigateur ne rend pas la page correctement, lisez s'il vous plaît le contenu de la page ci-dessous
Sprint #20 - Changelog
31 JANVIER 2019
20
Chouette Sprint #20 | Changelog l 2
Sommaire
Introduction 4
Europe et multimodal 4
Principales nouveautés 5
Sprint #20 du 31 janvier 2019 5
Les API de publication 5
Gestion des utilisateurs 5
Import Neptune 5
Un projet qui avance vite, notamment grâce aux boosters 5
Des correctifs liés au Centre de Support 6
Nouvelles fonctionnalités
& évolutions 7
Publication des données 7
Gérer les APIs de Publication 7
Définir une API de Publication 8
Consulter une API de Publication 9
Créer une clé autorisant l’accès à une API de Publication 10
Donner accès aux données d’un export complet dans une API de
Publication 10
Donner accès aux données d’un export par ligne dans une API de
Publication 11
Donner accès à une page d’accueil dans l’API de Publication 11
Sécuriser l’accès aux APIs de Publication 12
Transmettre une publication avec un export complet vers une
Destination de type API de Publication 12
Transmettre une publication avec un export par ligne vers une
Destination de type API de Publication 13
Publication des données après une retour sur une offre agrégée
précédente 13
Conserver les exports utilisés par une API de Publication 13
Pas de destination « Dummy » en production 14
Gestion des utilisateurs 15
Consulter les utilisateurs de l’organisation 15
Chouette Sprint #20 | Changelog l 3
Associer un profil prédéfini à un utilisateur 16
Création d’un compte administrateur à l’inscription 17
Inviter un nouvel utilisateur dans son organisation 17
Accepter une invitation pour un nouveau compte 17
Procédure de réinitialisation du mot de passe 18
Réinitialiser le mot de passe d’un utilisateur de son organisation 19
Modifier un utilisateur de son organisation 19
Bloquer et débloquer un utilisateur 20
Import Neptune 21
Lancement d’un import Neptune 21
Import des lignes, réseaux et transporteurs Neptune dans le
référentiel de lignes 21
Import des arrêts Neptune dans le référentiel d’arrêts 24
Import des calendriers Neptune au sein d’un jeu de données 26
Import des itinéraires Neptune au sein d’un jeu de données 27
Import des missions Neptune au sein d’un jeu de données 28
Import des courses Neptune au sein d’un jeu de données 29
Compléments 30
Gestion des lignes 30
Création d’un ligne « Bus » sans sous-mode de transport 30
Validation des données 31
Création d’un groupe de contrôle « Bus » sans sous-mode de
transport 31
Import / Export GTFS 31
Meilleures gestions des fuseaux horaires à l’import GTFS 31
Meilleures gestions des fuseaux horaires à l’export GTFS 31
Corrections 31
Gestion des jeux de données 32
Corrections 32
Gestion des contrôles 32
Problème de contrôles de temps entre deux arrêts 32
Chouette Sprint #20 | Changelog l 4
Introduction
Europe et multimodal
Les services d’information voyageur multimodaux et transnationaux
européens ne verront le jour qu’à la condition que des référentiels de
données harmonisés des offres soient rendus disponibles.
C’est pourquoi la Commission Européenne a lancé, à la fin de l’année
dernière un appel aux états membres visant à proposer un groupe de
support au développement et déploiement des formats standards de
publication des offres de transport public.
C’est d’ores et déjà l’association ITxPT, dont af83 est membre, qui a été
désignée comme I mplementing Body. En association avec l’UITP, elle
aura comme mission de piloter — avec 14 états membres de l’UE — le
consortium en charge de répondre aux besoins d’implémentation des
autorités publiques et/ou organisatrices de mobilité liées à la mise en
œuvre des normes Transmodel, NeTEx et SIRI.
Dans le même temps, en France, la Loi d’Orientation des Mobilités est en
lecture au Sénat. Une loi faisant office de décret et déclinaison française
de la directive ITS de l’UE citée plus haut. Si son contenu exact reste sujet
à discussions, elle laisse néanmoins augurer, en sus de l’alignement
attendu avec les directives européennes, de positions fortes sur l’open
data et l’implication des opérateurs dans la mise à jour du futur Point
d’Accès National, actuellement piloté par l’AFIMB et Etalab / betagouv.
Une actualité brûlante donc, pour les acteurs de l’harmonisation et de
l’interopérabilité des transports, et notamment Chouette !
Vous trouverez ci-après le changelog d
u sprint #20 de notre solution,
disponible en SaaS, pour cette nouvelle année du cochon de terre, une
année que nous souhaitons propice à la transformation numérique de la
mobilité !
François Marceau
Chef de Produit
Chouette Sprint #20 | Changelog l 5 Principales nouveautés Sprint #20 du 31 janvier 2019 Les API de publication Au Sprint #19, nous avions livré les publications automatiques de votre offre agrégée : vous pouvez désormais programmer des exports récurrents, qui sont systématiquement envoyés vers vos destinations préférées : Google Bucket, un serveur SFTP, et désormais des API de Publication intégrées à Chouette. Les APIs de Publication permettent à des consommateurs de données de venir chercher l’offre la plus à jour directement depuis Chouette : vous ouvrez un accès que vous contrôlez entièrement à vos exports, et vous intégrez vos clients dans votre chaîne de production de la donnée. Pour cela, il vous suffit de créer une API de Publication dans le menu Paramètrages > Publications > APIs de Publication, l’ajouter à votre Publication Automatique, puis de créer un jeton d’accès. Dès la publication programmée suivante, l’API sera accessible à l’aide de ce jeton. Gestion des utilisateurs C’est la grande nouveauté du Sprint : pour les nouvelles organisations et les organisations actuelles qui le souhaitent, nous avons intégré un système de gestion des utilisateurs. Ainsi, les administrateurs peuvent inviter des collaborateurs, modifier leurs profils ou les bloquer. Ce système vous apporte à la fois de l’agilité et de l’autonomie de la gestion de vos collaborateurs. Import Neptune Le grand retour d’un format qui a fait de la France un pionnier de l’information voyageur : nous intégrons désormais l’essentiel des champs disponibles dans le format Neptune dans Chouette. Une bonne nouvelle pour les opérateurs qui agrègent et mettent en qualité la donnée ! Un projet qui avance vite, notamment grâce aux boosters Si ce changelog est aussi riche, c'est grâce aussi au soutien apporté par nos utilisateurs et partenaires via les boosters. C’est notamment le cas de l’AFIMB qui a poussé la gestion des utilisateurs et l’import Neptune dans ce Sprint, en finançant une partie des études nécessaires à la conception de ces fonctionnalités. La Roadmap est à votre disposition : si vous avez besoin
Chouette Sprint #20 | Changelog l 6 d'une fonctionnalité dans votre process, nous pouvons étudier avec vous son intégration au planning. Des correctifs liés au Centre de Support Certaines fonctionnalités et correctifs correspondent à des questions et tickets relevés par nos utilisateurs. Si c’est le cas, une mention « Centre de Support : Ticket XXXX » est ajoutée dans la description de l’évolution. Pour plus d’informations sur le Centre de Support et les nouvelles fonctionnalités, n’hésitez pas à vous rapprocher de nos équipes.
Chouette Sprint #20 | Changelog l 7 Nouvelles fonctionnalités & évolutions Publication des données Gérer les APIs de Publication L’utilisateur membre de l’organisation propriétaire du Groupe de Travail peut consulter les APIs de publications qui sont définies au niveau du Groupe de Travail. S’il dispose des permissions requises, il pourra gérer ces APIs de Publications. Plusieurs APIs de Publication peuvent être définies au sein du Groupe de Travail. Chacune peut être la destination de plusieurs Publications de données. Cette souplesse permet de diffuser l’offre du Groupe de Travail sous plusieurs formats, plusieurs modalités (durée de l’offre, etc) en gérant des accès aux niveaux de chaque API. L’utilisateur peut consulter les APIs de Publication actuellement définies. La roue dentée de chaque ligne permet de consulter, éditer ou supprimer (après confirmation) l’API de Publication. La gestion des publications est accessible via le menu "Paramétrages > Publications > APIs de Publication".
Chouette Sprint #20 | Changelog l 8
Définir une API de Publication
L’utilisateur autorisé et membre de l’organisation propriétaire du
Groupe de Travail peut créer et modifier une API de Publications.
Dans Paramétrages > Publications > APIs de Publication, l’utilisateur
peut créer une API de Publication.
L’utilisateur peut définir
● un nom, qui sera présent dans Chouette, et en externe.
● un nom court (ou nicename), correspond au nom utilisé dans l’URL
de l’API. Le nom court « acmee » produira, par exemple, des URLs
comme /api/v1/datas/acmee.gtfs.zip.
L’URL publique se met à jour en fonction du nom court, au fur et à mesure
que l’utilisateur remplit ce champ.
En cliquant sur “Valider”, Chouette crée une API de Publication, et
l’utilisateur arrive sur la page de consultation de cette API.Chouette Sprint #20 | Changelog l 9
Consulter une API de Publication
L’utilisateur membre de l’organisation propriétaire du Groupe de Travail
peut consulter le paramétrage d’une API de Publication.
Les détails d’une API de Publication intègrent :
● les informations, avec :
○ le nom
○ le nom court
○ l’URL publique
○ les dates de création et de dernière modification
● les publications associées, avec, pour chacune :
○ le nom avec un lien vers le dernier rapport de publication (qui
a alimenté cette API),
○ le type d’export
● les clefs d’accès, avec, pour chacune :
○ le nom
○ le token, ou jeton d’accès
○ les dates de création et de dernière modification
L’utilisateur avec les permissions requises peut modifier, ou supprimer
chaque clef d’accès. Il peut également en créer une.
Les clés d’accès peuvent être confiées à des tiers pour leur donner un accès
à toutes les données publiées par l’API. Dès qu’une clé est supprimée,Chouette Sprint #20 | Changelog l 10
l’accès n’est plus possible. L’utilisateur peut ainsi confier des clés différentes
à chaque tiers et gérer finement les droits d’accès et leur révocation.
Par défaut, quand l’API vient d’être créée, il n’y a pas encore de clé d’accès. Il
n’y a donc pas de tableau, mais un texte d’aide : « Cette API ne dispose pas
encore de clé d’accès. »
Créer une clé autorisant l’accès à une API de Publication
L’utilisateur autorisé peut créer une clé d’accès d’API de Publication depuis
les détails d’une API de Publication. Il peut définir un nom à la clé d’accès.
Le token ou jeton d’accès est généré automatiquement par Chouette.
Donner accès aux données d’un export complet dans une API de
Publication
Pour chaque Publication utilisant un export complet et ayant comme
destination une API de Publication, celle-ci met à disposition le fichier
exporté sur une URL de la forme :
/
api/v1/datas/..zip
Par exemple, pour une API avec le nom court « test », on pourra accéder aux
données via les URLs :
● /api/v1/datas/test.netex-idfm.zip
● /api/v1/datas/test.netex-full.zip
● /api/v1/datas/test.gtfs.zip
Lorsqu’une Publication met à disposition des données, les données
accessibles via l’API sont mises à jour, mais l’URL reste inchangée.Chouette Sprint #20 | Changelog l 11
Donner accès aux données d’un export par ligne dans une API de
Publication
L’utilisateur peut avoir recours à une Publication utilisant un export par
ligne. Cette fonctionnalité lui permet de segmenter la publication de son
offre par lignes.
Pour chaque Publication utilisant un export par lignes et ayant comme
destination une API de Publication, celle-ci met à disposition un fichier
exporté pour chaque ligne sur une URL de la forme :
/
api/v1/datas//lines/..zip
Par exemple, pour une API avec le nom court « test » et les lignes C00168_8
et C00163_1, on pourra accéder aux données via les URLs :
● /api/v1/datas/test/lines/C00168_8.netex-idfm.zip (ligne C00168_8)
● /api/v1/datas/test/lines/C00163_1.netex-idfm.zip (ligne C00163_1)
● /api/v1/datas/test/lines/C00168_8.gtfs.zip (ligne C00168_8)
● /api/v1/datas/test/lines/C00163_1.gtfs.zip (ligne C00163_1)
Lorsqu’une Publication met à disposition des données, les données
accessibles via l’API sont mises à jour, mais l’URL reste inchangée (pour une
ligne disposant du même code que précédemment).
Donner accès à une page d’accueil dans l’API de Publication
L’utilisateur qui consulte l’adresse de base d’une API de Publication
/api/v1/datas/avec son navigateur, a accès à une page
d’accueil donnant quelques indications sur l’utilisation de l’API pour accéder
aux données :
● la nécessité de disposer d’une clé d’accès (et de contacter le
“propriétaire” de l’API pour cela)
● les ressources disponibles :
○ pour les imports complets, l’URL de download
○ pour les imports par ligne, l’URL des métadonnées
● les détails techniques pour inclure la clé d’accès quand la requête à
l’APIChouette Sprint #20 | Changelog l 12
Sécuriser l’accès aux APIs de Publication
Les URLs des APIs de Publication ne sont accessibles que si la requête de
consultation utilise l’une des clés associées à l’API de Publication. Le token
de clé doit être inclus dans une entête HTTP de la forme ‘Authorization:
Token token=’.
Par exemple, si le token de clé est 5fa1f901a833aaec78, la requête doit
inclure une entête HTTP :
Authorization: Token token=5fa1f901a833aaec78
Si l'authentification est absente ou échoue, le message de retour (en
anglais) intègre un lien vers la page d’accueil de l’API :
Authorization token is
missing
. Please visit
https://.../api/v1/datas/
Authorization token is
incorrect
. Please visit
https://.../api/v1/datas/
Transmettre une publication avec un export complet vers une
Destination de type API de Publication
Une Publication de données intégrant un export complet peut inclure une
(ou plusieurs) Destination(s) de type API de Publication.Chouette Sprint #20 | Changelog l 13
A chaque Publication, l’API de Publication est informée que les données qui
doivent être transmises pour le format de la publication (le format choisi
pour l’export) sont maintenant les données exportées par cette Publication.
Une même API peut être alimentée par plusieurs Publications en export
complet. La contrainte (actuelle) est que chaque Publication doit utiliser un
format d’export différent.
Transmettre une publication avec un export par ligne vers une
Destination de type API de Publication
Une Publication de données intégrant un export par ligne peut inclure une
(ou plusieurs) Destination(s) de type API de Publication.
A chaque Publication, l’API de Publication est informée que les données qui
doivent être transmises pour la ligne et le format de la publication (le
format choisi pour l’export) sont maintenant les données exportées par
cette Publication.
La Publication transmet pour chaque ligne :
● le code public qui doit être utilisée par l’API pour publier les données
de la ligne. Il s’agit du numéro d’enregistrement (registration
number) de la ligne, ou par défaut, de son identifiant métier
(objectid)
● l’export associé
Dans plusieurs cas, l’API ne met pas/plus de données à disposition pour une
ligne :
● si la ligne n’est plus présente dans l’offre publiée,
● si l’export associé n’est pas en succès,
● si l’export est vide (pas de donnée pour la période de l’export)
Une même API peut être alimentée par plusieurs Publications en export par
ligne. La contrainte (actuelle) est que chaque Publication doit utiliser un
format d’export différent.
Publication des données après une retour sur une offre agrégée
précédente
Lorsqu’un utilisateur demande un retour en arrière sur l’offre agrégée de
son Groupe de Travail, l’ensemble des publications du Groupe de Travail
sont sollicitées avec l’offre agrégée sélectionnée par.
Conserver les exports utilisés par une API de Publication
Lorsqu’un export est associé à une API de Publication :Chouette Sprint #20 | Changelog l 14
● l’export ne peut pas être supprimé par un utilisateur
● les mécanismes de purge (du fichier de l’export ou de l’export
lui-même) ne s’applique pas
Pas de destination « Dummy » en production
L’utilisateur en production n’a pas à sa disposition la destination du type
« Dummy » (réservée aux tests des publications de données).
Gestion des utilisateurs
Suite aux nombreuses évolutions comme l’intégration de permissions pour
régir l’ensemble des accès aux ressources de l’application ou le support de
fonctionnalités optionnelles, l’ancienne administration des utilisateurs est
désactivée dans Chouette.
Cette nouvelle Gestion des utilisateurs remet en place au fur et à mesure les
fonctionnalités telles que :
● la modification des utilisateurs,
● l’invitation ou le blocage d’autres utilisateurs.
Pour l’instant, la gestion des permissions ne se fait que via des profils
prédéfinis par Chouette.
Consulter les utilisateurs de l’organisation
L’utilisateur peut consulter les utilisateurs de son organisation. Pour chaque
utilisateur, son nom complet, son email, son profil et l’état de son compte
sont affichés.Chouette Sprint #20 | Changelog l 15 Les utilisateurs peuvent être filtrés selon : ● leur nom complet ● leur profil ● l’état de leur compte Pour chaque utilisateur, une roue dentée de chaque ligne permet de lancer les actions disponibles sur cet utilisateur (consulter, éditer, supprimer, etc). Pour chaque utilisateur, il est possible de consulter les détails du compte.
Chouette Sprint #20 | Changelog l 16
Les informations disponibles sont :
● l’email de l’utilisateur
● son profil
● l’état du compte
● la date de la dernière connexion à Chouette
● si le compte est bloqué, la date de mise en place du blocage
● la date de création et de mise à jour du compte
Associer un profil prédéfini à un utilisateur
Chaque utilisateur dispose d’une ensemble de permissions qui régissent les
actions possibles ou non au sein de Chouette.
L’utilisateur autorisé peut agir sur les permissions des autres utilisateurs de
son organisation en choisissant parmi 3 profils prédéfinis :
● Administrateur : incluant toutes les permissions, en particulier
l’édition des informations et permissions des utilisateurs de
l’organisation
● Editeur : incluant toutes les permissions standards pour gérer l’offre
de transport au sein de Chouette
● Visiteur : permettant la consultation de l’application, sans édition
possible des donnéesChouette Sprint #20 | Changelog l 17
Quand l’utilisateur ne dispose pas de permissions relevant d’un profil
prédéfini, le Profil affiché est « Sur Mesure ». Dans ce cas, il n’est pas
possible de modifier le Profil de l’utilisateur.
L’utilisateur doit disposer de la permission users.update pour modifier le
profil des autres utilisateurs de son organisation.
Création d’un compte administrateur à l’inscription
A l’inscription, le premier utilisateur de l’organisation dispose du profil
prédéfini Administrateur.
Inviter un nouvel utilisateur dans son organisation
L’utilisateur autorisé peut inviter une nouvel utilisateur dans son
organisation en indiquant :
● le nom complet de l’utilisateur
● son email
● son profil
Le mot de passe n’est pas défini à cette étape. L’utilisateur invité reçoit une
invitation par email. Pour le compte utilisateur nouvellement créé, l’état est
« Invité ». Tant que le compte est dans l’état « Invité », un utilisateur autorisé
peut renvoyer une invitation à l’utilisateur invité. Le compte ne peut être
utilisé tant que l’invitation n’est pas acceptée. Une fois activé, son compte
passe en « Confirmé ».
L’utilisateur doit disposer de la permission users.create pour inviter un autre
utilisateur dans son organisation.
Accepter une invitation pour un nouveau compte
L’utilisateur invité reçoit un email incluant un lien lui permettant de finaliser
la création de son compte sur Chouette.
L’email d’invitation est défini comme suit :
Sujet : Confirmation de compte sur Chouette ITS
Bonjour,
Vous avez été invité(e) dans l’organisation (nom) de Chouette ITS par
(nom de l’utilisateur invitant).
Activer votre compte (Chouette Sprint #20 | Changelog l 18
Procédure de réinitialisation du mot de passe
L’utilisateur peut, quand il n’est pas connecté sur l’application, initier une
réinitialisation de son mot de passe. Il doit indiquer l’email associé à son
compte Chouette. Si l’email indiqué n’est pas trouvé, l’utilisateur en est
informé.
Un utilisateur autorisé peut initier pour un autre utilisateur de son
organisation cette même procédure. Dans les deux cas, l’utilisateur dont le
mot de passe doit être réinitialisé reçoit l’email suivant :
Sujet : Réinitialiser votre mot de passe
Bonjour,
Vous pouvez choisir une nouveau mot de passe pour accéder à votre
compte sur Chouette ITS :
Réinitialiser mon mot de passe (Chouette Sprint #20 | Changelog l 19
l’action est sélectionnée, une demande de confirmation doit être validée
par l’utilisateur.
Voulez vous envoyer un lien de réinitialisation de mot de passe à cet
utilisateur ?
Oui | Non
Ensuite, la procédure est la même que si l’utilisateur demande lui même
une réinitialisation de son mot de passe. L’utilisateur doit disposer de la
permission users.update pour lancer la procédure de réinitialisation.
Modifier un utilisateur de son organisation
L’utilisateur autorisé peut modifier les autres utilisateurs de son
organisation.
Les informations suivantes peuvent être modifiées :
● Le nom complet de l’utilisateur
● Le profil (s’il est modifiable)
L’email ne peut pas être modifié. L’utilisateur doit disposer de la permission
users.update pour modifier un autre utilisateur.
Bloquer et débloquer un utilisateur
L’utilisateur autorisé peut bloquer le compte d’un autre utilisateur de son
organisation. L’utilisateur bloqué apparaît toujours dans les listes des
utilisateurs de l’organisation mais avec un statut « Bloqué ». Un utilisateur
bloqué ne peut plus accéder aux interfaces de Chouette. S’il tente de se
connecter alors que son compte a été désactivé, l’interface lui renvoie le
message suivant :Chouette Sprint #20 | Changelog l 20
Votre compte a été désactivé. Merci de contacter les administrateurs de
votre organisation pour plus d’informations.
L’utilisateur autorisé peut débloquer un compte bloqué. Lorsque l’action est
sélectionnée, une demande de confirmation doit être validée :
Voulez-vous (dé)bloquer cet utilisateur ? Ce dernier ne pourra plus se
connecter à la plateforme
Oui | Non
Lors du blocage, si l’utilisateur est connecté à la plateforme, il sera
automatiquement déconnecté. L’utilisateur doit disposer de la permission
users.update pour (dé)bloquer un autre utilisateur.
Import Neptune
L’import Neptune prend en charge les fichiers respectant le profil
d’échange NEPTUNE tel que défini dans la mise à jour de septembre 2014.
Lancement d’un import Neptune
L’utilisateur autorisé peut lancer l’import d’un “fichier Neptune”. 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
Un “fichier Neptune” est un fichier ZIP contenant des fichiers XML au format
NEPTUNE. Chouette traite l’ensemble de fichiers XML présents dans la
racine du fichier ZIP soumis par l’utilisateur.
Import des lignes, réseaux et transporteurs Neptune dans le
référentiel de lignes
Pour chaque balise ChouettePTNetwork / ChouetteLineDescription / Line,
les attributs suivant sont pris en compte pour créer ou mettre à jour une
Ligne du référential de lignes du Groupe de Travail :Chouette Sprint #20 | Changelog l 21
Attribut Chouette content Technical reference
objectId Line registration number Line#registration_num
ber
objectVersion ignored
name Line name Line#name
number Line number Line#number
publishedName Line published name Line#published_name
transportModeName Line transport mode and Cf transport mode
sub mode mapping
lineEnd ignored
registration / ignored
registrationNumber
ptNetworkIdShortcut ignored
comment Line comments Line#comment
stableId ignored
mobilityRestrictedSuita ignored
bility
accessibilitySuitabilityD ignored
etails
Pour chaque balise ChouettePTNetwork / PTNetwork, les attributs suivant
sont pris en compte pour créer ou mettre à jour un Réseau du référentiel de
lignes du Groupe de Travail :
Attribut Chouette content Technical reference
objectId Network registration Network#registration_numbe
number r
objectVersion ignored
versionDate ignored
name Network name Network#name
registration / ignored
registrationNumb
er
sourceName ignoredChouette Sprint #20 | Changelog l 22
sourceIdentifier ignored
comment Network comments Network#comment
Les informations du GroupOfLine sont ignorées. Pour chaque balise
ChouettePTNetwork / Company, les attributs suivant sont pris en compte
pour créer ou mettre à jour un Transporteur du référentiel de lignes du
Groupe de Travail :
Attribut Chouette content Technical reference
objectId Company registration Company#registration_nu
number mber
objectVersion ignored
name Company name #name
shortName Company short name #short_name
organisationalUnit Company Unit #organizational_unit
operatingDepartment Company Department #operating_department_n
Name ame
code Company Code #code
phone Company Phone #phone
fax Company Fax #fax
email Company Email #email
registration / ignored
registrationNumber
Les transportModeNames Neptune sont associés à un mode et sous-mode
de transport dans Chouette selon ces correspondances :
TransportModeName Transport Mode and sub-mode
Air ignored
Train rail / regionalRail
LongDistanceTrain rail / interregionalRail
LocalTrain rail / suburbanRailway
RapidTransit rail / railShuttle
Metro metroChouette Sprint #20 | Changelog l 23
Tramway tram
Coach bus
Bus bus / non défini
Ferry ignored
Waterborne ignored
PrivateVehicle ignored
Walk ignored
Trolleybus tram
Bicycle ignored
Shuttle bus / airportLinkBus
Taxi ignored
VAL rail / railShuttle
Other ignored
Le mode de transport est toutefois modifiable a posteriori dans le référentiel
de lignes.
L’identification des lignes, transporteurs et réseau est réalisé/conservé via
au numéro d’enregistrement. Chouette ne permettant plus à l’utilisateur de
personnaliser les objectids des objets, l’import ne peut stocker la valeur
apportée par le fichier dans l’objectid. Cette valeur de l‘objectid Neptune
des lignes, transporteurs et réseau est donc conservée dans le numéro
d’enregistrement.
Si un 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.
Import des arrêts Neptune dans le référentiel d’arrêts
Pour chaque balise ChouettePTNetwork / ChouetteArea / StopArea, les
attributs suivant sont pris en compte pour créer ou mettre à jour un arrêt
du référentiel d’arrêt du Groupe de Travail :
Attribut Chouette content Technical reference
objectId StopArea registration StopArea#registration_num
number berChouette Sprint #20 | Changelog l 24
objectVersion ignored
name StopArea name StopArea#name
contains Referenced StopArea Cf parent management
parent
boundaryPoint ignored
comment StopArea Description #comment
ChouettePTNetwork/ChouetteArea/AreaCentroid referenced by centroidOfArea
objectid ignored
objectVersion ignored
name ignored
comment ignored
latitude StopArea latitude in Converted in WGS84
WGS84
longitude StopArea longitude in Converted in WGS84
WGS84
address / StopArea street name
streetName
address / ignored
countryCode
projectedPoint ignored
containedIn ignored
StopAreaExtension attributes
areaType StopArea type Cf area type mapping
nearestTopicName ackStopArea Nearest #nearest_topic_name
point of interest disponible en Sprint #21
fareCode StopArea fare code #fare_code (integer)
disponible en Sprint #21
registration ignored
mobilityRestricted ignored
Suitability
accessibilitySuitabil ignored
ityDetailsChouette Sprint #20 | Changelog l 25
stairsAvailability ignored
liftAvailability ignored
Le type d’arrêt renseigné par StopAreaExtension / areaType est interprété
comme suit :
Neptune StopArea Chouette StopArea
BoardingPosition
Quay (Zone d’Embarquement)
Quay
CommercialStopPoint Monomodal Stop Place (Zone de Lieu)
StopPlace Stop Place (Lieu d’Arrêt)
L’identification des arrêts est réalisé / conservé via au numéro
d’enregistrement. Chouette ne permettant plus à l’utilisateur de
personnaliser les objectids des objets, l’import ne peut stocker la valeur
apportée par le fichier dans l’objectid. Cette valeur de l‘objectid Neptune
des arrêts est donc conservée dans le numéro d’enregistrement.
Si un arrêt est défini plusieurs fois dans les données importées, c’est la
dernière version lue par Chouette qui est prise en compte.
Le parent des arrêts est défini selon les identifiants renseignés dans
StopArea / contains. Les correspondances (ConnectionLink) sont ignorées.
Les accès (PTAccessPoint) et les liens accès-zone d’arrêt (AccessLink) sont
ignorés. Les équipements (ChouetteFacilityType) sont ignorés.
Import des calendriers Neptune au sein d’un jeu de données
Pour chaque balise ChouettePTNetwork / TimeTable, les attributs suivant
sont pris en compte pour créer un calendrier d’application dans le jeu de
données :
Attribute Chouette content Technical reference
objectId ignored Only used during import
objectVersion ignored
creationTime TimeTable creation time TimeTable#created_at
creatorId TimeTable creator name #metadata.creator_userna
meChouette Sprint #20 | Changelog l 26
comment TimeTable name #comment, use objectid if
undefined
version ignored
period / a TimeTable Period for TimeTable::Period
startOfPeriod each tag
period /
endOfPeriod
calendarDay a TimeTable Date TimeTable::Date included:
“included” for each tag true
dayType TimeTable Period day See below possible values
types
Les valeurs possibles pour les jours d’application des périodes sont :
● WeekDay (lundi à vendredi)
● WeekEnd (samedi et dimanche)
● Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
Les valeurs ScoolHolliday (congé scolaire), PublicHolliday (jour férié) et
MarketDay ne sont pas supportés.
Si une balise TimeTable utilise le même objectid qu’une TimeTable déjà
présente dans le même import, le calendrier déjà défini dans le jeu de
données est complété, selon ces règles :
● les périodes sont ajoutées au calendrier existant sauf si elles existent
déjà avec les mêmes bornes
● les dates incluses sont ajoutées au calendrier existant sauf si elles
existent déjà
● des jours d’application différents ne sont pas supportés
Les périodes de définition de fréquences de passages (TimeSlot) ne sont pas
supportés.
Import des itinéraires Neptune au sein d’un jeu de données
Pour chaque balise ChouettePTNetwork / ChouetteLineDescription /
ChouetteRoute, les attributs suivant sont pris en compte pour créer un
itinéraire dans le jeu de données :
Attribute Chouette content Technical reference
objectId ignored Only used during import
objectVersion ignored
creationTime Route creation time Route#created_atChouette Sprint #20 | Changelog l 27
creatorId Route creator name #metadata.creator_userna
me
name Route name #name
publishedName Route published #published_name
name
wayBackRouteId Route reversed route #opposite_route
direction ignored
comment ignored
RouteExtension/wayBa Route Direction Route#wayback
ck
Values are case insensitive
- “A”, “aller” : outbound
- “R”, “retour” : inbound
La liste des arrêts de l’itinéraire est déterminée par la liste des PtLinks
associés à la balise ChouetteRoute. L’arrêt associé est identifié par l’attribut
StopPoint / containedIn.
Les autres attributs des balises StopPoints sont ignorés.
Import des missions Neptune au sein d’un jeu de données
Pour chaque balise ChouettePTNetwork / ChouetteLineDescription /
JourneyPattern, les attributs suivant sont pris en compte pour créer un
itinéraire dans le jeu de données :
Attribute Chouette content Technical reference
objectId ignored Only used during import
objectVersion ignored
creationTime JourneyPattern creation JourneyPattern#created
time _at
creatorId JourneyPattern creator #metadata.creator_user
name name
name JourneyPattern name #name
publishedName JourneyPattern published #published_name
name
routeId JourneyPattern route #routeChouette Sprint #20 | Changelog l 28
origin ignored -
destination ignored -
registration / JourneyPattern #registration_number
registrationNumber registration number
lineIdShortcut ignored
comment ignored
La liste des arrêts de la mission est déterminée la liste de stopPointList
associés à la balise JourneyPattern.
Import des courses Neptune au sein d’un jeu de données
Pour chaque balise ChouettePTNetwork / ChouetteLineDescription /
VehicleJourney, les attributs suivant sont pris en compte pour créer une
course dans le jeu de données :
Attribute Chouette content Technical reference
objectId ignored Only used during import
objectVersion ignored -
creationTime VehicleJourney creation JourneyPattern#created
time _at
creatorId VehicleJourney creator #metadata.creator_user
name name
name VehicleJourney name #name
routeId VehicleJourney journey If journeyPatternId is
journeyPatternId pattern undefined, first (uniq)
JourneyPattern of the
Route
publishedJourneyNam VehicleJourney Name #published_journey_na
e me
publishedJourneyIden VehicleJourney Published #published_journey_ide
tifier Identifier ntifier
transportMode VehicleJourney transport Same mapping than
mode and sub-mode lines
vehicleTypeIdentifier ignored
lineIdShortcut ignoredChouette Sprint #20 | Changelog l 29
routeIdShortcut ignored
operatorId VehicleJourney Company find Company by
registration number
facility ignored
number ignored
comment ignored
timeSlotId ignored
For each vehicleJourneyAtStop tag
stopPointId VehiculeJourneyAtStop
stop area
vehicleJourneyId ignored only used during import
connectingServiceId ignored
arrivalTime VehiculeJourneyAtStop VehiculeJourneyAtStop
arrival time #arrival_time
departureTime VehiculeJourneyAtStop VehiculeJourneyAtStop
departure time #departure_time
elapseDuration ignored
headwayFrequency ignored
boardingAlightingPos ignored
sibility
order ignored
Les courses du jeu de données sont associés aux calendriers d’application
dont la balise Timetable / vehicleJourneyId référence la course.
Les périodes de définition de fréquences de passages (TimeSlot) ne sont pas
supportées.
Dans les horaires (VehicleJourneyAtStopType), les attributes
elapseDuration, headwayFrequency ne sont pas supportés.Chouette Sprint #20 | Changelog l 30
Compléments
Gestion des lignes
Création d’un ligne « Bus » sans sous-mode de transport
L’utilisateur peut créer une ligne au mode de transport « Bus » sans préciser
un sous-mode de transport (sous-mode « Non défini »).
Validation des données
Création d’un groupe de contrôle « Bus » sans sous-mode de
transport
L’utilisateur peut créer une groupe de contrôle portant sur le mode de
transport des lignes en choisissant le mode de transport “Bus” sans préciser
un sous-mode de transport (sous-mode « Non défini »).
Import / Export GTFS
Meilleures gestions des fuseaux horaires à l’import GTFS
A l’import, Chouette respecte les spécifications du format GTFS :
● les arrêts importés prennent le fuseau horaire spécifié dans stops.txt
● si l'arrêt a un parent, il prend son fuseau horaire
● sinon l’arrêt prend le fuseau horaire de l’agency.txt
Meilleures gestions des fuseaux horaires à l’export GTFS
Quand Chouette exporte les horaires d'une ligne, trois configurations sont
possibles :
1. la course (ou sa ligne) est associée à un transporteur dont le fuseau
horaire est renseigné. Dans ce cas, tous les horaires de passage sont
exprimés dans ce fuseau horaire au moment de l'export.
2. la course (ou sa ligne) est associée à un transporteur qui n'a pas de
fuseau horaire. Dans ce cas, c'est le fuseau +00:00 GMT qui est utilisé.
Le fuseau "Etc/GMT" est renseigné automatiquement dans le champ
agency_timezone du transporteur. Un warning est ajouté à l'export
pour signaler ce comportement par défaut.
3. la course (ou sa ligne) n'est pas associée à un transporteur. Dans ce
cas, l'export GTFS créé une agency "default", avec l'idChouette Sprint #20 | Changelog l 31
"chouette_default", le name "Default Agency" et aucune URL. Un
warning est ajouté à l'export pour signaler ce comportement par
défaut.
Corrections
● Support à l'import GTFS d'un calendrier portant sur une seule journée
Gestion des jeux de données
Corrections
● Problème de filtrage des lignes (Centre de Support : Ticket 792174)
Gestion des contrôles
Problème de contrôles de temps entre deux arrêts
L’utilisateur peut choisir une criticité warning ou error lorsqu’il crée un
contrôle de distance ou de temps sur les missions.
Centre de Support : Ticket 628915Vous pouvez aussi lire
