delete from hateblo.jp where 1=1;

タイトルに意味はありません。

Redmineでできること redmine-charts

ruby redmine

いろんなところでRedmineについての解説などがあるので、作り方については特に説明はしません。
ここではお勧めのPluginについてメモを取っていきます。

この記事ではRails2.2に沿って説明しています。
あと、最近Rails2.3.2も出てきているので人柱になりたいです。

Redmine chartsでできること

  • バーンダウンチャートを表示
  • チケット単位での時間割合
え？これで何ができるのか？

って声が聞こえそうなので、補足。
Redmineはバグ管理システムとしても優れているが、別の使い方もできます。
チマタではチケット駆動型開発などと呼ばれているものに使われます。

　−−−−−−−まぁ、このあたりは大体お分かりでしょうから飛ばしてくださって結構です。

実際、開発の現場や、作業の現場ではバグの記録だけが管理したいことではないです。
担当する人たちが何をやって、どれぐらいの時間を消費しているか、
仕上がる製品に対して何をしなくてはならないかを管理しなくてはなりません。
そこで、バグを管理するのではなく、作業を管理するツールとしてかなり有用だと叫ばれています。

この話を踏まえたうえで本題だが、『管理するもの』は「作業」とそれに伴う「時間」であることが見えてくるはずです。
作業に対して時間を記録することにより、進捗の管理ができてきます。

　−−−−−−−このあたりまで

「作業」に結びついた「時間」を視覚的に表示できたらすばらしいじゃないかと探していたら、見つかったのが
「Redmine charts」です。

用意するもの

準備

Redmineのインストール - Redmineガイドなどを参考にしてRedmineの環境を作成する。
ちなみに、rails(2.2.2)だと、エラーになる。
回避策としては /redmine/config/environment.rb の最後から2行目付近に以下のものを挿入する。

  config.action_controller.session = { :session_key => "_myapp_session", :secret => "some secret phrase of at least 30 characters" }

もし、外部に公開するRedmineの場合は上記の「some secret phrase of at least 30 characters」箇所をランダムな値で30文字に置き換えていただきたい。

導入手順

Open flash chartを準備
cd /redmine

上記フォルダで以下のコマンドを実行する

ruby script/plugin install git://github.com/pullmonkey/open_flash_chart.git

もし、エラーになる場合は、以下の方法で試してみる。

ruby script/plugin install http://github.com/pullmonkey/open_flash_chart.git

そして、必要なファイルを公開フォルダにコピーする。
(おそらくredmine chartsの仕様を変更すれば、この操作は必要ないだろう。気が向いたら直してみます。)

cd /redmine
cp ./vender/plugins/open_flash_chart/assets/open-flash-chart.swf ./public/
chmod 755 ./public/open-flash-chart.swf
chown redmine:redmine ./public/open-flash-chart.swf


Windowsの場合は以下のコマンド

cd \redmine
copy .\vender\plugins\open_flash_chart\assets\open-flash-chart.swf .\public\


Redmine chartsをインストールする

開発元のmszczytowskiさんのGit(ソース)から情報を取ってくる。

ruby script/plugin install git://github.com/mszczytowski/redmine_charts.git

後は簡単、実行するだけ。

もし、メニューの欄に"チャート"(Chart)という項目がない場合は、プロジェクト->設定->プラグイン->chartsにチェックが入っているかを確認しましょう。
なお、日本語版については現在、翻訳中...
githubの使い方が...むしろ、gitの使い方がよくわからないからアップロードできていません(汗)

翻訳(Rails2.2以降版)

以下のファイルに下に示す内容を書き込んでおいてください。
/redmine/vender/plugins/redmine_charts/config/locales/ja.yml

