Queries Perfect

Opis

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

Kluczowe funkcje

• Dodaje OR i AND w filtrach zadań
• Dodaje grupowanie według zadania nadrzędnego i najwyższego poziomu
• Dodaje nowe filtry i kolumny w listach zadań i rejestrach czasu

---

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_workflows, redmine_kanban, redmine_advanced_checklists, advanced_charts, appearance_custom, module_manager, periodic_reminder, user_group_editor, selectbox_autocompiler, cost_calculator.

---

Instalacja i aktualizacja

1. Usuń starą wersję wtyczki z Redmine, jeśli istnieje.

   cd redmine/plugins
   rm -r queries_perfect
   

2. Skopiuj nowy folder wtyczki queries_perfect do redmine/plugins/.

3. Uruchom migracje w głównym katalogu Redmine.

   bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=queries_perfect
   

4. Zatrzymaj i uruchom Redmine. (W niektórych instalacjach Redmine (np. Docker) ważne jest, aby zatrzymać i uruchomić serwer, a nie tylko go zrestartować.)

---

Odinstalowywanie

1. Wykonaj polecenie odinstalowujące w głównym katalogu Redmine.

bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=queries_perfect VERSION=0

2. Usuń folder wtyczki queries_perfect z redmine/plugins/.

rm -r queries_perfect

3. Zatrzymaj i uruchom Redmine.

---

Konfiguracja

Ta wtyczka nie ma ustawień.

---

Glosariusz

• Zadanie najwyższego poziomu (root issue) — to najwyższy rodzic w hierarchii podzadań. Dla każdego zadania potomnego jest to element główny, od którego zaczyna się cały łańcuch zagnieżdżonych zadań. (Jeśli zadanie nie ma podzadań, to samo jest dla siebie zadaniem najwyższego poziomu.)

  >root_issue
    \_ child1
      \_ subchild1
      \_ subchild2
  

Funkcjonalności Wtyczki

Sekcja "Zadania"

Rozszerzenie funkcjonalności

• Nowe kolumny
  • Zadanie najwyższego poziomu
  • Odchylenie czasu
  • Projekt zadania nadrzędnego
  • Status zadania nadrzędnego
  • Status zadania najwyższego poziomu
  • Termin zakończenia zadania najwyższego poziomu
  • Termin zakończenia zadania nadrzędnego
• Nowe filtry
  • Zadanie najwyższego poziomu:
    • ID zadania najwyższego poziomu
    • Status zadania najwyższego poziomu
    • Tracker zadania najwyższego poziomu
    • Projekt zadania najwyższego poziomu
    • Termin zakończenia zadania najwyższego poziomu
    • Blokada zadania najwyższego poziomu
  • Zadanie nadrzędne:
    • Tracker zadania nadrzędnego
    • Status zadania nadrzędnego
    • Projekt zadania nadrzędnego
  • Podzadania:
    • Tracker podzadań
    • Projekt podzadań
    • Blokada podzadań
  • Filtry OR:
    • AND any following
    • OR any following
    • OR all following
    • Początek i koniec bloku AND
    • Początek i koniec bloku OR
• Pole sumaryczne "Odchylenie czasu"
• Grupowanie według zadania najwyższego poziomu i zadania nadrzędnego.
• Opcja « do mnie, bez grup » w filtrze « Przypisany do »
• Opcja « Projekt zadania » w filtrze « Projekt zadania nadrzędnego »

---

Filtry

• AND any following: wszystkie kolejne filtry zostaną połączone operatorem OR i umieszczone w nawiasach.

• OR any following: wszystkie kolejne filtry zostaną połączone operatorem OR i umieszczone w nawiasach. Przed nawiasami będzie operator OR.

• OR all following: wszystkie kolejne filtry zostaną połączone operatorem AND i umieszczone w nawiasach. Przed nawiasami będzie operator OR.

• Początek i koniec bloku AND: tworzy logiczną grupę warunków połączonych operatorem AND. Wszystkie filtry znajdujące się między początkiem a końcem bloku muszą być spełnione łącznie.

• Początek i koniec bloku OR: tworzy logiczną grupę warunków połączonych operatorem OR. Wystarczy spełnienie któregokolwiek z filtrów w bloku.

• W filtrze « Przypisany do » dodano pozycję « do mnie, bez grup », która wyświetla zadania przypisane bezpośrednio do bieżącego użytkownika, z wyłączeniem zadań przypisanych do grup, do których należy.

• W filtrze « Projekt zadania nadrzędnego » dodano pozycję « Projekt zadania », umożliwiającą wyświetlanie tylko tych zadań, których projekt różni się od projektu zadania nadrzędnego.

---

Grupowanie

Wtyczka dodaje grupowanie według zadania nadrzędnego i najwyższego poziomu.

Podczas grupowania zadań według zadania nadrzędnego lub najwyższego poziomu staje się dostępna dodatkowa opcja « Wyświetl na pasie ».

Opcja ta pozwala wyświetlić na pasie wartość pól niestandardowych typu "Lista" i/lub "Status zadania" dla zadania nadrzędnego/najwyższego poziomu:

---

Pola sumaryczne

Pole sumaryczne « Odchylenie czasu » oblicza różnicę między oszacowaniem czasu a rzeczywistym czasem pracy.

---

Sekcja "Rejestry czasu"

Rozszerzenie funkcjonalności

• Kolumny

  • Unikalny identyfikator
  • Temat

• Filtry

  • Unikalny identyfikator
  • Tekst: Temat

• Grupowanie według zadania najwyższego poziomu i zadania nadrzędnego.

Użycie

Na stronie « Rejestry czasu » dodawane są kolumny « Unikalny identyfikator » i « Temat », a także odpowiadające im filtry « Unikalny identyfikator » i « Tekst: Temat », umożliwiające wyszukiwanie wpisów czasu według identyfikatora lub tematu zadania, do którego się odnoszą.

---

Administracja

Sekcja "Pola niestandardowe"

Wtyczka Queries Perfect rozszerza możliwości pól niestandardowych typu « Data ». Podczas tworzenia lub edycji takiego pola pojawia się opcja:

« Użyj jako filtra dla zadania najwyższego poziomu »

Jeśli zostanie aktywowana, do ogólnej listy filtrów, oprócz standardowego filtra dla tego pola, zostanie dodany specjalny filtr o nazwie **<NAZWA_POLA> zadania najwyższego poziomu**.