Trac Ticket Queries
Table of Contents
Trac erlaubt custom ticket queries, die eine Liste der zutreffenden Tickets anzeigen, basierend auf beliebig zusammenstellbaren Filterkriterien.
Die Ticket Querys erscheinen automatisch durch Klick auf View Tickets. Die in Trac ebenfalls enthaltenen Reports sind in dieser Installation deaktiviert und stehen nicht zur Verfügung.
Filter
Beim ersten Aufruf der Seite werden alle offenen Tickets angezeigt - falls man als eingeloggt ist, werden nur die offenen Tickets angezeigt, die diesem Account zugewiesen sind. Jeder aktive Filter kann entfernt werden, indem auf der rechten Seite auf das Minus-Icon geklickt wird. Neue Filterkriterien werden durch Auswahl aus der Dropdown-Liste hinzugefügt und können dann noch angepaßt werden. Filter, die entweder eine Textbox oder ein Dropdown-Menü zur Auswahl anbieten, können auch mehrfach hinzugefügt werden, um eine oder-Operation durchzuführen.
Unterhalb des Filter-Bereichs stehen Optionen zur Gruppierung der Resultate zur Verfügung, sowie zur Anzeige der Ticketbeschreibung.
Sobald die Filter passend konfiguriert sind, werden die Suchergebnisse durch Klick auf Update aktualisiert.
Tickets navigieren
Der Klick auf eines der Abfrageergebnisse zeigt das entsprechende Ticket an. Die Ticketanzeige zeigt oben rechts Links zum Vor- und Zurückspringen innerhalb der im Query angezeigten Ticketliste. Der Link Back to Query führt zurück zur Liste.
Tickets können bedenkenlos bearbeitet werden. Trac merkt sich die Liste und aktualisiert diese nicht automatisch. Ein geändertes Ticket verbleibt also dort, auch wenn es eigentlich nicht mehr den Filterkriterien entspricht. Bei der Rückkehr zur Filterliste wird jedes Ticket, welches bearbeitet wurde, in kursiver Schrift angezeigt. Tickets, die jetzt aus den Filterkriterien herausfallen würden, werden zusätzlich in grauer Schrift dargestellt. Neue Tickets, die in der Zwischenzeit erstellt wurden, werden in Fettschrift angezeigt.
Die Query-Resultate können jederzeit aktualisiert werden, um diese Status-Indikatoren zu entfernen - einfach Update klicken, um eine aktualisierte Liste zu erhalten.
Querys speichern
Querys lassen sich derzeit leider noch nicht abspeichern und als navigierbare Liste verfügbar machen, aber es ist möglich, Referenzen auf Suchen im Wiki abzulegen.
Using TracLinks
Um Querys so zu speichern, dass sie später erneut aufgerufen werden können, kann folgender Wiki-Code eingefügt werden:
[query:status=new|assigned|reopened&version=SELFHTML Tickets zu SELFHTML]
Dargestellt wird das dann so:
Diese Variante nutzt eine sehr simple Abfragesprache, um die Kriterien zu definieren (siehe Query Language).
Alternativ kann auch der Query-String (aus der URL) einer Abfrage als Parameter in den Wiki-Link kopiert werden, inklusive Fragezeichen ?:
[query:?status=new&status=assigned&status=reopened&group=owner Tickets gruppiert nach Besitzer]
Dargestellt wird das dann so:
Benutzung des [[TicketQuery]] Makros
Das [[TicketQuery]]-Makro erlaubt die Anzeige von Ticketlisten überall dort, wo WikiFormatting erlaubt ist.
Beispiel:
[[TicketQuery(type=Aufgabe|Tippfehler&resolution=fixed)]]
Das wird so dargestellt:
Genau wie bei query: Wiki-Links erwartet das Makro einen Query-String, der den Regeln der ticket query language entspricht.
Eine kompaktere Version der Tickets erhält man so: A more compact representation without the ticket summaries is also available:
[[TicketQuery(type=Aufgabe|Tippfehler&resolution=fixed, compact)]]
This is displayed as:
Query Language
query: TracLinks und die [[TicketQuery]] Makros nutzen beide eine “mini query language”, um Filterkriterien anzugeben. Grundsätzlich werden einzelne Filter durch das Und-Zeichen (&) getrennt. Jeder Filter besteht dann aus dem Ticket-Feldnamen, einem Operator, sowie einem oder mehreren Werten, die durch das Pipe-Zeichen (|) getrennt werden (oder-Verknüpfung).
Verfügbare Operatoren sind:
| = | das Feld muss exakt einem der angegebenen Werte entsprechen |
| ~= | das Feld enthält einen oder mehrere der angegebenen Werte |
| ^= | das Feld beginnt mit einem der angegebenen Werte |
| $= | das Feld endet mit einem der angegebenen Werte |
Diese Operatoren können alle auch negiert werden:
| != | das Feld enthält keinen der angegebenen Werte |
| !~= | das Feld enthält keinen der angegebenen Werte als Bestandteil |
| !^= | das Feld beginnt nicht mit einem der angegebenen Werte |
| !$= | das Feld endet nicht mit einem der angegebenen Werte |
Weiterführende Informationen: TracTickets, TracGuide
Übersetzt von Sven Rautenberg, SELFHTML e.V.
Diese deutsche Übersetzung der Original-Trac-Wikiseite ist lizensierbar unter Creative Commons BY-SA: Namensnennung, Weitergabe unter gleichen Bedingungen.
