Show page source of TicketAdmin #31762

[[PageNavi(NavigationList)]]

= チケット管理者ガイド =

!SourceForge.JPで提供している「チケット」機能の管理者向けのガイドです。
主にプロジェクト管理者、チケット機能管理者、チケット担当者がチケット機能の管理を
行うために知っておきたいこと/知っていると便利なことに関して書かれています。

チケットの登録やチケットを使った日々のやりとりに関しては
[TicketUser チケットの使い方]を参照してください。

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

== チケット機能を有効にする ==

プロジェクトページ上部にあるプロジェクトメニューに「チケット」のタブがない場合は、
チケットの機能が有効になっていません。

「管理」タブ(※プロジェクト管理者のみ利用可能なタブです)のメニューから「プロジェクト情報変更」を
選択してプロジェクト情報変更画面を表示してください。

「利用する機能」に「チケット」の項目がありますので、チェックをつけて更新ボタンを押してください。

「チケット」の機能は「トラッカー」との排他利用になっています。トラッカーを有効にしている場合は
チケット機能を有効にできません。トラッカーの機能のチェックをはずしてから、チケットにチェックを
つけましょう。

トラッカーからチケットへの移行に関しては、トラッカーからの移行を参照してください。

== チケットシステムに関する権限 ==

「チケット」機能が有効になっていると、「管理」の「メンバー権限の設定」から
各プロジェクトメンバーのチケットに関する権限の調整ができるようになります。

チケットシステムに関する権限は2種類(特に権限を与えない場合を含めると3種類)
あります。一人の人に両方を重複して設定することも可能です(一人の人が、
「チケット管理者」でかつ「チケット担当者」であるという設定も可能です)

「チケット管理者」権限は、そのプロジェクトのチケットシステムの管理全般が
行えるようになります。例えば以下で述べるチケットシステムの設定、マイルストーンや
チケットの種類/コンポーネントの追加や削除、チケットそのものの削除等ができます。

「チケット担当者」権限は、個々のチケットをメインで担当する可能性のある人を
設定します。この権限があると、プロジェクトの任意のチケットに対して、マイルストーンや
種類などの属性、担当者の変更やチケットの完了の操作を行えるようになります。


== チケットシステムの設定 ==

チケットシステムの全体設定は、チケットメニューの「管理」から行います。

チケットシステムの設定ページで設定できる項目は以下になります。

=== 匿名投稿の許可 ===

非ログインユーザによる「新規チケット登録」およびチケットへの
「コメント書き込み」を許可するかどうかを設定します。

チェックをはずして更新を行うと非ログインユーザによるチケット登録/チケットへの
コメントの書き込みができなくなります。

非ログインユーザからの書き込みはバグ報告や要望を広く吸い上げるという意味では
有効な手段ではありますが、書き込みの本人が特定できなかったり、(スパムを
受けないようにフィルタは実装されてはいますが100%完全にフィルタすることは
不可能ですので)コメントスパムが投稿されたりする可能性もあります。

状況によって使い分けてください。

=== チケット新規作成/コメント投稿/属性修正時メール送信先 ===

チケットの新規登録やコメントの投稿、変更があった場合にチケットを登録した人や
チケットの担当者には変更内容を記載したメールが送信されます。

それ以外にプロジェクトのメンバーにも同様のメールが送信されるように設定することが
できます。設定できるのは以下の5種類のうち一つです。

 * メールの送信は行わない
 * 「チケット担当者」権限を設定されているプロジェクトメンバー全員に送信する
 * 「チケット管理者」権限を設定されているプロジェクトメンバー全員に送信する
 * 「チケット管理者」権限もしくは「チケット管理者」を設定されているプロジェクトメンバー全員に送信する
 * プロジェクトメンバー全員にメールを送信する。

なお、以上の条件やチケットの担当者/投稿者など複数の条件にあてはまるような人に
対しても、メールは一通しか送られません(複数条件に合致したことで、同じメールが
複数送信されるようなことはありません)

=== ファイルリリースとの同期 ===

「ファイルリリース」機能を利用している場合(プロジェクトメニューに「ダウンロード」タブが
表示されていれば、ファイルリリースが有効になっています)、ファイルリリースでリリースした
ものに対して、自動的にチケットの「コンポーネント」が登録されるように設定しておくことが
できます。

プロジェクトからリリースしたものに対して、バグレポートなどを受け付ける場合、どの
パッケージのどのバージョンのリリースか? といったことを報告してもらいたい場合が多いと
思います。そのためにはチケットの「コンポーネント」の属性を使って、管理を行うことになりますが、
その項目監理の一部を自動で更新してくれる機能になります。

