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:		[[TicketQuery(id=1,col=id|owner|reporter,rows=summary,table)]]
Segnalazione In carico a Segnalatore Non è stata trovata alcuna segnalazione

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:

0

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 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