Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
minLevel1
maxLevel7

Format des paramètres

Tous les paramètres sont des chaines de caractère, mais ils peuvent être interprétés en tant qu’entiers, tableaux, etc…

...

Une durée (duration) est une séquence de nombres décimaux potentiellement signés, chacun avec un suffixe comme “300ms”, “-1.5h” ou “2h45m”. Les unités valides sont : "ns", "us" (ou "µs"), "ms", "s", "m", "h".

Liste des paramètres

Paramètres de connexion

Ara effectuera des requêtes en utilisant OAuth si les 3 paramètres remote_authentication.oauth.client_id, remote_authentication.oauth.client_secret et remote_authentication.oauth.token_url sont définis. Le paramètre remote_authentication.oauth.scopes est a ajouter si il est requis par le client utilisant OAuth.

...

Nom

Type

Description

local_credential

string

Token permettant d'identifier les requêtes entrantes, doit être unique

local_credentials

[]string

Liste de tokens permettant d'identifier les requêtes entrantes, chacun doit être unique. S’additionne à un éventuel Token défini dans local_credential

remote_credential

string

Token permettant de s’identifier lorsqu'Ara envoie des requêtes

remote_authentication.oauth.client_id

string

Identifiant utilisé pour récupérer le Token lors d'échanges utilisant OAuth

remote_authentication.oauth.client_secret

string

Secret utilisé pour récupérer le Token lors d'échanges utilisant OAuth

remote_authentication.oauth.token_url

string

Adresse où le client http ARA peut récupérer le Token lors d'échanges utilisant OAuth

remote_authentication.oauth.scopes

[]string

Liste de scopes pour récupérer le Token lors d'échanges utilisant OAuth

local_url

srting

Adresse d’Ara envoyée dans le paramètre SIRI Address

remote_url

string

Adresse du partenaire distant

notifications.remote_url

string

Adresse à laquelle envoyer les notifications d’abonnement. En l’absence de ce paramètre, remote_url sera utilisé

subscriptions.remote_url

string

Adresse à laquelle envoyer les demandes d’abonnement. En l’absence de ce paramètre, remote_url sera utilisé

partner.status.maximum_retry

int

Nombre de fois que l’on peut effectuer un CheckStatus avec un statut Unknown avant d’effectivement passer le statut du partenaire à Unknown.

rate_limit_per_ip

int

Limiter le nombre de requêtes par minute et par adresse IP reçues par Ara pour un partenaire.

Paramètres d’identifiants

Nom

Type

Description

remote_code_space

string

Type d’identifiant utilisé par le partenaire

<connector_name>.remote_code_space

string

Type d’identifiant utilisé par un connecteur de diffusion particulier. Liste des connecteurs supportant ce paramètre :

gtfs-rt-trip-updates-broadcaster
gtfs-rt-vehicle-positions-broadcaster
siri-estimated-timetable-request-broadcaster
siri-estimated-timetable-subscription-broadcaster
siri-general-message-request-broadcaster
siri-general-message-subscription-broadcaster
siri-lines-discovery-request-broadcaster
siri-lite-vehicle-monitoring-request-broadcaster
siri-production-timetable-subscription-broadcaster
siri-stop-monitoring-request-broadcaster
siri-stop-monitoring-subscription-broadcaster
siri-stop-points-discovery-request-broadcaster

<connector_name>.vehicle_remote_code_space

string

Type d’identifiant utilisé pour les véhicules par un connecteur de diffusion particulier. Liste des connecteurs supportant ce paramètre :

gtfs-rt-vehicle-positions-broadcaster
siri-lite-vehicle-monitoring-request-broadcaster

Paramètres de format

  • génerateurs d’identitiants

...

Nom

Type

Description

generators.message_identifier

string

Generateur utilisé pour l’attribut SIRI MessageIdentifier. Ne supporte que uuid

generators.response_message_identifier

string

Generateur utilisé pour l’attribut SIRI ResponseMessageIdentifier. Ne supporte que uuid

generators.data_frame_identifier

string

Generateur utilisé pour l’attribut SIRI MessageIdentifier. Ne supporte que les attributs id et uuid. L’attribut id contiendra le modelDate d’Ara (la date sous la forme YYYY-MM-DD)

generators.reference_identifier

string

Generateur utilisé pour toutes les références à des objets SIRI que l’on réécrit ou qui ne possèdent pas d’objectid du bon type. Ne supporte que type et uuid

generators.reference_stop_area_identifier

string

Generateur utilisé pour toutes les références à des StopAreas que l’on arrive pas à retrouver dans Ara. Ne supporte que id, et uuid

generators.subscription_identifier

string

Generateur utilisé pour les identifiants d’abonnement émis par Ara. Ne supporte que uuid

siri.envelope

string

Format spécifique de l’enveloppe des messages SIRI autre que SOAP.
Valeur autorisée: raw

Paramètres de collecte

Les paramètres “collect.include_XXX” et “collect.exclude_XXX” fonctionnent de la manière suivante :

...

Nom

Type

Description

collect.priority

int

Priorité du partenaire pour la collecte. Si deux partenaires peuvent collecter le même arrêt, celui avec la plus grande priorité sera choisi

collect.include_lines

[]string

Liste d’identifiants de lignes que le partenaire doit collecter. Utilise le format d’identifiant défini dans remote_code_space

collect.exclude_lines

[]string

Liste d’identifiants de lignes que le partenaire ne doit pas collecter. Utilise le format d’identifiant défini dans remote_code_space

collect.include_stop_areas

[]string

Liste d’identifiants d’arrêts que le partenaire doit collecter. Utilise le format d’identifiant défini dans remote_code_space

collect.exclude_stop_areas

[]string

Liste d’identifiants d’arrêts que le partenaire ne doit pas collecter. Utilise le format d’identifiant défini dans remote_code_space

collect.use_discovered_stop_areas

bool

Le partenaire collectera les arrêts découverts grâce à une requête de StopPointsDiscovery en plus de ceux éventuellement définis dans les paramètres collect.include_XXX

collect.subscriptions.persistent

bool

Permet de ne pas supprimer les abonnements de collecte si le statut du partenaire devient DOWN ou UNKNOWN

OBSOLÈTE : utiliser le paramètre collect.persistent à la place

collect.persistent

bool

Permet de ne pas supprimer les abonnements et requêtes de collecte si le statut du partenaire devient DOWN ou UNKNOWN

collect.filter_general_messages

bool

Les GeneralMessageRequests seront filtrées par lignes ou arrêts

generalMessageRequest.version2.2

bool

Utilise la version 2.2 des GeneralMessageRequests SIRI, en requête et en abonnement (dans la pratique, change un namespace dans le XML)

discovery_interval

duration

Temps entre deux requêtes de StopPointsDiscovery ou LinesDiscovery

collect.gtfs.ttl

duration

Temps entre deux requêtes de GTFS-RT. Minimum de 30 secondes (valeur par défaut si le paramètre n’est pas défini)

subscriptions.maximum_resources

int

Limite le nombre maximum de ressources auxquelles on s’abonne dans 1 abonnement SIRI. Un entier négatif ou nul compte comme une absence de paramètre (aucune limite)

Paramètres de diffusion

Tous les caches de diffusion (uniquement utilisé pour le GTFS-RT pour le moment) ont un minimum de 10 secondes, et une valeur par défaut de 60 secondes.

...