ja:
  charts_menu_label: "チャート"
  charts_link_ratio: "記録時間割合"
  charts_link_timeline: "記録時間予定"
  charts_link_burndown: "バーンダウン"
  charts_link_deviation: "記録時間分布"
  charts_show_last: "表示"
  charts_show_last_days: "日"
  charts_show_last_weeks: "週"
  charts_show_last_months: "月"
  charts_group_by: "グループ化"
  charts_group_by_none: "なし"
  charts_group_by_users: "メンバー"
  charts_group_by_activities: "活動"
  charts_group_by_issues: "チケット"
  charts_group_by_categories: カテゴリ
  charts_condition_issue_id: "チケット #"
  charts_condition_user_id: "メンバー"
  charts_condition_activity_id: "活動"
  charts_condition_issues:
    category_id: "カテゴリ"
  charts_condition_all: "すべて"
  charts_condition_include_subprojects: "チャートにサブプロジェクトも含む"
  charts_button: 表示
  charts_group_all: すべて

  charts_ratio_global_hint: "#total# 時間から #val# 時間<br>#percent# / 100%%"
  charts_ratio_label: "{{label}}"
  charts_ratio_hint: "{{label}}<br>{{hours}} ({{percent}}%%) / {{total_hours}} 時間"
  charts_ratio_others: "その他"
  charts_ratio_none: "なし"
  charts_ratio_help: "時間はメンバ、チケット、活動、カテゴリごとに分類およびフィルタした記録時間の合計に比例しています"

  charts_timeline_x: ""
  charts_timeline_y: "時間"
  charts_timeline_hint: "{{hours}} 時間, {{entries}} 個"
  charts_timeline_hint_empty: "0 時間"
  charts_timeline_help: "メンバ、チケット、活動、カテゴリごとに分類およびフィルタして時間経過を表しています"

  charts_burndown_x: ""
  charts_burndown_y: "時間"
  charts_burndown_hint_estimated: "{{estimated_hours}} 時間見積"
  charts_burndown_hint_logged: "{{logged_hours}} 時間記録"
  charts_burndown_hint_remaining: "完了まで残り {{remaining_hours}} 時間 ({{work_done}}%% 完了)"
  charts_burndown_hint_predicted: "完了まで合計 {{remaining_hours}} 時間"
  charts_burndown_hint_predicted_over_estimation: "完了まで合計 {{remaining_hours}} 時間, {{hours_over_estimation}} 時間予定オーバー"
  charts_burndown_group_estimated: "見積時間"
  charts_burndown_group_logged: "経過時間"
  charts_burndown_group_remaining: "残り時間"
  charts_burndown_group_predicted: "予測完了時間 (経過 + 記録) 時間"
  charts_burndown_help: "見積もり、経過および残りの時間を表しています"

  charts_deviation_x: "チケット"
  charts_deviation_y: "経過時間の割合(%)"
  charts_deviation_hint_logged_over_estimation: "{{logged_hours}} 時間記録, {{hours_over_estimation}} 時間オーバー ({{over_estimation}}%)"
  charts_deviation_hint_logged: "{{logged_hours}} 時間記録"
  charts_deviation_hint_remaining_over_estimation: "完了まで {{remaining_hours}} 時間, {{hours_over_estimation}} 時間オーバー ({{over_estimation}}%)"
  charts_deviation_hint_remaining: "完了まで{{remaining_hours}} 時間"
  charts_deviation_hint_issue: "<br>{{estimated_hours}} 時間見積, {{work_done}}% 完了"
  charts_deviation_hint_label: "<br>チケット #{{issue_id}}, {{issue_name}}"
  charts_deviation_hint_project_label: "<br>プロジェクトの平均"
  charts_deviation_label: "#{{issue_id}}"
  charts_deviation_project_label: "プロジェクト"
  charts_deviation_group_logged: "記録時間"
  charts_deviation_group_remaining: "残り時間"
  charts_deviation_group_estimated: "経過時間"
  charts_deviation_help: "各チケットの見積時間と記録時間と残り時間の割合を表しています。この割合は100%以下になるべきです。見積時間のあるチケットのみ表示しています。左端に表示しているバーはこのプロジェクトの平均値を表しています。"

  charts_earlier: "&laquo; 過去"
  charts_later: "最新 &raquo;"

以上で日本語化完了します。
翻訳に自信があまりないのでフォローお願いします。

参考文献

補足等

1238164907補足

フォローがありましたので訂正させていただきます。
上記方法はRails2.2以降です。

1251728406補足

GitHubへマージしました。
最新版についてもコミットしています。
http://github.com/indication/redmine_charts

1253196331補足

本線マージが決定しました。(15日ほど前に...連絡が遅くなりました)
現在は、日付関連の修正のコミットを考えています。
#最近はRubyを離れてZend(PHP)に集中してしまっていて申し訳ないです。

2009/11/29誤記修正