tracquery
no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
— | tracquery [2015/06/09 15:23] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Trac Ticket Queries ====== | ||
+ | [[: | ||
+ | |||
+ | In addition to [[: | ||
+ | |||
+ | To configure and execute a custom query, switch to the //View Tickets// module from the navigation bar, and select the //Custom Query// link. | ||
+ | |||
+ | ===== Filters ===== | ||
+ | When you first go to the query page the default filters will display all open tickets, or if you're logged in it will display open tickets assigned to you. Current filters can be removed by clicking the button to the right with the minus sign on the label. | ||
+ | |||
+ | You can use the fields just below the filters box to group the results based on a field, or display the full description for each ticket. | ||
+ | |||
+ | Once you've edited your filters click the //Update// button to refresh your results. | ||
+ | |||
+ | ===== Navigating Tickets ===== | ||
+ | Clicking on one of the query results will take you to that ticket. | ||
+ | |||
+ | You can safely edit any of the tickets and continue to navigate through the results using the // | ||
+ | |||
+ | The query results can be refreshed and cleared of these status indicators by clicking the //Update// button again. | ||
+ | |||
+ | ===== Saving Queries ===== | ||
+ | |||
+ | While Trac does not yet allow saving a named query and somehow making it available in a navigable list, you can save references to queries in Wiki content, as described below. | ||
+ | |||
+ | ==== Using TracLinks ==== | ||
+ | |||
+ | You may want to save some queries so that you can come back to them later. | ||
+ | < | ||
+ | [[: | ||
+ | </ | ||
+ | |||
+ | |||
+ | Which is displayed as: | ||
+ | [[: | ||
+ | |||
+ | This uses a very simple query language to specify the criteria (see [[: | ||
+ | |||
+ | Alternatively, | ||
+ | < | ||
+ | [[: | ||
+ | </ | ||
+ | |||
+ | |||
+ | Which is displayed as: | ||
+ | [[: | ||
+ | |||
+ | ==== Using the `[[: | ||
+ | |||
+ | The `[[: | ||
+ | |||
+ | Example: | ||
+ | < | ||
+ | [[: | ||
+ | </ | ||
+ | |||
+ | |||
+ | This is displayed as: | ||
+ | [[: | ||
+ | |||
+ | Just like the [[: | ||
+ | |||
+ | A more compact representation without the ticket summaries is also available: | ||
+ | < | ||
+ | [[: | ||
+ | </ | ||
+ | |||
+ | |||
+ | This is displayed as: | ||
+ | [[: | ||
+ | |||
+ | ==== Query Language ==== | ||
+ | |||
+ | `query:` TracLinks and the `[[: | ||
+ | |||
+ | The available operators are: | ||
+ | | **=** | the field content exactly matches the one of the values | | ||
+ | | **~=** | the field content contains one or more of the values | | ||
+ | | **!^=** | the field content starts with one of the values | | ||
+ | | **$=** | the field content ends with one of the values | | ||
+ | |||
+ | All of these operators can also be negated: | ||
+ | | **!=** | the field content matches none of the values | | ||
+ | | **!~=** | the field content does not contain any of the values | | ||
+ | | **!!^=** | the field content does not start with any of the values | | ||
+ | | **!$=** | the field content does not end with any of the values | | ||
+ | |||
+ | ---- | ||
+ | See also: TracTickets, | ||
tracquery.txt · Last modified: 2015/06/09 15:23 by 127.0.0.1