チケットクエリ

レポート に加えて、 Trac は カスタムチケットクエリ があります。 カスタムチケットクエリ は、ある一定の基準を満たすチケットのリストを表示するのに使用されます。

カスタムクエリを設定・実行するために、ナビゲーションバーの チケットを見る (英語版では View tickets) モジュールに切り替え、 カスタムクエリ (英語版では Custom Query) のリンクを選択します。

フィルタ

最初にクエリのページを開くと、デフォルトのフィルタとして、現在未解決のチケットの一覧が表示されます。ログインしているならば、自分が担当者となっていて未解決のチケットが表示されます。現在のフィルタは検索条件の右側にある "-" (マイナス) のラベルのボタンをクリックすることにより削除することができます。新しいフィルタをフィルタボックスの右下にあるプルダウンリストから追加することができます。テキストボックスやオプションのプルダウンメニューのフィルタを or 条件として、いくつでも追加することができます。

フィルタボックスの下のフィールドを使用することによって、結果をフィールドごとにグループ化したり、各チケットの完全な説明を表示することができます。

一度フィルタを編集したら、 更新 (英語版では Update) ボタンで結果を更新することができます。

チケットナビゲーション

クエリの結果の一つをクリックすると、そのチケットが表示されます。メインメニューバーの 次のチケット (英語版では Next Ticket) または 前のチケット (英語版では Previous Ticket) というリンクをクリックすることによって、クエリの結果を行き来することができます。 クエリに戻る (英語版では Back to Query) というリンクをクリックすると、クエリのページに戻ります。

あなたは安全にチケットの編集をすることができ、編集を保存した後に 次のチケット/前のチケット/クエリに戻る の各リンクを使用して、結果を行き来することができます。クエリに戻ったとき、 編集済みのチケット はイタリックのテキストで表示されます。チケットの 1 つが編集され、 クエリの基準を満たさなくなった 場合、テキストはグレーで表示されます。最後に、 クエリの基準を満たす新しいチケットが登録される と、テキストが太字で表示されます。

クエリの結果は 更新 ボタンを押すごとにステータスがクリアされリフレッシュされます。

クエリを保存する

Trac は今のところ、クエリに名前をつけて保存することも、 (訳注: レポート一覧のように) ナビゲート可能なリストを作ることもできませんが、以下に示すように Wiki のコンテンツとしてクエリへの参照を保存できます。

TracLinks を使用する

クエリを保存しておくと、後から保存したクエリを再度実行できます。保存は Wiki ページにクエリへのリンクを作成することで行います。

[query:status=new|assigned|reopened&version=1.0 1.0 での未解決のチケット]

表示内容:

1.0 での未解決のチケット

ここでは、検索内容を特定するとても単純なクエリ言語が使用されています。 (クエリ言語 参照)

あるいは、クエリを実行した画面の URL をコピーし、 ? 以降の文字列 (訳注: URL のパラメータ部) を Wiki リンクに貼り付けることができます:

[query:?status=new&status=assigned&status=reopened&group=owner 担当者別着手済みチケット]

表示内容:

担当者別着手済みチケット

[[TicketQuery]] マクロを使用する

​TicketQuery マクロは条件にマッチするチケットの一覧を表示します。 WikiFormatting が使用できるいずれの場所でも使用できます。

例:

[[TicketQuery(version=0.6|0.7&resolution=duplicate)]]

表示内容:

No results

query: Wiki リンク 同様、このマクロのパラメータは クエリ言語 に規定されるルールに基づいたクエリ文字列で記述しなければなりません。

チケットのサマリを表示しない、よりコンパクトな表示も利用可能です:

