Lifeとあるエンジニアのとある1日のつぶやき。Estimationプラグイン-初めに。Estimationプラグインをインストールするにあたっては下記のサイトを参考にさせていただきました。Estimationプラグインは、Tracのチケットに対する作業時間を入力し、その作業実績を管理する為のプラグインです。チケットに着手する際に、そのチケット解決までの見積り時間を設定し、それに対して日々どれだけの作業をしたかを入力する事で、チケットの作業割合が確認できます。この辺はプラグイン利用の際のルールをきちんと整備し、そのルールを如何にメンバーに守らせるかなど運用の方が重要になってくると思いますが・・・。Estimationプラグインをインストールする為には、Trac0.10以上のバージョンが必要です。要件を満たしていない場合は、事前にアップグレードしておきましょう。プラグインを追加するにあたりTracWebAdminをインストールしておけば楽に作業できます。TracWebAdminのインストール方法については、下記参照。プラグインのインストールにTracWebAdminは必須ではありません。インストールしてみたいと思います。」を参照してください。Estimationプラグインを追加する前にPYTHON_EGG_CACHEと言う環境変数の定義と、そのキャッシュ用のディレクトリを作成しておきます。eggで利用されるキャッシュ用のディレクトリでプラグインは通常、それらをユーザーのホームディレクトリを利用しますが、権限などの問題でエラーになる事もあるので明確に定義しておきます。(TracWebAdminプラグインをインストールした時は必要なかったんだが・・・)まず、キャッシュ用のディレクトリを作成します。ディレクトリの場所は何処でもかまいません。/var/trac/python_egg_cache次に、Apacheの設定ファイル(httpd.conf)に、PYTHON_EGG_CACHEの環境変数を定義(追記)します。Tracのバージョン0.11.1以前ではSetEnvでPYTHON_EGG_CACHEの環境変数をセットしていましたが、0.11.2以降では、PythonOptionで指定するように変更されています。PYTHON_EGG_CACHEの設定方法が変わった?編集後は、Apacheを再起動します。-」の「エラーメッセージその2」を参照してください。ダウンロードできます。source」の項目からダウンロードしています。InternetExplorerだとダウンロードの際のファイル名が正常に表示されません・・・。FireFoxならいけましたけど。IE使っている場合は、ダウンロード後に拡張子をzipに変更します。Estimationプラグインのインストールダウンロードしたzipファイルをサーバーに転送し、解凍しておきます。後は、解凍後のディレクトリにあるsetup.pyを実行します。Estimationプラグインは、デフォルトだと無効になっているのでこれを有効化します。有効化は、TracWebAdminから行えます。(手動でも可)ただ、TracWebAdminにアクセスする前に追加したプラグインを認識させる為にApacheの再起動が必要です。0.4.4」という項目が追加されていますので、その項目名をクリックして各コンポーネットのチェックボックスにチェックを要れ「更新」ボタンを押します。Estimationプラグインが有効になります。TracWebAdminをインストールしていない場合は、tracの設定ファイル(trac.ini)を編集する事でも有効化できます。enabledだけでもOKです。余談ですが、「estimatedhours.label」と「hours.label」、「totalhours.label」はチケット登録時の表示ラベルになっていて、日本語化できます。等と設定してあげればラベルが日本語になります。(要Apache再起動)有効化の後は、trac-adminコマンドでアップグレードを実行します。私の環境では、DBにPostgreSQLを利用している為「--no-backup」オプションを指定しましたがSQLiteを利用している場合は、「--no-backup」オプションは必要ないようです。Estimationプラグインが利用できるようになりました。Ticket)が入力できるテキストボックスが追加されているかと思います。Tracのメニューに「Management」というメニューが増えているはずです。「Management」メニューを制御(見える/見えない)する権限は、今のところないようです。誰でも見えて(使えて)しまいます。Ticket)を入力します。Ticket)を入力していきます。Hours)が合算されていきます。Hours)が変更できてしまうのがなんなんですが・・・。(ログには残るので、勝手に書き換えられたらわかりますけどね)次に各チケットごとの作業実績を確認したい場合は、集計しレポートを表示させる事も可能です。レポートを見るには、「チケットを見る」メニューからではなく、「Management」メニューから確認します。「Management」メニューから各作業時間の集計レポートが見れます。]チケット別の作業時間の集計レポート。分かりづらいですが、左上の数字がチケットの番号になっています。period」が、それらの総合計です。]マイルストンごとの集計結果です。「worked_add」欄はチケットの作業実績の集計が表示されています。]担当者(開発者)ごとの作業時間の集計結果です。Ticket)を付け加えたものです。このレポートはあまり意味が無いような・・・。]コンポーネントごとの集計結果。どのコンポーネントにどれだけの時間を要しているのか見るような用途でしょうか。Ticket)が入力されているか入力されていないかの違いでしょうか。本レポートは、作業実績時間が入力されていなくてもレポートの結果に反映されます。この辺も、自由にカスタマイズが効くのでSQLが書ければ必要なレポートを作ってみても良いと思います。項目名の日本語化もSQLを編集する事で可能ですし。Estimationプラグインの利用法は、下記も参照してみてください。Estimationプラグインの削除したい場合プラグインを「完全」に削除方法は、下記の通りです。特定のプロジェクトに対してだけプラグインを無効化したい場合は、不要です。Estimationプラグインが利用できなくなります。Trac設定ファイル(trac.ini)ファイルの編集trac.iniファイル内のプラグインに関連する記述を削除します。削除する前に念のためにtrac.iniファイルのバックアップを取っておきましょう。0上記の項目を削除します。DBのレコード&テーブルの削除やる前に念のためにDBのバックアップを取っておきましょう。Estimationプラグインで登録されたレコードを削除します。report_version)あと、これはTracHacksには載っていませんでしたが、systemテーブルに下記のようなデータが入っていましたので、これも削除。Estimationプラグインを有効化し、Tracをアップグレードすると、下記の2つのテーブルがDBに追加されています。report_versionこれらのテーブルをdrop。これで完全にプラグインを削除できるはず。原因は、TracWebAdminがtraci.iniファイルを編集しようとしてその権限が無いため。対処方法としては、Apacheのユーザへ書き込み権限を扶養してあげれば解消されます。upgrade"プラグインを有効化した直後にブラウザに表示されたエラーメッセージ。書かれているようにtrac-adminコマンドを実行する必要があります。先にも書いたとおりDBにPostgreSQLを使用している場合は、「--no-backup」オプションが必要。--no-backupを実行。Estimationプラグインを追加した際に、「チケットを見る」メニューにに幾つか新しいレポートが追加されています。それを見た際に表示されるエラーメッセージ。これはエラーではない模様。見ると、これらのレポートは、「Management」メニュー内のリンクから経由した場合にのみ正常に表示されます。Trac内でレポートの画面を弄る方法が提供されておらず、プラグインから勝手に弄るのも良くないので、SQL置き場的にレポートの機能を利用しているのかな・・・。Reports」から参照する事。Estimationプラグインをインストールすると、レポートの追加でエラーが発生するようになりました。回避方法は、下記を参照。Reserved.スパムを報告お問い合わせ利用規約ヘルプ。