Das Trac Ticket System

Table of Contents

Das Trac Ticket System bietet eine einfache, aber effektive Möglichkeit, Aufgaben, Probleme und Fehler in einem Projekt zu verwalten.

Tickets sind das zentrale Projektmanagement-Element von Trac. Sie werden für Dinge wie Aufgaben, Feature-Wünsche, Fehlermeldungen und sonstigen Support benutzt.

Genau wie das TracWiki wurde dieses Untersystem mit dem Ziel entwickelt, die Beteiligung von Benutzern so einfach wie möglich zu machen. Das Eintragen von Fehlermeldungen und Verbesserungsvorschlägen soll einfach und selbsterklärend funktionieren.

Ein Ticket ist einer Person zugeordnet, die das Ticket entweder erledigen soll, oder es einer anderen Person zuweist. Alle Tickets können jederzeit bearbeitet, mit Anmerkungen versehen, priorisiert oder diskutiert werden.

Ticket-Felder

Ein Ticket enthält die folgenden Informationsfelder:

  • Reporter - Der Autor des Tickets. Hier erscheint Ihr angegebener Name bzw. Mailadresse. Bei eingeloggten Usern der Redaktion erscheint hier der Login-Kurzname.
  • Type - Die Art des Tickets (z.B. Vorschlag, Fehlermeldung, Aufgabe)
  • Component - Der Bereich, den das Ticket betrifft.
  • Version - Die Version, auf die sich das Ticket bezieht.
  • Keywords - Schlüsselwörter, die es erleichtern sollen, das Ticket bei der Suche oder in Reports wiederzufinden.
  • Priority - Priorität des Tickets. Es gibt vier Stufen von kritisch bis unwichtig.
  • Milestone - Der Meilenstein, mit dem das Ticket erledigt werden soll.
  • Assigned to/Owner - Die für die Erledigung verantwortliche Person.
  • Cc - Eine Liste von Personen, die mit dem Ticket verbunden sind. Dies bedeutet keine Verantwortlichkeit für die Erledigung oder sonst irgendeine Verpflichtung.

  • Status - Status des Tickets. Mögliche Werte sind new (neu), assigned (zugewiesen), closed (erledigt), reopened (wiedereröffnet).
  • Resolution - Grund, weshalb ein Ticket als erledigt (closed) gekennzeichnet wurde. Mögliche Werte fixed (behoben), invalid (ungültig), wontfix (wird nicht behoben), duplicate (wurde doppelt gemeldet), worksforme (Fehler kann nicht nachvollzogen werden).
  • Summary - Die Kurzfassung der Problembeschreibung.
  • Description - Der eigentliche Text des Tickets, der das Problem, den Vorschlag oder die Aufgabe ausführlicher beschreibt.
  • URL - Wenn das Ticket auf eine konkrete URL verweist, ist dieses Feld gefüllt. Das erlaubt u.A. die Suche nach Tickets, die dieselbe URL haben, und erleichtert das Auffinden von Duplikaten.
  • SELFHTML-Kapitel - Bei Tickets, die sich auf die Komponente "SELFHTML-Doku" beziehen, kann hier eine genauere Angabe zum passenden Kapitel gemacht werden - das erleichtert den Überblick und die Zuordnung zum Zuständigen.

Note: Die Felder type (TicketTypes?), component (TicketComponent?), version (TicketVersion?), priority (TicketPriority?) und severity (TicketSeverity?) können alle durch das Kommandozeilentool trac-admin administriert werden.

Ändern und Kommentieren von Tickets

Sobald ein Ticket in Trac eingetragen wurde, können Sie es jederzeit ergänzen, indem Sie Anmerkungen hinzufügen. Alle Veränderungen am Ticket werden nämlich geloggt und sichtbar eingetragen, so dass der zeitliche Verlauf später jederzeit nachvollziehbar ist.

Als nicht eingeloggter Benutzer können Sie lediglich Kommentare zu einem Ticket hinzufügen, sowie Dateien anhängen. Als eingeloggter Redakteur können alle Parameter eines Tickets verändert werden.

Note: Ein wichtiges Feature ist die Benutzbarkeit von TracLinks und WikiFormatting in der Ticket-Beschreibung und den Kommentaren. Benutzen Sie TracLinks, um zu anderen Tickets, Wiki-Seiten oder URLs zu verlinken und so diese Informationen leichter abrufbar zu machen.

State Diagram

http://projects.edgewall.com/trac/attachment/wiki/TracTickets/Trac%20Ticket%20State%20Chart%2020060603DF.png?format=raw

Standardwerte für Drop-Down-Felder

Die Standardwerte für die diversen Dowp-Down-Felder werden in der Datei trac.ini in the [ticket] section definiert:

  • default_component: Name der Standard-Komponente
  • default_milestone: Name des Standard-Meilensteins
  • default_priority: Standard-Priorität
  • default_type: Standard-Tickettyp
  • default_version: Standard-Version

Wenn eine dieser Optionen nicht gesetzt ist, wird entweder der erste Wert der Liste oder ein leerer Wert verwendet, je nachdem, ob das Feld verpflichtend ausgefüllt sein muß, oder nicht.

Felder verstecken und eigene Felder hinzufügen

Viele der Standard-Felder können versteckt werden, indem alle definierten Werte durch trac-admin gelöscht werden. Das funktioniert natürlich nur bei Drop-Down-Feldern wie type, priority, severity, component, version oder milestone.

Trac erlaubt auch das Hinzufügen von selbstdefinierten Feldern. Siehe TracTicketsCustomFields? für Details.

Assign-to als Drop-Down-Liste

Wenn die Liste der möglichen Ticket-Besitzer endlich ist, kann das Ticket-Feld von einem Textfeld in ein Drop-Down-Feld geändert werden, indem die Option restrict_owner im [ticket]-Abschnitt der trac.ini auf “true” gesetzt wird. In diesem Fall wird Trac alle User auflisten, die sich bislang eingeloggt haben.

Um in der Liste zu erscheinen, muss ein User mindestens einmal eine Veränderung an Trac gesendet haben, beispielsweise indem er die Daten in der Settings-Seite verändert bzw. ausfüllt. Außerdem muß er das Recht TICKET_MODIFY besitzen.

Voreingestellte Werte für neue Tickets

Um einen Link zu erstellen, der das Formular New Ticket mit vorbelegten Werten aufruft, sind an die URL /newticket? die passenden Parameter anzugängen in der Form variable=value, getrennt durch das &.

Mögliche Werte sind:

  • type - Ein Wert der Type-Liste
  • reporter - Name oder Email des Meldenden
  • summary - Zusammenfassung des Tickets
  • description - Beschreibung des Tickets
  • component - Ein Wert der Komponentenliste
  • version - Ein Wert der Versionsliste
  • keywords - Keywords
  • priority - Ein Wert der Prioritätsliste
  • milestone - Ein Wert der Meilensteinliste
  • owner - Eine Person, der das Ticket zugewiesen wird
  • cc - Liste der Personen, die für das Ticket auf CC stehen sollen
  • URL - Zugeordnete URL des Tickets.
  • chapter - Das Feld "SELFHTML-Kapitel"

Beispiel: https://redaktion.selfhtml.org/newticket?component=SELFHTML-Doku&version=SELFHTML%208.1.2

Verweise zu verwandten Themen: TracGuide, TracWiki, TracTicketsCustomFields?, TracNotification

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