Changes between Version 2 and Version 3 of TracTickets


Ignore:
Timestamp:
Dec 31, 2005, 4:43:10 PM (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracTickets

    v2 v3  
    1 = チケット管理システム =
     1= The Trac Ticket System =
    22[[TracGuideToc]]
    33
    4 Trac のチケット管理データベースは、プロジェクトのチケットやバグについての、簡単で効果的なトラッキング機能を提供します。
     4The Trac issue database provides simple but effective tracking of issues and bugs within a project.
    55
    6 Trac のプロジェクト管理機能の中枢である、チケット管理システムは、 '''バグレポート''', '''機能追加要求''', '''ソフトウェアサポートの課題''', '''プロジェクトのタスク管理''' などに使用できます。
     6As the central project management element of Trac, tickets are used for '''project tasks''', '''feature requests''', '''bug reports''' and '''software support issues'''.
    77
    8 このサブシステムは TracWiki のように、ユーザのコントリビュートと参加をできるだけ簡単にするという目標で設計しています。バグを報告して、質問して、改良を提案するのはできるだけ簡単であるべきです。
     8As with the TracWiki, this subsystem has been designed with the goal of making user contribution and participation as simple as possible. It should be as easy as possible to report bugs, ask questions and suggest improvements.
    99
    10 チケットは、それを解決しなければならない人にすでにアサインされているか、あるいは解決可能な人に再アサインされます。
    11 すべてのチケットは、いつでも、編集したり、注釈をしたり、アサインしたり、優先付けしたり、議論したりできます。
     10An issue is assigned to a person who must resolve it or reassign the ticket to someone else.
     11All tickets can be edited, annotated, assigned, prioritized and discussed at any time.
    1212
    13 '''Note:''' チケット管理システムの有効な活用は、単なるバグレポートに留まらず、プロジェクトのアイデアとタスクのための ''いれもの'' として使うことです。
     13'''Note:''' To make full use of the ticket system, use it as an ''in bucket'' for ideas and tasks for your project, rather than just bug/fault reporting.
    1414
    15 == チケット属性 ==
     15== Ticket Fields ==
    1616
    17 チケットは、以下の情報を属性として含んでいます:
     17A  ticket contains the following information attributes:
    1818 
    19  * '''報告者 (Reporter)''' - チケットを登録した人。
    20  * '''コンポーネント (Component)''' - チケットが適用されるモジュールやサブシステム。
    21  * '''バージョン (Version)''' - チケットが適用されるバージョン。
    22  * '''重要度 (Severity)''' - チケットの影響範囲。 ''enhancement'' (機能追加要求) から ''blocker'' (次のマイルストーンまでに直さなければならない)の中から選択する。
    23  * '''優先度 (Priority)''' - このチケットと他のチケットを比較した時の重要性。
    24  * '''マイルストーン (Milestone)''' - このチケットが少なくとも、いつまでに解決されなければならないか。
    25  * '''解決方法 (Resolution)''' - チケットが解決された際の理由。直した(fixed)、チケットではない(invalid)、他のチケットと内容が重複している(duplicate)など。
    26  * '''キーワード (Keywords)''' - チケットに付与するキーワード。検索や、レポートの生成で使用する。
    27  * '''担当者 (Assigned to)''' - チケットを解決に責任を持つ担当者。
    28  * '''関係者 (Cc)''' - チケットに関係がある人のリスト。 ''Note: 責任やそのほかの方針についての意味を暗に持つわけでは '''ありません'''。''
    29  * '''ステータス (Status)''' - チケットの現在の状態。
    30  * '''概要 (Summary)''' - 問題点や、チケットについての簡単な説明。タイトル。
    31  * '''説明 (Description)''' - チケットの内容。 '''特定された状況について、詳しく記述され、的を絞った''' 良い説明文を書いてください。
     19 * '''Reporter''' - The author of the ticket.
     20 * '''Type''' - The nature of the ticket (for example, defect or enhancement request)
    3221
    33 == チケットの更新や注釈 ==
     22 * '''Component''' - The project module or subsystem this ticket concerns.
     23 * '''Version''' - Version of the project that this ticket pertains to.
     24 * '''Keywords''' - Keywords that a ticket is marked with.  Useful for searching and report generation.
    3425
    35 ひとたびチケットが Trac に投入されると、あとはいつでもチケットに '''注釈''' することで
    36 情報を変更することができます。つまり、チケットへの更新やコメントは、
    37 チケットそのものの一部として記録されます。
     26 * '''Priority''' - The importance of this issue, ranging from ''trivial'' to ''blocker''.
     27 * '''Milestone''' - When this issue should be resolved at the latest.
     28 * '''Assigned to/Owner''' - Principal person responsible for handling the issue.
     29 * '''Cc''' - A list of other associated people. ''Note that this does not imply responsiblity or any other policy.''
     30 
     31 * '''Resolution''' - Reason for why a ticket was closed. One of {{{fixed}}}, {{{invalid}}}, {{{wontfix}}}, {{{duplicate}}}, {{{worksforme}}}.
     32 * '''Status''' - What is the current status? One of {{{new}}}, {{{assigned}}}, {{{closed}}}, {{{reopened}}}.
     33 * '''Summary''' - A brief description summarizing the problem or issue.
     34 * '''Description''' - The body of the ticket. A good description should be specific, descriptive and to the point.
    3835
    39 チケットの閲覧画面では、更新履歴は、メインの表示領域の下に表示されます。
     36'''Note:''' Versions of Trac prior to 0.9 did not have the ''type'' field, but instead provided a ''severity'' field and different default values for the ''priority'' field. This change was done to simplify the ticket model by removing the somewhat blurry distinction between ''priority'' and ''severity''. However, the old model is still available if you prefer it: just add/modify the default values of the ''priority'' and ''severity'', and optionally hide the ''type'' field by removing all the possible values through [wiki:TracAdmin trac-admin].
    4037
    41 ''Trac 自身の開発では、チケットのコメントは問題点やタスクについてディスカッションに
    42 使っています。これによって、設計や実装上の選択の背後にある動機の理解が簡単になり、後で思い出しやすくなります。''
    4338
    44 '''Note:''' チケットの説明や、コメントでは、 TracLinks と WikiFormatting を
    45 使用することができます。これは重要な機能です。 TracLinks によって、
    46 他の課題や、チェンジセット、ファイルへのリンクをチケットに設定できるので、
    47 チケットを明確にしたり、理解しやすくしたりできます。
     39== Changing and Commenting Tickets ==
    4840
    49 '''Note:''' チケットの更新を email で通知する設定をする方法は TracNotification に記述しています。
     41Once a ticket has been entered into Trac, you can at any time change the
     42information by '''annotating''' the bug. This means changes and comments to
     43the ticket are logged as a part of the ticket itself.
    5044
    51 === ステータスダイアグラム ===
     45When viewing a ticket, the history of changes will appear below the main ticket area.
     46
     47''In the Trac project, we use ticket comments to discuss issues and tasks. This makes
     48understanding the motivation behind a design- or implementation choice easier,
     49when returning to it later.''
     50
     51'''Note:''' An important feature is being able to use TracLinks and
     52WikiFormatting in ticket descriptions and comments. Use TracLinks to refer to
     53other issues, changesets or files to make your ticket more specific and easier
     54to understand.
     55
     56'''Note:''' See TracNotification for how to configure email notifications of ticket changes.
     57
     58=== State Diagram ===
    5259http://projects.edgewall.com/trac/attachment/wiki/TracTickets/Trac%20Ticket%20State%20Chart%2020040607DF.png?format=raw
    5360
    54 == 上級トピック: 新規チケット登録時に、URLで値を設定する ==
    5561
    56 値が設定されたチケット登録フォームへのリンクを作成するには、 /newticket? に続いて、 パラメータ=値 を & でつないだ形式の URL を呼び出します。
     62== Default Values for Drop-Down Fields ==
    5763
    58 値を設定できるパラメータ:
     64The option selected by default for the various drop-down fields can be set in [wiki:TracIni trac.ini], in the `[ticket]` section:
    5965
    60  * '''reporter''' - 報告者の名前
    61  * '''summary''' - チケットの概要
    62  * '''description''' - チケットの完全な説明
    63  * '''component''' - コンポーネント
    64  * '''version''' - バージョン
    65  * '''severity''' - 重要度
    66  * '''keywords''' - キーワード
    67  * '''priority''' - 優先度
    68  * '''milestone''' - マイルストーン
    69  * '''owner''' - チケットを解決できそうな人
    70  * '''cc''' - チケットが更新されたときに email で通知する人のリスト。
     66 * `default_type`: Default ticket type
     67 * `default_component`: Name of the component selected by default
     68 * `default_version`: Name of the default version
     69 * `default_milestone`: Name of the default milestone
     70 * `default_priority`: Default priority value
     71 * `default_severity`: Default severity value
    7172
    72 '''例:''' ''/trac/newticket?summary=Compile%20Error&version=1.0&component=gui''
     73If any of these options are omitted, the default value will either be the first in the list, or an empty value, depending on whether the field in question is required to be set.
    7374
    7475
    75 参考:  TracGuide, TracWiki, TracTicketsCustomFields, TracNotification
     76== Hiding Fields and Adding Custom Fields ==
     77
     78Many of the default ticket fields can be hidden from the ticket web interface simply by removing all the possible values through [wiki:TracAdmin trac-admin]. This of course only applies to drop-down fields, such as ''type'', ''priority'', ''severity'', ''component'', ''version'' and ''milestone''.
     79
     80Trac also lets you add your own custom ticket fields. See TracTicketsCustomFields for more information.
     81
     82
     83== Assign-to as Drop-Down List ==
     84
     85If the list of possible ticket owners is finite, you can change the ''assign-to'' ticket field from a text input to a drop-down list. This is done by setting the `restrict_owner` option of the `[ticket]` section in [wiki:TracIni trac.ini] to “true”. In that case, Trac will use the list of all users who have logged in and set their email address to populate the drop-down field.
     86
     87''Note that this feature is '''still experimental as of version 0.9'''. There is no way to only display a subset of all known users as possible ticket owners. Nor is there a convenient way to remove emeritus users short of directly modifying the database.''
     88
     89
     90== Preset Values for New Tickets ==
     91
     92To create a link to the new-ticket form filled with preset values, you need to call the `/newticket?` URL with variable=value separated by &.
     93
     94Possible variables are :
     95
     96 * '''reporter''' - Name or email of the reporter
     97 * '''summary''' - Summary line for the ticket
     98 * '''description''' - Long description of the ticket
     99 * '''component''' - The component droplist
     100 * '''version''' - The version droplist
     101 * '''severity''' - The severity droplist
     102 * '''keywords''' - The keywords
     103 * '''priority''' - The priority droplist
     104 * '''milestone''' - The milestone droplist
     105 * '''owner''' - The person responsible for the ticket
     106 * '''cc''' - The list of emails for notifying about the ticket change
     107
     108'''Example:''' ''/trac/newticket?summary=Compile%20Error&version=1.0&component=gui''
     109
     110
     111See also:  TracGuide, TracWiki, TracTicketsCustomFields, TracNotification