Edgewall Software

Trac-Ticket-Abfragen

Andere Sprachen:

Zusätzlich zu Berichten bietet Trac benutzerdefinierte Ticketabfragen an, die zum Auflisten von Tickets entspechend angegebener Kriterien verwendet werden.

Um eine benutzerdefinierte Abfrage vorzubreiten und auszuführen, wechseln Sie in der Navigationsleiste zu Tickets anzeigen und wählen den Verweis Individuelle Abfrage.

Filter

Wenn Sie die Abfrageseite das erste Mal besuchen, wird Ihnen der Standard-Filter Sie betreffende Tickets anzeigen:

  • Falls Sie angemeldet sind, dann werden alle offenen Tickets, die angezeigt werden, Ihnen zugewiesene Tickets öffnen.
  • Falls Sie nicht angemeldet sind, jedoch einen Namen oder eine E-Mail-Adresse in den Benutzer-Einstellungen angegeben haben, dann werden Ihnen alle offenen Tickets angezeigt, deren Kopie-Liste Ihre E-Mail-Adresse (oder, bei fehlender E-Mail-Adresse, Ihren Namen) enthält.
  • Ohne Anmeldung und ohne Angaben zu Name und E-Mail-Adresse in den Benutzer-Einstellungen werden alle offenen Vorgänge angezeigt.

Vorhandene Filter können durch Anklicken der Minus-Schaltfläche links daneben entfernt werden. Aus den Auswahllisten am Ende des Filterkastens ('UND'-Bedingungen links, 'ODER'-Bedingungen rechts) lassen sich neue Filter hinzufügen. Filter mit Eingabefeld oder Auswahlliste der Optionen können mehrfach hinzugefügt werden, um diese Kriterien mit oder zu verknüpfen.

Sie können die Felder direkt unterhalb des Filterkastens nutzen, um die Ergebnisse nach einem Feld zu gruppieren oder die vollständige Beschreibung zu jedem Ticket anzuzeigen.

Nachdem Sie Ihre Filter bearbeitet haben, klicken Sie die Schaltfläche Aktualisieren zum Anpassen Ihrer Ergebnisse.

Ein Klick auf eines der Abfrageergebnisse bringt Sie zu diesem Ticket. Sie können sich durch die Ergebnisse bewegen, indem Sie die Verweise nächstes Ticket oder vorheriges Ticket direkt unterhalb der Hauptnavigationsleiste anklicken, oder Sie wählen den Verweis Zurück zur Abfrage um zur Abfrageseite zurückzukehren.

Sie können ruhig jedes der Tickets bearbeiten und nach dem Abspeichern Ihrer Änderungen den Durchgang durch die Ergebnisse mit den Verweisen !nächstes/vorheriges/Zurück zur Abfrage fortsetzen. Wenn Sie zur Abfrage zurückkehren, werden alle bearbeiteten Tickets mit kursivem Text dargestellt. Falls eines der Tickets so verändert wurde, dass es den Abfragekriterien nicht mehr entspricht , dann wird der Text grau. Schließlich wird ein neues Ticket, das den Abfragekriterien entspricht, fett dargestellt.

Durch nochmaliges Anklicken der Schaltfläche Aktualisieren können die Abfrageergebnisse wiederum angepaßt und diese Statuskennzeichen gelöscht werden.

Abfragen speichern

Trac bietet Ihnen an, die Abfrage als benannte Abfrage abzuspeichern, die vom Bericht-Modul aus erreichbar ist. Um eine Abfrage zu speichern, stellen Sie sicher, dass die Ansicht Aktualisiert haben, und klicken Sie dann die Schaltfläche Abfrage speichern, die unterhalb der Ergebnisse angezeigt wird. Sie können Verweise auf Abfragen auch wie nachfolgend beschrieben in Wiki-Text ablegen.

Anmerkung: Eine Art, Abfragen wie die folgenden einfach aufzubauen, ist die, Abfragen im Modul für benutzerdefinierte Berichte zu erstellen, zu testen und nach Fertigstellung Abfrage speichern zu klicken. Dies baut den Abfrageausdruck für Sie auf. Sie müssen nur noch überflüssige Zeilenumbrüche entfernen.

Sie möchten vielleicht einige Abfragen speichern, um später mit ihnen weiter arbeiten zu können. Dies können Sie tun, indem Sie von einer Wikiseite aus einen Verweis auf die Abfrage anlegen.

[query:status=new|assigned|reopened&version=1.0 Offene Tickets für 1.0]

was folgendermaßen dargestellt wird:

Offene Tickets für 1.0

Hier wird eine sehr einfache Abfrage-Sprache verwendet, um die Kriterien zu festzulegen (siehe Abfragesprache).