以下、ファイルリリースに以下のようなパッケージ/リリースが登録されている状態を例に説明します。

 * パッケージ「foo」に リリース「1.0」「1.1」「1.2」が登録されています
 * パッケージ「bar」に リリース「0.9」「1.0」「2.0」「3.0」が登録されています
 * パッケージ「baz」に リリース「0.1」が登録されています

==== チケットの自動取り込みをしない ====

自動取り込みの設定をしていない場合は、特に自動でコンポーネントが作成されることは
ありません。

すべて一つずつ手でコンポーネントを登録することになります。

==== ファイルリリースのパッケージ名をコンポーネントとして自動登録する ====

ファイルリリースのパッケージ名がコンポーネントとして登録されます。

最初の例の場合、コンポーネントとして「foo」「bar」「baz」というコンポーネントが
自動的に登録されることになります。

この状態で、ファイルリリースに新たに

 * パッケージ「foo」リリース「1.3」
 * パッケージ「hoge」リリース「0.1」

の2つが登録されると、さらにコンポーネントに「hoge」が追加されます。

==== ファイルリリースのリリース名をコンポーネントとして自動登録する ====

ファイルリリースのリリース名がコンポーネントとして登録されます。

最初の例の場合、コンポーネントとして「0.1」「0.9」「1.0」「1.1」「1.2」「2.0」「3.0」
が自動的に登録されます。

この状態で、ファイルリリースに新たに

 * パッケージ「foo」リリース「1.3」
 * パッケージ「hoge」リリース「0.1」

の2つが登録されると、さらにコンポーネントに「1.3」が追加されます。

==== ファイルリリースのパッケージ名+リリース名をコンポーネントとして自動登録する ====

ファイルリリースのパッケージ名とリリース名の組がコンポーネントとして登録されます。

この例の場合、コンポーネントとして「foo 1.0」「foo 1.1」「foo 1.2」「bar 0.9」「bar 1.0」
「bar 2.0」「bar 3.0」「baz 0.1」が自動的に登録されます。

この状態で、ファイルリリースに新たに

 * パッケージ「foo」リリース「1.3」
 * パッケージ「hoge」リリース「0.1」

の2つが登録されると、さらにコンポーネントに「foo 1.3」と「hoge 0.1」が追加されます。

==== ファイルリリースの変更と完全に同期する ====

「ファイルリリースの変更と完全に同期する」にチェックをつけていない場合は、
ファイルリリースでの新規追加時にチケット側のコンポーネントへの追加は行われますが、
ファイルリリースで削除を行っても、コンポーネント側では削除が行われません。

同期設定を行った上で「ファイルリリースの変更と完全に同期する」にチェックをつけて
おくと、コンポーネントの削除も自動的に行われるようになります(ただし、この場合
ファイルリリースに関連して登録したコンポーネントを手動で削除することはできなく
なります)。

==== その他の注意 ====

自動登録を有効にしている場合でも、その他のコンポーネントを手動で登録することができます。
完全同期している場合でも、手動登録は有効です。

自動登録を解除しても、それ以前に自動登録されたコンポーネントは有効なままです
(自動的に削除されることはありません)。

コンポーネント管理の手間を省くには「ファイルリリースのパッケージ名とリリース名を
コンポーネントとして自動登録する」を設定した上で、「ファイルリリースの変更と
完全に同期する」を有効にしておく設定がオススメです。

== マイルストーンの管理 ==

チケットには「マイルストーン」という属性を設定することができます。

この属性は例えば

 * バージョン2.0を出すまでにやらなければいけないチケットはこれだ!
 * 来月の15日〜30日までバグ修正強化期間にしよう、そのときに修正するべきチケットをまとめておこう

といったように、「ある程度の作業区切りにチケットを分類したい場合」や
「チケットの処理に開始日や締切りを設定したい場合」に利用する属性になります。

マイルストーンの登録/確認はチケットメニューの「マイルストーン一覧」から行います。

マイルストーンの登録/編集/削除は「チケット管理者」権限を持っているプロジェクトメンバーのみが
行えます。それ以外のユーザはマイルストーンの情報の詳細を閲覧できます。

マイルストーンの詳細ページから、マイルストーンに結びつけられたチケットの状態から自動的に
割り出されたマイルストーンの進捗度合いや、担当者やチケットの種類、優先度、コンポーネント、
重要度別のオープンチケット/完了チケットの状況などを見ることができるようになっています。