[[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]

表示内容:

No results

クエリにマッチした件数だけを取得したいのならば、 count パラメータを使用してください。

[[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]

表示内容:

0

table 形式でカスタマイズする

table 形式 (format=table) では、 col=<field> を使用することで列の表示をカスタマイズすることができます。複数のフィールドを指定したい場合、表示する順に列をパイプ (|) 区切りで指定します:

[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]

以下のように表示されます:

Results (1 - 3 of 780)

1 2 3 4 5 6 7 8 9 10 11 →

Ticket	Resolution	Summary	Owner	Reporter
#780	fixed	ver 3.0.0 メジャーバージョンアップ		yasunaka
#779	fixed	コミットメールの送付先選択の画面でフィルタの操作で選択状態が外れてしまう		yasunaka
#778	fixed	1日の利用ユーザ数の可視化および警告メールの送付		yasunaka

1 2 3 4 5 6 7 8 9 10 11 →

全行表示

table 形式では、以下の例のように rows=<field> を使用することで、全行表示を行うことができます:

[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]

以下のように表示されます:

Results (1 - 3 of 780)

1 2 3 4 5 6 7 8 9 10 11 →

Ticket	Resolution	Summary	Owner	Reporter
#780	fixed	ver 3.0.0 メジャーバージョンアップ		yasunaka
Description	crossnoteのサーバーおよびクライアントのプラットフォームの最新化のため、ver 3.0へのメジャーバージョンアップを行います。今回のバージョンアップではベースソフトの更新を伴うメジャーバージョンアップのため、インストーラーを用いた再インストールが必要です。 クライアント側のバージョンアップのみを行った場合、利用できる新機能に制限があります。詳しくは各新機能についてのチケットをご参照ください。 リリース予定時期：2025年8月末頃 リリース対象モジュール: クライアント(crossnote, admintool, editroom)、サーバー(axis2.war, hive.war, publisher.war, bw_publisher) サーバー側はjava / tomcat / Solrなどのバージョンアップも必要 サーバー側Version up managerによるDBスキーマ変更 ... あり 不具合対応 #779 コミットメールの送付先選択の画面でフィルタの操作で選択状態が外れてしまう 機能改善 #762 crossnoteサーバー/クライアントのプラットフォームの最新化 #763 デフォルトフォントを切り替える機能 #764 巨大なcrossnoteドキュメントをコピーする際、外部に持ち出すかどうかを確認する #765 crossnoteドキュメント中のイメージの元となった図面データへのリンク管理機能 #766 ファイルのバックアップのデータサイズを指定できるようにする #767 ドキュメント構成ファイルエディタの機能改善 #768 ドキュメント構成ファイルの履歴の改善 #769 HTMLレンダリング結果のDark Theme対応 #770 プラグインの自動登録機能 #771 MarkDownファイルのviewer #772 ドキュメント・アウトライン表示機能 #773 ユーザのふりがな対応 #774 ログイン時の2段階認証を毎回確認しないようにする #775 ファイルやフォルダの移動操作の改善 #776 ドキュメント構成ファイルのナンバリング機能の改善 #777 Markdown形式でのエクスポート時にイメージを埋め込み形式で出力できるようにする #778 1日の利用ユーザ数の可視化および警告メールの送付
#779	fixed	コミットメールの送付先選択の画面でフィルタの操作で選択状態が外れてしまう		yasunaka
Description	コミットメールの送付先選択時に上部のフィルタ機能を使って複数ユーザを選択しようとすると、先に選択したユーザが非選択状態になってしまう問題への対応。
#778	fixed	1日の利用ユーザ数の可視化および警告メールの送付		yasunaka
Description	１日の利用ユーザ数の推移を可視化し、ユーザ数が足りているかどうかを判断できるようにする。また超えそうなときに警告メールを送付するようにする。 admintoolの履歴に「ログイン数推移」画面を追加 サーバー、クライアントともver 3.0.0以上の場合のみ表示される 当日ログイン数の推移を線グラフで表示する 過去30日間、過去180日間、過去1年間、過去5年間 対象サービス ... crossnote, HIVE, SHARE ライセンスを保有しているエディション別に表示 縦軸を1日のログイン数、横軸を期間とし、縦軸の最大値をライセンス数とする 警告メール 当日ログイン数の100%に達した日の翌日AM0:00 ... 警告メールを送付する ログインできないユーザが発生したとき ... エラーメールを送付する

1 2 3 4 5 6 7 8 9 10 11 →

クエリ言語

query: TracLinks と [[TicketQuery]] マクロは、いずれもクエリのフィルタを特定するために小さな "クエリ言語" を使用します。基本的に、フィルタはアンパサンド (&) で区切られます。それぞれのフィルタはチケットの各フィールドの名前、オペレータ、1つ以上の値で構成されています。値が複数ある場合はパイプ (|) で区切り、フィルタがいずれかの値にマッチすればいいことを意味しています。

オペレータ一覧:

=	フィールドの内容はいずれかの値と完全に一致する
~=	フィールドの内容は1つ以上の値を含む
!^=	フィールドの内容が値の一つで始まる
$=	フィールドの内容が値の一つで終了する

これらのオペレータは否定の意味があります:

!=	フィールドの内容がいずれの値にも一致しない
!~=	フィールドの内容がいずれの値も含んでいない
!!^=	フィールドの内容がいずれの値でも始まらない
!$=	フィールドの内容がいずれの値でも終わらない

---

See also: TracTickets, TracReports, TracGuide