Migration vers Ara SaaS

Cette page vous aide à préparer votre migration vers Ara SaaS. D'un point de vue métier, Ara est un concentrateur de données temps réel : il collecte vos sources et les rediffuse vers vos réutilisateurs. La préparation consiste à recenser les deux côtés — vos sources (entrées) et les services tiers à alimenter (sorties) — puis à prévoir vos données de référence (arrêts, lignes, courses).

Audit du fonctionnement actuel

En tant que nouvel utilisateur d'Ara SaaS, que dois-je préparer ?

Répertorier vos sources de données

Ara peut importer des données dans plusieurs formats / normes : SIRI et GTFS-RT. Recensez chaque source avec ses éléments clés :

Les colonnes Services SIRI, Mode et Type de flux ne concernent que les sources SIRI. Le type de flux distingue SIRI Lite et SIRI (SOAP) — Ara gère les deux. L'espace de code et l'accès préparent la configuration du partenaire dans Ara (remote_code_space, remote_url, identifiants).

Qualifier vos données temps réel

Les données importées doivent respecter le format de leur norme. Ara lit autant d'informations que possible mais n'est pas un validateur SIRI ou GTFS-RT. Pour détailler les erreurs éventuelles d'un fichier, utilisez des outils dédiés :

• Validateur GTFS-RT : https://transport.data.gouv.fr/validation?type=gtfs-rt

• Schémas / validation SIRI : https://bitbucket.org/enroute-mobi/siri-xsd/src/master/ (dépôt des XSD)

Organisation interne pour produire vos données

La production des données temps réel s'organise différemment selon votre structure et les acteurs impliqués. Pour chaque source, définissez :

• le responsable : qui en assure la production et la maintenance ;

• le cloisonnement : faut-il isoler cette source dans son propre référentiel Ara (plutôt que la partager avec d'autres) ? Utile quand elle relève d'une gouvernance distincte (acteurs / responsables différents), de contraintes de confidentialité, ou qu'elle peut être mise en service ou retirée indépendamment des autres.

Répertorier les services tiers à alimenter

Recensez vos besoins d'alimentation de services tiers, en précisant le format attendu. Ara peut alimenter des services tiers via GTFS-RT, SIRI ou SIRI Lite.

Cohérence entre données théoriques et temps réel

Ara travaille sur des modèles — arrêts, lignes, courses, transporteurs (voir Les modèles d'Ara). La question clé de la migration : comment ces modèles sont-ils alimentés, et restent-ils cohérents avec vos données théoriques ?

Si vous gérez vos données théoriques dans Chouette SaaS — c'est tout l'intérêt du couple Chouette + Ara : garder données théoriques et temps réel cohérentes (mêmes identifiants).

• Chouette alimente Ara : une publication de type « Ara export » (transporteurs, arrêts, lignes, courses ; choix des lignes par fournisseur, transporteur ou liste) est envoyée via une destination « Ara SaaS » — URL du référentiel Ara + jeton d'identification.

• Les identifiants des flux temps réel (SIRI / GTFS-RT) doivent correspondre aux codes théoriques : avec un couple GTFS / GTFS-RT ils coïncident généralement ; avec des flux SIRI (ou des sources NeTEx), la correspondance se gère via les espaces de code.

• 👉 Tout est détaillé dans Gestion des codes temps-réel avec Chouette et Ara.

Sans données théoriques (Ara seul) — Ara constitue ses modèles à partir des flux temps réel eux-mêmes : en SIRI via les requêtes StopPointsDiscovery / LinesDiscovery (pour les sources qui les exposent), et directement à partir du contenu des flux GTFS-RT pour les sources collectées en GTFS-RT. Aucune mise en cohérence à prévoir.

Et ensuite ?

Une fois cet audit réalisé, passez à la configuration dans Ara :

• Guides Ara — concepts et mise en place des échanges (collecte / diffusion, SIRI / GTFS-RT) ;

• Manuel Utilisateur Ara — créer et gérer vos Partenaires d'échange et vos Espaces de Code ; visualiser vos arrêts / lignes / courses.