Trac プラグイン:TicketCalendarPlugin の使い方を説明します。

このプラグインは自分が担当しているチケットを「いつまでに、何を、どのくらい」対応しなければいけないかをビジュアル的に知りたいと思い、開発したプラグインです。
インストール方法はこちらのエントリーTrac プラグイン:TicketCalendarPlugin – チケットを月間カレンダーに表示するプラグイン(インストール編)を先にご覧下さい。

TicketCalendarPlugin の概要

TicketCalendarPlugin の特長

• 期限付きのチケットを月間カレンダー上で俯瞰
• リスト表示機能で直近の作業を確認
• チケットクエリ条件をつかって自分たちに必要なチケットのみ表示
• マイルストーンとチケットを1つの画面で見る
• マクロ機能で Trac Wiki に貼り付け可能
• 見た目が綺麗

TicketCalendarPlugin の機能

• 期限のあるチケットをBOXカレンダー表示
• 期限のあるチケットをリスト表示
• マイルストーンをカレンダーに表示
• チケットIDからチケット詳細画面に移動
• 日付(開始日)を指定して新規チケット作成
• チケットのフィルタ機能、カスタムクエリのフィルタがそのまま使える
• チケットのソート機能が使える
• マクロで Wiki や マイルストーンに貼り付け
• カレンダーとリストに表示するチケット分類アイコンを指定可能
• カレンダーとリストに表示するチケット重要度カラーを指定可能
• カレンダーとリストに表示するマイルストーンのアイコン・カラーを指定可能
• BOXカレンダーの週の始まる日を指定可能
• カスタムフィールドの開始日、終了日をユーザーが定義可能

TicketCalendarPlugin のインストールと設定内容についてはTrac プラグイン:TicketCalendarPlugin – チケットを月間カレンダーに表示するプラグインをご覧下さい。

1. スクリーンショット

 
TicketCalendarPlugin のスクリーンショットをご覧下さい。見たままの簡単操作であなたのチケットを教えてくれます。

2. 使い方

月間カレンダーを見る

月表示のBOXカレンダーを表示します。グローバルメニューから「チケットカレンダー」をクリックして表示されます。

カレンダーのチケットを見る

カレンダーに表示されるチケットをクリックすると、チケットの詳細を吹き出しで表示します。チケットIDのリンクをクリックするとチケット詳細画面に遷移します。

カレンダーから新しいチケットを作成する

月間カレンダーの日付セルをクリックすると吹き出しが表示されます。開始日を指定してチケットを作成、または期日を指定してチケットを作成することができます。

リストでチケットを見る

右上にある「リスト表示」をクリックするとチケットを今日の日付から1週間分リスト表示します。「先週のチケットを見る」「翌週のチケットを見る」をクリックすると先週・翌週のチケットリストを見ることができます。

3. 活用方法

 
どこかで見たり聞いたことある普通のカレンダー表示するだけのシンプルなプラグインですが当社での活用方法をお話しします。

チームの進捗管理に利用

 
チームの進捗会議を行うときに、Wikiに報告書を書くようにしています。（書いた報告書をみんなで共有）
進捗報告で利用する報告書にチケットカレンダーを貼り付けておくと、チーム毎、担当者毎の作業の混み具合や予定が「パッ」と俯瞰できます。

全体を一発で知るにはとてもよい機能だと思っています。

印刷してお客様向け報告に利用

 
カレンダー表示とリスト表示のどちらにも「マクロ」を出力する機能があります。
このマクロを Wiki に貼り付けます。
あとは、作業内容の報告・問題点などを記述すれば、あっという間に報告書のできあがりです。（実際のお客様に提出する場合はこれだけではダメですが。）

社内報告、協力会社への報告・共有、チームの情報共有などなど、サクッと資料を作ってしまいましょう。

ぜひ、TicketCalendarPlugin をお試し下さい。
皆様のご意見を聞かせて頂ければ今後の開発にいかしていきます。
ブログのコメントかお問い合せフォームよりお声をお待ちしております。
 

