Manuel Chouette ligne de commande
Contents
1. boardingPosi num non 2000 chelle d affichage minimale de l ic ne tionPicto rique MinScale boardingPosi num non 4000 chelle d affichage maximale de l ic ne tionPicto rique MaxScale commercial chemin non Ll png Ic ne de repr sentation d un quai 50x50 StopPoint de fichier AS Picto commercial num non 1600 chelle d affichage minimale de l ic ne StopPointPic rique toMinScale commercial num non 4000 chelle d affichage maximale de l ic ne StopPointPic rique toMaxScale stopPlacePicto chemin non es png Ic ne de repr sentation d un quai 50x50 de fichier y stopPlacePic num non 1600 chelle d affichage minimale de l ic ne toMinScale rique stopPlacePic num non 4000 chelle d affichage maximale de l ic ne toMaxScale rique accessPoint chemin non Ej png Ic ne de repr sentation d un quai 50x50 Picto de fichier accessPoint num non 1000 chelle d affichage minimale de l ic ne PictoMinScale rique accessPoint num non 2000 chelle d affichage maximale de l ic ne PictoMaxScale rique CITYWAY 16 162. tion maxDistanceForCom num rique non 10 Distance maximale en m tre mercial entre 2 arr ts de m me nom pour les regrouper au sein d un arr t commercial CITYWAY 13 16 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 a ignorer en fin du nom de l arr t lors des regroupements maxDistanceForConnec num rique non 50 Distance maximale pour cr er tionLink une correspondance entre 2 ar r ts voisins et non regroup s dans un arr t commercial optimizeMemory bool en non false Optimise la gestion m moire pour les imports volumineux ra lentit le traitement Export NEPTUNE Ligne Param tre type obligatoire valeur par extensions description d faut fichier outputFile chemin oui S O xml zip chemin du fichier produire de fichier 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 d sions fi faut chier outputFile chemin oui S O csv chemin du fichier produire de fichier Export GTFS Liane Param tre type obligatoire valeur exten description par d sions fi faut chier outputFile chemin oui S O xml zip chemin du fichier produire de fichier timeZone
3. 2e 40 CHOUETTE Maintenance accompagnement et recette de logiciels pour les changes de donn es multimodales application Chouette Utilisation en mode ligne de commandes V2 4 Auteurs Michel ETIENNE Luc DONNET Marc Florisson CityWay Patrick GENDRE CEREMA Jean SENG AFIMB R sum CHOUETTE est un logiciel libre d velopp l initiative du minist re francais charg des transports et du d veloppement durable dans le but de faciliter l change de donn es d offre th orique de trans port collectif TC en s appuyant pour cela sur la norme NFP 99506 dite Neptune qui sp cifie un pro fil d change XML Les utilisateurs vis s sont les collectivit s locales Autorit s Organisatrices de Transport AOT les ex ploitants des r seaux TC et leurs prestataires bureaux d tude ou soci t de services D autres utili sateurs potentiels sont n anmoins identifi s services de l tat diteurs de logiciels op rateurs de services d information chercheurs Le pr sent document d crit l utilisation de l application CHOUETTE en mode commande sans navi gateur web Agence fran aise pour l information multimodale et la billettique A Libert galit Fraternit R PUBLIQUE FRAN AISE Minist re de l cologie de l nergie du D veloppement durable et de la Mer CITYWAY 1 16 Informations sur ce document Organisme commanditaire
4. AFIMB Titre Utilisation de CHOUETTEen mode ligne de commande Organismes auteurs R dacteurs Participants CITYWAY Marc FLORISSON Patrick GENDRE CEREMA DT Med Michel ETIENNE Jean SENG Luc DONNET Maitre d ouvrage AFIMB Mots cl s profil d change Neptune information multi P O modale application Chouette ligne de com mande postgreSQL JAVA Diffusion publique licence Creative Commons CC by nd Nombre de pages Date Confidentialit Bibliographie Mai 2014 16 pages A Non Oui Historique des versions r visions Date d applica Description des changements tion 21 01 13 Nouveau document issu partir du manuel Patrick GENDRE Chouette 1 7 Michel Etienne Mai 2014 Mises jour techniques Michel Etienne CITYWAY 2 16 Table des mati res 1Chouette Mode commande ss 4 lTiPr s ntations ouest anne anni tels 4 1 2 Instala iaa 4 1 3 Modes d ICON A A Ae 4 1 4 Options generales ccoo ociosa canadian iraa EEA a a Aaaa A AE eeN R iso 5 1S Commandes disponibles iii a nn AS 6 1 06 EXEMples ini rre 9 1 7 Import et export en ligne de commande sise 12 CITYWAY 3 16 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 consol
5. CITYWAY 4 16 as 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 la DAO cette option mise imp rativement en premier permet d all ger le lancement de l application dans le cas d un usage ne n cessitant pas la base de donn e comme par exemple des conversions de format ou une validation de fichiers Neptune Il n est pas n cessaire de dispo ser 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 connec ter la base de donn e il est imp ratif que le sch ma ait t cr par l application WEB dans le cas contraire celui ci ne pourra pas tre exploit par celle ci e 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 e help command affiche l aide g n rale des commandes disponibles ou le d tail d une com mande sp cifi e e object neptuneObjectName pr cise sur quel type d objet les commandes suivantes vont devoir s ex cuter Cette option est aussi disponible apr s chaque commande pour changer de type d objet e interactive active l
6. ans le document d architec ture options propagate supprime aussi les objets li s mais pouvant avoir une existence ind pen dante exemple lors d une suppression de ligne suppression des arr ts du r f rentiel qui ne sont pas partag s avec une autre ligne la liste des objets supprim s par propaga tion est d finie dans le document d architecture 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 lang change la langue des messages options fr passage en francais en passage en anglais info fournit la liste des attributs d un objet help fourni l aide sur la liste des commandes disponibles ou le d tail sur une commande pr cis e options cmd commandName aide d taill e sur la commande CITYWAY 8 16 e include ins re le contenu d un autre fichier script dans le fichier en cours de chargement options file filename chemin du fichier script inclure chemin absolu ou relatif l empla cement 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 resea
7. areacentroid areacentroid cr ation d une ligne new o line objectlId NINOXE AreaCentroid ARR1 objectVersion 1 longitude 4 040980161539514 latitude 49 21905234063518 longLatType WGS84 projectedPoint x 724260 projectedPoint y 2470377 projectedPoint projectionType epgs 27572 name Arr t num ro 1 set attr objectld NINOXE Line l set attr objectVersion 1 set attr name LIGNE 1 set attr number 1 set attr publishedName LIGNE 1 set attr transportModeName Bus CITYWAY 10 16 association au r seau set ref ptNetwork NINOXE GroupOfLine Test association au transporteur set ref company NINOXE set attr mobilityRestrictedSuitable false save Company TransDemo utilisation du script chouette sh f script 3 mode interactif lancement chouette sh f script d roulement txt EXE unknown object 0 gt info o line Command 1 info parameters object line objectld type String objectVersion type int creationTime type Date creatorld type String name type String number type String publishedName type String transportModeName type TransportModeNameEnum Air Train Long RapidTransit Metro DistanceTrain LongDistanceTrain 2 LocalTrain Tramway Coach Bus Ferry Waterborne PrivateVehicle Walk Trolley bus Bicycle Shuttle Taxi VAL Other registrati
8. des getlmportFormats et getExportFormats Import Neptune Ligne Param tre type obligatoire valeur par extensions description d faut fichier inputFile chemin oui S O xml chemin du fichier importer de fichier zip CITYWAY 12 16 fileFormat texte non type de fichier si l extension n est pas conforme au format validate bool en non false active la validation des donn es selon la XSD Neptune optimizeMe bool en non false Optimise la gestion m moire pour les im mory ports volumineux ralentit le traitement Import CSV Ligne Param tre type obligatoire valeur par extensions description d faut fichier inputFile chemin oui S O csv chemin du fichier importer de fichier fileFormat texte non type de fichier si l extension n est pas conforme au format objectldPrefix texte non param tre fournit le pr fixe des identifiants Neptune system des objets g n r s code de la configura tion Import GTFS Ligne Param tre type obliga valeur par extensions description toire d faut fichier inputFile chemin de oui S O 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 configura
9. e 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 donn 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 repor tez vous au manuel d installation 1 3 Modes d activation Chouette command dispose de 2 scripts de lancement e chouette bat pour Windows e chouette sh pour Linux Chouette command peut ex cuter un enchainement de commandes l mentaires sous 3 modes e commandes pass es par argument e Chouettel sh options g n rales c commandel argu ments c commande2 arguments e commandes fournies dans un fichier script e chouette sh options g n rales f fichier script e commandes saisies interactivement par l op rateur e cChouette 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
10. e dans le but de les exporter Note les objets lus dans la base de donn es ne contiennent par d faut que les informations utiles leur mise jour les modules d export peuvent avoir besoin de donn es compl men CITYWAY 6 16 as taires 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 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 e new cr e un nouvel objet en m moire e 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 attributeName nom de l attribut value valeur fixer entre si la valeur contient des espaces non rensei gn 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 vyyy MM dd_HH mm ss ref attributeName referenceObjectlid fixe une r f rence un autre objet Nep tune celui ci doit d ja tre pr sent dans la base attributeName nom de l attribut referenceObjectid r f rence Neptune de l objet champs Objectld non renseign pour supprim
11. e la valeur d un des param tres de l import optionN repr sente le nom du param tre tel qu il est retourn par getlm portFormats valeurOptionN repr sente la valeur du param tre optionnel pour un boo l en o la pr sente de l option revient une valeur true 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 pour le type d objet actif comportement identique getimportFormats 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 rap port 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 moir
12. e mode interactif les commandes seront saisie sur la console le prompt pr cisera chaque fois quel est le type d objet actif e 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 commen ant par le caract re di se sont ignor es et la commande quit permet d interrompre le script avant la fin du fichier toutefois les lignes au del de cette commande doivent tre syntaxi quement correctes e command command command arguments ex cute la commande fournie avec ses argu ments Plusieurs blocs d arguments commen ant par command permettent d enchainer les com mandes sans crire un script ni passer en mode interactif CITYWAY 5 16 1 5 Commandes disponibles Rappel l option object neptuneObjectName est disponible sur chaque 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 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 ci fiques attendus import importe les donn es un format connu options format formatName pr cise le format nom fourni par getimportFormats optionN valeurOptionN renseign
13. er la r f rence existante e add ajoute une valeur un attribut de cardinalit multiple voir set pour la syntaxe mais les param tres value ou referenceObjectld sont obligatoires e remove retire une valeur d un attribut de cardinalit multiple voir set pour la syntaxe mais les param tres value ou referenceObjectld sont obligatoires e 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 Commande d acc s la base e get charge des objets depuis la base CITYWAY 7 16 options id value filtre sur une liste d identifiants techniques cl primaire de la base objectid value filtre sur une liste d identifiants m tier Objectld 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 ptnetwork objectld sur un objet de type Line operator null eq like value si n cessaire valeur de comparaison save sauve les objets en m moire dans la base options propagate propage la sauvegarde aux objets li s issus d un import par exemple delete supprime les objets en m moire de la base ainsi que les objets en d pendance struc turelles la liste des objets supprim s en cascade est d finie d
14. onNumber type String comment type String ptNetworkIdsShortcut type String lineEnd collection of type String add allowed CITYWAY 11 16 ptNetwork type PTNetwork company type Company companie collection of type Company route collection of type Route add allowed remove allowed mobilityRestrictedSuitable type Boolean userNeed collection of type UserNeedEnum add allowed allergic heartCondition otherMedicalNeed visuallmpairment audi toryImpairment cognitivelnputlmpairment averseToLifts averseToEscalators averseToConfinedSpaces averseToCrowds otherPsychosensoryNeed luggageEncumbered pushchair baggageTrolley oversizeBaggage guideDog otherAnimal otherEncumbrance wheelchair assistedWheelchair motorizedWheelchair walkingFrame restrictedMobility otherMobilityNeed groupOfLine type GroupOfLine groupO0fLine collection of type GroupOfLine restrictionConstraint collection of type RestrictionConstraint add allowed remove allowed facilitie collection of type Facility command info executed in 94 ms line 0 gt new Command 3 new line 1 gt q fin d ex cution 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 comman
15. texte oui S O fuseau horaire selon le codage TZ voir CITYWAY 14 16 http fr wikipedia org wiki Tz_database Export G oportail R seau Param tre type obligatoire valeur exten description par d sions fi faut chier outputFile chemin oui S O xml zip chemin du fichier produire de fichier logoFile chemin oui S O gif png fichier image du logo de l AOT de fichier jpg jpeg tmp logoFileName texte non nom du nom du fichier s il arrive par upload fichier logoFlle aotURL texte oui S O URL de l AOT legallnforma texte non vide Informations l gales tion legallnforma texte non vide URL des informations l gales tionURL aotAddress texte oui S O Adresse de l AOT aotEmail texte oui S O Email de l AOT aotPhone texte oui S O Num ro de t l phone de l AOT readMe texte oui S O Contenu du fichier ReadMe txt stopNote texte oui S O Notes sur les arr ts accessNote texte oui S O Note sur les acc s quayPicto chemin non A png Ic ne de repr sentation d un quai 50x50 de fichier quayPicto num non 2000 chelle d affichage minimale de l ic ne MinScale rique quayPicto num non 4000 chelle d affichage maximale de l ic ne MaxScale rique boardingPosi chemin non png Ic ne de repr sentation d un quai 50x50 tionPicto de fichier J CITYWAY 15 16
16. u zip validate c save propagate sh est n cessaire sous linux import Neptune validation chouette sh noDao c import o line format NEPTUNE inputFile 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 outputFile tatrobus zip 2 commandes crites dans un script script de cr ation d objet cr ation d une nouvelle instance de r seau new 0 ptnetwork valorisation des attributs set attr objectId NINOXE GroupOfLine Test set attr objectVersion set attr versionDate 2011 08 30 set attr name R seau de d monstration sauvegarde en base save CITYWAY 9 16 cr ation d une nouvelle instance de transporteur new o company set attr objectId NINOXE Company TransDemo set attr objectVersion 1 set attr name Transporteur de d monstration save cr ation d un arr t commercial new 0 StopArea set attr set attr set attr set attr objectId NINOXE StopArea ARRI objectVersion 1 name Arr t num ro 1 areaType CommercialStopPoint g olocalisation set attr set attr set attr Set attr set attr set attr set attr set rater set attr save areacentroid areacentroid areacentroid areacentroid areacentroid areacentroid areacentroid
Download Pdf Manuals
Related Search