Alternativ dazu können Sie den Abfrageausdruck einer Abfrage kopieren und diesen einschließlich des vorangestellten Fragezeichens ? in den Verweis im Wiki einfügen:

[query:?status=new&status=assigned&status=reopened&group=owner Zugewiesene Tickets, gruppiert nach Verantwortlichen]

was folgendermaßen dargestellt wird:

Zugewiesene Tickets, gruppiert nach Verantwortlichen

Mit dem [[TicketQuery]]-Makro

Das TicketQuery-Makro erlaubt Ihnen die Darstellung von Tickets, die bestimmte Kriterien erfüllen, über all dort, wo die Verwendung von Wiki-Formatierung möglich ist.

Beispiel:

[[TicketQuery(version=0.6|0.7&resolution=duplicate)]]

Dies wird folgendermaßen dargestellt:

#181
Wiki preview injects new lines
#204
request for colour legend (or something similar) for ticket groups in reports
#226
Ticket Dependencies
#239
Link to diff of specifik wiki change instead of the page itself
#351
All ticket modifications should be tracked in timeline
#413
Installing on Windows, drive other than C:
#450
Diffviewer should try to convert the text into utf-8.
#475
merging of similar tickets
#519
Python process sometimes hangs on Windows Server 2003
#529
IE 5-6 over HTTPS broken downloads

Ebenso wie die query: Verweise im Wiki, so wird auch bei diesem Makro ein Abfrageausdruck erwartet, der entsprechend der Regeln der einfachen Ticket-Abfragesprache gestaltet ist.

Eine verdichtete Darstellung ohne Ticket-Beschreibungen ist ebenfalls verfügbar:

[[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]

Dies wird folgendermaßen dargestellt:

#181, #204, #226, #239, #351, #413, #450, #475, #519, #529

Falls Sie schließlich nur die Anzahl der Fehler, welche die Abfrage erfüllen, erhalten möchten, nutzen Sie den Parameter count.

[[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]

Dies wird folgendermaßen dargestellt:

10

Anpassung der Darstellung als Tabelle

Sie können die Spalten in der Tabellen-Darstellung (format=table) mithilfe von col≤Feld>-Ausdrücken auch anpassen; mehrere Felder und ihre Darstellungsreihenfolge können Sie durch senkrechte Trennstriche (|) zwischen den Spalten bestimmen:

[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]

Dies wird folgendermaßen dargestellt:

Tabellenbreit durchgängige Zeilen

Im Format table können Sie auch tabellenbreit durchgängige Zeilen mit rows≤Feld> wie folgend einrichten:

[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]

Dies wird folgendermaßen dargestellt:

Results (1 - 3 of 10925)

1 2 3 4 5 6 7 8 9 10 11
Ticket Resolution Summary Owner Reporter
#13085 duplicate OperationalError: ambiguous column name: id admin
Description

Upgraded from 1.0 to 1.2.3. Now, most of the time custom queries works Ok, but at random interval custom queryies give below error.

How to Reproduce

While doing a GET operation on /query, Trac issued an internal error.

(please provide additional details here)

Request parameters:

{u'col': [u'id',
          u'summary',
          u'owner',
          u'status',
          u'doc_title',
          u'doc_revision',
          u'doc_revdate',
          u'doc_tag',
          u'doc_author',
          u'doc_reviewer',
          u'doc_approver'],
 u'group': u'status',
 u'order': u'priority',
 u'report': u'12',
 u'type': u'Document'}

User agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:62.0) Gecko/20100101 Firefox/62.0

System Information

Trac 1.2.3
Babel 1.3
Docutils 0.12
Genshi 0.7 (with speedups)
Pygments 2.0.1
pysqlite 2.6.0
Python 2.7.9 (default, Apr 2 2015, 15:33:21)
[GCC 4.9.2]
pytz 2014.10
setuptools 18.0.1
SQLite 3.8.7.4
Subversion 1.8.10 (r1615264)
jQuery 1.11.3
jQuery UI 1.11.4
jQuery Timepicker 1.5.5

Enabled Plugins

graphviz 0.7.7dev-r0
KeepInterfaceSimple2Plugin 2.5
MultipleWorkflowPlugin 1.4.1
OdtExportPlugin 0.7.dev0
parameterizedincludemacro N/A
TicketImport 0.9.0
TracCustomFieldAdmin 0.2.12
TracMasterTickets 4.0.2
TracMathJax 0.4
TracMultiSelectField 1.0.1.post0
TracSQL 0.3
TracWysiwyg 0.12.0.5.post0
Wikinfo 0.2dev-r0
WikiTableMacro 0.3.dev0

Interface Customization

shared-htdocs
shared-templates
site-htdocs logo.png
site-templates site.html

Python Traceback

Traceback (most recent call last):
  File "build/bdist.linux-x86_64/egg/trac/web/main.py", line 647, in _dispatch_request
    dispatcher.dispatch(req)
  File "build/bdist.linux-x86_64/egg/trac/web/main.py", line 248, in dispatch
    resp = chosen_handler.process_request(req)
  File "build/bdist.linux-x86_64/egg/trac/ticket/query.py", line 1016, in process_request
    return self.display_html(req, query)
  File "build/bdist.linux-x86_64/egg/trac/ticket/query.py", line 1122, in display_html
    tickets = query.execute(req, cached_ids=orig_list)
  File "build/bdist.linux-x86_64/egg/trac/ticket/query.py", line 303, in execute
    self.num_items = self._count(sql, args)
  File "build/bdist.linux-x86_64/egg/trac/ticket/query.py", line 284, in _count
    % sql, args)[0][0]
  File "build/bdist.linux-x86_64/egg/trac/db/api.py", line 122, in execute
    return db.execute(query, params)
  File "build/bdist.linux-x86_64/egg/trac/db/util.py", line 128, in execute
    cursor.execute(query, params if params is not None else [])
  File "build/bdist.linux-x86_64/egg/trac/db/util.py", line 72, in execute
    return self.cursor.execute(sql_escape_percent(sql), args)
  File "build/bdist.linux-x86_64/egg/trac/db/sqlite_backend.py", line 88, in execute
    result = PyFormatCursor.execute(self, *args)
  File "build/bdist.linux-x86_64/egg/trac/db/sqlite_backend.py", line 64, in execute
    args or [])
  File "build/bdist.linux-x86_64/egg/trac/db/sqlite_backend.py", line 55, in _rollback_on_error
    return function(self, *args, **kwargs)
