Erweiterter Workflow

Beschreibung

Plugin für flexible Konfiguration und Automatisierung von Geschäftsprozessen. Es ermöglicht Ihnen, komplexe Szenarien zu konfigurieren und automatisch auszuführen, die über die standardmäßigen Redmine-Workflows hinausgehen. Und das flexible System der "Benutzerdefinierten Regeln" ermöglicht es Ihnen, spezifische Einschränkungen festzulegen.

Hauptmerkmale

Neues benutzerdefiniertes Feldformat: "Datum und Uhrzeit"
Benutzerdefinierte Regeln
Automatische Aktionen

Kompatibilität

Redmine: 5.0 - 6.1

Webbrowser: Chrome, Firefox, Safari, Edge

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

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

Installation und Aktualisierung

Entfernen Sie die alte Version des Plugins von Redmine, falls vorhanden.
```
cd redmine/plugins
rm -r advanced_workflow
```
Kopieren Sie den neuen Plugin-Ordner advanced_workflow nach redmine/plugins/

Führen Sie Migrationen im Redmine-Stammverzeichnis aus

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

Stoppen und starten Sie Redmine. (Bei einigen Redmine-Installationen (z. B. in Docker) ist es wichtig, den Server zu stoppen und zu starten, nicht nur neu zu starten.)

Entfernung

Führen Sie den Löschbefehl im Redmine-Stammverzeichnis aus

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

Entfernen Sie den Plugin-Ordner advanced_workflow aus redmine/plugins/

    rm -r advanced_workflow

Stoppen und starten Sie Redmine.

Konfiguration

Konfigurieren Sie Benutzerrollen unter Administration -> Rollen und Berechtigungen.
Aktivieren Sie das Modul "Erweiterte Workflows" für Projekte in den Einstellungen jedes Projekts.
Überprüfen und ändern Sie andere Plugin-Einstellungen unter Administration -> Module -> Erweiterte Workflows.

Administration

Abschnitt "Rollen und Berechtigungen"

Projektbezogene Regeln verwalten - Zugriff zum Bearbeiten von Regeln und Aktionen innerhalb des Projekts.

Abschnitt "Benutzerdefinierte Felder"

Das Advanced Workflows Plugin fügt ein neues benutzerdefiniertes Feldformat hinzu: "Datum und Uhrzeit"

Benutzerdefinierte Felder

in Issue edit

"Datum und Uhrzeit" kann als Filter (Bedingung) verwendet werden

Wird als Filter verwendet

Verfügbare Optionen:

Nächste Stunde - Der Filter enthält diejenigen Issues, bei denen der Wert des Feldes "Datum und Uhrzeit" innerhalb der nächsten Stunde ab der aktuellen UTC-Zeit liegt.

Filter: Release-Zeit

Abschnitt "Module"

In Administration -> Module -> Erweiterte Workflows können Sie Folgendes konfigurieren:

Ausführen als Benutzer - Möglichkeit, den Administrator auszuwählen, in dessen Namen die Aktionen gemäß dem Zeitplan ausgeführt werden
Maximale Anzahl von Issues bei der Durchführung geplanter Aktionen

Plugin-Einstellungen

Abschnitt "Benutzerdefinierte Regeln"

Benutzerdefinierte Regeln ermöglichen es Ihnen, Einschränkungen für die Zuweisung von Issues für Benutzer unter bestimmten Bedingungen festzulegen.

In Administration -> Benutzerdefinierte Regeln können Sie Regeln erstellen und konfigurieren:

Seite "Benutzerdefinierte Regeln" ohne Regeln

Erstellen einer Regel

Geben Sie beim Erstellen den Namen und die Aktivität an:

Erstellen einer neuen Regel

Bearbeiten von Regeln

Nach dem Erstellen einer Regel wird die Möglichkeit angezeigt, Bedingungen und Einschränkungen zu bearbeiten.

Seite "Benutzerdefinierte Regeln" mit aktiver Regel

Mögliche Bedingungen:

Projekt
Tracker
Version
Autor
Aktueller Benutzer
Zugewiesen an Gruppe
Autorengruppe
Zugewiesen an Rolle
Rolle des aktuellen Benutzers
Issue-Status
Parent Issue Tracker
Parent Issue Version
Benutzerdefinierte Felder "Issues" mit den Typen "Liste", "Text", "Float", "Integer", "Datum", "Datum und Uhrzeit".
Benutzerdefinierte Felder "Projekte" mit den Typen "Liste", "Text", "Float", "Integer", "Datum".

Bedingungen

Mögliche Einschränkungen:

Verantwortlicher
Zugewiesen an Gruppe
Rolle des Verantwortlichen
Fälligkeitsdatum
Tracker
Version

Einschränkungen

Abschnitt "Automatische Aktionen"

Automatische Aktionen ermöglichen es Ihnen, ausgewählte Aktionen beim Speichern eines Issues oder nach einem Zeitplan innerhalb spezifizierter Bedingungen auszuführen.

In Administration -> Automatische Aktionen können Sie Aktionen erstellen und konfigurieren:

Seite "Automatische Aktionen" ohne Aktionen

Erstellen von Aktionen

