Trac-Ticket-Abfragen
Table of Contents
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.
Tickets durchgehen
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.
Mit Trac-Verweisen
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:
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:
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:
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:
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:
Results (1 - 3 of 11343)
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 11343)
| Ticket | Resolution | Summary | Owner | Reporter |
|---|---|---|---|---|
| #13920 | fixed | 1 failure occurs with multipart 2.0.1 | ||
| Description |
======================================================================
ERROR: test_post_with_unnamed_value (trac.web.tests.api.RequestTestCase.test_post_with_unnamed_value)
----------------------------------------------------------------------
Traceback (most recent call last):
File "/home/jun66j5/src/tracdev/git/trac/web/tests/api.py", line 597, in test_post_with_unnamed_value
self.assertEqual('named value', req.args['foo'])
^^^^^^^^
File "/home/jun66j5/src/tracdev/git/trac/web/api.py", line 695, in __getattr__
value = self.callbacks[name](self)
^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/jun66j5/src/tracdev/git/trac/web/api.py", line 677, in <lambda>
'args': lambda req: arg_list_to_args(req.arg_list),
^^^^^^^^^^^^
File "/home/jun66j5/src/tracdev/git/trac/web/api.py", line 695, in __getattr__
value = self.callbacks[name](self)
^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/jun66j5/src/tracdev/git/trac/web/api.py", line 1052, in _parse_arg_list
return list(parse_form_data(self.environ))
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/jun66j5/src/tracdev/git/trac/web/api.py", line 535, in parse_form_data
forms, files = multipart.parse_form_data(environ, charset='utf-8',
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/jun66j5/venv/py311/lib/python3.11/site-packages/multipart.py", line 1269, in parse_form_data
for part in MultipartParser(
File "/home/jun66j5/venv/py311/lib/python3.11/site-packages/multipart.py", line 999, in __iter__
for part in self._part_iter:
File "/home/jun66j5/venv/py311/lib/python3.11/site-packages/multipart.py", line 1038, in _iterparse
for event in parser.parse_blocking(self.stream.read, bufsize):
File "/home/jun66j5/venv/py311/lib/python3.11/site-packages/multipart.py", line 715, in parse_blocking
yield from self.parse(chunk)
File "/home/jun66j5/venv/py311/lib/python3.11/site-packages/multipart.py", line 562, in parse
self._segment = self._create_segment(self._segment_headerlist)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/jun66j5/venv/py311/lib/python3.11/site-packages/multipart.py", line 795, in _create_segment
raise StrictParserError(
multipart.StrictParserError: Invalid Content-Disposition segment header: Missing name option
|
|||
| #13918 | fixed | 8 failures with Pygment 2.21 | ||
| Description |
8 failures occur on unit tests with Pygments 2.21. ======================================================================
FAIL: test_pygments_lexer_arguments (trac.mimeview.tests.pygments.PygmentsRendererTestCase)
----------------------------------------------------------------------
Traceback (most recent call last):
File "/home/jun66j5/src/tracdev/git/trac/mimeview/tests/pygments.py", line 217, in test_pygments_lexer_arguments
self._test('pygments_lexer_arguments', result)
File "/home/jun66j5/src/tracdev/git/trac/mimeview/tests/pygments.py", line 76, in _test
self.assertEqual(split(exp), split(res))
AssertionError: Lists differ: ['<di[212 chars]">', ''MyClass'</span>', '<span class=[47 chars]an>'] != ['<di[212 chars]">', "'MyClass'</span>", '<span class="p">', '[39 chars]an>']
First differing element 12:
''MyClass'</span>'
"'MyClass'</span>"
['<div class="wiki-code">',
'<div class="code">',
'<pre>',
'<span class="k">',
'if</span>',
' <span class="p">',
'(</span>',
'<span class="nx">',
'class_exists</span>',
'<span class="p">',
'(</span>',
'<span class="s1">',
- ''MyClass'</span>',
+ "'MyClass'</span>",
'<span class="p">',
'))</span>',
' <span class="p">',
'{</span>']
...
FAILED (failures=8)
|
|||
| #13917 | cantfix | trac 1.6 crashes after adding svn repository on python 3.13.0 | ||
| Description |
The system I am using it on is debian 13 (trixie). It uses python3. # python3 --version Python 3.13.5 # trac-admin --version trac-admin 1.6 Here are the steps I used to set it up: # apt-get install libapache2-mod-wsgi-py3 python3-pip python3-setuptools python3-genshi python3-subversion sqlite3 libsqlite3-dev # pip install --break-system-packages pysqlite3 && pip install --break-system-packages --upgrade pysqlite3 # pip --version pip 25.1.1 from /usr/lib/python3/dist-packages/pip (python 3.13) # pip install --break-system-packages babel docutils pygments textile && pip install --break-system-packages --upgrade babel docutils pygments textile # pip install --break-system-packages Trac && pip install --break-system-packages --upgrade Trac I setup a new project: # rm -rf /usr/share/trac/projects/test # mkdir -p /usr/share/trac/projects/test # trac-admin /usr/share/trac/projects/test initenv -set project name to test Copied over header-logo.jpg to /usr/share/trac/projects/test/htdocs set my user to be admin # trac-admin /usr/share/trac/projects/test permission add admin TRAC_ADMIN Edit /usr/share/trac/projects/test/conf/trac.ini -change this section to match [header_logo] alt = test height = 85 link = /trac src = site/header-logo.jpg width = 900 -change this section to match [trac] base_url = https://test.local/trac -change this section to match [trac] secure_cookies = enabled -add this as a new section [components] tracopt.versioncontrol.svn.* = enabled tracopt.perm.authz_policy.* = enabled -change this section to match putting AuthzPolicy in front [trac] permission_policies = AuthzPolicy, DefaultPermissionPolicy, LegacyAttachmentPolicy -add this as a new section [authz_policy] authz_file = /etc/apache2/testpermissions Then I edited the website configuration file for apache to have: WSGIScriptAlias /trac /usr/share/trac/cgi-bin/trac.wsgi And restarted apache # service apache2 restart I could access it using the url: https://test.local/trac I logged in as an admin. I went to https://test.local/trac/admin/versioncontrol/repository Saw no repositories. I added a test one this way: # trac-admin /usr/share/trac/projects/test repository add testrepo /home/svn/repo/testrepo svn My web browser says an empty response was sent. Apache logs show this: (20014)Internal error (specific information not available) Which I found indicates the service it is trying to contact is not responding. But if I manually remove it, then it works: # trac-admin /usr/share/trac/projects/test repository remove testrepo But I have to restart apache first before I can access it again. Then in the trac website, I manually added a repository under svn as the type. And same result. But even if I restart apache, I still can't access it. |
|||
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
