Dokumentacja: Queries Perfect dla Redmine

Opis

Queries Perfect to wtyczka do Redmine, która rozszerza możliwości filtrowania i grupowania.

---

Główne funkcje

• Dodaje logikę LUB i ORAZ do filtrów zgłoszeń
• Dodaje nowe filtry i kolumny do list zgłoszeń oraz czasu pracy

---

Zgodność

Redmine: 5.0 - 6.0

Przeglądarki internetowe: Chrome, Firefox, Safari, Edge

Bazy danych: MySQL 5.7, MySQL 8.0, PostgreSQL 14-16, SQLite

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

---

Instalacja

1. Skopiuj folder wtyczki do katalogu plugins/ Redmine.
2. Zrestartuj serwer Redmine.

---

Słownik

• Zgłoszenie główne (root issue) — najwyższe zgłoszenie nadrzędne w hierarchii podzadań. Dla każdego zgłoszenia podrzędnego jest to element główny, od którego zaczyna się cała zagnieżdżona struktura. (Jeśli zgłoszenie nie ma podzadań, jest samym sobą zgłoszeniem głównym.)

• root_issue
  • child1
    • subchild1
    • subchild2

---

Funkcje wtyczki

Sekcja Zgłoszenia (Issues)

Rozszerzone funkcje:

• Nowe kolumny

  • Zgłoszenie główne
  • Odchylenie: szacowany vs. faktyczny czas
  • Projekt nadrzędny
  • Status nadrzędny
  • Status główny
  • Termin główny
  • Termin nadrzędny

• Nowe filtry

  • Zgłoszenie główne:
    • ID zgłoszenia głównego
    • Status główny
    • Tracker główny
    • Projekt główny
    • Termin główny
    • Zablokowane (główne)
  • Zgłoszenie nadrzędne:
    • Tracker nadrzędny
    • Status nadrzędny
    • Projekt nadrzędny
  • Podzadania:
    • Tracker podzadań
    • Projekt podzadań
    • Zablokowane (podzadania)
  • Filtry LUB:
    • ORAZ wszystkie następne
    • LUB wszystkie następne
    • LUB wszystkie następne (ORAZ wewnętrzne)
    • Początek / koniec grupy ORAZ
    • Początek / koniec grupy LUB

• Pole podsumowujące: Odchylenie: szacowany vs. faktyczny czas

• Grupowanie wg zgłoszenia głównego i zgłoszenia nadrzędnego

• Opcja „Dla mnie, bez grup” w filtrze Przypisane do

• Opcja „Projekt zgłoszenia” w filtrze Projekt nadrzędny

---

Użycie

Filtry:

• ORAZ wszystkie następne: wszystkie kolejne filtry są łączone operatorem LUB i grupowane w nawiasach.

• LUB wszystkie następne: wszystkie kolejne filtry są łączone operatorem LUB i grupowane w nawiasach, poprzedzone LUB.

• LUB wszystkie następne (ORAZ wewnętrzne): wszystkie kolejne filtry są łączone operatorem ORAZ i grupowane w nawiasach, poprzedzone LUB.

• Początek / koniec grupy ORAZ: tworzy grupę logiczną, w której wszystkie warunki wewnętrzne muszą być spełnione (logika ORAZ).

• Początek / koniec grupy LUB: tworzy grupę logiczną, w której wystarczy spełnienie jednego z warunków (logika LUB).

• W filtrze Przypisane do dodano opcję „Dla mnie, bez grup”, która wyświetla tylko zgłoszenia przypisane bezpośrednio bieżącemu użytkownikowi, wykluczając te przypisane do grup, do których należy.

• W filtrze Projekt nadrzędny dodano opcję „Projekt zgłoszenia”, która wyświetla tylko zgłoszenia, których projekt różni się od projektu zgłoszenia nadrzędnego.

---

Grupowanie:

Podczas grupowania zgłoszeń wg zgłoszenia nadrzędnego lub głównego dostępna jest dodatkowa opcja „Wyświetl na pasie (swimlane)”.

Opcja ta pozwala wyświetlić na pasie wartości pól niestandardowych typu „Lista” i/lub Status zgłoszenia nadrzędnego/głównego:

---

Pola podsumowujące:

Pole podsumowujące „Odchylenie: szacowany vs. faktyczny czas” oblicza różnicę między szacowanym czasem a faktycznie wprowadzonym czasem pracy.

---

Sekcja Czas pracy (Time Entries)

Rozszerzone funkcje:

• Kolumny

  • Unikalny ID
  • Temat

• Filtry

  • Unikalny ID
  • Tekst: Temat

• Grupowanie wg zgłoszenia głównego i zgłoszenia nadrzędnego

Użycie

Na stronie Czas pracy dodawane są kolumny „Unikalny ID” i „Temat”, a także odpowiednie filtry „Unikalny ID” i „Tekst: Temat”, umożliwiające wyszukiwanie czasu pracy według ID lub tematu powiązanego zgłoszenia.

---

Administracja

Sekcja Pola niestandardowe

Wtyczka Queries Perfect rozszerza pola niestandardowe typu „Data”. Podczas tworzenia lub edycji takiego pola pojawia się opcja:

„Użyj jako filtr dla zgłoszenia głównego”

Jeśli jest włączona, oprócz standardowego filtra, do globalnej listy filtrów dodawany jest specjalny filtr o nazwie <NAZWA_POLA> zgłoszenia głównego.