17 | | チケットは、以下の情報を属性として含んでいます: |
| 20 | * '''Component''' — The project module or subsystem this ticket concerns. |
| 21 | * '''Version''' — Version of the project that this ticket pertains to. |
| 22 | * '''Keywords''' — Keywords that a ticket is marked with. Useful for searching and report generation. |
| 23 | |
| 24 | * '''Priority''' — The importance of this issue, ranging from ''trivial'' to ''blocker''. |
| 25 | * '''Milestone''' — When this issue should be resolved at the latest. |
| 26 | * '''Assigned to/Owner''' — Principal person responsible for handling the issue. |
| 27 | * '''Cc''' — A comma-separated list of other users or E-Mail addresses to notify. ''Note that this does not imply responsiblity or any other policy.'' |
19 | | * '''報告者 (Reporter)''' - チケットを登録した人。 |
20 | | * '''分類 (Type)''' - チケットの本質 (例えば、不具合 (defect), 機能追加 (enhancement request) など) |
| 29 | * '''Resolution''' — Reason for why a ticket was closed. One of {{{fixed}}}, {{{invalid}}}, {{{wontfix}}}, {{{duplicate}}}, {{{worksforme}}}. |
| 30 | * '''Status''' — What is the current status? One of {{{new}}}, {{{assigned}}}, {{{closed}}}, {{{reopened}}}. |
| 31 | * '''Summary''' — A brief description summarizing the problem or issue. |
| 32 | * '''Description''' — The body of the ticket. A good description should be specific, descriptive and to the point. |
26 | | * '''優先度 (Priority)''' - ''trivial'' から ''blocker'' の範囲で示されるチケットの重要性。 |
27 | | * '''マイルストーン (Milestone)''' - このチケットが少なくとも、いつまでに解決されなければならないか。 |
28 | | * '''担当者 (Assigned to/Owner)''' - チケットの扱いに責任を持つ主たる人。 |
29 | | * '''関係者 (Cc)''' - チケットに関係がある人のリスト。 ''Note: これは責任やそのほかの方針を意味しない。'' |
30 | | |
31 | | * '''解決方法 (Resolution)''' - チケットが解決された際の理由。{{{修正した(fixed)}}}、{{{無効なチケット(invalid)}}}、{{{修正しない(wontfix)}}}、{{{他のチケットと重複(duplicate)}}}、{{{再現しない(worksforme)}}}など。 |
32 | | * '''ステータス (Status)''' - チケットの現在の状態。 {{{new}}}, {{{assigned}}}, {{{closed}}}, {{{reopened}}} のいずれか |
33 | | * '''概要 (Summary)''' - 問題点や、チケットについての簡単な説明。タイトル。 |
34 | | * '''説明 (Description)''' - チケットの内容。 特定された状況について、詳しく記述され、的を絞った良い説明文を書いてください。 |
| 36 | '''Note:''' the [trac:TicketTypes type], [trac:TicketComponent component], version, priority and severity fields can be managed with [wiki:TracAdmin trac-admin] or with the [trac:WebAdmin WebAdmin] plugin. |
36 | | '''Note:''' バージョン 0.9 以前の Trac では ''分類 (Type)'' 属性がありませんでしたが、代わりに ''重要度 (Severity)'' 属性が提供されており、 ''優先度 (Priority)'' 属性のデフォルトの値も異なっていました。この変更を行ったのは、やや不鮮明な ''優先度 (Priority)'' と ''重要度 (Severity)'' の区別を排除し、チケットモデルを簡素化するためです。しかしながら以前のチケットモデルも利用可能です: 単に ''優先度 (Priority)'' と ''重要度 (Severity)'' のデフォルトの値を追加 / 変更し、必要なら ''分類 (Type)'' 属性の全ての値を削除してください。これらは [wiki:TracAdmin trac-admin] コマンドで出来ます。 |
| 38 | '''Note:''' Description of the builtin ''priority'' values is available at [trac:TicketTypes#Whyistheseverityfieldgone TicketTypes] |
| 39 | |
| 40 | == Changing and Commenting Tickets == |
| 41 | |
| 42 | Once a ticket has been entered into Trac, you can at any time change the |
| 43 | information by '''annotating''' the bug. This means changes and comments to |
| 44 | the ticket are logged as a part of the ticket itself. |
| 45 | |
| 46 | When viewing a ticket, the history of changes will appear below the main ticket area. |
| 47 | |
| 48 | ''In the Trac project, we use ticket comments to discuss issues and tasks. This makes |
| 49 | understanding the motivation behind a design- or implementation choice easier, |
| 50 | when returning to it later.'' |
| 51 | |
| 52 | '''Note:''' An important feature is being able to use TracLinks and |
| 53 | WikiFormatting in ticket descriptions and comments. Use TracLinks to refer to |
| 54 | other issues, changesets or files to make your ticket more specific and easier |
| 55 | to understand. |
| 56 | |
| 57 | '''Note:''' See TracNotification for how to configure email notifications of ticket changes. |
| 58 | |
| 59 | '''Note:''' See TracWorkflow for information about the state transitions (ticket lifecycle), and how this workflow can be customized. |
| 60 | |
| 61 | == Default Values for Drop-Down Fields == |
| 62 | |
| 63 | The option selected by default for the various drop-down fields can be set in [wiki:TracIni trac.ini], in the `[ticket]` section: |
| 64 | |
| 65 | * `default_component`: Name of the component selected by default |
| 66 | * `default_milestone`: Name of the default milestone |
| 67 | * `default_priority`: Default priority value |
| 68 | * `default_severity`: Default severity value |
| 69 | * `default_type`: Default ticket type |
| 70 | * `default_version`: Name of the default version |
| 71 | * `default_owner`: Name of the default owner, ''if no owner for the component has been set'' |
| 72 | |
| 73 | If 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. Some of these can be chosen through the [trac:WebAdmin WebAdmin] plugin in the "Ticket System" section (others in the "trac.ini" section). The default owner for a ticket will be the component owner, if that is set, or `default_owner`, if not. |
45 | | チケットの閲覧画面では、更新履歴は、メインの表示領域の下に表示されます。 |
46 | | |
47 | | ''Trac 自身の開発では、チケットのコメントは問題点やタスクについてディスカッションに |
48 | | 使っています。これによって、設計や実装上の選択の背後にある動機の理解が簡単になり、 |
49 | | 後で思い出しやすくなります。'' |
50 | | |
51 | | '''Note:''' チケットの説明や、コメントでは、 TracLinks と WikiFormatting を |
52 | | 使用することができます。これは重要な機能です。 TracLinks によって、 |
53 | | 他の課題や、チェンジセット、ファイルへのリンクをチケットに設定できるので、 |
54 | | チケットを明確にしたり、理解しやすくしたりできます。 |
55 | | |
56 | | '''Note:''' チケットの更新を email で通知する設定をする方法は TracNotification に記述しています。 |
57 | | |
58 | | === ステータスダイアグラム === |
59 | | http://projects.edgewall.com/trac/attachment/wiki/TracTickets/Trac%20Ticket%20State%20Chart%2020040607DF.png?format=raw |
| 80 | Trac also lets you add your own custom ticket fields. See TracTicketsCustomFields for more information. |
66 | | * `default_type`: デフォルトのチケットの分類 |
67 | | * `default_component`: デフォルトで選択されているコンポーネント名 |
68 | | * `default_version`: デフォルトのバージョン |
69 | | * `default_milestone`: デフォルトのマイルストーン |
70 | | * `default_priority`: デフォルトの優先度 |
71 | | * `default_severity`: デフォルトの重要度 |
| 87 | To appear in the dropdown list, a user needs be registered with the project, ''i.e.'' a user session should exist in the database. Such an entry is automatically created in the database the first time the user submits a change in the project, for example when editing the user's details in the ''Settings'' page, or simply by authenticating if the user has a login. Also, the user must have `TICKET_MODIFY` [TracPermissions permissions]. |
83 | | == 担当者をドロップダウンリストにする == |
| 101 | * '''type''' — The type droplist |
| 102 | * '''reporter''' — Name or email of the reporter |
| 103 | * '''summary''' — Summary line for the ticket |
| 104 | * '''description''' — Long description of the ticket |
| 105 | * '''component''' — The component droplist |
| 106 | * '''version''' — The version droplist |
| 107 | * '''severity''' — The severity droplist |
| 108 | * '''keywords''' — The keywords |
| 109 | * '''priority''' — The priority droplist |
| 110 | * '''milestone''' — The milestone droplist |
| 111 | * '''owner''' — The person responsible for the ticket |
| 112 | * '''cc''' — The list of emails for notifying about the ticket change |
87 | | ''Note: この機能は '''バージョン 0.9 では実験段階です''' 。全てのユーザの中から、チケットの担当者になりうる人だけを表示する方法がありません。また、既に現役でないユーザをデータベースから削除する簡単な方法がありません。'' |
88 | | |
89 | | |
90 | | == 新規チケット登録時に、URLで値を設定する == |
91 | | |
92 | | 値が設定されたチケット登録フォームへのリンクを作成するには、 /newticket? に続いて、 パラメータ=値 を & でつないだ形式の URL を呼び出します。 |
93 | | |
94 | | 値を設定できるパラメータ: |
95 | | |
96 | | * '''reporter''' - 報告者の名前 |
97 | | * '''summary''' - チケットの概要 |
98 | | * '''description''' - チケットの完全な説明 |
99 | | * '''component''' - コンポーネント |
100 | | * '''version''' - バージョン |
101 | | * '''severity''' - 重要度 |
102 | | * '''keywords''' - キーワード |
103 | | * '''priority''' - 優先度 |
104 | | * '''milestone''' - マイルストーン |
105 | | * '''owner''' - チケットを解決できそうな人 |
106 | | * '''cc''' - チケットが更新されたときに email で通知する人のリスト。 |
107 | | |
108 | | '''例:''' ''/trac/newticket?summary=Compile%20Error&version=1.0&component=gui'' |
109 | | |
110 | | |
111 | | See also: TracGuide, TracWiki, TracTicketsCustomFields, TracNotification |
| 116 | ---- |
| 117 | See also: TracGuide, TracWiki, TracTicketsCustomFields, TracNotification, TracReports, TracQuery |