Skip to content
A Redmine plugin for syncing time with the Harvest time tracking API
JavaScript Ruby Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
assets
config
db/migrate
lib
test
.gitignore
Gemfile
README.md
init.rb

README.md

redmine_harvest_smc

FEATURES:

  • Sync time entries made in Harvest with issues in Redmine
  • Matches incoming Harvest entries against Redmine issue IDs from active projects
  • Adds time entries to Redmine time tracking report
  • Attempts to match Harvest task name with Redmine time tracking entry description
  • Redmine admin users can see and sync time for all users
  • Time column header cell shows sum total
  • Users can synchronize time using time report 1-click reconciliation of recent entries
  • Cron script for nightly (or more often) syncing
  • Admins can create an exclusion list where matching entries are ignored or associated with some blanket issue (e.g. break time could be added to a single master slip)
  • Time report page has filters (jQuery DataTables)
  • Ensure matched issue IDs are from an active project
  • Harvest admin users sync project and task names from Harvest for easier filtering on settings page

OieXx6o.png


PREREQUISITES:

Redmine 2.x

sudo apt-get install libxslt1-dev

cd /path/to/redmine/plugins/redmine_harvest_smc/
bundle install 

or install gems manually:

gem install ezcrypto --no-ri --no-rdoc
gem install on_the_spot --no-ri --no-rdoc
gem install nokogiri --no-ri --no-rdoc 

redmine.org/projects/redmine/wiki/Plugins

INSTALL

  1. Copy your plugin directory into #{RAILS_ROOT}/plugins (Redmine 2.x) or #{RAILS_ROOT}/vendor/plugins (Redmine 1.x). If you are downloading the plugin directly from GitHub, you can do so by changing into your plugin directory and issuing a command like git clone git://github.com/user_name/name_of_the_plugin.git.

  2. Update the password & salt used to encrypt Harvest usernames and passwords. Lines ~31,32,46, and 47 of app/models/harvest_user.rb

  3. If the plugin requires a migration, run the following command to upgrade your database (make a db backup before).

3.1. For Redmine 2.x:

rake redmine:plugins:migrate RAILS_ENV=production
  1. Restart Redmine

You should now be able to see the plugin list in Administration -> Plugins and configure the newly installed plugin (if the plugin requires to be configured).

  1. Enter your Harvest subdomain (e.g. http://subdomain.harvestapp.com/) on the settings page for this plugin

  2. Enter your Harvest credentials on the “Harvest User” page linked in the top header menu in Harvest.

UNINSTALL

  1. If the plugin required a migration, run the following command to downgrade your database (make a db backup before):

1.1. For Redmine 2.x:

rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production
  1. Remove your plugin from the plugins folder: #{RAILS_ROOT}/plugins (Redmine 2.x)

  2. Restart Redmine

You can’t perform that action at this time.