Show page source of TicketUser #31957

[[PageNavi(NavigationList)]]

= チケットの使い方 =

!SourceForge.JPで提供している「チケット」機能を利用するためのガイドです。

チケットシステムを管理する管理者や担当者向けの情報は
[TicketAdmin チケット管理者ガイド]を参照してください。

問題点や要望などがありましたら、
[https://sourceforge.jp/projects/sourceforge/ticket/ チケット]
を利用して報告をお願いします。

== チケットってなに? ==

オープンソースプロジェクトに参加している/オープンソースプロジェクトの成果を
利用していると...

 * こんなバグがありました
 * こんなことをしないといけないね(例えば、次のリリースまでに)
 * こんな機能がほしい
 * ここの機能がよくわからないんだけど、教えて
 * こんなパッチはどうかな?
 * ここをこういう風に仕様変更しようと思うけど、どうだろう?

といった「誰かがなにかしないといけない/誰かがなにかをすること」がたくさん
発生すると思います。

チケットシステムでは、そういった「誰かがなにかをしないといけないこと/誰かがなにかを
すること」を「チケット」という形で登録して、その処置の過程を記録/追跡したり、
その情報を検索できるようにするシステムです。

== チケットの一覧/検索 ==

チケットシステムが有効にされているプロジェクトでは、各プロジェクトのメニューに
「チケット」とかかれたタブが表示されていると思います。ここをクリックすることで、
各プロジェクトのチケットシステムにアクセスできます。

チケットシステムにアクセスするとチケットの一覧が表示されます。
特にユーザ設定を変更していない場合(ユーザ設定に関してはユーザ設定の項目を
参照してください)、状況がオープンなチケットの一覧が表示されていると思います。

=== チケットの一覧 ===

まず、表示されているチケットの一覧を見てみましょう。

チケットにはいくつかの属性がセットされています。ディフォルトでは、一覧には
それらの属性のうち「チケットID」「チケットの概要」「担当者」「マイルストーン」
「優先度」が表示されます。

項目が多い場合は、一定件数(ディフォルトは100件になっています。ユーザ設定で
変更可能です)ごとにページ分割して表示されていると思います。複数ページに
分割されている場合は、表の上に前ページ/次ページに移動するための矢印リンク
および 対応する各ページに直接移動するためのリンクが表示されます。

一覧の右上にある「一覧表示項目」の選択をクリックすると、チケットの属性に対応
したチェックボックスのリストが表示されます。これらのチェックボックスに
チェックをつける/はずすことで、一覧に表示する項目を選択することもできます。

ここでの変更は、チケットシステム以外のページに移動してしまうとクリアされて
しまう(表示項目がもとに戻ってしまう)ことに注意してください。

!SourceForge.JPアカウントでログインしている場合は、チケットメニューの
「ユーザ設定」からディフォルトの表示項目を調整することもできます。
「ユーザ設定」から設定したものは、DB上に記録されますので別ページに
移動したりした場合でも戻ってしまうことはありません。ユーザ設定の
詳細に関しては、ユーザ設定の項目を参照してください。

チケットは優先度/IDで降順にソートされて表示されます。また、各項目は
優先度に応じて色付けされて表示されます。

一覧の表の項目名(IDや概要、優先度などと表示されている部分)をクリックする
ことで、各項目の値でソートしなおすこともできます。Shift キーをおしながら
クリックすることで、複数項目を利用したソートも可能です。例えば、マイルストーンで
ソートして、さらにソートされたものを優先度でソートしたい場合は、Shiftキーを
おしたまま、マイルストーン、優先度 の順でクリックします。

個々のチケットの「ID」もしくは「概要」のリンクをクリックすると、各チケットの
詳細を表示します。

=== チケットの検索 ===

例えば「自分が担当してるチケットだけを表示したいんだけど」とか「優先度が
低いチケットはとりあえず表示したくない」とか「XXX機能に関係するチケット
ないかな、概要にXXX機能って書いてあるチケットを探そう」など、
様々な条件でチケットの絞り込みがしたくなることがあると思います。

そういった場合には、チケットの検索機能を利用しましょう。

チケットの検索は、一覧表示の上部にある「検索条件」BOXで検索条件を
指定して行います。

=== 検索条件の追加 ===

例として、担当者で絞り込みを行ってみましょう。

検索条件を追加する場合は、「検索条件の追加」から追加する条件に
あった項目を選択します。まず、ここでは「担当者」を選択します。

すると、その条件を指定するため項目が上部に追加されます。

担当者というラベルがついた項目が表示され、そこには「条件」と
「検索する値」を選択する2つのセレクタブルタブが表示されます。
また、その項目の一番右には - がついたボタンが表示されている
と思います。

担当者の場合(他には、「チケットの種類」「コンポーネント」
「マイルストーン」「報告者」「解決法」の場合も同様ですが)
条件には「が次と等しい」もしくは「が次と等しくない」が選択できる
ようになっていると思います。

また、検索する値には担当者名が並んでいると思います。このうち
「(未割り当て)」となっているものは、担当者がまだ指定されていない
チケットを示すときに使用します。

例えば、「担当者が ishikawa である」チケットを検索したい場合は
条件を「が次と等しい」にして値から「ishikawa」を選びます。

この状態で、検索ボタンをおすと「担当者が ishikawa である」チケットが
一覧されます。

「優先度」、「重要度」を選択した場合は検索の条件として、値が等しい、
等しくない以外に「以上」「以下」「未満」「より大きい」が指定できます。

また、「概要」「詳細」「コメント」に関しては、それぞれに「ある文字列が
含まれる/含まない」「で始まる/終わる」「と一致する/一致しない」という
条件で検索ができます。


==== 同一項目複数指定 ====

一つの項目に対して、複数の値を指定することができます。

前述の例のように「担当者」の項目が追加されている状態で、さらに検索条件の
追加から「担当者」を選択します。すると または というラベルと「条件の値」を
選択できる条件指定項目が上部に追加されます。

追加された条件は同一項目の検索に付随する「OR 条件」になります。

これを用いると「担当者が ishikawa もしくは hogehogeである」チケットを
一覧したり「担当者が ishikawa もしくは huga ではない」チケットを一覧
することが可能になります。

==== 複数条件指定 ====

検索項目は複数指定することが可能です。例えば、「担当者が hogehoge」
で かつ 「マイルストーンが foo」であるチケットを一覧することなどが
できます。

この例の場合は検索条件の追加から「担当者」を選択したあと、
同じく検索条件の追加から「マイルストーン」を選んで検索条件を
指定します。

複数の条件項目を指定した場合、それらはすべて「AND 条件」で指定
されます。

==== 検索条件の削除 ====

誤って検索条件を追加してしまったような場合は、それぞれの項目の右端に
ある「 - 」がかかれたボタンを押すと、その項目が削除されます。

==== 属性の値ごとまとめて表示 ====

この指定は、厳密には検索条件ではなく、検索結果の表示の仕方に影響します。

通常一覧表示では、チケットの属性にかかわらず件数ごとにまとめられて
一覧が表示されます。これを属性の値ごとにまとめて表示することができます。

例えば、検索条件を指定して出てきた結果を「チケットの種類」ごと分類して
表示して見たい場合があると思います。

こういった場合「属性の値ごとまとめて表示」で「チケットの種類」を指定すると
例えば「チケットの種類」が「バグ」のもの、「サポートリクエスト」、「機能リクエスト」
など種類毎にわけられた上で、ソートされて表示されます(件数が多い場合は、各種類毎で
件数ごと複数にわけられて表示します)。

属性の値ごとまとめて表示する条件はユーザ設定であらかじめ指定しておくことも
できます。

==== まとめ と 注意点 ====

検索条件指定に関するまとめです。

 * 検索条件の指定は一覧上部の「検索条件」で行います
 * 検索条件の追加は、「検索条件の追加」から検索項目を選んで行います
 * 検索項目が追加されたら、条件と値を指定します
 * 同一の検索項目を複数指定することもできます。その場合は複数指定されているものは「OR 条件」として処理されます。
 * 複数の異なった検索条件(例えば、「担当者」と「マイルストーン」など)を指定することもできます。この場合は、各条件は「AND 条件」として処理されます。
 * 検索結果は、指定した属性の値ごとまとめて表示するように指定することもできます

== チケットの詳細を表示する ==


=== チケットの属性 ====

==== チケット番号 ====

==== 概要 ====

==== 登録時刻 ====

==== 最終更新時刻 ====

==== 報告者 ====

==== 担当者 ====

==== 優先度 ====

==== チケットの種類 ====

==== マイルストーン ====

==== コンポーネント ====

==== 状況 ====

==== 解決法 ====

==== 詳細 ====

=== チケットの履歴 ===

== チケットにコメントする ==

== チケットにファイルを添付 ==

== チケットの表示設定 ==

== チケットを登録する ==

== チケットの変更を追跡する ==

=== RSS ===

=== モニタ ===

== マイルストーン一覧 ==
== チケットの種類一覧 ==
== コンポーネント一覧 ==
== よく使われるチケット一覧/RSSリスト ==

[[PageNavi(NavigationList)]]