こんにちは、新しい Trac プラグインをリリースいたしました。
チケットに「開始日」「終了日」を設定すると Google Calendar の月間表示のように機能する TicketCalendarPlugin を開発いたしました。

このプラグインは自分が担当しているチケットを「いつまでに、何を、どのくらい」対応しなければいけないかをビジュアル的に知りたいと思い、開発したプラグインです。

動作しているスクリーンショット(イメージ図)は以下です。

• TicketCalendarPlugin – Trac Hacks – Plugins Macros etc. – Trac

このエントリーではインストールと初期設定について見ていきます。

1. easy_install でインストール

easy_install に http://trac-hacks.org/wiki/TicketCalendarPlugin/0.12 を渡せばさくっとインストールできます。
svn コマンドがない環境では、これではインストールできないと思います。その場合、Trac-hacksから手動でダウンロードを行い、ダウンロードしたディレクトリを easy_install に渡すようにしてください。

C:>easy_install -Z http://trac-hacks.org/svn/TicketCalendarPlugin/0.12
Downloading http://trac-hacks.org/svn/TicketCalendarPlugin/0.12
Doing subversion checkout from http://trac-hacks.org/svn/TicketCalendarPlugin/0.12 to c:\docume~1\admini~1.ope\locals~1\temp\easy_install-x_lmas\0.12
Processing 0.12
Running setup.py -q bdist_egg --dist-dir c:\docume~1\admini~1.ope\locals~1\temp\easy_install-x_lmas\0.12\egg-dist-tmp-ubt6k_
zip_safe flag not set; analyzing archive contents...
TicketCalendarPlugin 0.12.0.1 is already the active version in easy-install.pth

Installed c:\traclight\python\lib\site-packages\TicketCalendarPlugin-0.12.0.1-py2.6.egg
Processing dependencies for TicketCalendarPlugin==0.12.0.1
Finished processing dependencies for TicketCalendarPlugin==0.12.0.1

2. trac.ini でプラグインを有効にする

有効にしたい Trac プロジェクトの conf/trac.ini でこのプラグインを有効にします。(inherit-file で共有している trac.ini でも可能)

# trac.ini
[components]
ticketcalendar.web_ui.* = enabled

[ticketcalendar]
first_week_day = 6
milestone.color = #C2C2C2
milestone.icon = ui-icon-flag
ticket.due_date = due_date
ticket.due_date.format = %Y/%m/%d
ticket.start_date = start_date
ticket.start_date.format = %Y/%m/%d

この後、Trac を動作させている Web サーバを再起動させます。
チケットカレンダーを利用するためにチケットにカスタムフィールドに2項目追加する必要があります。
チケットカレンダーで利用するカスタムフィールドは trac.ini で定義します。

例示した設定の場合

• start_date ・・・作業開始日
• due_date ・・・作業終了日

を設定しています。利用する前にカスタムフィールドを追加してください。
これでインストール作業は終了です。

利用方法の説明についてはこちらのエントリー「Trac プラグイン:TicketCalendarPlugin の使用方法」を参照してください。

3. 設定の説明とカスタマイズ

チケットカレンダーは trac.ini で色やアイコンを利用者の好みにカスタマイズすることができます。
TicketCalendarPlugin の設定項目の説明と利用方法についてまとめています。

first_week_day = 6

milestone.color = #C2C2C2

milestone.icon = ui-icon-flag

ticket.due_date = due_date

ticket.due_date.format = %Y/%m/%d

ticket.start_date = start_date

設定例:
ticket.priority.color = #faa, #ffa, ...
または
ticket.priority.color = blocker:#faa, critical:#ffa, ...

デフォルト:
ticket.priority.color = #fa6653, #ffad46, #7bd148, #4986e7, #cca6ac

設定例
ticket.type.icon = ui-icon-contact, ui-icon-lightbulb, ...
または
ticket.type.icon = task:ui-icon-contact, defect:ui-icon-lightbulb, ...

デフォルト:
ticket.type.icon = ui-icon-contact, ui-icon-lightbulb, ui-icon-check, ui-icon-gear, ui-icon-comment