こんにちは、tracpath の新しい機能「チケットカレンダー」をご紹介します。
trac プラグインとしてすでにリリースした TicketCalendarPlugin を tracpath で利用できるようにしました。

 

このプラグインは、チケットの対応予定を視覚的に分かりやすく「見える化」するためのプラグインです。
tracpath にはチケットを確認する方法として、メール通知、レポート機能、フィルタ機能、Excleエクスポートを提供しています。が、視覚的に確認する機能がありませんでした。チケットカレンダーによって、柔軟なフィルタ機能を利用して必要なチケットを見える化することが可能になります。

tracpath で利用するためにチケットにカスタムフィールドを設定する必要があります。
チケットカレンダーに表示するためには、チケットやマイルストーンに日付項目が必須となります。
日付項目に従ってカレンダーに表示するためです。

設定項目は2つのみです。

 

チケットカレンダーに必要な設定

 
チケットに新しい属性「開始日」「終了日」をカスタムフィールドから追加します。

カスタムフィールド
名称 タイプ ラベル デフォルト値 書式
start_date Text 開始日 空白 Plain
due_date Text 終了日 空白 Plain

 

名称の「start_date」「due_date」は一意な名前を付ける必要があります。start_date と due_date はユーザが自由に設定することができます。(設定方法については後述)
 


 

これで、チケットカレンダーが利用できるようになりました。
 
 

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

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

 

月間カレンダーを見る

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

 

リストでチケットを見る

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

 

チケットカレンダーのカスタマイズ

 
チケットカレンダーは標準の設定でそのまま利用する事ができますが、色やアイコンを自由に変更することができます。チケットカレンダーのカスタマイズ方法について説明します。

チケットカレンダーのカスタマイズ画面はプロジェクトの管理画面 » サイドメニューの ticketcalendar をクリックします。

 

チケットカレンダーのカスタマイズ項目
項目名 表示 デフォルト値 説明
週の開始日 first_week_day -1 カレンダーにおける週の最初の曜日を指定します。-1 の場合、ユーザのロケールに対応する曜日を使用します。それ以外の場合、指定した値を使用します。(0 が月曜日になります)
マイルストーン背景色 milestone.background-color #c2c2c2 マイルストーンの背景色を指定します
マイルストーンアイコン milestone.icon ui-icon-flag マイルストーンで表示する jquery-ui のアイコン名を指定します。
チケットの期日 ticket.due_date due_date チケット期日になるフィールド名を指定します
チケット期日の書式 ticket.due_date.format %Y-%m-%d チケット期日の書式を指定します。
チケット優先度の背景色 ticket.priority.color #fca89e, #ffad46, #7bd148, #8db3f0, #cca6ac チケットの優先度に使う背景色をカンマ区切りで指定します。優先度と背景色を明示的に指定することもできます。例: blocker:#fa6653, critical:#ffad46, …
チケットの開始日 ticket.start_date start_date チケット開始日になるフィールド名を指定します
チケット開始日の書式 ticket.start_date.format %Y-%m-%d チケット開始日の書式を指定します。
チケット分類のアイコン ticket.type.icon ui-icon-contact, ui-icon-lightbulb, ui-icon-check, ui-icon-gear, ui-icon-comment チケット分類に使う jquery-ui のアイコン名をカンマ区切りで指定します。 http://jquery-ui.googlecode.com/svn/tags/1.8.21/tests/static/icons.html を参照してください。チケット分類とアイコン名を明示的に指定することができます。 例: defect:ui-icon-contact, task:ui-icon-lightbulb, …

 

 

チケットカレンダーに利用できるアイコン集

 


Leave a reply

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong> 

required