Version 1.3.0 · Redmine 5.1 und 6 · GPLv2
Dieses Handbuch beschreibt Installation, Konfiguration und täglichen Einsatz des atori-Checklisten-Plugins.
Das Plugin ergänzt die Redmine-Ticket-Ansicht um eine Checkliste pro Ticket. Einträge liegen direkt am zugehörigen Ticket; es gibt kein separates Modell, keine projektweiten Vorlagen und kein globales Register. Jede Änderung an einem Eintrag – hinzufügen, umbenennen, abhaken, entfernen, alles leeren – wird in das Ticket-Journal geschrieben, sodass die vollständige Historie dort liegt, wo Anwender ohnehin nachschauen.
Zentrale Begriffe:
cd /pfad/zu/redmine
unzip at_checklist-1.4.0.zip -d plugins/
bundle exec rake redmine:plugins:migrate NAME=at_checklist RAILS_ENV=production
# Redmine neu startencd /pfad/zu/redmine
git clone <repo-url> plugins/at_checklist
bundle exec rake redmine:plugins:migrate NAME=at_checklist RAILS_ENV=production
# Redmine neu startenAls Administrator einloggen und Administration → Plugins öffnen. Das Plugin Checklist sollte mit Version 1.3.0 erscheinen.
cd /pfad/zu/redmine
bundle exec rake redmine:plugins:migrate NAME=at_checklist VERSION=0 RAILS_ENV=production
rm -rf plugins/at_checklist
# Redmine neu startenDer Rake-Task entfernt die einzige vom Plugin verwaltete Tabelle (at_checklist_items). Bestehende Ticketdaten werden nicht angerührt.
Das Plugin ist als Projekt-Modul eingebunden und standardmäßig deaktiviert.
Zwei unabhängige Rechte stehen unter Administration → Rollen und Rechte → Checklist zur Verfügung:
| Recht | Wirkung | Typische Rolle |
|---|---|---|
| Checkliste ansehen | Nur lesender Zugriff auf Checklisten | Berichterstatter |
| Checkliste verwalten | Einträge hinzufügen / umbenennen / abhaken / entfernen | Entwickler, Manager |
Die Trennung von Lesen und Verwalten erlaubt es, Berichterstattern den Fortschritt zu zeigen, ohne dass sie Einträge ändern können.
Ist das Modul aktiv, wird eine Checklist-Sektion per Redmine-Ticket-Hook in die Ticket-Ansicht eingefügt. Kein zusätzlicher Menüeintrag, keine separate Seite – die Checkliste lebt direkt neben der Beschreibung.
In der Checklisten-Sektion auf Hinzufügen klicken, Text eingeben, mit Enter bestätigen. Der Eintrag erscheint sofort, ein Journaleintrag wird geschrieben.
Um mehrere Einträge in einem Rutsch anzulegen, mehrzeiligen Text in das Eingabefeld einfügen. Jede Zeile wird zu einem Checklisten-Eintrag, und ein einzelner aggregierter Journaleintrag hält die Sammelaktion fest. Praktisch, um Vorlagen aus Texteditor oder Wiki zu übernehmen.
Das Kontrollkästchen neben einem Eintrag klicken. Der Erledigt-Status wechselt, ein Journaleintrag wird geschrieben („als erledigt markiert" / „als offen markiert"). Der Fortschrittsbalken aktualisiert sich ohne Seitenneuladen.
Auf den Eintrag-Text klicken, um ihn zu einem Eingabefeld zu machen, ändern, mit Enter bestätigen. Die Änderung landet mit altem und neuem Text im Journal („umbenannt von X in Y"), sodass die Bearbeitungshistorie nachvollziehbar bleibt.
Auf das × neben dem Eintrag klicken. Der Journaleintrag enthält den gelöschten Text. Für einzelne Einträge gibt es keine Rückfrage – das hält den Regelfall schnell.
Oben in der Checkliste Alle entfernen klicken, die Rückfrage bestätigen. Sämtliche Einträge werden gelöscht, ein einzelner Journaleintrag hält die Anzahl der entfernten Einträge fest.
Die Wahrheit liegt im Ticket-Journal. Über den Verlauf-Tab des Tickets lässt sich jede Checklisten-Änderung nachvollziehen, einschließlich wann und von wem. Separate Logs, Exporte oder Berichte sind nicht nötig.
Checklisten-Sektion erscheint nicht am Ticket. Prüfen, ob das Modul Checklist in den Projekteinstellungen aktiviert ist und ob die Rolle des Benutzers im Projekt das Recht Checkliste ansehen besitzt.
Hinzufügen oder Bearbeiten funktioniert nicht. Prüfen, ob die Rolle das Recht Checkliste verwalten hat. Die Schaltflächen bleiben mit reinem Leserecht sichtbar, weil die Sektion die Rohdaten anzeigt – schreibende Aktionen werden aber abgelehnt.
Fortschrittsbalken sieht falsch aus. Ticketseite neu laden. Das Fortschrittsverhältnis wird serverseitig aus dem aktuellen Eintrag-Set berechnet; eine veraltete Browser-Ansicht nach paralleler Bearbeitung durch andere Benutzer ist die häufigste Ursache.
Bulk-Add legt nur einen Eintrag an statt mehrerer. Sicherstellen, dass der mehrzeilige Text echte Zeilenumbrüche enthält (Enter-Taste) und nicht literale \n-Sequenzen. Einfügen aus Texteditoren funktioniert zuverlässig; aus Tabellen-Zellen werden Umbrüche manchmal entfernt.
Support ist für zwölf Monate ab Kaufdatum enthalten und deckt Fehlermeldungen, Konfigurationsfragen und Kompatibilitätsprobleme ab.
E-Mail: support@atori.de Erstreaktion: werktags innerhalb von 48 Stunden.
Bitte in Supportanfragen angeben:
log/production.log, sofern verfügbar