Workflow Avanzato

Descrizione

Plugin per la configurazione flessibile e l'automazione dei processi aziendali. Consente di configurare ed eseguire automaticamente scenari complessi che vanno oltre i workflow standard di Redmine. Il sistema flessibile di "Regole Personalizzate" permette di impostare restrizioni specifiche.

---

Funzionalità Chiave

• Nuovo formato di campo personalizzato: "Data e Ora"
• Regole Personalizzate
• Azioni Automatiche

---

Compatibilità

Redmine: 5.0 - 6.1

Browser Web: Chrome, Firefox, Safari, Edge

Database: MySQL 5.7, MySQL 8.0, PostgreSQL 14-16, SQLite

Plugin: redmine_kanban, redmine_advanced_checklists, advanced_charts, appearance_custom, module_manager, periodic_reminder, user_group_editor, queries_perfect, selectbox_autocompiler, cost_calculator.

---

Installazione e Aggiornamento

1. Rimuovere la vecchia versione del plugin da Redmine, se esistente.

   cd redmine/plugins
   rm -r advanced_workflow
   

2. Copiare la nuova cartella del plugin advanced_workflow in redmine/plugins/
3. Eseguire le migrazioni nella directory principale di Redmine

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

4. Fermare e avviare Redmine. (In alcune installazioni di Redmine (ad esempio, in Docker), è importante fermare e avviare il server, non solo riavviarlo.)

---

Rimozione

1. Eseguire il comando di eliminazione nella directory principale di Redmine

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

2. Rimuovere la cartella del plugin advanced_workflow da redmine/plugins/

    rm -r advanced_workflow

3. Fermare e avviare Redmine.

---

Configurazione

1. Configurare i ruoli utente in Amministrazione -> Ruoli e Permessi.

2. Abilitare il modulo "Workflow Avanzato" per i progetti nelle impostazioni di ciascun progetto.

3. Verificare e modificare le altre impostazioni del plugin in Amministrazione -> Moduli -> Workflow Avanzato.

---

Amministrazione

Sezione "Ruoli e Permessi"

• Gestisci regole a livello di progetto - Accesso per modificare regole e azioni all'interno del progetto.

---

Sezione "Campi personalizzati"

Il plugin Workflow Avanzato aggiunge un nuovo formato di campo personalizzato "Data e Ora"

"Data e Ora" può essere utilizzato come filtro (condizione)

Opzioni disponibili:

• Ora successiva - Il filtro include le issue in cui il valore del campo "Data e Ora" rientra nell'ora successiva rispetto all'ora UTC corrente.

---

Sezione "Moduli"

In Amministrazione -> Moduli -> Workflow Avanzato è possibile configurare:

• Esegui come utente - Possibilità di selezionare l'amministratore per conto del quale verranno eseguite le azioni secondo la pianificazione

• Numero massimo di issue durante l'esecuzione di azioni pianificate

---

Sezione "Regole personalizzate"

Le regole personalizzate consentono di impostare restrizioni sull'assegnazione delle issue agli utenti in condizioni specifiche.

In Amministrazione -> Regole personalizzate è possibile creare e configurare le regole:

Creazione di una regola

Durante la creazione, specificare il nome e l'attività:

Modifica delle regole

Dopo aver creato una regola, appare la possibilità di modificare le condizioni e le restrizioni.

Condizioni possibili:

• Progetto
• Tracker
• Versione
• Autore
• Utente corrente
• Assegnato al gruppo
• Gruppo autore
• Assegnato al ruolo
• Ruolo dell'utente corrente
• Stato dell'issue
• Tracker dell'issue padre
• Versione dell'issue padre
• Campi personalizzati "Issue" con tipi "Elenco", "Testo", "Float", "Integer", "Data", "Data e Ora".
• Campi personalizzati "Progetti" con tipi "Elenco", "Testo", "Float", "Integer", "Data".

Restrizioni possibili:

• Assegnatario
• Assegnato al gruppo
• Ruolo dell'assegnatario
• Data di scadenza
• Tracker
• Versione

---

Sezione "Azioni automatiche"

Le azioni automatiche consentono di eseguire azioni selezionate al salvataggio di un'issue o secondo una pianificazione, all'interno di condizioni specificate.

In Amministrazione -> Azioni automatiche è possibile creare e configurare le Azioni:

Creazione di azioni

Durante la creazione, specificare il nome, il metodo di esecuzione e l'attività.

Le azioni possono essere eseguite in due modi diversi:

