TicketQuery Wiki Macro
The TicketQuery macro lets you display ticket information anywhere that accepts WikiFormatting.
The query language used by the [[TicketQuery]] macro is described in the TracQuery page.
Usage
[[TicketQuery]]
Elenca le segnalazioni che corrispondono a certi criteri.
Questa macro accetta una lista di parametri nella forma "chiave=valore" separati da virgole.
Quando la chiave è il nome di un campo, la sintassi del valore deve corrispondere a quella dei filtri, definita in TracQuery#QueryLanguage.
Nota che non si tratta della medesima sintassi semplificata usata nei URL di collegamento query: che cominciano con il carattere ?.
È possibile includere delle virgole (,) nei valori precedendole con un backslash (\\).
Per utilizzare una serie di alternative separare i singoli criteri con l'operatore or.
Oltre ai criteri di filtro, è possibile usare diversi altri parametri, tutti opzionali, per controllare la presentazione dei risultati.
Il parametro format determina come verrà presentata la lista delle segnalazioni:
- list -- la presentazione di default è un elenco di segnalazioni, una per riga, con l'ID seguito dal suo sommario.
- compact -- le segnalazioni verranno presentate come una lista di ID separati da virgole.
- count -- verrà mostrato solo il numero di segnalazioni corrispondenti.
- rawcount -- verrà mostrato solo il numero di segnalazioni corrispondenti, senza neanche il collegamento alla ricerca effettuata (dalla 1.1.1).
- table -- una vista simile a quella delle ricerche personalizzate (ma senza i controlli).
- progress -- una vista simile ai grafici mostrati negli obiettivi.
Il parametro max può essere usato per limitare il numero di segnalazioni mostrate (di default 0, cioè illimitato).
Il parametro order imposta il campo utilizzato per ordinare le segnalazioni (di default il campo id).
Il parametro desc indica se l'ordinamento delle segnalazioni debba essere invertito (di default false).
Il parametro group imposta il campo utilizzato per raggruppare le segnalazioni (di default non viene effettuato alcun raggruppamento).
Il parametro groupdesc indica se l'ordine di visualizzazione dei gruppi debba essere invertito (di default false).
Il parametro verbose può essere impostato a un valore true per ottenere la descrizione delle segnalazioni elencate. Solo per il formato table. deprecato, sostituito dal parametro rows.
Il parametro rows può essere usato per specificare il campo, o i campi, da visualizzare, ad esempio rows=description|summary.
Il parametro col può essere usato per specificare quali campi debbano essere visualizzati come colonne. Solo per il formato table.
Per compatibilità con Trac 0.10, l'eventuale ultimo parametro posizionale verrà usato per specificare il format.
Inoltre, è ancora consentito l'utilizzo di "&" come separatore dei campi (tranne che nel caso di order), ma è deprecato.
Examples
| Example | Result | Macro | ||||
|---|---|---|---|---|---|---|
| Number of Triage tickets: | 0 | [[TicketQuery(status=new&milestone=,count)]]
| ||||
| Number of new tickets: | 0 | [[TicketQuery(status=new,count)]]
| ||||
| Number of reopened tickets: | 0 | [[TicketQuery(status=reopened,count)]]
| ||||
| Number of assigned tickets: | 0 | [[TicketQuery(status=assigned,count)]]
| ||||
| Number of invalid tickets: | 0 | [[TicketQuery(status=closed,resolution=invalid,count)]]
| ||||
| Number of worksforme tickets: | 0 | [[TicketQuery(status=closed,resolution=worksforme,count)]]
| ||||
| Number of duplicate tickets: | 0 | [[TicketQuery(status=closed,resolution=duplicate,count)]]
| ||||
| Number of wontfix tickets: | 0 | [[TicketQuery(status=closed,resolution=wontfix,count)]]
| ||||
| Number of fixed tickets: | 0 | [[TicketQuery(status=closed,resolution=fixed,count)]]
| ||||
| Number of untriaged tickets (milestone unset): | 0 | [[TicketQuery(status!=closed,milestone=,count)]]
| ||||
| Total number of tickets: | 0 | [[TicketQuery(count)]]
| ||||
| Number of tickets reported or owned by current user: | 0 | [[TicketQuery(reporter=$USER,or,owner=$USER,count)]]
| ||||
| Number of tickets created this month: | 0 | [[TicketQuery(created=thismonth..,count)]]
| ||||
| Number of closed Firefox tickets: | 0 | [[TicketQuery(status=closed,keywords~=firefox,count)]]
| ||||
| Number of closed Opera tickets: | 0 | [[TicketQuery(status=closed,keywords~=opera,count)]]
| ||||
| Number of closed tickets affecting Firefox and Opera: | 0 | [[TicketQuery(status=closed,keywords~=firefox opera,count)]]
| ||||
| Number of closed tickets affecting Firefox or Opera: | 0 | [[TicketQuery(status=closed,keywords~=firefox|opera,count)]]
| ||||
| Number of tickets that affect Firefox or are closed and affect Opera: | 0 | [[TicketQuery(status=closed,keywords~=opera,or,keywords~=firefox,count)]]
| ||||
| Number of closed Firefox tickets that don't affect Opera: | 0 | [[TicketQuery(status=closed,keywords~=firefox -opera,count)]]
| ||||
| Last 3 modified tickets: | Nessun risultato | [[TicketQuery(max=3,order=modified,desc=1,compact)]]
| ||||
Details of ticket #1: |
| |||||
| ||||||
Format: list
[[TicketQuery(version=0.6|0.7&resolution=duplicate)]]
This is displayed as:
Nessun risultato
[[TicketQuery(id=123)]]
This is displayed as:
Nessun risultato
Format: compact
[[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]
This is displayed as:
Nessun risultato
Format: count
[[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]
This is displayed as:
Format: progress
[[TicketQuery(milestone=0.12.8&group=type,format=progress)]]
This is displayed as:
Format: table
You can choose the columns displayed in the table format (format=table) using col=<field>. You can specify multiple fields and the order they are displayed in by placing pipes (|) between the columns:
[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]
This is displayed as:
| Segnalazione | Risoluzione | Sommario | In carico a | Segnalatore |
|---|---|---|---|---|
| Non è stata trovata alcuna segnalazione | ||||
Full rows
In table format you can specify full rows using rows=<field>:
[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]
This is displayed as:
| Segnalazione | Risoluzione | Sommario | In carico a | Segnalatore |
|---|---|---|---|---|
| Non è stata trovata alcuna segnalazione | ||||
See also: TracQuery, TracTickets, TracReports
