Dokumentation: Queries Perfect für Redmine

Beschreibung

Queries Perfect ist ein Plugin für Redmine, das die Möglichkeiten der Filterung und Gruppierung erweitert.

---

Hauptfunktionen

• Fügt ODER- und UND-Logik zu Issue-Filtern hinzu
• Fügt neue Filter und Spalten in Issue-Listen und Arbeitszeiterfassungen hinzu

---

Kompatibilität

Redmine: 5.0 – 6.0

Webbrowser: Chrome, Firefox, Safari, Edge

Datenbanken: MySQL 5.7, MySQL 8.0, PostgreSQL 14–16, SQLite

Plugins: advanced_workflow, redmine_kanban, redmine_advanced_checklists, advanced_charts, appearance_custom, periodic_reminder, user_group_editor, queries_perfect, selectbox_autocompiler, cost_calculator

---

Installation

1. Kopieren Sie den Plugin-Ordner in das Verzeichnis plugins/ von Redmine.
2. Starten Sie den Redmine-Server neu.

---

Glossar

• Root-Issue — das oberste übergeordnete Issue in der Unteraufgaben-Hierarchie. Für jedes untergeordnete Issue ist es das Wurzelelement, von dem die gesamte verschachtelte Kette ausgeht. (Hat ein Issue keine Unteraufgaben, ist es sein eigenes Root-Issue.)

• root_issue
  • child1
    • subchild1
    • subchild2

---

Plugin-Funktionen

Issue-Bereich

Erweiterte Funktionen:

• Neue Spalten

  • Root-Issue
  • Abweichung geschätzte vs. erfasste Zeit
  • Projekt des übergeordneten Issues
  • Status des übergeordneten Issues
  • Status des Root-Issues
  • Fälligkeitsdatum des Root-Issues
  • Fälligkeitsdatum des übergeordneten Issues

• Neue Filter

  • Root-Issue:
    • ID des Root-Issues
    • Status des Root-Issues
    • Tracker des Root-Issues
    • Projekt des Root-Issues
    • Fälligkeitsdatum des Root-Issues
    • Blockiert (Root-Issue)
  • Übergeordnetes Issue:
    • Tracker des übergeordneten Issues
    • Status des übergeordneten Issues
    • Projekt des übergeordneten Issues
  • Unteraufgaben:
    • Tracker der Unteraufgaben
    • Projekt der Unteraufgaben
    • Blockiert (Unteraufgaben)
  • ODER-Filter:
    • UND alle folgenden
    • ODER alle folgenden
    • ODER alle folgenden (UND-Verknüpfung)
    • UND-Gruppe: Beginn / Ende
    • ODER-Gruppe: Beginn / Ende

• Zusammenfassungsfeld: Abweichung geschätzte vs. erfasste Zeit

• Gruppierung nach Root-Issue und übergeordnetem Issue

• Option „Mir, ohne Gruppen“ im Zugewiesen-an-Filter

• Option „Issue-Projekt“ im Filter Projekt des übergeordneten Issues

---

Verwendung

Filter:

• UND alle folgenden: Alle nachfolgenden Filter werden mit ODER verknüpft und in Klammern gruppiert.

• ODER alle folgenden: Alle nachfolgenden Filter werden mit ODER verknüpft und in Klammern gruppiert, mit vorangestelltem ODER.

• ODER alle folgenden (UND-Verknüpfung): Alle nachfolgenden Filter werden mit UND verknüpft und in Klammern gruppiert, mit vorangestelltem ODER.

• UND-Gruppe: Beginn / Ende: Erstellt eine logische Gruppe, in der alle Bedingungen innerhalb erfüllt sein müssen (UND-Logik).

• ODER-Gruppe: Beginn / Ende: Erstellt eine logische Gruppe, in der mindestens eine Bedingung erfüllt sein muss (ODER-Logik).

• Im Zugewiesen-an-Filter wurde die Option „Mir, ohne Gruppen“ hinzugefügt, die nur Issues anzeigt, die direkt dem aktuellen Benutzer zugewiesen sind (ausschließlich Gruppenzuweisungen).

• Im Filter Projekt des übergeordneten Issues wurde die Option „Issue-Projekt“ hinzugefügt, um nur Issues anzuzeigen, deren Projekt sich vom Projekt des übergeordneten Issues unterscheidet.

---

Gruppierung:

Bei Gruppierung nach übergeordnetem oder Root-Issue wird die zusätzliche Option „Im Swimlane anzeigen“ aktiviert.

Diese Option ermöglicht die Anzeige von benutzerdefinierten Feldern vom Typ „Liste“ und/oder dem Status des übergeordneten/Root-Issues im Swimlane:

---

Zusammenfassungsfelder:

Das Zusammenfassungsfeld „Abweichung geschätzte vs. erfasste Zeit“ berechnet die Differenz zwischen geschätztem und tatsächlich erfasstem Aufwand.

---

Arbeitszeiterfassung (Time Entries)

Erweiterte Funktionen:

• Spalten

  • Unique ID
  • Betreff

• Filter

  • Unique ID
  • Text: Betreff

• Gruppierung nach Root-Issue und übergeordnetem Issue

Verwendung

Auf der Seite Arbeitszeiterfassung werden die Spalten „Unique ID“ und „Betreff“ sowie die zugehörigen Filter „Unique ID“ und „Text: Betreff“ hinzugefügt, um Zeiteinträge nach der ID oder dem Betreff des zugehörigen Issues zu durchsuchen.

---

Administration

Bereich Benutzerdefinierte Felder

Das Plugin Queries Perfect erweitert benutzerdefinierte Felder vom Typ „Datum“. Beim Erstellen oder Bearbeiten eines solchen Feldes erscheint die Option:

„Als Filter für Root-Issue verwenden“

Wenn aktiviert, wird zusätzlich zum Standardfilter ein spezieller Filter mit dem Namen <FELDNAME> des Root-Issues zur globalen Filterliste hinzugefügt.