• バージョンやカテゴリなど、見つからない場合は何も設定されない
• バージョンやカテゴリなど、設定したい場合はプロジェクトにあらかじめ用意しておく必要がある
• CSVにユーザ名がある場合は、loginidに変更する必要がある
• 日付はYYYY/MM/DD形式じゃないとエラーになる。Redmineからダウンロードしてきたデータがyyyy年MM月DD日とかの場合は、Redmineの設定でYYYY-MM-DDとかにしてCSVダウンロードするとよい

準備はいいか？

At the time of writing, the API is only available in trunk (see r3310, r3313).

チケットを取得する

チケットを作成する

accept_key_auth :index, :show, :changes, :new, :update, :destroy

Form authenticity token is missing or is invalid. API calls must include a proper Content-type header (text/xml or text/json).

 <issue>
   <project_id>rest</project_id>
   <tracker_id>3</tracker_id>
   <status_id>2</status_id>
   <priority_id>5</priority_id>
   <assigned_to_id>1</assigned_to_id>
   <subject>こんにちは世界</subject>
   <description>ありがとう世界</description>
   <start_date>2010-03-01</start_date>
   <due_date>2010-03-02</due_date>
   <done_ratio>10</done_ratio>
   <estimated_hours>10.5</estimated_hours>
   <custom_field_values>
     <1>カスタムなテキストフィールド</1>
     <2>11111</2>
     <3>0.33</3>
     <4>ううう</4>
     <5>1978-05-08</5>
     <6>1</6>
   </custom_field_values>
 </issue>

チケットの更新

 <issue>
   <project_id>rest</project_id>
   <tracker_id>2</tracker_id>
   <status_id>3</status_id>
   <priority_id>7</priority_id>
   <assigned_to_id>3</assigned_to_id>
   <subject>こんにちは世界2</subject>
   <description>ありがとう世界2</description>
   <start_date>2010-03-03</start_date>
   <due_date>2010-03-04</due_date>
   <done_ratio>20</done_ratio>
   <estimated_hours>20.5</estimated_hours>
   <custom_field_values>
     <1>カスタムなテキストフィールド2</1>
     <2>111112</2>
     <3>0.332</3>
     <4>いいい</4>
     <5>1978-05-09</5>
     <6>0</6>
   </custom_field_values>
 </issue>

チケットの削除

困ったこと

<?xml version="1.0" encoding="UTF-8"?>
<errors>
  <error>&#20778;&#20808;&#24230; &#12434;&#20837;&#21147;&#12375;&#12390;&#12367;&#12384;&#12373;&#12356;&#12290;</error>
  <error>&#12459;&#12473;&#12479;&#12512;&#12394;&#12522;&#12473;&#12488;&#12501;&#12451;&#12540;&#12523;&#12489; &#12399;&#19968;&#35239;&#12395;&#12354;&#12426;&#12414;&#12379;&#12435;&#12290;</error>
</errors>

まとめ

• エンジニアじゃない人向けに、簡単なUIつくって簡単ポスト
• どっかのデータからRedmineにチケット化

アジャイルプラクティス 達人プログラマに学ぶ現場開発者の習慣

アジャイルプラクティスの本だけど、たんに「こうやるべし」が書いてあるわけではない。
そういう情報が欲しい場合は、ちょっと前に読んだ初めてのアジャイル開発がいいかもしれない。

この本は、プラクティスの説明云々よりも、「プロフェッショナルなエンジニアを目指す心構え」が、ちょっとずつわかり易い言葉で書かれている。ついやってしまうことが悪魔の囁きと、こうやったらうまくいくのでは？という天使の言葉が対になっているため共感しやすかった。

たまたま、先日「すくすくスクラム」に参加したのだが、そこにアジャイルプラクティスの監訳をされた角谷信太郎さんがいらっしゃった（藤原はあとで知った）。

そして、帰りにこの本を読み終えたのだが、この本のすばらしいところは、監訳者あとがきだと思う。
たしかに、この本の中身もとても面白く、小さくまとまっていて楽しく読める。しかし、これを翻訳した方の声がここまで自分に届くとは思わなかった。

