Import et association automatique des documents
Dans Chouette, vous avez la possibilité d’importer des documents et de les relier manuellement ou automatiquement à un objet de l’offre de transport :
Arrêts
Lignes
Transporteurs
Ce guide explique pas à pas comment un utilisateur peut importer des documents et les relier un objet automatiquement ou manuellement.
Pour importer un document associé à un objet, vous devez disposer de :
Types de documents : Assurez-vous que le type de document existe dans Chouette et récupérez son nom court (par exemple 'fiche_horaire').
Formats de fichier autorisés : pdf, kml, jpg, jpeg, png.
Utilisation de Chouette client pour importer les documents avec des codes
Prérequis
Vous devez récupérer l’identifiant de la ligne par exemple dans le GTFS (route_id dans le fichier routes.txt) :
route_id,agency_id,route_short_name,route_long_name,route_desc,route_type,route_url,route_color,route_text_color
AB,DTA,10,Airport - Bullfrog,,3,,,
BFC,DTA,20,Bullfrog - Furnace Creek Resort,,3,,,
STBA,DTA,30,Stagecoach - Airport Shuttle,,3,,,
CITY,DTA,40,City,,3,,,
AAMV,DTA,50,Airport - Amargosa Valley,,3,,,
Utilisation de l’API Chouette
Afin d’importer les documents, nous avons besoin de générer la clé d’API de Chouette. La clé API doit être générée et récupérée dans la partie “Paramétrages” de votre espace de travail. Il faut cliquer sur le bouton “Ajouter une clé d’accès API”.
Donnez un nom à la clé d’accès API et le token sera généré automatiquement par Chouette.
Notez l’identifiant de l’espace de travail 11 et le token pour une utilisation par la suite
Import
enRoute met à disposition un client Chouette opensource vous permettant d’importer les documents.
Une description de son utilisation est disponible sur le repository bitbucket : https://bitbucket.org/enroute-mobi/chouette-client/src/master/. Vous trouverez dans les sources la mise à disposition d’exécutables pour tous les OS.
Vous pouvez utiliser la ligne de commande suivante avec :
workbench : identifiant de l’espace de travail (11)
name : nom du fichier
document-type : nom court du type de document (fiche_horaire)
code : espace de code et identifiant de la ligne (external:CITY)
Cet espace de code sera utilisé par la suite pour l’association automatique des documents aux arrêts/lignes
# Create a single Document with a code
CHOUETTE_TOKEN=secret chouette-client create document --workbench=11 --name=Test --document-type=fiche_horaire --code=external:AB /path/to/document
Utilisation de Chouette pour importer manuellement les documents avec des codes
Si vous créez un document manuellement, il faut renseigner un code dans un espace de code dédié.
Dans l’exemple ci-dessous, nous créons un document avec un code égal au numéro d’enregistrement de la ligne à laquelle il doit être associé (“CITY”) dans l’espace de code “external” :
Association automatique d’un document et d'un objet
L’objectif est de relier un objet et un document ayant le même code et ce quel que soit l’espace de code associé.
Génération d’un code pour les arrêts ou les lignes
À l’aide d’un jeu d’instruction Créer un code, vous pouvez générer pour les lignes les un code égal à leur numéro d’enregistrement sur un espace de code “external” :
Une fois ce jeu d’instruction exécuté, le code “CITY” est généré sur la ligne City :
Association automatique
Une fois que les codes sont en place sur le document et la ligne/arrêt, vous pouvez associer les objets. Pour cela, il faut créer et exécuter le jeu d’instruction Associer un document en sélectionnant le modèle cible (arrêt ou ligne) et un espace de code cible (“external”) pour les documents et les lignes :
À l’exécution de ce jeu d’instruction, le document et la ligne ayant le même code seront automatiquement associés.
Et vous pourrez voir sur la fiche de la ligne le document venant d'être associé :