• Al salvataggio - le azioni verranno eseguite istantaneamente durante la creazione/modifica dell'issue.

• Cron job - le regole verranno eseguite periodicamente secondo la pianificazione cron.

Modifica delle azioni

Dopo aver creato un'azione, appare la possibilità di modificare le condizioni e le azioni.

Condizioni possibili:

• Filtri standard per le issue
• Filtri personalizzati per le issue

Azioni possibili:

• Assegnatario
• Disabilita salvataggio
• Invia email
• Stato
• Tracker
• Versione
• Versione delle sottoissue aperte
• Watcher
• Webhook (GET)
• Webhook Mattermost
• Webhook Telegram
• Checklist (se è installato il plugin :redmine_advanced_checklists)

Per le azioni "Invia email", "Webhook (GET)", "Webhook Mattermost" e "Webhook Telegram" sono disponibili variabili di azione.

---

Utilizzo

Abilitazione di regole e azioni

Dopo aver creato regole e azioni, è necessario abilitarle separatamente nelle impostazioni del progetto.

Per fare ciò, vai su:

Progetto -> Impostazioni -> Regole personalizzate, abilita le regole necessarie in questo progetto.

Progetto -> Impostazioni -> Azioni automatiche, abilita le azioni necessarie in questo progetto.

Regole personalizzate

Restrizioni disponibili che verranno applicate quando le condizioni sono soddisfatte:

Assegnatario:

L'issue può essere assegnata solo agli utenti selezionati.

Gruppo dell'assegnatario:

L'issue può essere assegnata solo agli utenti membri dei gruppi selezionati.

Ruolo dell'assegnatario:

L'issue può essere assegnata solo agli utenti con il ruolo selezionato per il progetto.

Data di scadenza:

La data di scadenza dell'issue può essere specificata solo all'interno di un intervallo di date definito.

Tracker:

Le issue possono avere solo i tracker selezionati.

Versione:

Le issue possono avere solo le versioni selezionate.

Azioni automatiche

Metodo di esecuzione "Cron job"

Le azioni verranno eseguite periodicamente secondo la pianificazione cron.

Affinché l'azione automatica funzioni correttamente, è necessario aggiungere un nuovo comando al crontab del server, che esegue il comando bundle exec rake advanced_workflows:run_actions

Esempio di comando:

*/5 * * * * cd /absolute/path/to/redmine && redmine bundle exec rake advanced_workflows:run_actions >> /absolute/path/to/redmine/logs/cron_advanced_workflows.log

Aggiungere questo comando a cron per conto dell'utente sotto il quale è in esecuzione Redmine, sostituendo /percorso/assoluto/a/redmine con il percorso assoluto alla cartella di installazione di Redmine.

Il comando cron verrà eseguito ogni 5 minuti */5 * * * *

Tutti i messaggi standard verranno aggiunti al file .../logs/cron_advanced_workflows.log

Azioni disponibili che verranno eseguite quando le condizioni sono soddisfatte:

Webhook (GET):

Invia una richiesta GET all'URL specificato. Utilizzato per l'integrazione con sistemi esterni, ad esempio, per la sincronizzazione con Jira.

Supporta tutte le variabili del campo issue.

Webhook Mattermost:

Invia un messaggio all'URL specificato in formato Mattermost. Per l'integrazione con Mattermost.

Supporta tutte le variabili del campo issue.

Webhook Telegram

Invia un messaggio all'URL specificato in formato Telegram. Per l'integrazione con Telegram

Supporta tutte le variabili del campo issue.

Invia email:

Invia un'email agli utenti specificati o agli utenti nei gruppi.

Supporta tutte le variabili del campo issue.

Versione:

Cambia automaticamente la versione dell'issue.

• Sostituisci con la versione dell'issue corrente - Sostituisci la versione dell'issue con la versione corrente (effettiva) del progetto.

Versione delle sottoissue aperte:

• Cambia in - Cambia la versione di tutte le sottoissue aperte in quella specificata.

• Imposta uguale alla versione dell'issue - Cambia la versione di tutte le sottoissue aperte alla versione dell'issue.

Disabilita salvataggio:

Disabilita la creazione/modifica dell'issue.

Watcher:

Aggiunge i watcher specificati all'issue.

Stato:

Cambia lo stato dell'issue in quello specificato.

Tracker:

Cambia il tracker dell'issue in quello specificato.

Checklist:

Disponibile se è installato il plugin :redmine_advanced_checklists.

Crea automaticamente una checklist dai modelli quando le condizioni sono soddisfatte.

Usa modelli pre-preparati.