Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Redmine Plugin to integrate it with Pivotal Tracker

branch: master
README.rdoc

Redmine Trackmine Plugin

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.

Features

  • 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

Setup

Installation

In Redmine app run:

$ script/plugin install https://github.com/capita/redmine_trackmine.git

or clone it into /vendor/plugins/

$ git clone git@github.com: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

Install gems

$ bundle install

Run plugin migrations

$ rake db:migrate_plugins

Configuration- Redmine side

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

Syntax:

[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]"

trackmine.yml

foouser@example.net: 
  token: 1234 

baruser@example.net:
  email: baruser2@fake.net
  password: 2222

super_user:
  email: admin@net.org
  password: 1234

error_notification:
  recipient: errors@examplet.net
  from: "Trackmine Notifications <no-reply@example.net>"

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.

Configuration- Pivotal Tracker side

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

Example:

http://my-company-redmine-site.org/pivotal_activity.xml

Usage

Mapping

  • As a Redmine administrator go to 'Administration -> Trackmine' section.

  • Use link 'Add mapping'

  • Select Redmine project and Pivotal project (or label)

Mapping Configuration

You can configure:

  • Mapping between Pivotal story estimation points and Redmine estimated_hours

Default:

1 point  => 1 hour
2 points => 4 hours
3 points => 10 hours
  • Mapping between Pivotal story_types and Redmine trackers

Default:

'feature'  => 'Feature'
'bug'      => 'Bug'
'chore'    => 'Support'

Copyright

Copyright © 2010 Capita Unternehmensberatung GmbH. See LICENSE for details.

Something went wrong with that request. Please try again.