From 891730d13b324fad916572a82f0bd610c5de9aad Mon Sep 17 00:00:00 2001 From: Rob Austein Date: Sun, 13 Sep 2020 23:06:24 +0000 Subject: Rename for conversion --- raw-wiki-dump/TicketQuery.trac | 125 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 raw-wiki-dump/TicketQuery.trac (limited to 'raw-wiki-dump/TicketQuery.trac') diff --git a/raw-wiki-dump/TicketQuery.trac b/raw-wiki-dump/TicketQuery.trac new file mode 100644 index 0000000..8b6f877 --- /dev/null +++ b/raw-wiki-dump/TicketQuery.trac @@ -0,0 +1,125 @@ += !TicketQuery Wiki Macro + +The !TicketQuery macro lets you display information on tickets within wiki pages. +The query language used by the `[[TicketQuery]]` macro is described in [TracQuery#UsingtheTicketQueryMacro TracQuery] page. + +== Usage + +[[MacroList(TicketQuery)]] + +== Example + +||= **Example** =||= **Result** =||= **Macro** =|| +|----------------------------------------------------------- +||=Number of [query:status=new&milestone= Triage tickets]: =||\ +|| **[[TicketQuery(status=new&milestone=,count)]]**||\ +|| `[[TicketQuery(status=new&milestone=,count)]]` || +|----------------------------------------------------------- +||=Number of new tickets: =||\ +|| **[[TicketQuery(status=new,count)]]**||\ +|| `[[TicketQuery(status=new,count)]]` || +|----------------------------------------------------------- +||=Number of reopened tickets: =||\ +|| **[[TicketQuery(status=reopened,count)]]**||\ +|| `[[TicketQuery(status=reopened,count)]]` || +|----------------------------------------------------------- +||=Number of assigned tickets: =||\ +|| **[[TicketQuery(status=assigned,count)]]**||\ +|| `[[TicketQuery(status=assigned,count)]]` || +|----------------------------------------------------------- +||=Number of invalid tickets: =||\ +|| **[[TicketQuery(status=closed,resolution=invalid,count)]]**||\ +|| `[[TicketQuery(status=closed,resolution=invalid,count)]]` || +|----------------------------------------------------------- +||=Number of worksforme tickets: =||\ +|| **[[TicketQuery(status=closed,resolution=worksforme,count)]]**||\ +|| `[[TicketQuery(status=closed,resolution=worksforme,count)]]` || +|----------------------------------------------------------- +||=Number of duplicate tickets: =||\ +|| **[[TicketQuery(status=closed,resolution=duplicate,count)]]**||\ +|| `[[TicketQuery(status=closed,resolution=duplicate,count)]]` || +|----------------------------------------------------------- +||=Number of wontfix tickets: =||\ +|| **[[TicketQuery(status=closed,resolution=wontfix,count)]]**||\ +|| `[[TicketQuery(status=closed,resolution=wontfix,count)]]` || +|----------------------------------------------------------- +||=Number of fixed tickets: =||\ +|| **[[TicketQuery(status=closed,resolution=fixed,count)]]**||\ +|| `[[TicketQuery(status=closed,resolution=fixed,count)]]` || +|----------------------------------------------------------- +||=Total number of tickets: =||\ +|| **[[TicketQuery(count)]]**||\ +|| `[[TicketQuery(count)]]` || +|----------------------------------------------------------- +||=Number of tickets reported **or** owned by current user: =||\ +|| **[[TicketQuery(reporter=$USER,or,owner=$USER,count)]]**||\ +|| `[[TicketQuery(reporter=$USER,or,owner=$USER,count)]]` || +|----------------------------------------------------------- +||=Number of tickets created this month: =||\ +|| **[[TicketQuery(created=thismonth..,count)]]**||\ +|| `[[TicketQuery(created=thismonth..,count)]]` || +|----------------------------------------------------------- +||=Last 3 modified tickets: =||\ +||**[[TicketQuery(max=3,order=modified,desc=1,compact)]]**||\ +|| `[[TicketQuery(max=3,order=modified,desc=1,compact)]]` || +|----------------------------------------------------------- +{{{#!th rowspan=2, style="text-align: left;" +Details of ticket #1: +}}} +{{{#!td style="border-bottom: 0;" +}}} +{{{#!td +`[[TicketQuery(id=1,col=id|owner|reporter,rows=summary,table)]]` +}}} +|- +{{{#!td colspan=2, style="border-top: 0;" +[[TicketQuery(id=1,col=id|owner|reporter,rows=summary,table)]] +}}} +|----------------------------------------------------------- + +== Using the `[[TicketQuery]]` Macro + +The [trac:TicketQuery TicketQuery] macro lets you display lists of tickets matching certain criteria anywhere you can use WikiFormatting. + +Example: +{{{ +[[TicketQuery(version=0.6|0.7&resolution=duplicate)]] +}}} + +This is displayed as: + [[TicketQuery(version=0.6|0.7&resolution=duplicate)]] + +Just like the [wiki:TracQuery#UsingTracLinks query: wiki links], the parameter of this macro expects a query string formatted according to the rules of the simple [wiki:TracQuery#QueryLanguage ticket query language]. This also displays the link and description of a single ticket: +{{{ +[[TicketQuery(id=123)]] +}}} + +This is displayed as: + [[TicketQuery(id=123)]] + +A more compact representation without the ticket summaries is: +{{{ +[[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]] +}}} + +This is displayed as: + [[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]] + +If you wish to receive only the number of defects that match the query, use the `count` parameter: +{{{ +[[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]] +}}} + +This is displayed as: + [[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]] + +A graphical use of the macro is with the `format=progress` attribute: +{{{ +[[TicketQuery(milestone=0.12.8&group=type,format=progress)]] +}}} + +For example for one of the upcoming milestones, bars are shown by ticket type: +[[TicketQuery(milestone=0.12.8&group=type,format=progress)]] + +---- +See also: TracQuery, TracTickets, TracReports, TracGuide \ No newline at end of file -- cgit v1.2.3