SourceForge.JPで提供している「チケット」機能の管理者向けのガイドです。 主にプロジェクト管理者、チケット機能管理者、チケット担当者がチケット機能の管理を 行うために知っておきたいこと/知っていると便利なことに関して書かれています。
チケットの登録やチケットを使った日々のやりとりに関しては チケットの使い方を参照してください。
問題点や要望などがありましたら、 チケット を利用して報告をお願いします。
プロジェクトページ上部にあるプロジェクトメニューに「チケット」のタブがない場合は、 チケットの機能が有効になっていません。
「管理」タブ(※プロジェクト管理者のみ利用可能なタブです)のメニューから「プロジェクト情報変更」を 選択してプロジェクト情報変更画面を表示してください。
「利用する機能」に「チケット」の項目がありますので、チェックをつけて更新ボタンを押してください。
「チケット」の機能は「トラッカー」との排他利用になっています。トラッカーを有効にしている場合は チケット機能を有効にできません。トラッカーの機能のチェックをはずしてから、チケットにチェックを つけましょう。
トラッカーからチケットへの移行に関しては、トラッカーからの移行を参照してください。
「チケット」機能が有効になっていると、「管理」の「メンバー権限の設定」から 各プロジェクトメンバーのチケットに関する権限の調整ができるようになります。
チケットシステムに関する権限は2種類(特に権限を与えない場合を含めると3種類) あります。一人の人に両方を重複して設定することも可能です(一人の人が、 「チケット管理者」でかつ「チケット担当者」であるという設定も可能です)
「チケット管理者」権限は、そのプロジェクトのチケットシステムの管理全般が 行えるようになります。例えば以下で述べるチケットシステムの設定、マイルストーンや チケットの種類/コンポーネントの追加や削除、チケットそのものの削除等ができます。
「チケット担当者」権限は、個々のチケットをメインで担当する可能性のある人を 設定します。この権限があると、プロジェクトの任意のチケットに対して、マイルストーンや 種類などの属性、担当者の変更やチケットの完了の操作を行えるようになります。
チケットシステムの全体設定は、チケットメニューの「管理」から行います。
チケットシステムの設定ページで設定できる項目は以下になります。
非ログインユーザによる「新規チケット登録」およびチケットへの 「コメント書き込み」を許可するかどうかを設定します。
チェックをはずして更新を行うと非ログインユーザによるチケット登録/チケットへの コメントの書き込みができなくなります。
非ログインユーザからの書き込みはバグ報告や要望を広く吸い上げるという意味では 有効な手段ではありますが、書き込みの本人が特定できなかったり、(スパムを 受けないようにフィルタは実装されてはいますが100%完全にフィルタすることは 不可能ですので)コメントスパムが投稿されたりする可能性もあります。
状況によって使い分けてください。
チケットの新規登録やコメントの投稿、変更があった場合にチケットを登録した人や チケットの担当者には変更内容を記載したメールが送信されます。
それ以外にプロジェクトのメンバーにも同様のメールが送信されるように設定することが できます。設定できるのは以下の5種類のうち一つです。
なお、以上の条件やチケットの担当者/投稿者など複数の条件にあてはまるような人に 対しても、メールは一通しか送られません(複数条件に合致したことで、同じメールが 複数送信されるようなことはありません)
「ファイルリリース」機能を利用している場合(プロジェクトメニューに「ダウンロード」タブが 表示されていれば、ファイルリリースが有効になっています)、ファイルリリースでリリースした ものに対して、自動的にチケットの「コンポーネント」が登録されるように設定しておくことが できます。
プロジェクトからリリースしたものに対して、バグレポートなどを受け付ける場合、どの パッケージのどのバージョンのリリースか? といったことを報告してもらいたい場合が多いと 思います。そのためにはチケットの「コンポーネント」の属性を使って、管理を行うことになりますが、 その項目監理の一部を自動で更新してくれる機能になります。
以下、ファイルリリースに以下のようなパッケージ/リリースが登録されている状態を例に説明します。
自動取り込みの設定をしていない場合は、特に自動でコンポーネントが作成されることは ありません。
すべて一つずつ手でコンポーネントを登録することになります。
ファイルリリースのパッケージ名がコンポーネントとして登録されます。
最初の例の場合、コンポーネントとして「foo」「bar」「baz」というコンポーネントが 自動的に登録されることになります。
この状態で、ファイルリリースに新たに
の2つが登録されると、さらにコンポーネントに「hoge」が追加されます。
ファイルリリースのリリース名がコンポーネントとして登録されます。
最初の例の場合、コンポーネントとして「0.1」「0.9」「1.0」「1.1」「1.2」「2.0」「3.0」 が自動的に登録されます。
この状態で、ファイルリリースに新たに
の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」が自動的に登録されます。
この状態で、ファイルリリースに新たに
の2つが登録されると、さらにコンポーネントに「foo 1.3」と「hoge 0.1」が追加されます。
「ファイルリリースの変更と完全に同期する」にチェックをつけていない場合は、 ファイルリリースでの新規追加時にチケット側のコンポーネントへの追加は行われますが、 ファイルリリースで削除を行っても、コンポーネント側では削除が行われません。
同期設定を行った上で「ファイルリリースの変更と完全に同期する」にチェックをつけて おくと、コンポーネントの削除も自動的に行われるようになります(ただし、この場合 ファイルリリースに関連して登録したコンポーネントを手動で削除することはできなく なります)。
自動登録を有効にしている場合でも、その他のコンポーネントを手動で登録することができます。 完全同期している場合でも、手動登録は有効です。
自動登録を解除しても、それ以前に自動登録されたコンポーネントは有効なままです (自動的に削除されることはありません)。
コンポーネント管理の手間を省くには「ファイルリリースのパッケージ名とリリース名を コンポーネントとして自動登録する」を設定した上で、「ファイルリリースの変更と 完全に同期する」を有効にしておく設定がオススメです。