Documentazione: Queries Perfect per Redmine

Descrizione

Queries Perfect è un plugin per Redmine che estende le funzionalità di filtraggio e raggruppamento.

---

Funzionalità principali

• Aggiunge la logica OR e AND ai filtri delle issue
• Aggiunge nuovi filtri e colonne nelle liste issue e nelle registrazioni di tempo

---

Compatibilità

Redmine: 5.0 - 6.0

Browser Web: Chrome, Firefox, Safari, Edge

Database: 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.

---

Installazione

1. Copiare la cartella del plugin nella directory plugins/ di Redmine.
2. Riavviare il server Redmine.

---

Glossario

• Issue radice (root issue) — l’issue superiore nella gerarchia delle sotto-issue. Per qualsiasi issue figlia, è l’elemento radice da cui inizia l’intera catena annidata. (Se un’issue non ha sotto-issue, è essa stessa la radice.)

• root_issue
  • child1
    • subchild1
    • subchild2

---

Funzionalità del plugin

Sezione Issue

Funzionalità estese:

• Nuove colonne

  • Issue radice
  • Scostamento stima vs. tempo registrato
  • Progetto del padre
  • Stato del padre
  • Stato radice
  • Data di scadenza radice
  • Data di scadenza del padre

• Nuovi filtri

  • Issue radice:
    • ID radice
    • Stato radice
    • Tracker radice
    • Progetto radice
    • Data di scadenza radice
    • Bloccata (radice)
  • Issue padre:
    • Tracker padre
    • Stato padre
    • Progetto padre
  • Sotto-issue:
    • Tracker sotto-issue
    • Progetto sotto-issue
    • Bloccata (sotto-issue)
  • Filtri OR:
    • AND tutte le seguenti
    • OR tutte le seguenti
    • OR tutte le seguenti (AND interno)
    • Inizio / fine gruppo AND
    • Inizio / fine gruppo OR

• Campo riepilogativo: Scostamento stima vs. tempo registrato

• Raggruppamento per issue radice e issue padre

• Opzione «A me, escludendo gruppi» nel filtro Assegnato a

• Opzione «Progetto dell’issue» nel filtro Progetto del padre

---

Utilizzo

Filtri:

• AND tutte le seguenti: Tutti i filtri successivi sono uniti con OR e raggruppati tra parentesi.

• OR tutte le seguenti: Tutti i filtri successivi sono uniti con OR e raggruppati tra parentesi, preceduti da OR.

• OR tutte le seguenti (AND interno): Tutti i filtri successivi sono uniti con AND e raggruppati tra parentesi, preceduti da OR.

• Inizio / fine gruppo AND: Crea un gruppo logico in cui tutte le condizioni interne devono essere soddisfatte (logica AND).

• Inizio / fine gruppo OR: Crea un gruppo logico in cui è sufficiente che sia soddisfatta almeno una condizione (logica OR).

• Nel filtro Assegnato a, l’opzione «A me, escludendo gruppi» mostra solo le issue assegnate direttamente all’utente corrente, escludendo quelle assegnate ai gruppi di cui fa parte.

• Nel filtro Progetto del padre, l’opzione «Progetto dell’issue» mostra solo le issue il cui progetto differisce da quello dell’issue padre.

---

Raggruppamento:

Quando si raggruppa per issue padre o issue radice, diventa disponibile l’opzione aggiuntiva «Mostra nella swimlane».

Questa opzione permette di visualizzare nella swimlane i valori dei campi personalizzati di tipo «Elenco» e/o lo Stato dell’issue padre/radice:

---

Campi riepilogativi:

Il campo riepilogativo «Scostamento stima vs. tempo registrato» calcola la differenza tra il tempo stimato e il tempo effettivamente registrato.

---

Sezione Registrazioni di tempo (Time Entries)

Funzionalità estese:

• Colonne

  • ID univoco
  • Oggetto

• Filtri

  • ID univoco
  • Testo: Oggetto

• Raggruppamento per issue radice e issue padre

Utilizzo

Nella pagina Registrazioni di tempo, vengono aggiunte le colonne «ID univoco» e «Oggetto», nonché i filtri corrispondenti «ID univoco» e «Testo: Oggetto», permettendo di cercare registrazioni di tempo in base all’ID o all’oggetto dell’issue associata.

---

Amministrazione

Sezione Campi personalizzati

Il plugin Queries Perfect estende i campi personalizzati di tipo «Data». Durante la creazione o modifica di un campo di questo tipo, compare l’opzione:

«Usa come filtro per l’issue radice»

Se attivata, oltre al filtro standard, viene aggiunto un filtro specifico denominato <NOME_CAMPO> dell’issue radice nell’elenco globale dei filtri.