Flows Add-on
Das Flows Add-on für i-doit ist ein leistungsstarkes Werkzeug zur Automatisierung von Prozessen innerhalb des CMDB-Systems. Es ermöglicht die Erstellung von automatisierten Flows basierend auf Triggern und definierten Bedingungen. Mit Flows können Benutzer repetitive Aufgaben und manuelle Schritte automatisieren, indem sie Regeln festlegen, die durch bestimmte Ereignisse oder Zustände (z. B. eine Änderung in der CMDB) ausgelöst werden. Das Add-on hilft, Arbeitsabläufe effizienter zu gestalten, Fehler zu reduzieren und die Verwaltung komplexer IT-Umgebungen zu vereinfachen, indem es Routineprozesse ohne Benutzerinteraktion abwickelt.
Sie können dieses Add-on testen: Installieren Sie dazu einfach das Add-on.
Das Flows Add-on kann ohne Lizenz genutzt werden. In diesem Fall stehen Ihnen allerdings nur der Auslöser Zeitbasiert (Time based) und die Aktion Befehl aufrufen (Call command) zur Verfügung.
Download und Installation#
Dieses Add-on kann nachträglich installiert werden. Detaillierte Beschreibungen bezüglich Download, Installation, Updates usw. liefert der Artikel i-doit Add-ons.
Benötigte CLI Commands#
Sofern der Befehl für einen anderen als den ersten Mandanten ausgeführt werden soll, ist die entsprechende Mandanten ID zu übergeben.
Das Flows Add-on wird mit zwei CLI-Befehlen geliefert. Beide Befehle werden benötigt, damit das Flows-Add-on vollständig funktioniert. Es gibt zwei Möglichkeiten, die CLI-Befehle einzurichten. Die Befehle können z.B. über einen Crontab ausgeführt werden. Wir haben auch ein Service-Installationsskript mit dem Namen create-daemon.sh erstellt, das sich im Flows Add-on Ordner unter i-doit/src/classes/modules/synetics_flows/ befindet.
Systemdienst-Installationsskript verwenden#
Das Flows Add-on wird mit zwei CLI-Befehlen geliefert. Beide Befehle werden benötigt, damit das Flows-Add-on vollständig funktioniert. Es gibt zwei Möglichkeiten, die CLI-Befehle einzurichten. Die Befehle können z.B. über einen Crontab ausgeführt werden. Wir haben auch ein Service-Installationsskript mit dem Namen create-daemon.sh erstellt, das sich im Flows Add-on Ordner unter i-doit/src/classes/modules/synetics_flows/ befindet.
Dieser Dienst führt alle paar Sekunden die CLI-Befehle des Flows Add-on aus. Zuerst müssen wir die Ausführungsrechte für die Datei festlegen. Verwenden Sie den Befehl im Ordner i-doit:
1 | |
Nun kann die Datei ausgeführt werden, um einen Systemdienst zu erstellen. Dies muss für jeden Mandanten durchgeführt werden
-ui-doit Person mit Administrator rechten-pdas Passwort für die Person-iMandanten ID in dem die Person verwendet wird, kann über Konsolenbefehl eingesehen werden tenant-list
1 | |
Erstellen eines Crontab#
Die Crontab führt die CLI-Befehle jede Minute aus. Erstellen Sie eine Crontab für den Apache-Benutzer. Beispiel für Debian:
1 | |
Fügen Sie die folgenden Zeilen am Ende der Datei ein, nachdem Sie die i-doit Anmeldeinformationen ersetzt haben. Möglicherweise müssen Sie auch die Mandanten-ID ersetzen.
1 2 | |
Rechtevergabe#
Unter Verwaltung → Berechtigungen → Flows können Rechte für Personen und Personengruppen angepasst werden.
| Recht | Beschreibung |
|---|---|
| Erstellen | Erlaubt das erstellen, duplizieren und impliziert das Ansehen Recht |
| Ansehen | Erlaubt Zugriff auf die Flows Overview |
| Editieren | Erlaubt editieren, aktivieren/deaktivieren und impliziert das Ansehen Recht |
| Löschen | Erlaubt das löschen von Flows und impliziert das Ansehen Recht |
| Supervisor | Erlaubt alles |
Übersicht#
Über die Aktionsleiste können Flows erstellt, gelöscht oder exportiert werden. Sofern ein Flow erstellt wurde kann dieser in der Flows Übersicht, über die Aktionen Spalte geöffnet, aktiviert oder deaktiviert werden. Außerdem sind über den "3 Punkte" (More) Button weitere Aktionen möglich wie zum Beispiel: Bearbeiten, Duplizieren oder Zum Test Modus wechseln.
Flow erstellen#
Um einen Flow zu erstellen wird das Flows Add-on aufgerufen, dies erfolgt über Add-ons → Flows. Anschließend wird über den Add Button ein neuer Flow erstellt. Ein Flow muss einen Namen, einen Trigger und eine oder mehrere Actions definiert haben um vollständig zu sein. Zu guter Letzt muss der Flow über den Button noch aktiviert werden.
Auslöser#
Trigger bestimmen wann ein Flow ausgeführt wird. Es ist nur ein Trigger pro Flow möglich.
Die Aktion wird ausgeführt, sobald Datum und Uhrzeit erreicht sind. Sie kann regelmäßig wiederholt werden.
Die Aktion wird ausgeführt, sobald der Button angeklickt wird. Der Button wird in der Aktionsleiste des Objektes angezeigt, wenn die Bedingungen erfüllt sind.
Die Aktion wird ausgeführt, wenn ein bestimmter CMDB-Status gesetzt wird. Es lässt sich auch nach bestimmten Objekttypen filtern. Wird NICHT ausgelöst, wenn Kategoriedaten durch Importe oder API-Interaktion geändert werden.
Die Aktion wird ausgeführt, wenn Kategorien oder Einträge bearbeitet werden. Wird NICHT ausgelöst, wenn Kategoriedaten durch Importe oder API-Interaktion geändert werden.
Konditionen#
Es muss keine Konditionen gewählt werden. Außerdem können conditions mit UND sowie ODER verknüpft und verschachtelt werden.
Es können mehrere Logische Konditionen hinzugefügt werden um Bedingungen zu verknüpfen oder zu verschachteln.
Prüft, ob das Objekt die definierten Bedingungen erfüllt. Diese Auswahl bezieht sich auf den Endzustand des Objekts oder Attributs.
Prüft, ob die Ausführungszeit innerhalb der festgelegten Zeiträume liegt.
Prüft, ob die Bewegung durch ausgewählte Personen oder Mitglieder von Personengruppen ausgelöst wird.
Aktionen#
Es muss mindestens eine Aktion definiert werden.
Die Aktion führt einen definierten API-Aufruf aus. Der API-Aufruf benötigt eine URL, eine Methode sowie angaben zur Autorisierung. Für diesen Action type kann Twig als template Engine verwendet werden.
Die Aktion sendet eine E-Mail an bestimmte Empfänger. Ein Subject ist notwendig. Für diesen Action type kann Twig als template Engine verwendet werden.
Die Aktion erstellt ein neues Objekt. Es ist möglich Attribute für Kategorien zu hinterlegen.
Die Aktion aktualisiert Attribute in Objekten.
Rufen Sie einen i-doit-Konsolenbefehl auf. Weitere Informationen zu Befehl ausführen
Logs#
Die Logs sind für alle Flows ersichtlich oder für den jeweils geöffneten Flow. In den Logs werden wichtige Informationen zu den Ausführungen gespeichert.
CLI-Befehle und Optionen#
| Befehl | Interne Beschreibung |
|---|---|
| flows:perform | Führt Ausführungen durch |
| flows:time-trigger | Löst die Ausführung der Zeitautomatisierung aus |
flows:perform#
Führt Ausführungen durch.
Optionen:
| Parameter (Kurzversion) | Parameter (Langversion) | Beschreibung |
|---|---|---|
| -u | --user={BENUTZERNAME} | Benutzername eines autorisierten Benutzers zur Ausführung |
| -p | --password={PASSWORT} | Passwort zur Authentifizierung des angegebenen Benutzers |
| -i | --tenant={MANDANTID} | Mandanten-ID des zu verwendenden Mandanten (Standard: 1) |
| -c | --config={KONFIGURATION} | Konfigurationsdatei |
| -h | --help | Hilfetext zur Anzeige weiterer Informationen |
| -q | --quiet | Quiet-Modus zur Deaktivierung der Ausgabe |
| -V | --version | Gibt die Version der i-doit Konsole aus |
| --ansi --no-ansi | Erzwingt (oder deaktiviert mit --no-ansi) ANSI-Ausgabe | |
| -n | --no-interaction | Deaktiviert alle Interaktionsfragen der i-doit Konsole |
| -v / -vv / -vvv | --verbose | Erhöht die Ausführlichkeit der Ausgabe (1 = normale Ausgabe, 2 = detaillierte Ausgabe, 3 = Debug-Level) |
Anwendungsbeispiel
1 | |
flows:time-trigger#
Löst die Ausführung der Zeitautomatisierung aus.
Optionen:
| Parameter (Kurzversion) | Parameter (Langversion) | Beschreibung |
|---|---|---|
| -u | --user={BENUTZERNAME} | Benutzername eines autorisierten Benutzers zur Ausführung |
| -p | --password={PASSWORT} | Passwort zur Authentifizierung des angegebenen Benutzers |
| -i | --tenant={MANDANTID} | Mandanten-ID des zu verwendenden Mandanten (Standard: 1) |
| -c | --config={KONFIGURATION} | Konfigurationsdatei |
| -h | --help | Hilfetext zur Anzeige weiterer Informationen |
| -q | --quiet | Quiet-Modus zur Deaktivierung der Ausgabe |
| -V | --version | Gibt die Version der i-doit Konsole aus |
| --ansi --no-ansi | Erzwingt (oder deaktiviert mit --no-ansi) ANSI-Ausgabe | |
| -n | --no-interaction | Deaktiviert alle Interaktionsfragen der i-doit Konsole |
| -v / -vv / -vvv | --verbose | Erhöht die Ausführlichkeit der Ausgabe (1 = normale Ausgabe, 2 = detaillierte Ausgabe, 3 = Debug-Level) |
Anwendungsbeispiel
1 | |
Anwendungsfälle#
Anwendungsfälle sind in unserer Demo zu finden und können von dort Exportiert werden.
Releases#
| Version | Date | Changelog |
|---|---|---|
| 1.1.0 | 2025-04-24 | [Improvement] Upgrade now from Flows Console Command [Improvement] Flows Lite: Command Alternative for extend-contracts [Improvement] Flows Lite: Command Alternative for import-jdisc [Improvement] Flows Lite: Command Alternative for import-jdiscdiscovery [Improvement] Flows Lite: Command Alternative for ldap-sync [Improvement] Flows Lite: Command Alternative for ldap-syncdn [Improvement] Flows Lite: Command Alternative for notifications-send [Improvement] Flows Lite: Command Alternative for search-index [Improvement] Flows Lite: Command Alternative for system-objectrelations [Improvement] Flows Lite: Command Alternative for sync-dynamic-groups [Improvement] Flows Lite: Command Alternative for import-csv [Improvement] Flows Lite: Command Alternative for import-xml [Improvement] Flows Lite: Command Alternative for report-export [Improvement] Flows Lite: Command Alternative for import-hinventory [Task] Make sure the correct Action and Trigger are shown if no valid license is installed [Task] Allow user to use Flows in Lite variant if the add-on is not licensed [Task] Implement validation for dynamic option types [Task] Adjust option description view [Bug] Sort commands in select command on Create/Edit command action [Bug] Unable to generate url with route cmdb.object-type.icon [Bug] Object browser icon should not overlap the field input [Bug] Unable to select assigned licenses for operating system category at flow action [Bug] Specific category Net doesnt validate passed data correctly [Bug] Correct text of object event trigger |
| 1.0.1 | 2025-02-24 | [Task] Make symfony 6.4 compatible [Task] Integrate validation of the CMDB criteria [Task]() Open "last execution" details in new tab [Task] Allow access to object type information in placeholder [Improvement]() Export Flows to file [Improvement] Allow usage of detailed information of assets [Improvement] Import Flows from file [Bug] Trigger is not performed when using a category event for a list category [Bug] Attribute condition should not be available for change in action "update object" [Bug] Not selected attribute value is displayed in the overview of a flow [Bug] Creation date and Date of change are not available in object based conditions [Bug] SQL error in object when an object based condition is configured for a location matches a title [Bug] Selected custom attributes set as a trigger do not trigger the flow [Bug] Selection of the object ID as a variable not possible [Bug] Search popup is hard to read |
| 1.0 | 2024-10-10 | Initiales Release |