Redmine is an excellent multi-project issue tracking tool focussing on collaboration in the implementation and integration parts of software development. Pivotal Tracker, on the other hand, is a superb planning tool and extremely well suited for requirements capturing and customer feedback.
The Trackmine -plugin provides simple but effective bi-directional communication between Pivotal Tracker and Redmine by outsourcing the workflow between Pivotal's “Started” and “Finished” states to Redmine. The triggers for teleporting between the tools are starting a story in Pivotal and closing an issue in Redmine. The workflow in Redmine remains customizable and can be tailored to individual needs.
Starting a story in a Pivotal Tracker automatically creates a Redmine issue with status “Accepted”.
Updating a story in a Pivotal Tracker updates the Redmine issue attributes (subject, description, status).
Closing a Redmine issue finishes the Pivotal Tracker story.
Mapping between Pivotal Tracker and Redmine attributes can be configured
In Redmine app run:
$ script/plugin install https://github.com/capita/redmine_trackmine.git
or clone it into /vendor/plugins/
$ git clone firstname.lastname@example.org:capita/redmine_trackmine.git
Copy Gemfile and Gemfile.lock from redmine_trackmine to redmine app
$ cp vendor/plugins/redmine_trackmine/Gemfile Gemfile $ cp vendor/plugins/redmine_trackmine/Gemfile.lock Gemfile.lock
$ bundle install
Run plugin migrations
$ rake db:migrate_plugins
Make sure you have following custom fields for Redmine Issue:
'Pivotal Project ID' (field_format: int, Trackers: Bug, Support, Feature) .
'Pivotal Story ID' (field_format: int, Trackers: Bug, Support, Feature) .
Add valid Pivotal Tracker credentials in [redmine_app]/config/trackmine.yml
[redmine_email]: email: [pivotal_tracker_email] password: [pivotal_tracker_password] super_user: # You can use an api token or email/password for the PT api. token: [pivotal_tracker_api_token] error_notification: recipient: [email_for_error_notifications] from: "[information to emails FROM field]"
email@example.com: token: 1234 firstname.lastname@example.org: email: email@example.com password: 2222 super_user: email: firstname.lastname@example.org password: 1234 error_notification: recipient: email@example.com from: "Trackmine Notifications <firstname.lastname@example.org>"
Users mentioned in trackmine.yml should have administration rights in redmine. The user named 'super_user' should have access to all Pivotal Tracker projects you want to map to. It might be the Pivotal Tracker admin. Its credentials are used to handle Pivotal Tracker hooks.
Add Web Hook Url pointing to your Redmine app. To do that:
On your project page choose 'Project -> Configure Integrations'
Find Activity Web Hook section
In 'Web Hook Url' put [redmine_app_url]/pivotal_activity.xml
As a Redmine administrator go to 'Administration -> Trackmine' section.
Use link 'Add mapping'
Select Redmine project and Pivotal project (or label)
You can configure:
Mapping between Pivotal story estimation points and Redmine estimated_hours
1 point => 1 hour 2 points => 4 hours 3 points => 10 hours
Mapping between Pivotal story_types and Redmine trackers
'feature' => 'Feature' 'bug' => 'Bug' 'chore' => 'Support'
Copyright © 2010 Capita Unternehmensberatung GmbH. See LICENSE for details.