アジャイル（agile）という単語が形容詞であること

形容詞は単体では成り立たない。アジャイル開発、アジャイルプロセス・・・といった「何か」と紐づいてはじめて成立する。アジャイルは単体では成り立たない。同じ机でワークショップした人が書いた本ということもあり、「すごい人だな」と肌で感じた。

アジャイルという言葉が技術系記事でも眼にすることが多くなり、社内でも使われるようになり、「またアジャイルブームがきたのか」と思っていた。
Web2.0だのRailsだのFacebookだのTwitterだの、新しくて面白いものが世の中に広がり、「今までと違うやりかた」で成功を収める企業も増えてきたため、もしかすると、これまでのやり方（ウォーターフォールとか）の限界を感じる人達が、角谷さんのような人の声に耳をかたむけるようになったのかもしれない。
そして、その波が業界全体にやってきたのかもしれない。

「アジャイル」という言葉が一人歩きして失敗する例をよく聞いていたり、「それはアジャイルではないでしょ」というような話もよく聞いた。
「アジャイル」というマジックワードが自分の会社でも使われるようになり、「これも失敗しそうだ」という印象が強い。
それをなんとかしたいから勉強しているのだけれど、アジャイルを知れば知るほど、その深さにびっくりする。

自分には「プロフェッショナルになりたい」という思いがある。そのために、アジャイルプラクティスであったり、マネジメント手法であったり、いろんなことを試せるときに（試せないことの方が多かった）試してみた。

ずっと同じことをするには向いていない性格なので、「どうやったらもっとうまくいくか」ばかりを考えて働いていた。
アジャイルプラクティスを読んでいると、これまでやってきたことの答え合わせをしている気分になった。
「ここはこの本に書いてあるやり方のほうがよかったかも」とか「ここは私のやりかただともっといいかも」とか、この本を読んでまたアイデアが浮かんだりとか。

この本からは、そういう前向きな気持を感じることができた。
この本を読んで、アジャイルの価値をさらに深く知りたいとも思った。

次はアジャイルな見積りと計画づくりだー。

だったら作ればいいじゃない！

ということで、最終的にTracのAgiloみたいにアジャイルツール全てを実装することを目指して、Ruby勉強中。

一発目にバーンダウンチャートプラグインを実装してみて気がついたんだけど、Redmineだと以下の点がプラグインに落とし込みにくい。

• Y軸を残時間にした場合、予想と実績（タイムトラッキングのデータ）に差分があったとき、実績の残時間が０にならない
• Y軸をチケット数にすると、チケットごとの難易度（多分、予想時間）が見えにくい

一つ目は、予想の総和は変わらない（はず）なので線として綺麗にバーンダウンしてくれる。しかし、実績は変動するので、予想時間の合計から線を引くと、最終的に０にバーンダウンしてくれない。
また、チケットが増える（これはよくないんだろうけど）と、ラインの総和がかわるので、Y軸の開始位置がかわる。これだと見積もりがかわる（すなわち予想が外れる）ことになり、開始位置が変わるとそれに気がつかない。

％で表す進捗の問題を、バーンダウンで解決出来ていないじゃん！ということに気がついたのです。

http://github.com/scrumalliance/redmine_burndownでは、journalファイルを使っているみたいなんだけど。TimeEntryだとなりたたないのかな。

二つ目は、１時間かかる作業も１０時間かかる作業も、どちらも１つのチケットになるのでチケット数だといいのかわるいのかよくわからん。だから時間にしたいんだけど・・・。

バーンダウンチャートをもうちょっと勉強しないとだめだと思った。むむー。まだまだひよっこスクラムだ。
とりあえずやりたいことをまとめておこう。

• 見積もりした合計時間がどのように減っていく予定なのかを知りたい
• 実績データと見積もりの比較を見える化したい
• 最後はどのラインも０になって欲しい
• 理想線を表示したい（これは実装できた）