=== マイルストーンの新規登録 ===

ディフォルトではマイルストーンは登録されていません。マイルストーンの新規作成で登録を
行います。

==== マイルストーンの概要 ====

「マイルストーンの概要」はマイルストーンの名前として表示される短い単語/文を登録します。
この文字列が、マイルストーン一覧での表示やチケットの属性を設定する選択項目として表示
されます。入力は必須になっています。

==== スケジュール ====

スケジュールにはマイルストーンの開始日/終了日を入力してください。

日付のフォーマットは 2009-08-23 のように 年4桁、月2桁、日2桁をハイフンで
区切った形式になります(時刻は指定できません)。Javascriptを無効にしていなければ、
入力フォームをクリックすることでカレンダーが表示されますので、そこから選択すれば
その日付が入力されます。

また、スケジュールは設定を省略することもできます。その場合には開始日はマイルストーンを
作成した時点、終了日は設定なし(締切りなし)がセットされます。

開始日、および終了日には自動的に開始/終了の処理がされます。この際、プロジェクトメンバー
全員にマイルストーンの開始/終了を知らせるメールが送信されます。


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

そのマイルストーンがどんなマイルストーンなのか、詳細説明を記述してください。
Wiki フォーマットの文法が使用できます。


=== マイルストーンの編集 ===

マイルストーンの「概要」や「詳細」を修正したい、あるいは「締切りや開始日を
変更したい」「もう、このマイルストーンは完了してるので完了にしてしまいたい」
といった修正を行う場合は、各マイルストーンの詳細ページにある編集ボタンから
編集画面を開いて修正を行ってください。

==== マイルストーンを完了にする ====

オープンなマイルストーンの場合、その時点でマイルストーンを完了にすることが
できます(締切り前でも完了にします)。

ここで手動で完了処理を行う場合、その時点で該当マイルストーンに残っている
オープンチケットを別のマイルストーンに移すことができます(あるいは、それらの
チケットのマイルストーン属性自体を未設定とすることもできます)。

完了にするにチェックをつけると、そのマイルストーンにオープンチケットが残っている
場合は、移動先のマイルストーンが選択できるようになるので、そこから移動先の
マイルストーンを選択してください。

==== 終了したマイルストーンを再度有効にする ====

終了したマイルストーンをなんらかの理由により再度オープンにしたいことがある
かもしれません。

チケット管理者でマイルストーン一覧を見ると、右上に「終了したマイルストーンも
表示する」というチェックボックスが表示されていると思います。ここにチェックをつけると
一覧に完了済みのマイルストーンも表示されます(表中で赤く表示されているものが
完了済みのマイルストーンです)。

該当するマイルストーンの詳細を表示して、編集ボタンを押し編集画面に行き
マイルストーンを再度有効にすることができます。

マイルストーンを再度有効にするには、スケジュールの欄の「再度オープンにする」に
チェックをつけて、適用ボタンを押してください。

この時、もし締切り日が設定されている場合は締切り日が今日以降になる(あるいは、
空欄にして締切りを設定しないようにする)ように調整しておいてください。
今日以前の日付のまま 再度有効にした場合、直後の定時処理で再び自動的に
マイルストーンが完了にされてしまいます。

=== マイルストーンの削除 ===

不要になったマイルストーンは削除することができます。削除してしまうと、
元に戻す方法はありませんので注意してください。

マイルストーンの削除は、編集同様マイルストーンの詳細画面から行うことができます。

削除ボタンを押すと、削除の確認画面が出ますので 本当に削除する場合は
「はい、削除します」ボタンをおしてください。

この際に、削除されるマイルストーンに残っているオープンチケットを別の
マイルストーン(あるいは、未設定)に移行することができます。

編集の場合と同様、移行先を選択してから「はい、削除します」をクリック
してください。

=== タスクからのデータ移行 ===

タスク機能を有効にしている場合、タスクからチケットマイルストーンへの移行を
行うために、タスクのデータをマイルストーンのデータとして取り込む機能が
提供されています。

タスクからは、「サマリ」「詳細」「開始日」「終了日」「登録者」のデータのみが
移行されて、対応するマイルストーンが新たに作成されます。

移行が行われるのは「公開サブプロジェクト」の「オープンなタスク」のみです。
(非公開なサブプロジェクトやすでにクローズされているタスクの情報は移行
されません)。

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

== チケットコンポーネントの管理 ==

== チケットの管理 ==

== トラッカーからの移行 ==

[[PageNavi(NavigationList)]]