Manuel Chouette ligne de commande
Contents
1. CHOUETTE Maintenance accompagnement et recette de logiciels pour les changes de donn es multimodales Manuel utilisateur de l application CHOUETTE en ligne de commandes CHOUETTE V2 3 Janvier 2013 Centre d tudes sur les r seaux les transports l urbanisme et les constructions publiques Informations sur ce document Organisme commanditaire AFIMB Titre Manuel utilisateur de l application CHOUETTE en mode lignes de commande Organismes auteurs R dacteurs Participants CITYWAY Marc FLORISSON Patrick GENDRE MOBIGIS Zakaria BOUZIANE Marc FLORISSON CETE Med Michel ETIENNE Zakaria BOUZIANE Luc DONNET Michel ETIENNE Patrick H rard Luc DONNET Maitre d ouvrage Cyril BLOUDEAU Yannick DENIS DGITM AFIMB Olivier LEMETTAIS Fr d ric SCHETTINI Hugo CHAUVIN Laurent DEZOU J r mie GASTON RAOUL Jean Dominique LECA R sum CHOUETTE est un logiciel libre d velopp l initiative du minist re fran ais charg des transports et du d veloppement durable dans le but de faciliter l change de donn es d offre th orique de transport col lectif TC en s appuyant pour cela sur la norme NFP 99506 dite Neptune qui sp cifie un profil d change XML Les utilisateurs vis s sont les collectivit s locales Autorit s Organisatrices de Transport AOT les exploi tants des r seaux TC et leurs prestataires bureaux d tude ou soci t de services D autres utilisateurs potentiels sont n anmoins identifi s s2. Manuel utilisateur de l application CHOUETTE V2 3 en passage en anglais info fournit la liste des attributs d un objet e help fourni l aide sur la liste des commandes disponibles ou le d tail sur une com mande pr cis e options cmd commandName aide d taill e sur la commande include ins re le contenu d un autre fichier script dans le fichier en cours de charge ment options file filename chemin du fichier script inclure chemin absolu ou relatif l emplacement du fichier contenant l instruction include e exec ex cute les commandes d un fichier depuis le mode interactif options file filename chemin du fichier script ex cuter 1 6 Exemples 1 commandes pass es par argument import Neptune sauvegarde en base chouette sh c import o line format NEPTUNE inputFile reseau zip validate c save propagate sh est n cessaire sous linux import Neptune validation chouette sh noDao c import o line format NEPTUNE input File reseau zip validate c validate f report txt export Neptune chouette sh c get o line filter ptnetwork objectId eq NINOXE GroupOfLine tatrobus c export format NEPTUNE out putFile tatrobus zip 2 commandes crites dans un script script de cr ation d objet cr ation d une nouvelle instance de r seau new o ptnetwork valorisation des attributs set attr objectId NINOXE GroupOfLine Test set attr ob
3. cl primaire de la base objectId value filtre sur une liste d identifiants m tier ObjectId filter filterargs filtre sur une requ te sur attribut filterargs attribute operator value attribute nom de l attribut peut tre l attribut d un sous objet ou d une sous structure comme par exemple ptnet work objectId sur un objet de type Line operator null eq like value si n cessaire valeur de comparaison e save sauve les objets en m moire dans la base options propagate propage la sauvegarde aux objets li s 1ssus d un import par exemple e delete supprime les objets en m moire de la base ainsi que les objets en d pendance structurelles la liste des objets supprim s en cascade est d finie dans le document d architecture options propagate supprime aussi les objets li s mais pouvant avoir une existence ind pendante exemple lors d une suppression de ligne suppression des arr ts du r f ren tiel qui ne sont pas partag s avec une autre ligne la liste des objets suppri m s par propagation est d finie dans le document d architecture 1 5 4 Autres commandes quit ou exit arr te le script ou le mode interactif verbose active ou d sactive le mode verbeux options on par d faut active le mode verbeux off d sactive le mode verbeux e lang change la langue des messages options fr passage en fran ais Certu 2013
4. WEB dans le cas contraire celui ci ne pourra pas tre exploit par celle ci verbose affiche des informations lors de l ex cution des commandes comme par exemple le num ro d ordre d ex cution de la commande le temps d ex cution les param tres help command affiche l aide g n rale des commandes disponibles ou le d tail d une commande sp cifi e object neptuneObjectName pr cise sur quel type d objet les commandes sui vantes vont devoir s ex cuter Cette option est aussi disponible apr s chaque commande pour changer de type d objet interactive active le mode interactif les commandes seront saisie sur la console le prompt pr cisera chaque fois quel est le type d objet actif file fileName active le mode script les commandes sont lues dans le fichier script Le fichier script doit contenir une commande par ligne des lignes blanches ou com men ant par le caract re di se sont ignor es et la commande quit permet d inter rompre le script avant la fin du fichier toutefois les lignes au del de cette com mande doivent tre syntaxiquement correctes command command command arguments ex cute la commande fournie avec ses arguments Plusieurs blocs d arguments commengant par command permettent d enchainer les commandes sans crire un script ni passer en mode interactif 1 5 Commandes disponibles Rappel l option object neptuneObjectName est disponible sur c
5. 1 2 Import CSV Ligne Param tre type obligatoire valeur par extensions description d faut fichier inputFile chemin 5 0 CSV chemin du fichier importer de fichier fileFormat texte non type de fichier si l extension n est pas conforme au format objectIdPrefix texte non param tre fournit le pr fixe des identifiants Neptune system des objets g n r s code de la configura tion 1 7 1 3 Import GTFS Ligne Param tre type obligatoire valeur par extensions description d faut fichier inputFile chemin de 5 0 Zip chemin du fichier importer fichier fileFormat texte non type de fichier si l extension n est pas conforme au format objectIdPrefix texte non param tre fournit le pr fixe des identifiants system Neptune des objets g n r s code de la Certu 2013 11 Manuel utilisateur de l application CHOUETTE V2 3 configura tion maxDistanceForCom num rique non 10 Distance maximale en m tre entre mercial 2 arr ts de m me nom pour les regrouper au sein d un arr t com mercial ignoreLastWord bool en non false Ignorer le dernier mot du nom de l arr t lors des regroupements ignoreEndChars num rique non 0 Nombre de caract res ignorer en fin du nom de l arr t lors des regroupements maxDistanceForCon num rique non 50 Distance maximale pour cr er nectionLink une correspondance entre 2 arr ts voisins et non regroup s dans un arr t
6. commercial optimizeMemory bool en non false Optimise la gestion m moire pour les imports volumineux ralentit le traitement 1 7 1 4 Export NEPTUNE Ligne Param tre type obligatoire valeur par extensions description d faut fichier outputFile chemin 5 0 xml zip chemin du fichier produire de fichier 1 7 1 5 Export CSV Ligne n accepte qu une ligne ne poss dant qu au maximum une s quence d arr t aller et une retour Param tre type obligatoire valeur exten description par sions d faut fichier outputFile chemin de oui 5 0 CSV chemin du fichier produire fichier 1 7 1 6 Export GTFS Ligne Param tre type obligatoire valeur exten description par sions d faut fichier outputFile chemin de oui 5 0 xmi zip chemin du fichier produire fichier timeZone texte oui 5 0 fuseau horaire selon le codage TZ voir http fr wikipedia org wiki Tz database 1 7 1 7 Export G oportail R seau Param tre type obligatoire valeur exten description par sions 12 Certu 2013 Manuel utilisateur de l application CHOUETTE en ligne de commandes d faut fichier le chemin de out SO xml ip chemin du fichier produire hchier logie chemin de oui SO pif png fschier image du loge de FAO fichier jpg jpeg imp logaFileame texte nem di mom du fich
7. ervices de l tat diteurs de logiciels op rateurs de services d infor mation chercheurs Le pr sent document d crit l utilisation de l application CHOUETTE en mode commande sans navigateur web Mots cl s Diffusion profil d change Neptune information multimo dale application Chouette manuel utilisateur IHM publique licence Creative Commons CC by nd Nombre de pages Date Confidentialit o Historique des versions r visions Historique des versions r visions Version Date d application Description des changements Auteur r vision V2 0 21 01 13 Nouveau document issu partir du manuel Patrick GENDRE Chouette 1 7 23 04 14 Changement du titre du doc de V2 0 vers V2 3 Pia MURGAT Manuel utilisateur de l application CHOUETTE en ligne de commandes Sommaire 1 Chouette Mode commande ss 4 1 1 Pr sentation EE 4 1 2 Stala E 4 1 3 Modes M 4 1 4 Options 5 _ TE 4 1 5 Commandes GISDONIDISS loss ets 5 1 5 1Commandes d changes de donn es 5 1 5 2Commandes de manipulation des objets 6 15 5Comimande EEN I EE 7 ee 8 1 7 Import et export en ligne de 11 faport Neptune EE sce eret dn teca tra rte en Enea gege ee ER 11 LRO N E E 11 kromo GLES LINE E 11 1 7 1 4Ex
8. hainement de commandes l mentaires sous 3 modes commandes pass es par argument e chouette sh options g n rales xe commandel arguments c commande arguments commandes fournies dans un fichier script options generales L SOEXIpt commandes saisies interactivement par l op rateur e chouette sh options g n rales i En dehors du mode interactif le processus d ex cution des commandes est interrompu d s qu une de celles ci retourne une erreur Note sous Windows il convient de passer la console sur la fonte de caract res LUCIDA Console et une fois activ e de lancer la commande chcp 1252 pour visualiser les codes UTF 8 1 4 Options g n rales Les options g n rales de chouette command sont e noDao n active pas les modules d acc s cette option mise imp rativement en premier permet d all ger le lancement de l appli cation dans le cas d un usage ne n cessitant pas la base de donn e comme par Certu 2013 Manuel utilisateur de l application CHOUETTE en ligne de commandes exemple des conversions de format ou une validation de fichiers Neptune Il n est pas n cessaire de disposer non plus de la base de donn es dans ce cas Attention dans le cas o cette option n est pas utilis e l application Chouette va se connecter la base de donn e il est imp ratif que le sch ma ait t cr par l appli cation
9. haque commande pour changer le type de donn e Neptune si n cessaire le changement de type efface de la m moire les objets pr c demment charg s 1 5 1 Commandes d changes de donn es getImportFormats fournit la liste des modules d import de donn es disponibles pour le type d objet actif cette m thode interroge les modules d import pour retourner aussi les param tres sp cifiques attendus import importe les donn es un format connu options format formatName pr cise le format nom fourni par getImportFormats optionN valeurOptionN renseigne la valeur d un des param tres de l import optionN repr sente le nom du param tre tel qu il est retourn par getImportFormats valeurOptionN repr sente la valeur du param tre optionnel pour un bool en o la pr sente de l option revient une valeur true Certu 2013 Manuel utilisateur de l application CHOUETTE V2 3 en retour de cette commande le mod le import est en m moire du programme en attente d une nouvelle commande sauvegarde dans la base validation export un autre format getExportFormat fournit la liste des modules d export de donn es disponibles pour le type d objet actif comportement identique getImportFormats export exporte les donn es disponibles en m moire options identiques import getDeletionExportFormats fournit la liste des modules d export de de suppression donn es disponibles po
10. ier s il arrive par uplumi fichier logon e ax URL texte aui 8 0 URL de l AOT legnllnforma texte vide Informations l gales ton legalinlonma lexie nem vici URL des mforrmatsons legales tion U RT ai Address texte aui 8 0 Adresse de T ACHT texte aui SO Email de FAOT texte gui SO Numer de t l phone de AOT read Me Lx b aui SO Contenu du fichier txt atepNote expe aui SO Notes sur les armis access Mate texte aui 8 0 Nope sur les acc s quay Picto chemin de non Ic ne de repr sentation d un quai 50x50 cher quay Pici mum ZIXKI chelle d affichage minimale de l ic ne Minscale rique quay nume HEN chelle d affichage maximale de l ic ne rique boardingPosi chemin de non le ne de repr sentation dun quai 50x50 tionl icto fichier num s Echelle d affichage minimale de Meine rique Minscale bourdingPos mum MXKI chelle d affichage maximale de l ic ne tionPicto rique Max heale comumereial chemin de non pig le ne de repr sentation dun guai 3050 StopPointPicto fichier COMME nume ZG Echelle d affichage minimale de popl ointPic rigue commercial mum AXKI chelle d affichage maximale de l ic ne 5qapPointPics rique 2013 13 Manuel utilisateur de l application CHOUETTE V2 3 stonPlacePicto chemi
11. jectVersion 1 set attr versionDate 2011 08 30 set attr name R seau de d monstration sauvegarde en base save cr ation d une nouvelle instance de transporteur new o company Certu 2013 Manuel utilisateur de l application CHOUETTE en ligne de commandes set attr NINOXE Company TransDemo set attr objectVersion 1 set attr name Transporteur de d monstration save cr ation d un arr t commercial new StopArea set attr objectId NINOXE StopArea ARRI set attr objectVersion 1 set attr name Arr t num ro 1 set attr areaType CommercialStopPoint g olocalisation set attr areacentroid objectlId NINOXE AreaCentroid ARRI set attr areacentroid objectVersion 1 set attr areacentroid longitude 4 040980161539514 set attr areacentroid latitude 49 21905234063518 set attr areacentroid longLatType WGS84 set attr areacentroid projectedPoint x 724260 set attr areacentroid projectedPoint y 2470377 set areacentroid projectedPoint projectionType epgs 27572 set attr areacentroid name Arr t num ro 1 Save cr ation d une ligne new o line set attr objectId NINOXE Line 1 set attr objectVersion 1 set attr name LIGNE 1 set attr number 1 set attr publishedName LIGNE 1 set attr transportModeName Bus association au r seau set ref ptNetwork NINOXE GroupOfLine Test association au transporteur set ref company NINOXE Company TransDe
12. mo set attr mobilityRestrictedSuitable false save utilisation du script chouette sh f script txt 3 mode interactif lancement chouette sh f script txt Certu 2013 Manuel utilisateur de l application CHOUETTE V2 3 d roulement unknown object 0 info o line Command 1 info parameters object line objectId type String objectVersion type int creationTime type Date creatorId type String name type String number type String publishedName type String transportModeName type TransportModeNameEnum Air Train LongDistanceTrain LongDistanceTrain 2 Local Train RapidTransit Metro Tramway Coach Bus Ferry Waterborne PrivateVehicle Walk Trolleybus Bicycle Shuttle Taxi VAL Other registrationNumber type String comment type String ptNetworkIdShortcut type String lineEnd collection of type String add allowed ptNetwork type PTNetwork company type Company companie collection of type Company route collection of type Route add allowed remove allo wed mobilityRestrictedSuitable type Boolean userNeed collection of type UserNeedEnum add allowed allergic heartCondition otherMedicalNeed visuallImpairment auditoryImpairment cognitivelnputlmpairment averseToLifts averseToEscalators averseToConfinedSpaces averseToCrowds otherPsychosensory Need luggageEncumbered pushchair baggageTrolley oversizeBaggage guideDog otherA
13. n de non Fichier num toMinscale rique stonPlacePic num toMaxSscule rique doces chemin ade Pico chier access Point num FitoMm cale rige PictoMaxs gou cale 14 png dr ZG all RB HX KS Ic ne de repr sentation d un quai 50x50 chelle d affichage minimale de licne Echelle d affichage maximale de l ic ne lc ne de repr sentation dun quan 50x50 chelle d affichage minimale de l ic ne chelle d affichage maximale de l ic ne Certu 2013
14. nimal otherEncumbrance wheelchair assistedWheelchair motorizedWheelchair wal kingFrame restrictedMobility otherMobilityNeed groupOfLine type GroupOfLine groupOfLine collection of type GroupOfLine restrictionConstraint collection of type RestrictionCons traint add allowed remove allowed facilitie collection of type Facility command info executed in 94 ms line 0 new Command 3 new 10 Certu 2013 line 1 gt q fin d ex cution Manuel utilisateur de l application CHOUETTE en ligne de commandes 1 7 Import et export en ligne de commande Chaque module d import dispose de ses propres arguments dans ce paragraphe ne sont pr sent s que ceux disponibles en standard Les param tres des modules d import export sont toujours disponibles en utilisant les com mandes getImportFormats et getExportFormats 1 7 1 1 Import Neptune Ligne Param tre type obligatoire valeur extensions description d faut fichier inputFile chemin 5 0 xml chemin du fichier importer de fichier zip fileFormat texte non type de fichier si l extension n est pas conforme au format validate bool en false active la validation des donn es selon la XSD Neptune optimizeMe bool en non false Optimise la gestion m moire pour les mory imports volumineux ralentit le traitement 1 7
15. port NEPTUNE Ligne 12 RSR CSV LIGNE a a cd 12 LI Lobxport GLES L ne 12 Bxport G oportail RES ere te 12 Certu 2013 Manuel utilisateur de l application CHOUETTE V2 3 1 Chouette Mode commande 1 1 Pr sentation Afin de r aliser des actions automatiques ou d agir interactivement sur les donn es Neptune sans passer par l application WEB de Chouette un mode commande est disponible sous la forme d une application JAVA lancer depuis une console Windows ou un terminal Linux L application s ex cute en local sur la machine sur laquelle est est install e elle n est pas accessible distance et dans le cas d utilisation des commandes agissant sur la base de don n es la machine doit pouvoir se connecter celle ci 1 2 Installation L archive java chouette command zip est disponible en t l chargement sur le site internet www chouette mobi dans le menu CHOUETTE Version pr compil e http www chouette mobi spip php rubrique87 Merci d avance de nous laisser vos coordonn es via le site chouette mobi pour que nous ayons connaissance de nos utilisateurs Il est galement possible de g n rer ce fichier zip partir du code avec Maven pour cela reportez vous au manuel d installation 1 3 Modes d activation Chouette command dispose de 2 scripts de lancement chouette bat pour Windows chouette sh pour Linux Chouette command peut ex cuter un enc
16. teName nom de l attribut on value valeur fixer entre si la valeur contient des espaces non renseign e pour supprimer la valeur existante Note si l attribut est de type date heure ou horodate le format de la valeur doit respecter la syntaxe suivante type format date yyyy MM dd heure HH mm ss horodate yyyy MM dd HH mm ss ref attributeName referenceObjectId fixe une r f rence un autre objet Neptune celui ci doit d j tre pr sent dans la base attributeName nom de l attribut Certu 2013 Manuel utilisateur de l application CHOUETTE en ligne de commandes referenceObjectid r f rence Neptune de l objet champs ObjectId non renseign pour supprimer la r f rence existante ajoute une valeur un attribut de cardinalit multiple voir set pour la syntaxe mais les param tres value ou referenceObjectId sont obligatoires remove retire une valeur d un attribut de cardinalit multiple voir set pour la syn taxe mais les param tres value ou referenceObjectId sont obligatoires print imprime les attributs et les d pendances d un objet options level deepness profondeur d affichage des objets en d pendance par d faut 0 uniquement les attributs directs 1 5 3 Commande d acc s la base e get charge des objets depuis la base options id value filtre sur une liste d identifiants techniques
17. ur le type d objet actif comportement identique getImport Formats exportForDeletion exporte la demande de suppression des donn es disponibles en m moire options identiques import Note l export de suppression doit tre effectu avant la suppression effective des donn es de la base validate valide les objets en m moire options file filename fichier d enregistrement du rapport de validation par d faut le rapport est imprim la console append optionnel ajoute le rapport au fichier en l absence de cette option le pr c dent contenu du fichier est effac complete enrichit les attributs des objets en m moire dans le but de les exporter Note les objets lus dans la base de donn es ne contiennent par d faut que les infor mations utiles leur mise jour les modules d export peuvent avoir besoin de don n es compl mentaires comme les identifiants m tier des objets en relation directe ou indirecte avec l un d entre eux cette commande r sout l ensemble de ces donn es Exemple LineldShortcut dans l objet VehicleJourney 1 5 2 Commandes de manipulation des objets Ces commandes l exception de new et print ne sont disponibles que si un unique objet est en m moire new cr e un nouvel objet en m moire set fixe la valeur d un attribut de cardinalit 1 de l objet en m moire options attr attributeName value ajoute une valeur de type l mentaire attribu
Download Pdf Manuals
Related Search