Changes between Version 1 and Version 2 of TracQuery


Ignore:
Timestamp:
May 13, 2012, 9:15:45 PM (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracQuery

    v1 v2  
    1 = チケットクエリ =
     1= チケットクエリ = #TracTicketQueries
    22[[TracGuideToc]]
    33
    44[wiki:TracReports レポート] に加えて、 Trac は ''カスタムチケットクエリ'' があります。 ''カスタムチケットクエリ'' は、ある一定の基準を満たすチケットのリストを表示するのに使用されます。
    55
    6 カスタムクエリを設定・実行するために、ナビゲーションバーの ''チケットを見る'' モジュールに切り替え、 ''カスタムクエリ'' のリンクを選択します。
     6カスタムクエリを設定・実行するために、ナビゲーションバーの ''チケットを見る'' (英語版では ''View tickets'') モジュールに切り替え、 ''カスタムクエリ'' (英語版では ''Custom Query'') のリンクを選択します。
    77
    8 == フィルタ ==
    9 最初にクエリのページを開くと、デフォルトのフィルタとして、現在未解決のチケットの一覧が表示されます。ログインしているならば、自分が担当者となっていて未解決のチケットが表示されます。現在のフィルタは検索条件の右側にある "-" (マイナス) のラベルのボタンをクリックすることにより削除することができます。新しいフィルタをフィルタボックスの右下にあるプルダウンリストから追加することができます。テキストボックスやオプションのプルダウンメニューのフィルタを ''or'' 条件として、いくつでも追加することができます。
     8== フィルタ == #Filters
     9
     10最初にクエリのページを開くと、デフォルトのフィルタが適用され、自分に関連するチケットの一覧が表示されます:
     11 * ログインしている場合、自分が担当者 ("assigned to") になっている、オープンチケットが表示されます。
     12 * ログインしていない場合でも、個人設定 ("Prefernces") で名前やメールアドレスを設定している場合は、自分が設定した名前やメールアドレスが、関係者 ("CC") に含まれているオープンチケットが表示されます。
     13 * ログインしておらず、個人設定も保存していない場合、すべてのオープンチケットが表示されます。
     14
     15現在のフィルタは検索条件の左側にある "-" (マイナス) のラベルのボタンをクリックすることにより削除することができます。新しいフィルタは、フィルタボックスの下にあるプルダウンリストから追加することができます ('And' 条件は左側に、 'Or' 条件は右側に配置されています)。テキストボックスやオプションのプルダウンメニューのフィルタを ''or'' 条件として、いくつでも追加することができます。
    1016
    1117フィルタボックスの下のフィールドを使用することによって、結果をフィールドごとにグループ化したり、各チケットの完全な説明を表示することができます。
    1218
    13 一度フィルタを編集したら、 ''更新'' ボタンで結果を更新することができます。
     19一度フィルタを編集したら、 ''更新'' (英語版では ''Update'') ボタンで結果を更新することができます。
    1420
    15 == チケットナビゲーション ==
    16 クエリの結果の一つをクリックすると、そのチケットが表示されます。メインメニューバーの ''次のチケット'' または ''前のチケット'' というリンクをクリックすることによって、クエリの結果を行き来することができます。 ''クエリに戻る'' というリンクをクリックすると、クエリのページに戻ります。
     21== チケットナビゲーション == #NavigatingTickets
     22クエリの結果の一つをクリックすると、そのチケットが表示されます。メインメニューバーの ''次のチケット'' (英語版では ''Next Ticket'') または ''前のチケット'' (英語版では ''Previous Ticket'') というリンクをクリックすることによって、クエリの結果を行き来することができます。 ''クエリに戻る'' (英語版では ''Back to Query'') というリンクをクリックすると、クエリのページに戻ります。
    1723
    18 あなたは安全にチケットの編集をすることができ、編集を保存した後に ''次のチケット/前のチケット/クエリに戻る'' の各リンクを使用して、結果を行き来することができます。クエリに戻ったとき、 ''編集済みのチケット'' はイタリックのテキストで表示されます。チケットの 1 つが編集され、 [[html(<span style="color: grey">クエリの基準を満たさなくなった</span>)]] 場合、テキストはグレーで表示されます。最後に、 '''クエリの基準を満たす新しいチケットが登録される''' と、テキストが太字で表示されます。
     24あなたは安全にチケットの編集をすることができ、編集を保存した後に ''次のチケット/前のチケット/クエリに戻る'' の各リンクを使用して、結果を行き来することができます。クエリに戻ったとき、 ''編集済みのチケット'' はイタリックのテキストで表示されます。チケットの 1 つが編集され、 [[html(<span style="color: grey">クエリの基準を満たさなくなった</span>)]] 場合、テキストはグレーで表示されます。 '''クエリの基準を満たす新しいチケットが登録される''' と、テキストが太字で表示されます。
    1925
    2026クエリの結果は ''更新'' ボタンを押すごとにステータスがクリアされリフレッシュされます。
    2127
    22 == クエリを保存する ==
     28== クエリを保存する == #SavingQueries
    2329
    24 Trac は今のところ、クエリに名前をつけて保存することも、 (訳注: レポート一覧のように) ナビゲート可能なリストを作ることもできませんが、以下に示すように Wiki のコンテンツとしてクエリへの参照を保存できます。
     30Trac ではクエリをレポートモジュールからアクセスできる名前付きクエリとして保存することができます。クエリを保存するには ''更新'' (英語版では ''Update'') ボタンで表示を更新してから、画面の下の方にある ''クエリを保存する'' (英語版では ''Save query'') ボタンを押下します。
     31また、下記の方法で Wiki のコンテンツとしてクエリへの参照を保存することもできます。
    2532
     33''Note:'' 下記の方法で使用するクエリを簡単に組み立てるには、カスタムクエリモジュールでクエリを組み立ててテストしてから、 ''クエリを保存する'' を押下します。すると、すでに組み立てられたクエリ文字列が得られるので、余計な改行文字を削除すると、そのまま使うことができます。
    2634
    27 === TracLinks を使用する ===
     35=== TracLinks を使用する === #UsingTracLinks
    2836
    2937クエリを保存しておくと、後から保存したクエリを再度実行できます。保存は Wiki ページにクエリへのリンクを作成することで行います。
    … …  
    3543  [query:status=new|assigned|reopened&version=1.0 1.0 での未解決のチケット]
    3644
    37 ここでは、検索内容を特定するとても単純なクエリ言語が使用されています。 ([wiki:TracQuery#クエリ言語 クエリ言語] 参照)
     45ここでは、検索内容を特定するとても単純なクエリ言語が使用されています。 ([wiki:TracQuery#QueryLanguage クエリ言語] 参照)
    3846
    3947あるいは、クエリを実行した画面の URL をコピーし、 `?` 以降の文字列 (訳注: URL のパラメータ部) を Wiki リンクに貼り付けることができます:
    … …  
    4553  [query:?status=new&status=assigned&status=reopened&group=owner 担当者別着手済みチケット]
    4654
    47 === `[[TicketQuery]]` マクロを使用する ===
     55=== `[[TicketQuery]]` マクロを使用する === #UsingtheTicketQueryMacro
    4856
    49 `[[TicketQuery]]` マクロは条件にマッチするチケットの一覧を表示します。 WikiFormatting が使用できるいずれの場所でも使用できます。
     57[http://trac.edgewall.org/wiki/TicketQuery TicketQuery] マクロは条件にマッチするチケットの一覧を表示します。 WikiFormatting が使用できるいずれの場所でも使用できます。
    5058
    5159例:
    5260{{{
    53 [[TicketQuery(version=1.0|2.0&resolution=duplicate)]]
     61[[TicketQuery(version=0.6|0.7&resolution=duplicate)]]
    5462}}}
    5563
    5664表示内容:
    57   [[TicketQuery(version=1.0|2.0&resolution=duplicate)]]
     65  [[TicketQuery(version=0.6|0.7&resolution=duplicate)]]
    5866
    59 [wiki:TracQuery#TracLinksを使用する query: Wiki リンク] 同様、このマクロのパラメータは [wiki:TracQuery#クエリ言語 クエリ言語] に規定されるルールに基づいたクエリ文字列で記述しなければなりません。
     67[wiki:TracQuery#UsingTracLinks query: Wiki リンク] 同様、このマクロのパラメータは [wiki:TracQuery#QueryLanguage クエリ言語] に規定されるルールに基づいたクエリ文字列で記述しなければなりません。
    6068
    6169チケットのサマリを表示しない、よりコンパクトな表示も利用可能です:
    6270{{{
    63 [[TicketQuery(version=1.0|2.0&resolution=duplicate, compact)]]
     71[[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]
    6472}}}
    6573
    6674表示内容:
    67   [[TicketQuery(version=1.0|2.0&resolution=duplicate, compact)]]
     75  [[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]
    6876
    69 === クエリ言語 ===
     77クエリにマッチした件数だけを取得したいのならば、 ``count`` パラメータを使用してください。
    7078
    71 `query:` TracLinks と `[[TicketQuery]]` マクロは、いずれもクエリのフィルタを特定するために小さな "クエリ言語" を使用します。基本的に、フィルタはアンパサンド (`&`) で区切られます。それぞれのフィルタはチケットの各フィールドの名前、オペレータ、1つ以上のの値で構成されています。値が複数ある場合はパイプ (`|`) で区切り、フィルタがいずれかの値にマッチすればいいことを意味しています。
     79{{{
     80[[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]
     81}}}
     82
     83表示内容:
     84  [[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]
     85
     86=== ''table'' 形式でカスタマイズする === #Customizingthetableformat
     87table 形式 (''format=table'') では、 ''col=<field>'' を使用することで列の表示をカスタマイズすることができます。複数のフィールドを指定したい場合、表示する順に列をパイプ (`|`) 区切りで指定します:
     88
     89{{{
     90[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]
     91}}}
     92
     93以下のように表示されます:
     94[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]
     95
     96==== 全行表示 ==== #Fullrows
     97''table'' 形式では、以下の例のように ''rows=<field>'' を使用することで、全行表示を行うことができます:
     98
     99{{{
     100[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]
     101}}}
     102
     103以下のように表示されます:
     104[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]
     105
     106
     107=== クエリ言語 === #QueryLanguage
     108
     109`query:` TracLinks と `[[TicketQuery]]` マクロは、いずれもクエリのフィルタを特定するために小さな "クエリ言語" を使用します。基本的に、フィルタはアンパサンド (`&`) で区切られます。それぞれのフィルタはチケットの各フィールドの名前、オペレータ、1つ以上の値で構成されています。値が複数ある場合はパイプ (`|`) で区切り、フィルタがいずれかの値にマッチすればいいことを意味しています。 `&` や `|` の文字そのものを値に含めたい場合、バックスラッシュ (`\`, 環境によっては円マーク) でエスケープしてください。
    72110
    73111オペレータ一覧:
    74 || '''=''' || フィールドの内容はいずれかの値と完全に一致する。 ||
    75 || '''~=''' || フィールドの内容は1つ以上の値を含む ||
    76 || '''!^=''' || フィールドの内容が値の一つで始まる ||
    77 || '''$=''' || フィールドの内容が値の一つで終了する ||
     112|| '''`=`''' || フィールドの内容はいずれかの値と完全に一致する ||
     113|| '''`~=`''' || フィールドの内容は1つ以上の値を含む ||
     114|| '''`^=`''' || フィールドの内容が値の一つで始まる ||
     115|| '''`$=`''' || フィールドの内容が値の一つで終了する ||
    78116
    79117これらのオペレータは否定の意味があります:
    80 || '''!=''' || フィールドの内容がどれも値にも一致しない ||
    81 || '''!~=''' || フィールドの内容がいずれの値も含んでいない ||
    82 || '''!!^=''' || フィールドの内容がいずれの値でも始まらない ||
    83 || '''!$=''' || フィールドの内容がいずれの値でも終わらない ||
     118|| '''`!=`''' || フィールドの内容がいずれの値にも一致しない ||
     119|| '''`!~=`''' || フィールドの内容がいずれの値も含んでいない ||
     120|| '''`!^=`''' || フィールドの内容がいずれの値でも始まらない ||
     121|| '''`!$=`''' || フィールドの内容がいずれの値でも終わらない ||
     122
     123日付フィールドである `登録日` (英語版では `created`) と `更新日` (英語版では `modified`) は `=` オペレータに二つの日付を、二つのドット (`..`) で区切って指定することができます。日付の範囲の片方が空の場合、空の方向には条件を指定しないことを意味します。また、日付パーサは自然言語に似た構文を解釈できます。たとえば "3 weeks ago", "last month", "now" などです。 Bugzilla スタイルの "1d", "2w", "3m", "4y" なども、それぞれ1日、2週間、3ヶ月、4年と解釈できます。クエリ文字列に指定する場合、これらの構文からは空白文字を除外して指定してください。
     124|| '''`created=2007-01-01..2008-01-01`''' || 2007年に登録されたチケットへのクエリ ||
     125|| '''`created=lastmonth..thismonth`''' || 前月に登録されたチケットへのクエリ ||
     126|| '''`modified=1weekago..`''' || 1週間以内に更新されたチケットへのクエリ ||
     127|| '''`modified=..30daysago`''' || 30日間更新されていないチケットへのクエリ ||
    84128
    85129----