OperationalError: ambiguous column name: id
#13082 duplicate IndexError: pop from empty list indianer
Description

How to Reproduce

While doing a GET operation on /attachment/wiki/WikiStart/, Trac issued an internal error.

(please provide additional details here)

Request parameters:

{'action': u'new', 'path': u'WikiStart/', 'realm': u'wiki'}

User agent: Mozilla/5.0 (X11; Linux x86_64; rv:61.0) Gecko/20100101 Firefox/61.0

System Information

Trac 1.0.2
Babel 1.3
Docutils 0.12
Genshi 0.7 (with speedups)
Pygments 2.0.1
pysqlite 2.6.0
Python 2.7.9 (default, Jun 29 2016, 13:08:31)
[GCC 4.9.2]
pytz 2012c
setuptools 33.1.1
SQLite 3.8.7.1
jQuery 1.7.2
jQuery UI 1.10.1
jQuery Timepicker 1.2

Enabled Plugins

Python Traceback

Traceback (most recent call last):
  File "/usr/lib/python2.7/dist-packages/trac/web/main.py", line 512, in _dispatch_request
    dispatcher.dispatch(req)
  File "/usr/lib/python2.7/dist-packages/trac/web/main.py", line 240, in dispatch
    content_type)
  File "/usr/lib/python2.7/dist-packages/trac/web/chrome.py", line 1042, in render_template
    encoding='utf-8')
  File "/usr/lib/python2.7/dist-packages/genshi/core.py", line 184, in render
    return encode(generator, method=method, encoding=encoding, out=out)
  File "/usr/lib/python2.7/dist-packages/genshi/output.py", line 58, in encode
    for chunk in iterator:
  File "/usr/lib/python2.7/dist-packages/genshi/output.py", line 350, in __call__
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/output.py", line 829, in __call__
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/output.py", line 669, in __call__
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/output.py", line 774, in __call__
    for kind, data, pos in chain(stream, [(None, None, None)]):
  File "/usr/lib/python2.7/dist-packages/genshi/output.py", line 594, in __call__
    for ev in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/core.py", line 289, in _ensure
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/core.py", line 289, in _ensure
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/trac/web/chrome.py", line 1182, in _strip_accesskeys
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/core.py", line 289, in _ensure
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/trac/web/chrome.py", line 1171, in _generate
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/template/base.py", line 618, in _include
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/template/markup.py", line 378, in _match
    ctxt, start=idx + 1, **vars):
  File "/usr/lib/python2.7/dist-packages/genshi/template/markup.py", line 378, in _match
    ctxt, start=idx + 1, **vars):
  File "/usr/lib/python2.7/dist-packages/genshi/template/markup.py", line 326, in _match
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/template/base.py", line 558, in _flatten
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/core.py", line 289, in _ensure
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/path.py", line 588, in _generate
    subevent = next()
  File "/usr/lib/python2.7/dist-packages/genshi/template/base.py", line 618, in _include
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/template/markup.py", line 315, in _strip
    event = next()
  File "/usr/lib/python2.7/dist-packages/genshi/template/base.py", line 558, in _flatten
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/core.py", line 289, in _ensure
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/path.py", line 588, in _generate
    subevent = next()
  File "/usr/lib/python2.7/dist-packages/genshi/template/base.py", line 618, in _include
    for event in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/template/markup.py", line 315, in _strip
    event = next()
  File "/usr/lib/python2.7/dist-packages/genshi/template/base.py", line 558, in _flatten
    for kind, data, pos in stream:
  File "/usr/lib/python2.7/dist-packages/genshi/filters/i18n.py", line 178, in _generate
    for event in msgbuf.translate(gettext(msgbuf.format())):
  File "/usr/lib/python2.7/dist-packages/genshi/filters/i18n.py", line 1051, in translate
    events = self.events[order].pop(0)
