= チケット管理システム =
[[TracGuideToc]]

Trac のチケット管理データベースは、プロジェクトのチケットやバグについての、簡単で効果的なトラッキング機能を提供します。

Trac のプロジェクト管理機能の中枢である、チケット管理システムは、 '''バグレポート''', '''機能追加要求''', '''ソフトウェアサポートの課題''', '''プロジェクトのタスク管理''' などに使用できます。

このサブシステムは TracWiki のように、ユーザのコントリビュートと参加をできるだけ簡単にするという目標で設計しています。バグを報告して、質問して、改良を提案するのはできるだけ簡単であるべきです。

チケットは、それを解決しなければならない人にすでにアサインされているか、あるいは解決可能な人に再アサインされます。
すべてのチケットは、いつでも、編集したり、注釈をしたり、アサインしたり、優先付けしたり、議論したりできます。

'''Note:''' チケット管理システムの有効な活用は、単なるバグレポートに留まらず、プロジェクトのアイデアとタスクのための ''いれもの'' として使うことです。

== チケット属性 ==

チケットは、以下の情報を属性として含んでいます:
 
 * '''報告者 (Reporter)''' - チケットを登録した人。
 * '''コンポーネント (Component)''' - チケットが適用されるモジュールやサブシステム。
 * '''バージョン (Version)''' - チケットが適用されるバージョン。
 * '''重要度 (Severity)''' - チケットの影響範囲。 ''enhancement'' (機能追加要求) から ''blocker'' (次のマイルストーンまでに直さなければならない)の中から選択する。
 * '''優先度 (Priority)''' - このチケットと他のチケットを比較した時の重要性。
 * '''マイルストーン (Milestone)''' - このチケットが少なくとも、いつまでに解決されなければならないか。
 * '''解決方法 (Resolution)''' - チケットが解決された際の理由。直した(fixed)、チケットではない(invalid)、他のチケットと内容が重複している(duplicate)など。
 * '''キーワード (Keywords)''' - チケットに付与するキーワード。検索や、レポートの生成で使用する。
 * '''担当者 (Assigned to)''' - チケットを解決に責任を持つ担当者。
 * '''関係者 (Cc)''' - チケットに関係がある人のリスト。 ''Note: 責任やそのほかの方針についての意味を暗に持つわけでは '''ありません'''。''
 * '''ステータス (Status)''' - チケットの現在の状態。
 * '''概要 (Summary)''' - 問題点や、チケットについての簡単な説明。タイトル。
 * '''説明 (Description)''' - チケットの内容。 '''特定された状況について、詳しく記述され、的を絞った''' 良い説明文を書いてください。

== チケットの更新や注釈 ==

ひとたびチケットが Trac に投入されると、あとはいつでもチケットに '''注釈''' することで
情報を変更することができます。つまり、チケットへの更新やコメントは、
チケットそのものの一部として記録されます。

チケットの閲覧画面では、更新履歴は、メインの表示領域の下に表示されます。

''Trac 自身の開発では、チケットのコメントは問題点やタスクについてディスカッションに
使っています。これによって、設計や実装上の選択の背後にある動機の理解が簡単になり、後で思い出しやすくなります。''

'''Note:''' チケットの説明や、コメントでは、 TracLinks と WikiFormatting を
使用することができます。これは重要な機能です。 TracLinks によって、
他の課題や、チェンジセット、ファイルへのリンクをチケットに設定できるので、
チケットを明確にしたり、理解しやすくしたりできます。

'''Note:''' チケットの更新を email で通知する設定をする方法は TracNotification に記述しています。

=== ステータスダイアグラム ===
http://projects.edgewall.com/trac/attachment/wiki/TracTickets/Trac%20Ticket%20State%20Chart%2020040607DF.png?format=raw

== 上級トピック: 新規チケット登録時に、URLで値を設定する ==

値が設定されたチケット登録フォームへのリンクを作成するには、 /newticket? に続いて、 パラメータ=値 を & でつないだ形式の URL を呼び出します。

値を設定できるパラメータ:

 * '''reporter''' - 報告者の名前
 * '''summary''' - チケットの概要
 * '''description''' - チケットの完全な説明
 * '''component''' - コンポーネント
 * '''version''' - バージョン
 * '''severity''' - 重要度
 * '''keywords''' - キーワード
 * '''priority''' - 優先度
 * '''milestone''' - マイルストーン
 * '''owner''' - チケットを解決できそうな人
 * '''cc''' - チケットが更新されたときに email で通知する人のリスト。

'''例:''' ''/trac/newticket?summary=Compile%20Error&version=1.0&component=gui''


参考:  TracGuide, TracWiki, TracTicketsCustomFields, TracNotification