Changes between Version 2 and Version 3 of TracTickets


Ignore:
Timestamp:
Jun 17, 2013, 1:35:49 PM (11 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracTickets

    v2 v3  
    66Trac のプロジェクト管理機能の中枢である、チケットシステムは、 '''プロジェクトのタスク管理''', '''機能追加のリクエスト''', '''バグレポート''', '''ソフトウェアサポートの課題''' などに使用できます。
    77
    8 このサブシステムは TracWiki のように、ユーザのコントリビュートと参加をできるだけ簡単にするという目標で設計しています。バグを報告して、質問して、改良を提案するのはできるだけ簡単であるべきです。
     8このサブシステムは TracWiki のように、ユーザのコントリビュートと参加をできるだけ簡単にするという目標で設計しています。バグの報告や質問、改良の提案、決議に関する議論は簡単であるべきです。
    99
    1010チケットは、それを解決しなければならない人にすでにアサインされているか、あるいは解決可能な人に再アサインされます。
    1111すべてのチケットは、いつでも、編集したり、注釈をしたり、アサインしたり、優先付けしたり、議論したりできます。
    1212
     13[=#edit-permissions]
     14しかしながら、Trac の設定において 個人が変更できる箇所に制限を加える場合があります。例えばデフォルトの設定では、認証していないユーザ("anonymous" ユーザ)に対して変更やコメントを許可しないことで、明らかなスパム行為を予防しています。ローカル貢献ポリシーを確認してください。通常はフロントページである WikiStart で見つけることが出来ます。また、使用している Trac の管理者にお問い合わせください。
     15
    1316== チケット属性 == #TicketFields
    1417
    1518チケットは、以下の情報を属性として含んでいます:
    16  
    17  * '''報告者 (Reporter)''' — チケットの作成者
    18  * '''分類 (Type)''' — チケットの本質 (例えば、不具合 (defect), 機能追加 (enhancement request) など)
    1919
    20  * '''コンポーネント (Component)''' — チケットが適用されるモジュールやサブシステム。
    21  * ''''バージョン (Version)''' — チケットが適用されるバージョン。
    22  * '''キーワード (Keywords)''' — チケットに付与するキーワード。検索や、レポートの生成で使用する。
     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 が適用されます
    2333
    24  * '''優先度 (Priority)''' — ''trivial'' から ''blocker'' の範囲で示されるチケットの重要性。
    25  * '''マイルストーン (Milestone)''' — このチケットが少なくとも、いつまでに解決されなければならないか。
    26  * '''担当者 (Assigned to/Owner)''' — チケットの扱いに責任を持つ主たる人。
    27  * '''関係者 (Cc)''' — チケットに関係がある人または通知メール用の E-mail アドレスのカンマ区切りのリスト。 ''これは責任もいかなるポリシも意味していないことを注記しておく。''
    28  
    29  * '''解決方法 (Resolution)''' — チケットが解決された際の理由。{{{修正した(fixed)}}}、{{{無効なチケット(invalid)}}}、{{{修正しない(wontfix)}}}、{{{他のチケットと重複(duplicate)}}}、{{{再現しない(worksforme)}}}など。
    30  * '''ステータス (Status)''' — チケットの現在の状態。 {{{new}}}, {{{assigned}}}, {{{closed}}}, {{{reopened}}} のいずれか
    31  * '''概要 (Summary)''' — 問題点や、チケットについての簡単な説明。タイトル。
    32  * '''説明 (Description)''' — チケットの内容。 特定された状況について、詳しく記述され、的を絞った良い説明文を書いてください。
     34'''Notes:'''
     35 - バージョン 0.9 以前の Trac では ''分類 (Type)'' 属性がありませんでしたが、代わりに ''重要度 (Severity)'' 属性が提供されており、 ''優先度 (Priority)'' 属性のデフォルトの値も異なっていました。この変更を行ったのは、やや不鮮明な ''優先度 (Priority)'' と ''重要度 (Severity)'' の区別を排除し、チケットモデルを簡素化するためです。しかしながら以前のチケットモデルも利用可能です: 単に ''優先度 (Priority)'' と ''重要度 (Severity)'' のデフォルトの値を追加/変更し、必要なら ''分類 (Type)'' 属性の全ての値を削除してください。これらは [wiki:TracAdmin trac-admin] コマンドで出来ます
    3336
    34 '''Note:''' バージョン 0.9 以前の Trac では ''分類 (Type)'' 属性がありませんでしたが、代わりに ''重要度 (Severity)'' 属性が提供されており、 ''優先度 (Priority)'' 属性のデフォルトの値も異なっていました。この変更を行ったのは、やや不鮮明な ''優先度 (Priority)'' と ''重要度 (Severity)'' の区別を排除し、チケットモデルを簡素化するためです。しかしながら以前のチケットモデルも利用可能です: 単に ''優先度 (Priority)'' と ''重要度 (Severity)'' のデフォルトの値を追加/変更し、必要なら ''分類 (Type)'' 属性の全ての値を削除してください。これらは [wiki:TracAdmin trac-admin] コマンドで出来ます。
     37 - [trac:TicketTypes 分類 (type)], [trac:TicketComponent コンポーネント (component)], バージョン (version), 優先度 (priority), 重要度 (severity) の各フィールドは [wiki:TracAdmin trac-admin] か [trac:WebAdmin WebAdmin プラグイン] を用いて管理することができます
    3538
    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)'' のデフォルト値についての説明は [trac:TicketTypes#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
    … …  
    6967 * `default_type`: デフォルトのチケットの分類
    7068 * `default_version`: デフォルトのバージョン
    71  * `default_owner`: デフォルトの担当者 ( ''コンポーネントの担当者が設定されていない場合に使用'' )
     69 * `default_owner`: デフォルトの担当者。 もし "< default >" (デフォルトの値)と設定された場合、コンポーネントの担当者が使用されます
    7270
    73 これらのオプションが設定されていない場合、デフォルト値はリストの 1 番目の項目になるか、空の値が使用されます。これは、問題となるフィールドが必須項目かどうかで異なります。これらのオプションのいくつかは、 [trac:WebAdmin WebAdmin] プラグインの "チケットシステム" セクションを通じて選択できます (その他のものは、 "trac.ini" セクションで設定できます) 。チケットのデフォルトの担当者はコンポーネントの担当者になります。もしチケットの担当者が設定されなかったら、 コンポーネントの担当者または `default_owner` が使用されます。
     71これらのオプションが設定されていない場合、デフォルト値はリストの 1 番目の項目になるか、空の値が使用されます。これは、問題となるフィールドが必須項目かどうかで異なります。これらのオプションのいくつかは、 [trac:WebAdmin WebAdmin] プラグインの "チケットシステム" セクションを通じて選択できます (その他のものは、 "trac.ini" の [wiki:TracIni#ticket-section|"[ticket]"] セクションで設定できます) 。
    7472
    7573
    … …  
    8785ドロップダウンリストに表示されるために、ユーザはプロジェクトに登録する必要があります。 ''例として'' ユーザのセッション情報がデータベースの中に存在すべきことがあげられます。セッション情報はユーザがそのプロジェクトで最初にデータベースを更新したときに自動的に生成されます。例えば、 ''ユーザ設定'' のページでユーザの詳細情報を編集したときや、認証ユーザがログインしたときなどです。また、ユーザは `TICKET_MODIFY` [TracPermissions パーミッション] が必要です。
    8886
    89 '''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 ドロップダウンリストにアサインを載せる] に、データベースのレベルで、ユーザのエントリを追加する方法が記載されています
    9089
    91 '''Note 2:''' 柔軟性が必要で、自分自身でコーディングをすることをいとわないならば、 [http://trac-hacks.org/wiki/FlexibleAssignToPlugin FlexibleAssignTo] を参照してみてください。 (ネタばれ: 私が作者です)
     90 - 柔軟性が必要で、自分自身でコーディングをすることをいとわないならば、 [http://trac-hacks.org/wiki/FlexibleAssignToPlugin FlexibleAssignTo] を参照してみてください (ネタばれ: 私が作者です)
    9291
    93 '''Note 3:''' このオプションを有効にするとパフォーマンスが低下する原因となるかもしれません。 [trac:TracPerformance#Configuration Trac の性能] にさらに詳しい情報があります。
     92 - このオプションを有効にするとパフォーマンスが低下する原因となるかもしれません。 [trac:TracPerformance#Configuration Trac の性能] にさらに詳しい情報があります
    9493
    9594== 新規チケット登録時に、 URL で値を設定する == #PresetValuesforNewTickets
    9695
    97 値が設定されたチケット登録フォームへのリンクを作成するには、 /newticket? に続いて、 パラメータ=値 を & でつないだ形式の URL を呼び出します。
     96値が設定されたチケット登録フォームへのリンクを作成するには、 `/newticket?` に続いて、 `パラメータ=値` を `&` でつないだ形式の URL を呼び出します。
    9897
    9998値を設定できるパラメータ:
    … …  
    106105 * '''version''' — バージョン
    107106 * '''severity''' — 重要度
    108  * '''keywords''' — キーワード 
     107 * '''keywords''' — キーワード
    109108 * '''priority''' — 優先度
    110109 * '''milestone''' — マイルストーン
    111110 * '''owner''' — チケットを解決できそうな人
    112  * '''cc''' — チケットが更新されたときに email で通知する人のリスト。
     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----