Geben Sie beim Erstellen den Namen, die Ausführungsmethode und die Aktivität an. Aktionen können auf zwei verschiedene Arten durchgeführt werden:

Beim Speichern - Aktionen werden sofort beim Erstellen/Bearbeiten des Issues ausgeführt.
Cron-Job - Regeln werden periodisch gemäß dem Cron-Zeitplan ausgeführt.

Erstellen einer neuen Aktion

Bearbeiten von Aktionen

Nach dem Erstellen einer Aktion wird die Möglichkeit angezeigt, Bedingungen und Aktionen zu bearbeiten.

Seite "Automatische Aktionen" mit aktiver Aktion

Mögliche Bedingungen:

Standardmäßige Issue-Filter
Benutzerdefinierte Issue-Filter

Mögliche Aktionen:

Verantwortlicher
Speichern deaktivieren
E-Mail senden
Status
Tracker
Version
Version offener Teilaufgaben
Beobachter
Webhook (GET)
Webhook Mattermost
Webhook Telegram
Checkliste (wenn das Plugin :redmine_advanced_checklists installiert ist)

Aktionen

Für die Aktionen "E-Mail senden", "Webhook (GET)", "Webhook Mattermost" und "Webhook Telegram" sind Aktionsvariablen verfügbar.

Aktionsvariablen

Verwendung

Aktivieren von Regeln und Aktionen

Nach dem Erstellen von Regeln und Aktionen müssen Sie diese separat in den Projekteinstellungen aktivieren.

Gehen Sie dazu zu:

Projekt -> Einstellungen -> Benutzerdefinierte Regeln, aktivieren Sie diejenigen Regeln, die in diesem Projekt benötigt werden. Benutzerdefinierte Regeln in den Projekteinstellungen

Projekt -> Einstellungen -> Automatische Aktionen, aktivieren Sie diejenigen Aktionen, die in diesem Projekt benötigt werden.

Automatische Aktionen in den Projekteinstellungen

Benutzerdefinierte Regeln

Verfügbare Einschränkungen, die angewendet werden, wenn die Bedingungen erfüllt sind:

Verantwortlicher:

Das Issue kann nur ausgewählten Benutzern zugewiesen werden.

Verantwortlicher

Gruppe des Verantwortlichen:

Das Issue kann nur denjenigen Benutzern zugewiesen werden, die Mitglieder der ausgewählten Gruppen sind.

Gruppe des Verantwortlichen

Rolle des Verantwortlichen:

Das Issue kann nur Benutzern mit der ausgewählten Rolle für das Projekt zugewiesen werden.

Rolle des Verantwortlichen

Fälligkeitsdatum:

Das Fälligkeitsdatum des Issue kann nur innerhalb eines bestimmten Zeitraums angegeben werden.

Fälligkeitsdatum

Tracker:

Issues können nur ausgewählte Tracker haben.

Tracker

Version:

Issues können nur ausgewählte Versionen haben.

Version

Automatische Aktionen

Ausführungsmethode "Cron-Job"

Aktionen werden periodisch gemäß dem Cron-Zeitplan ausgeführt.

Damit die automatische Aktion korrekt funktioniert, müssen Sie dem Crontab des Servers einen neuen Befehl hinzufügen, der den Befehl bundle exec rake advanced_workflows:run_actions ausführt.

Befehlsbeispiel:

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

Fügen Sie diesen Befehl cron im Namen des Benutzers hinzu, unter dem Redmine ausgeführt wird, und ersetzen Sie /absoluter/pfad/zu/redmine durch den absoluten Pfad zu Ihrem Redmine-Installationsordner.

Der Cron-Befehl wird alle 5 Minuten ausgeführt */5 * * * *

Alle Standardmeldungen werden an die Datei .../logs/cron_advanced_workflows.log angehängt.

Verfügbare Aktionen, die ausgeführt werden, wenn die Bedingungen erfüllt sind:

Webhook (GET):

Sendet eine GET-Anfrage an die angegebene URL. Wird zur Integration mit externen Systemen verwendet, beispielsweise zur Synchronisierung mit Jira.

Unterstützt alle Issue-Feldvariablen. Webhook (GET)

Webhook Mattermost:

Sendet eine Nachricht im Mattermost-Format an die angegebene URL. Zur Integration mit Mattermost.

Unterstützt alle Issue-Feldvariablen. Webhook Mattermost

Webhook Telegram

Sendet eine Nachricht im Telegram-Format an die angegebene URL. Zur Integration mit Telegram

Unterstützt alle Issue-Feldvariablen.

E-Mail senden:

Sendet eine E-Mail an angegebene Benutzer oder Benutzer in Gruppen.

Unterstützt alle Issue-Feldvariablen.

E-Mail senden

Version:

Ändert automatisch die Issue-Version.

Durch die Version des aktuellen Issue ersetzen - Ersetzt die Issue-Version durch die aktuelle (tatsächliche) Version des Projekts.

Version offener Teilaufgaben:

Ändern in - Ändert die Version aller offenen Teilaufgaben in die angegebene.
Auf die Version des Issue setzen - Ändert die Version aller offenen Teilaufgaben auf die Version des Issues.

Version offener Teilaufgaben