----

追記。
これを書きながら、実績や予実管理をいれちゃったらだめじゃん！ということに気がつきました。
終わったか終わらないかをチケットのステータスで判断して作ってみよう。
あとは、残時間がかわったときに、もとの予想時間に影響が出ないような仕様が必要かなー。

バーンダウンチャートプラグイン(Version Burndown Charts Plugin)

• License：GPLv3
• Source Code：Google Code
• Recent Version:0.0.3
• Requires Redmine 0.9.0
• Test Redmine is verison 0.9.0
• Test Server is WEBRick
  

Download / Install

• Download open_flash_chart 2.1.1.
• Unpack and move into vendor/plugins.
• Rename the plugin directory to open_flash_chart.
• Copy files from open_flash_chart/assets/* to RAILS_ROOT/public
• Download  Version Burndown Charts.
• Unpack and move into RAILS_ROOT/vendor/plugins.
• Rename the plugin directory to version_burndown_charts
• Restart Redmine.
• Login and configure the plugin (Administration > Roles and permissions > Permissions report)
• Configure the project (Project > Settings > Modules).
• Create version and set due date.
• Create ticket and set start date, estimated hours.
• Logged ticket status...
  
• Click to version burndown charts menu.
  

Change Log

• 2010/03/07 0.0.3 released. modified error message.
  
• 2010/03/01 0.0.2 released.
  
• 2010/02/28 0.0.1 released.

Product Backlog

• 日本語と英語のページを作るのがめんどくさい
• 当初の計画を自動計算しているので、予定工数が増えるとグラフの開始位置が変わってしまう
  

しかし、中には既存のテーブルにalterしちゃうのとかもあるので、Redmine本体のバージョンアップ時や、他のプラグイン実行時になにかと影響が出てしまう場合がある。

例えば、Backlogsプラグイン。これを使っていたら、チケットの削除ができなくなった。ロードマップに開始日を設定できる当たりが怪しい。

また、Advanced Roadmapプラグインもその名の通りロードマップを拡張するので、ロードマップ表示に影響が出ていた。

 Showing vendor/plugins/advanced_roadmap/app/views/projects/roadmap.rhtml where line #21 raised:
 undefined method `rest_hours' for #<version:0x6ce9158>

プラグインを作るときは、できるかぎり本体に影響が出ないようにしないと、運用中のRedmineがとつぜん暴走する。
本体に影響が出るような修正は、本家にPushすべしかな。

社内ではなぜか「お前話せ」みたいな感じで発表したり、勉強会行った事ないのに勉強会をとりまとめたりしていますが、ちまたでいわれているモノホンの勉強会に行ってきました。

ワイクル角さんがスピーカーでした。
（動画：http://www.ustream.tv/recorded/4993458）

*

・ATDP/ATDD（あとで調べる。TDDだけではない）
・BDD（あとで調べる）
・TiDD（チケット駆動。これ日本初なのか）

・3C・・・カード、会話、確認

・ストーリーカード
・・以下で考える
・・・役割
・・・機能、性能
・・・ビジネス価値

・「役割として、機能や性能が欲しい、ビジネス価値があるから」で考える
・・役割から考える方法
・・・私は○○なので・・・から考える

・エレベーターテストステートメント（あとで調べる）
・・エレベータ内のわずかな間で交渉。これぐらいの単位がわかりやすい

・ODSC＋RR（あとで調べる）
・・リクエストが大切そうだな

・エピック
・・このへんでよくわからなくなった
・・分解＞それを実現してもうまくいかない
・・そのままがよい？
・・そういうときは、一回提案から離れる

・命令的ストーリー（うちの会社これだ）
・対話的ストーリー（こうなりたい）

・オープンクエスチョン

・アジャイルにおけるテストの図
・・これはわかりやすかった

・・↑の本がよいらしい＞お気に入りした

・角さんはRedmine派らしい
・・バーンダウンチャートプラグイン真面目に作ろうと思ったりした
・・その前に社内に乱立したRedmineのデータ移行だ・・・

・その他気になったこと
・・小さなチーム、大きな仕事（Rails作った会社の話。へー本になったのか）

・・パワポの下にでていたRabbit0.6.2
・・同じ机の自然体の人
・・・アジャイルな見積りと計画づくり翻訳の角谷さん ＞ 有名な方なんだー

・・川口さん
・・・動画の人（オギー以外ではじめてみた）
・・・多分、来週お会いするんだろうけど、川口さんであっているかは明日会社にいかないと分からない・・・

*

初めての勉強会感想。

・いきなりワークショップが始まるのでびっくりした ＞ 自己紹介とかするかなーとおもったけど懇親会なのかな？
・参加者は勉強会慣れされているのか、なんかすごく違和感のある感じだった ＞ これは自分の力不足
・久しぶりにすっごくおとなしく過ごした気がする。慣れなのか！？勉強会は不思議な感じ
・勉強会の常連さんは、人が話している時にiPhoneとか平気で触るんだな ＞ これ嫌い

内容の感想。

・認定スクラムマスターまでくると、プロの臭いがする
・内容が難しくて、自分の中に落とせなかった。自分の特徴として理解するまでに時間がかかるので勉強不足
・よって、ワークショップと説明のつながりが見えにくかった ＞ 続けて参加ですね
・ワークショップごとの振り返りもやってほしかった

人生、経験ですな。
面白い本や参考文献を教えてもらったから、それを読んでもう一度話を聞いてみたい。
アジャイル探しはまだはじまったばかりという感触。
がんばって勉強しようとこころに誓うのだった。

  def index
    @graph = open_flash_chart_object(600,300,"/version_burndown/graph_code")
  end

Open Flash Chart
IO ERROR
Loading test data
Error #2032
This is the URL that I tried to open:/version_burndown/graph_code

 <script type="text/javascript">
   swfobject.embedSWF("/open-flash-chart.swf", "flash_content_DleU0GzY", "800", "450", "9.0.0", "expressInstall.swf",{"data-file":"%2Fversion_burndown%2Fgrapha_code"});
 </script>

• Flashのファイル（swfファイル）をHTMLで表示する
• swfファイルの引数に表示するデータ（JSON）のURL、ここでは/version_burndown/grapha_codeをCallする
• 受け取ったデータをswfファイルで表示する

5) Add the following to the test_it_controller.rb in RAILS_ROOT/app/controllers:
class TestItController < ApplicationController
  
  def index
    respond_to do |wants|
      wants.html {
        @graph = open_flash_chart_object( 600, 300, url_for( :action => 'index', :format => :json ) )
      }
      wants.json { 
        chart = OpenFlashChart.new( "MY TITLE" ) do |c|
          c << BarGlass.new( :values => (1..10).sort_by{rand} )
        end
        render :text => chart, :layout => false
      }
    end
  end

end

6) Add the following to index.html.erb in RAILS_ROOT/app/views/test_it/:
<html>
<head>
  <script type="text/javascript" src="/javascripts/swfobject.js"></script>
</head>
<body>
<%= @graph %>
</body>
</html>

  def index
    @graph = open_flash_chart_object( 800, 450, url_for( :action => 'graph_code', :project_id => @project.id, :version_id => @version.id ) )
  end

c:\fujihara\Ruby\redmine-0.9.0>ruby script/generate redmine_plugin version_burndown
      create  vendor/plugins/redmine_version_burndown/app/controllers
      create  vendor/plugins/redmine_version_burndown/app/helpers
      create  vendor/plugins/redmine_version_burndown/app/models
      create  vendor/plugins/redmine_version_burndown/app/views
      create  vendor/plugins/redmine_version_burndown/db/migrate
      create  vendor/plugins/redmine_version_burndown/lib/tasks
      create  vendor/plugins/redmine_version_burndown/assets/images
      create  vendor/plugins/redmine_version_burndown/assets/javascripts
      create  vendor/plugins/redmine_version_burndown/assets/stylesheets
      create  vendor/plugins/redmine_version_burndown/lang
      create  vendor/plugins/redmine_version_burndown/config/locales
      create  vendor/plugins/redmine_version_burndown/test
      create  vendor/plugins/redmine_version_burndown/README.rdoc
      create  vendor/plugins/redmine_version_burndown/init.rb
      create  vendor/plugins/redmine_version_burndown/lang/en.yml
      create  vendor/plugins/redmine_version_burndown/config/locales/en.yml
      create  vendor/plugins/redmine_version_burndown/test/test_helper.rb

c:\fujihara\Ruby\redmine-0.9.0>ruby script/generate redmine_plugin_controller version_burndown version_burndown index
      exists  app/controllers/
      exists  app/helpers/
      create  app/views/version_burndown
      create  test/functional/
      create  app/controllers/version_burndown_controller.rb
      create  test/functional/version_burndown_controller_test.rb
      create  app/helpers/version_burndown_helper.rb
      create  app/views/version_burndown/index.html.erb

ダウンロードはhttp://github.com/YukiKita/redmine_niko_cale/tree

すごい勢いでヴァージョンが上がってます。

さっそく入れてみたけど、このプラグインは開発女子にうける（とみた）。

早速、@tsukaさんサンキューです。

*

ちょっと時間がかかってしまったが読了。
スクラムやXPといった手法の、プラクティス＞その説明＞価値がわかりやすく書かれていてとてもよかった。「アジャイルってよく聞くけどなんだっけ？」という人や、「アジャイルってよくいう人はうさんくさい」と思っている私みたいな人にはぴったりだと思う。

参考になったのはやっぱりXPやスクラムだけど、UpやEvoとかもなかなか面白い。まだ「何が違うねん？」というところがあるので、定期的に読み直したい本。

それにしても、「一部のプラクティスやっただけで言い気になるな！」っていう感じが勉強になる。ケースによっては、全部のプラクティスを実効できないところがあると思うが、XPなんかは「プラクティスはお互いにコラボレーションしている」という意志をひしひしと感じるものなので、なんちゃってXPからの脱却を考える必要があるな。

それぞれのプラクティスにどういった価値があるか？

その理解を、会社の人間に語りかけるのもいいかもしれない。
この本は、会社においておくので、僕の席を知っている人はお気軽に読んでください。

# Japanese strings go here
ja:
  my_label: "My label"
  task_board_text_no_sprint: プロジェクトには実行中のスプリントがありません。バージョンの期限日を確認してください。

  <p><%= link_to_issue(issue) %>: <%=h issue.subject %></p>

と修正。

ChangeLog

• 1.1.0-daipresents ・・・ for multipule version and modified ja language file.
  
• 1.0.0-daipresents ・・・ for Redmine 0.9.x and add japanse language file.
  

Download

gem install mattetti-googlecharts --source=http://gems.github.com

ja:
  burndown: バーンダウンチャート
  burndown_text_no_sprint: プロジェクトには実行中のスプリントがありません。バージョンの期限日を確認してください。

    #self.start_date = version.created_on.to_date
    self.start_date = (Date.today - 7)

ActionView::TemplateError (undefined method `show_burndown_path' for #) on line #9 of vendor/plugins/redmine_burndown/app/views/burndowns/show.html.erb:

ActionController::Routing::Routes.draw do |map|
  map.latest_burndown 'projects/:project_id/burndown', :controller => 'burndowns', :action => 'show'
  map.show_burndown 'projects/:project_id/burndowns/:id', :controller => 'burndowns', :action => 'show'
end

Translation string with multiple values

DEPRECATION WARNING: using %s in messages is deprecated; use {{value}} instead..

<%= l(:recent_activity_status_log, old_name, new_name) %>

<%= l(:recent_activity_status_log, :old_name => old_name, :new_name => new_name) %>

recent_activity_status_log: "ステータスが{{old_name}}から{{new_name}}に変更されました。"