IndexError: pop from empty list
#13078 fixed TicketQuery for empty field of type time is incorrect Jun Omae Ryan J Ollos
Description

The issue was raised in gdiscussion:trac-users:e7NvYuzgQKk. For a field of type time (e.g. duedate), [[TicketQuery(duedate=)]] does not retrn the correct results.

It looks like the following patch might work:

  • trac/ticket/query.py

    diff --git a/trac/ticket/query.py b/trac/ticket/query.py
    index c65f2bfc8..ca1f1d496 100644
    a b class Query(object):  
    510510                    col = 'c.' + db.quote(name)
    511511                value = value[len(mode) + neg:]
    512512
    513                 if name in self.time_fields:
     513                if name in self.time_fields and value:
    514514                    if '..' in value:
    515515                        (start, end) = [each.strip() for each in
    516516                                        value.split('..', 1)]
1 2 3 4 5 6 7 8 9 10 11

Abfragesprache

query:-Trac-Verweise und das [[TicketQuery]]-Makro nutzen beide eine “Abfragesprache“ geringen Umfangs, um Abfragefilter zu definieren. Grundsätzlich sind die einzelnen Filter durch Et-Zeichen (&) getrennt. Jeder Filter besteht weiterhin aus dem Ticketfeldnamen, einem Operator und einem oder mehreren Werten. Mehrere Werte werden durch senkrechte Trennstriche (|) getrennt, was bedeutet, dass der Filter auf jeden dieser Werte prüft. Um die Zeichen & oder | in einen Wert aufzunehmen, maskieren Sie das Zeichen mithilfe eines umgekehrten Schrägstrichs (\).

Die verfügbaren Operatoren sind:

= der Feldinhalt entspricht exakt einem der Werte
~= der Feldinhalt enthält einen oder mehrere der Werte
^= der Feldinhalt beginnt mit einem der Werte
$= der Feldinhalt endet mit einem der Werte

Jeder dieser Operatoren kann auch negiert werden:

!= der Feldinhalt entspricht keinem der Werte
!~= der Feldinhalt enthält keinen der Werte
!^= der Feldinhalt beginnt mit keinem der Werte
!$= der Feldinhalt endet mit keinem der Werte

Die Datenfelder created und modified (Anm.d.Übersetzers: Erstellungszeitpunkt bzw. Zeitpunkt der letzten Ticketänderung) können mit dem =-Operator dadurch eingegrenzt werden, dass ein Wert mit zwei durch zwei Punkte (..) getrennten Datumsangaben eingesetzt wird. Beide Enden des Zeitbereichs können leer gelassen werden, gleichbedeutend damit, dass die entsprechende Grenze des Bereichs offen ist. Der Datumsübersetzer kennt einige natürliche Zeitdefinitionen wie "vor drei Wochen", "letzten Monat", und "jetzt" (Anm.d.Übersetzers: jeweils in der englisch-sprachigen Schreibweise, also "3 weeks ago", "last month" und "now"), ebenso Datumsangaben im Bugzilla-Stil wie "1d", "2w", "3m" oder "4y" für 1 Tag, 2 Wochen, 3 Monate und 4 Jahre. Leerzeichen in Datumsangaben können weggelassen werden, um das Auskommentieren von Abfrageausdrücken vermeiden zu können.

created=2007-01-01..2008-01-01 Suche nach Tickets, die im Jahr 2007 erstellt wurden
created=lastmonth..thismonth Suche nach Tickets, die während des letzten Monats erstellt wurden
modified=1weekago.. Suche nach Tickets, die in der vergangenen Woche verändert wurden sind
modified=..30daysago Suche nach Tickets, die während der letzten 30 Tage unverändert geblieben sind

Leseempfehlungen: TracTickets, TracReports, TracGuide

Last modified 8 years ago Last modified on Jan 1, 2011, 11:33:20 PM
Note: See TracWiki for help on using the wiki.