[[PageOutline(2-5,Contents,pullout)]] = Migrate Scarab issues to Trac tickets == Description This is a script that migrates [http://scarab.tigris.org/ Scarab] issues to Trac tickets. Scarab is an artefact tracking system released under the Apache license. It is currently developed in the Spanish locale only. See also: t:TracImport == Bugs/Feature Requests Existing bugs and feature requests for ScarabToTracScript are [report:9?COMPONENT=ScarabToTracScript here]. If you have any issues, create a [/newticket?component=ScarabToTracScript new ticket]. [[TicketQuery(component=ScarabToTracScript&group=type,format=progress)]] == TODO 1. Translate error messages to English. 1. Improve validation errors. 1. Implement tickets updating. 1. Implement a console (vielleicht readline) to facilitate the importation. == Download Download the zipped source from [export:scarabtotracscript here]. == Source You can check out ScarabToTracScript from [/svn/scarabtotracscript here] using Subversion, or [source:scarabtotracscript browse the source] with Trac. == Installation General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page. == Configuration You must install the XmlRpcPlugin, because updates are done through it. 1. Modify the configuration file, import-configuration.sample.xml. There are several sections: 1. Common: '''scarab-attachments-path''' should be the path where the Scarab attachments are located: {{{#!xml http://user:password@any-host-to-trac/projects/a-project/login/xmlrpc /tmp/scarab/attch_scarab }}} 1. Mappings between scarab users and Trac users {{{#!xml }}} 1. Global mappings between Scarab and Trac form fields. The optional ''ignore'' attribute indicates that if the field does not exist in the Trac form, will be ignored. It is used to define fields to be used as part of other fields (in transformations). The '''transformation''' element indicates that before setting the value of these field there will be a [http://genshi.edgewall.org/ Genshi] transformation, using as Genshi's context a variable named '''ticket''' with all Scarab issue's fields, including those marked with ignore = true and also the '''aditional-attributes''': {{{#!xml $ticket.summary [Issue Scarab $ticket.id] }}} 1. A '''scarab-artifact''' section: mappings for a particular Scarab issue type. '''additional-attributes''' Adds to Trac ticket (ticket-type attribute) associated with Scarab issue (type attribute). The value is also a Genshi transformation. Should have a '''scarab-artifact''' tag for each Scarab Issue type: {{{#!xml Ticket importado desde Scarab, ID = ${ticket.id} {% if "descripcion_scarab" in ticket %}${ticket.descripcion_scarab}{% end %} {% if "log" in ticket %}Log: ${ticket.log} {% end %} {% if "observaciones_comentarios_mejoras" in ticket %}Observaciones, comentarios y mejoras: $ticket.observaciones_comentarios_mejoras {% end %} }}} 1. A '''status-map''': maps the status field between Scarab and Trac statuses: {{{#!xml }}} 1. The scarab2trac.py script should run in a text terminal. With the "-h" parameter it prints the help: {{{ Usage: scarab2trac.py [options] Options: -h, --help show this help message and exit -c CONF, --conf=CONF Archivo de configuracion -s SCARAB, --scarab-issues=SCARAB Archivo con los issues exportados desde Scarab }}} The CONF file was explained above. The SCARAB file must be a XML file, exported from Scarab (Scarab options: Admin -> Current module -> XML export issues). == Recent Changes [[ChangeLog(scarabtotracscript, 3)]] == Author/Contributors '''Author:''' [wiki:szaffarano] [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:'''