Edgewall Software

Changes between Initial Version and Version 1 of 0.12/TranslationDe/TracQuery


Ignore:
Timestamp:
Jul 16, 2012, 9:22:39 PM (7 years ago)
Author:
trac
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • 0.12/TranslationDe/TracQuery

    v1 v1  
     1= Trac-Ticket-Abfragen = #TracTicketQueries
     2[[TracGuideToc]]
     3[[TranslatedPages(revision=31)]]
     4
     5Zusätzlich zu [wiki:TracReports Berichten] bietet Trac benutzerdefinierte Ticketabfragen an, die zum Auflisten von Tickets entspechend angegebener Kriterien verwendet werden.
     6
     7Um eine benutzerdefinierte Abfrage vorzubreiten und auszuführen, wechseln Sie in der Navigationsleiste zu ''Tickets anzeigen'' und wählen den Verweis ''Individuelle Abfrage''.
     8
     9== Filter == #Filters
     10
     11Wenn Sie die Abfrageseite das erste Mal besuchen, wird Ihnen der Standard-Filter Sie betreffende Tickets anzeigen:
     12 * Falls Sie angemeldet sind, dann werden alle offenen Tickets, die angezeigt werden, Ihnen zugewiesene Tickets öffnen.
     13 * 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.
     14 * Ohne Anmeldung und ohne Angaben zu Name und E-Mail-Adresse in den Benutzer-Einstellungen werden alle offenen Vorgänge angezeigt.
     15
     16Vorhandene 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.
     17
     18Sie 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.
     19
     20Nachdem Sie Ihre Filter bearbeitet haben, klicken Sie die Schaltfläche ''Aktualisieren'' zum Anpassen Ihrer Ergebnisse.
     21
     22== Tickets durchgehen == #NavigatingTickets
     23
     24Ein 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.
     25
     26Sie 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 [[html(<span style="color: grey">es den Abfragekriterien nicht mehr entspricht </span>)]], dann wird der Text grau. Schließlich wird '''ein neues Ticket, das den Abfragekriterien entspricht''', fett dargestellt.
     27
     28Durch nochmaliges Anklicken der Schaltfläche ''Aktualisieren'' können die Abfrageergebnisse wiederum angepaßt und diese Statuskennzeichen gelöscht werden.
     29
     30== Abfragen speichern == #SavingQueries
     31
     32Trac 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.
     33Sie können Verweise auf Abfragen auch wie nachfolgend beschrieben in Wiki-Text ablegen.
     34
     35''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.
     36
     37=== Mit Trac-Verweisen === #UsingTracLinks
     38
     39Sie 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.
     40{{{
     41[query:status=new|assigned|reopened&version=1.0 Offene Tickets für 1.0]
     42}}}
     43
     44was folgendermaßen dargestellt wird:
     45  [query:status=new|assigned|reopened&version=1.0 Offene Tickets für 1.0]
     46
     47Hier wird eine sehr einfache Abfrage-Sprache verwendet, um die Kriterien zu festzulegen (siehe [wiki:TracQuery#QueryLanguage Abfragesprache]).
     48
     49Alternativ dazu können Sie den Abfrageausdruck einer Abfrage kopieren und diesen einschließlich des vorangestellten Fragezeichens `?` in den Verweis im Wiki einfügen:
     50{{{
     51[query:?status=new&status=assigned&status=reopened&group=owner Zugewiesene Tickets, gruppiert nach Verantwortlichen]
     52}}}
     53
     54was folgendermaßen dargestellt wird:
     55  [query:?status=new&status=assigned&status=reopened&group=owner Zugewiesene Tickets, gruppiert nach Verantwortlichen]
     56
     57=== Mit dem `[[TicketQuery]]`-Makro === #UsingtheTicketQueryMacro
     58
     59Das [trac:TicketQuery TicketQuery]-Makro erlaubt Ihnen die Darstellung von Tickets, die bestimmte Kriterien erfüllen, über all dort, wo die Verwendung von [WikiFormatting Wiki-Formatierung] möglich ist.
     60
     61Beispiel:
     62{{{
     63[[TicketQuery(version=0.6|0.7&resolution=duplicate)]]
     64}}}
     65
     66Dies wird folgendermaßen dargestellt:
     67  [[TicketQuery(version=0.6|0.7&resolution=duplicate)]]
     68
     69Ebenso wie die [wiki:TracQuery#UsingTracLinks query: Verweise im Wiki], so wird auch bei diesem Makro ein Abfrageausdruck erwartet, der entsprechend der Regeln der einfachen [wiki:TracQuery#QueryLanguage Ticket-Abfragesprache] gestaltet ist.
     70
     71Eine verdichtete Darstellung ohne Ticket-Beschreibungen ist ebenfalls verfügbar:
     72{{{
     73[[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]
     74}}}
     75
     76Dies wird folgendermaßen dargestellt:
     77  [[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]
     78
     79Falls Sie schließlich nur die Anzahl der Fehler, welche die Abfrage erfüllen, erhalten möchten, nutzen Sie den Parameter ``count``.
     80
     81{{{
     82[[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]
     83}}}
     84
     85Dies wird folgendermaßen dargestellt:
     86  [[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]
     87
     88=== Anpassung der Darstellung als ''Tabelle'' ===
     89Sie 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:
     90
     91{{{
     92[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]
     93}}}
     94
     95Dies wird folgendermaßen dargestellt:
     96[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]
     97
     98==== Tabellenbreit durchgängige Zeilen ==== #Fullrows
     99Im Format ''table'' können Sie auch tabellenbreit durchgängige Zeilen mit ''rows=<Feld>'' wie folgend einrichten:
     100
     101{{{
     102[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]
     103}}}
     104
     105Dies wird folgendermaßen dargestellt:
     106[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]
     107
     108
     109=== Abfragesprache === #QueryLanguage
     110
     111`query:`-[TracLinks 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 (`\`).
     112
     113Die verfügbaren Operatoren sind:
     114|| '''`=`''' || der Feldinhalt entspricht exakt einem der Werte ||
     115|| '''`~=`''' || der Feldinhalt enthält einen oder mehrere der Werte ||
     116|| '''`^=`''' || der Feldinhalt beginnt mit einem der Werte ||
     117|| '''`$=`''' || der Feldinhalt endet mit einem der Werte ||
     118
     119Jeder dieser Operatoren kann auch negiert werden:
     120|| '''`!=`''' || der Feldinhalt entspricht keinem der Werte ||
     121|| '''`!~=`''' || der Feldinhalt enthält keinen der Werte ||
     122|| '''`!^=`''' || der Feldinhalt beginnt mit keinem der Werte ||
     123|| '''`!$=`''' || der Feldinhalt endet mit keinem der Werte ||
     124
     125Die 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.
     126|| '''`created=2007-01-01..2008-01-01`''' || Suche nach Tickets, die im Jahr 2007 erstellt wurden ||
     127|| '''`created=lastmonth..thismonth`''' || Suche nach Tickets, die während des letzten Monats erstellt wurden ||
     128|| '''`modified=1weekago..`''' || Suche nach Tickets, die in der vergangenen Woche verändert wurden sind ||
     129|| '''`modified=..30daysago`''' || Suche nach Tickets, die während der letzten 30 Tage unverändert geblieben sind ||
     130
     131----
     132Leseempfehlungen: TracTickets, TracReports, TracGuide