Changes between Version 1 and Version 2 of TracTickets


Ignore:
Timestamp:
09/18/14 10:48:12 (10 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracTickets

    v1 v2  
    66Trac のプロジェクト管理機能の中枢である、チケットシステムは、 '''プロジェクトのタスク管理''', '''機能追加のリクエスト''', '''バグレポート''', '''ソフトウェアサポートの課題''' などに使用できます。 
    77 
    8 このサブシステムは TracWiki のように、ユーザのコントリビュートと参加をできるだけ簡単にするという目標で設計しています。バグを報告して、質問して、改良を提案するのはできるだけ簡単であるべきです。 
     8このサブシステムは TracWiki のように、ユーザのコントリビュートと参加をできるだけ簡単にするという目標で設計しています。バグの報告や質問、改良の提案、決議に関する議論は簡単であるべきです。 
    99 
    1010チケットは、それを解決しなければならない人にすでにアサインされているか、あるいは解決可能な人に再アサインされます。 
    1111すべてのチケットは、いつでも、編集したり、注釈をしたり、アサインしたり、優先付けしたり、議論したりできます。 
    1212 
    13 == チケット属性 == #TicketFields 
     13[=#edit-permissions] 
     14しかしながら、Trac の設定において 個人が変更できる箇所に制限を加える場合があります。例えばデフォルトの設定では、認証していないユーザ("anonymous" ユーザ)に対して変更やコメントを許可しないことで、明らかなスパム行為を予防しています。ローカル貢献ポリシーを確認してください。通常はフロントページである WikiStart で見つけることが出来ます。また、使用している Trac の管理者にお問い合わせください。 
     15 
     16== チケット属性 == #TicketFields  
    1417 
    1518チケットは、以下の情報を属性として含んでいます: 
    1619  
    17  * '''報告者 (Reporter)''' - チケットを登録した人。 
    18  * '''分類 (Type)''' - チケットの本質 (例えば、不具合 (defect), 機能追加 (enhancement request) など) 
     20 * '''報告者 (Reporter)''' - チケットの作成者  
     21 * '''分類 (Type)''' - チケットの本質 (例えば、不具合 (defect), 機能追加 (enhancement request) など) 詳細は [trac:TicketTypes TicketTypes] 参照 
     22 * '''コンポーネント (Component)''' - チケットが適用されるモジュールやサブシステム 
     23 * '''バージョン (Version)''' - チケットが適用されるプロジェクトのバージョン 
     24 * '''キーワード (Keywords)''' - チケットに付与するキーワード。検索や、レポートの生成で使用する 
     25 * '''優先度 (Priority)''' - ''trivial'' から ''blocker'' の範囲で示されるチケットの重要度。定義した他の優先度を含めプルダウンで表示 
     26 * '''マイルストーン (Milestone)''' -  このチケットを少なくとも、いつまでに解決しなければならないのか。マイルストーンのリストをプルダウンで表示 
     27 * '''担当者 (Assigned to/Owner)''' - チケットの扱いに責任を持つ主たる人 
     28 * '''関係者 (Cc)''' -チケットに関係がある人または通知メール用の E-mail アドレスのカンマ区切りのリスト。 ''これは責任もいかなるポリシも意味していないことを注記しておく''  
     29 * '''解決方法 (Resolution)''' - チケットが解決された際の理由。{{{修正した(fixed)}}}、{{{無効なチケット(invalid)}}}、{{{修正しない(wontfix)}}}、{{{他のチケットと重複(duplicate)}}}、{{{再現しない(worksforme)}}}など 
     30 * '''ステータス (Status)''' - チケットの現在の状態。 {{{new}}}, {{{assigned}}}, {{{closed}}}, {{{reopened}}} のいずれか 
     31 * '''概要 (Summary)''' - 問題点や、チケットについての簡単な説明。タイトル。WikiFormatting の適用されない単純なテキスト 
     32 * '''説明 (Description)''' - チケットの内容。 特定された状況について、詳しく記述され、的を絞った良い説明文を書いてください。 WikiFormatting が適用されます 
    1933 
    20  * '''コンポーネント (Component)''' - チケットが適用されるモジュールやサブシステム。 
    21  * '''バージョン (Version)''' - チケットが適用されるバージョン。 
    22  * '''キーワード (Keywords)''' - チケットに付与するキーワード。検索や、レポートの生成で使用する。 
     34'''Notes:'''  
     35 - バージョン 0.9 以前の Trac では ''分類 (Type)'' 属性がありませんでしたが、代わりに ''重要度 (Severity)'' 属性が提供されており、 ''優先度 (Priority)'' 属性のデフォルトの値も異なっていました。この変更を行ったのは、やや不鮮明な ''優先度 (Priority)'' と ''重要度 (Severity)'' の区別を排除し、チケットモデルを簡素化するためです。しかしながら以前のチケットモデルも利用可能です: 単に ''優先度 (Priority)'' と ''重要度 (Severity)'' のデフォルトの値を追加/変更し、必要なら ''分類 (Type)'' 属性の全ての値を削除してください。これらは [wiki:TracAdmin trac-admin] コマンドで出来ます。 
    2336 
    24  * '''優先度 (Priority)''' - ''trivial'' から ''blocker'' の範囲で示されるチケットの重要性。 
    25  * '''マイルストーン (Milestone)''' - このチケットが少なくとも、いつまでに解決されなければならないか。 
    26  * '''担当者 (Assigned to/Owner)''' - チケットの扱いに責任を持つ主たる人。 
    27  * '''関係者 (Cc)''' - 関係者または通知したい E メールアドレスのカンマ区切りリスト ''これは責任もいかなるポリシも意味していないことを注記しておく。'' 
    28   
    29  * '''解決方法 (Resolution)''' - チケットが解決された際の理由。{{{修正した (fixed)}}}、{{{無効なチケット (invalid)}}}、{{{修正しない (wontfix)}}}、{{{他のチケットと重複 (duplicate)}}}、{{{再現しない (worksforme)}}}など。 
    30  * '''ステータス (Status)''' - 現在のチケットの状態。  {{{新規 (new)}}}, {{{割り当て済み (assigned)}}}, {{{クローズ (closed)}}}, {{{クローズからアクティブにされた (reopened)}}} のいずれか。 
    31  * '''概要 (Summary)''' - 問題点や、チケットについての簡単な説明。タイトル。 
    32  * '''説明 (Description)''' - チケットの内容。 特定された状況について、詳しく記述され、的を絞った良い説明文を書いてください。 
     37 - [http://trac.edgewall.org/wiki/TicketTypes 分類 (type)], [http://trac.edgewall.org/wiki/TicketComponent コンポーネント (component)], バージョン (version), 優先度 (priority), 重要度 (severity) の各フィールドは [wiki:TracAdmin trac-admin] か [trac:WebAdmin WebAdmin プラグイン] を用いて管理することができます。 
    3338 
    34 '''Note:''' バージョン 0.9 以前の Trac では ''分類 (Type)'' 属性がありませんでしたが、代わりに ''重要度 (Severity)'' 属性が提供されており、 ''優先度 (Priority)'' 属性のデフォルトの値も異なっていました。この変更を行ったのは、やや不鮮明な ''優先度 (Priority)'' と ''重要度 (Severity)'' の区別を排除し、チケットモデルを簡素化するためです。しかしながら以前のチケットモデルも利用可能です: 単に ''優先度 (Priority)'' と ''重要度 (Severity)'' のデフォルトの値を追加/変更し、必要なら ''分類 (Type)'' 属性の全ての値を削除してください。これらは [wiki:TracAdmin trac-admin] コマンドで出来ます。 
    35  
    36 '''Note:''' [http://trac.edgewall.org/wiki/TicketTypes 分類 (type)], [http://trac.edgewall.org/wiki/TicketComponent コンポーネント (component)], バージョン (version), 優先度 (priority), 重要度 (severity) の各フィールドは [wiki:TracAdmin trac-admin] か [http://trac.edgewall.org/wiki/WebAdmin WebAdmin プラグイン] を使用して管理することができます。 
    37  
    38 '''Note:''' ''優先度 (Priority)'' のデフォルト値についての説明は [http://trac.edgewall.org/wiki/TicetTypes#Whyistheseverityfieldgone TicketTypes] に書かれています。 
     39 - ''優先度 (Priority)'' のデフォルト値についての説明は [http://trac.edgewall.org/wiki/TicetTypes#Whyistheseverityfieldgone TicketTypes] に書かれています。 
    3940 
    4041== チケットの更新や注釈 == #ChangingandCommentingTickets 
    4142 
    42 ひとたびチケットが Trac に投入されると、あとはいつでもチケットに '''注釈''' することで 
    43 情報を変更することができます。つまり、チケットへの更新やコメントは、 
    44 チケットそのものの一部として記録されます。 
     43すでに [#edit-permissions 上記] で説明しているように、適切な権限を持っていれば、Trac にチケットを登録し、いつでも '''注釈''' を編集することができます。 
    4544 
    46 チケットの閲覧画面では、更新履歴は、メインの表示領域の下に表示されます。 
     45その際、変更やチケットへのコメントのような注釈は、チケットそのものの一部として記録されます。チケットの閲覧画面では、更新履歴がメイン表示領域の下部に表示されます。 
    4746 
    48 ''Trac 自身の開発では、チケットのコメントは問題点やタスクについてディスカッションに 
    49 使っています。これによって、設計や実装上の選択の背後にある動機の理解が簡単になり、 
    50 後で思い出しやすくなります。'' 
     47コメントの編集機能 (0.12 以降から) は フォーマットの調整や誤字脱字の修正のような小さな訂正を行うために使用するものであって、大幅な編集を行うものではありません。編集が長くなるような場合は、代わりとなるコメントを新しく追加するべきです。コメントを編集した場合、新しくコメントを記入した際や何か変更を行ったときのように [/timeline] に通知されることはありません。 
    5148 
    52 '''Note:''' チケットの説明や、コメントでは、 TracLinks と WikiFormatting を 
    53 使用することができます。これは重要な機能です。 TracLinks によって、 
    54 他の課題や、チェンジセット、ファイルへのリンクをチケットに設定できるので、 
    55 チケットを明確にしたり、理解しやすくしたりできます。 
     49すべての編集(フィールドの変更、コメントの追加、コメントの編集)において、チケットの "最終更新" 時間が更新されます。 
    5650 
    57 '''Note:''' チケットの更新を email で通知する設定をする方法は TracNotification に記述しています。 
    5851 
    59 '''Note:''' ステータスの遷移 (チケットのライフサイクル) をカスタマイズする方法は TracWorkflow に記述しています。 
     52'''Notes:'''  
     53 - 重要な特性として、チケットの説明やコメントでは TracLinks と WikiFormatting が使用できます。 TracLinks を用いて、他の課題やチェンジセット、ファイルを関連付けて、より明確で簡単に理解できるようにチケットを作成してください。 
     54 
     55 - チケットの変更を E メールで通知する設定方法に関しては TracNotification をご覧ください。 
     56 
     57 - チケットの状態遷移(ライフサイクル)とワークフローのカスタマイズ方法に関する情報は、 TracWorkflow をご覧ください。 
    6058 
    6159== ドロップダウン形式の属性のデフォルト値 == #DefaultValuesforDrop-DownFields 
    6260 
    6361ドロップダウン形式のチケット属性では、デフォルトで選択される値を [wiki:TracIni trac.ini] の `[ticket]` セクションで指定できます: 
    64  
    65  
    66  
    6762 
    6863 * `default_component`: デフォルトで選択されているコンポーネント名 
     
    7267 * `default_type`: デフォルトのチケットの分類 
    7368 * `default_version`: デフォルトのバージョン 
     69 * `default_owner`: デフォルトの担当者。 もし "< default >" (デフォルトの値)と設定された場合、コンポーネントの担当者が使用されます 
    7470 
    75 これらのオプションで指定されていない属性のデフォルト値はリストの先頭の値、もしくは空白になります。どちらになるかはチケット属性が NULL 値を許容するかに依存します 
     71これらのオプションが設定されていない場合、デフォルト値はリストの 1 番目の項目になるか、空の値が使用されます。これは、問題となるフィールドが必須項目かどうかで異なります。これらのオプションのいくつかは、 [trac:WebAdmin WebAdmin] プラグインの "チケットシステム" セクションを通じて選択できます (その他のものは、 "trac.ini" の [wiki:TracIni#ticket-section|"[ticket]"] セクションで設定できます)  
    7672 
    7773 
     
    8985ドロップダウンリストに表示されるために、ユーザはプロジェクトに登録する必要があります。 ''例として'' ユーザのセッション情報がデータベースの中に存在すべきことがあげられます。セッション情報はユーザがそのプロジェクトで最初にデータベースを更新したときに自動的に生成されます。例えば、 ''ユーザ設定'' のページでユーザの詳細情報を編集したときや、認証ユーザがログインしたときなどです。また、ユーザは `TICKET_MODIFY` [TracPermissions パーミッション] が必要です。 
    9086 
    91 '''Note:''' [http://pacopablo.com/wiki/pacopablo/blog/set-assign-to-drop-down ドロップダウンリストにアサインを載せる] に、データベースのレベルで、ユーザのエントリを追加する方法が記載されています。 
     87'''Notes:'''  
     88 - [http://pacopablo.com/wiki/pacopablo/blog/set-assign-to-drop-down ドロップダウンリストにアサインを載せる] に、データベースのレベルで、ユーザのエントリを追加する方法が記載されています。 
    9289 
    93 '''Note 2:''' If you need serious flexibility and aren't afraid of a little plugin coding of your own, see [http://trac-hacks.org/wiki/FlexibleAssignToPlugin FlexibleAssignTo] (disclosure: I'm the author) 
     90 - 柔軟性が必要で、自分自身でコーディングをすることをいとわないならば、 [http://trac-hacks.org/wiki/FlexibleAssignToPlugin FlexibleAssignTo] を参照してみてください。 (ネタばれ: 私が作者です) 
     91 
     92 - このオプションを有効にするとパフォーマンスが低下する原因となるかもしれません。 [trac:TracPerformance#Configuration Trac の性能] にさらに詳しい情報があります。 
    9493 
    9594== 新規チケット登録時に、 URL で値を設定する == #PresetValuesforNewTickets 
    9695 
    97 値が設定されたチケット登録フォームへのリンクを作成するには、 /newticket? に続いて、 パラメータ=値 を & でつないだ形式の URL を呼び出します。 
     96値が設定されたチケット登録フォームへのリンクを作成するには、 `/newticket?` に続いて、 `パラメータ=値` を `&` でつないだ形式の URL を呼び出します。 
    9897 
    9998値を設定できるパラメータ: 
    10099 
    101  * '''type''' - 分類のドロップダウンリスト 
    102  * '''reporter''' - 報告者の名前 
    103  * '''summary''' - チケットの概要 
    104  * '''description''' - チケットの完全な説明 
    105  * '''component''' - コンポーネント 
    106  * '''version''' - バージョン 
    107  * '''severity''' - 重要度 
    108  * '''keywords''' - キーワード 
    109  * '''priority''' - 優先度 
    110  * '''milestone''' - マイルストーン 
    111  * '''owner''' - チケットを解決できそうな人 
    112  * '''cc''' - チケットが更新されたときに email で通知する人のリスト。 
     100 * '''type''' — ドロップダウンリストのタイプ 
     101 * '''reporter''' 報告者の名前 
     102 * '''summary''' チケットの概要 
     103 * '''description''' チケットの完全な説明 
     104 * '''component''' コンポーネント 
     105 * '''version''' バージョン 
     106 * '''severity''' 重要度 
     107 * '''keywords''' — キーワード  
     108 * '''priority''' 優先度 
     109 * '''milestone''' マイルストーン 
     110 * '''owner''' チケットを解決できそうな人 
     111 * '''cc''' チケットが更新されたときに email で通知する人のリスト。 
    113112 
    114 '''例:''' ''/trac/newticket?summary=Compile%20Error&version=1.0&component=gui''[[BR]] 
     113例: ''`[/newticket?summary=Compile%20Error&version=1.0&component=gui]`''[[BR]] 
    115114 
    116115----