> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.groupalarm.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Flows

Die Flows in GroupAlarm sind ein mächtiges Instrument, um individuelle Funktionen und Abläufe abbilden und automatisieren zu können.  Vom automatisierten Versenden von Berichten oder Messenger Nachrichten bis hin zur Anbindung von Schnittstellen ist vieles möglich. Die einzelnen [Elemente des Flows](/de/article/elemente-des-flows-lbrh2v/) geben Ihnen die nötige Flexibilität. Wenn Sie eine Idee für eine Funktion in GroupAlarm haben, ist es gut möglich, dass sich diese mit den Flows abbilden lässt.

##### Inhaltsverzeichnis

* [Einleitung Flows](#1-einleitung-flows)

* [Flow erstellen / bearbeiten](#1-flow-erstellen-bearbeiten)

* [Flow Beispiele](#1-flow-beispiele)

* [Flow Insights / Fehlerdiagnose](#1-flow-insights-fehlerdiagnose)

* [Flow vererben](#1-flow-vererben)

* [Flow Export / Import](#1-flow-export-import)

* [Elemente des Flows](#1-elemente-des-flows)


# Einleitung Flows

Um einen Flow erstellen oder bearbeiten zu können, werden die entsprechenden administrativen Berechtigungen für den Service Flows benötigt. Als Organisationsbesitzer oder Organisationsadministrator liegen diese Berechtigungen automatisch vor.

Unter dem Punkt Admin ⇾ Flows erhalten Sie eine Übersicht über alle bestehenden Flows. 

![](https://storage.crisp.chat/users/helpdesk/website/91fefd8b4b0ac000/einleitungflowsdeneu_8kcp7g.png)

1️⃣ Über die Regler auf der linken Seite lässt sich der Flow ein- oder ausschalten. Deaktivierte Flows werden nicht ausgeführt. Bei vererbten Flows wird der Status in der Oberorganisation definiert.

2️⃣ Die Spalte, welche mit dem Blitz gekennzeichnet ist, gibt Aufschluss über das im Flow festgelegte Trigger-Element. Informationen zu den einzelnen Elementen erhalten Sie [hier](/de/article/elemente-des-flows-lbrh2v/).

3️⃣ In der Spalte `Vererbung` ist ersichtlich, ob und aus welcher Oberorganisation ein Flow geerbt wurde. Mehr zum Thema Vererbung von Flows erfahren Sie [hier](#1-flow-vererben).

4️⃣ Die Spalte `Valide` gibt an, ob ein Flow funktionstüchtig ist. Nicht valide Flows sind mit einem roten Ausrufezeichen gekennzeichnet und werden nicht ausgeführt, auch wenn diese aktiv sind.

5️⃣ Über die drei Punkte auf der rechten Seite erhalten Sie weitere Optionen zu dem jeweiligen Flow. 

Bearbeiten: Öffnet die Bearbeitungsansicht
Exportieren: Exportiert einen Flow, um diesen in eine andere Organisation einfügen zu können.
Insights: Detaillierte Informationen zu den einzelnen Ausführungen des Flows
Löschen: Entfernt den Flow


# Flow erstellen / bearbeiten

Um einen Flow zu erstellen, klicken Sie bitte zunächst in der Übersicht der Flows auf `Flow anlegen`. Möchten Sie hingegen einen bestehenden Flow bearbeiten, klicken Sie bitte rechts auf die drei Punkte an dem entsprechenden Flow und wählen Sie `Bearbeiten`.

Die Maske zur Bearbeitung eines Flows gestaltet sich wie folgt. 

1️⃣ Auf der linken Seite können Sie einen Namen für den Flow vergeben sowie eine zusätzliche Beschreibung. Beides wird in der Übersicht der Flows angezeigt.

2️⃣ Über den Regler `Vererben` lässt sich ein Flow in alle angeschlossenen Unterorganisationen vererben. 
Weitere Informationen zum Vererben von Flows erhalten Sie [hier](#1-flow-vererben).

3️⃣ Die Struktur eines Flows wird über den sogenannten Flow-Builder festgelegt. Unten rechts finden Sie den gesamten Pool aller verfügbaren Elemente. Die einzelnen Elemente können mit der Maus per Drag-and-drop an die gewünschten Positionen im Flow gezogen werden. Bestehende Elemente können Sie so auch an neue Positionen verschieben. 

||| ❗️ Wenn Sie die Elemente  [Prüfen auf Zeichenkette](/de/article/elemente-des-flows-prufen-auf-zeichenkette-1vbj9zi/) oder  [Prüfen auf eine oder mehrere Zeichenketten](/de/article/elemente-des-flows-prufen-auf-eine-oder-mehrere-zeichenketten-1cbcrq5/) verschieben oder löschen, bleiben nur die nachfolgenden Elemente auf dem `Ja` Pfad erhalten. Alle Elemente auf dem `Nein` Pfad werden automatisch gelöscht. Sollten Sie diese Elemente beibehalten wollen, verschieben Sie diese Elemente zunächst separat.

4️⃣ Um ein Element wieder zu löschen, ziehen Sie es ebenfalls via Drag-and-drop nach oben links in die Ecke der Baumansicht. Dort erscheint dann ein Papierkorb, über welchen sich das Element löschen lässt.

5️⃣ Nachdem Sie ein Element in die Baumstruktur eingefügt haben, muss dieses konfiguriert werden. Elemente, welche bisher nicht konfiguriert wurden, sind mit einem roten Ausrufezeichen gekennzeichnet.

Um die Konfiguration eines Elements zu beginnen, klicken Sie das Element mit der Maus an. Bitte beachten Sie, dass Änderungen an einem Element nur dann wirksam werden, wenn Sie die Bearbeitungsansicht über den Button `Fertig` verlassen. Andernfalls werden alle vorgenommenen Änderungen wieder verworfen.

| Details zu den einzelnen Elementen eines Flows erfahren Sie [hier](/de/article/elemente-des-flows-lbrh2v/).

![](https://storage.crisp.chat/users/helpdesk/website/91fefd8b4b0ac000/flowerstellenbearbeitendeupdat_k2j2cz.png)


# Flow Beispiele

* [Ereignis schließen](/de/article/flowbeispiel-ereignis-schliessen-1n5zh02/)

* [Messenger Nachricht senden](/de/article/flowbeispiel-messenger-nachricht-senden-eoa4f9/)

* [Bericht per E-Mail versenden](/de/article/flowbeispiel-bericht-per-e-mail-versenden-duycd6/)


# Flow Insights / Fehlerdiagnose

Die Insights geben Ihnen Auskunft über die einzelnen Durchläufe eines Flows. Somit eignen sich die Insights hervorragend zur Fehleranalyse bei ungewünschtem Verhalten eines Flows.

Die Insights erreichen Sie aus der Übersicht der Flows über die drei Punkte rechts an dem jeweiligen Flow (siehe [Einleitung Flows](#1-einleitung-flows)). Oder alternativ aus der Bearbeiten-Ansicht eines Flows über den Button `Flow Insights` in der oberen rechten Ecke.

Rufen Sie die Insights eines Flows auf, gelangen Sie zunächst zu der Übersicht der einzelnen Durchläufe.

||| ❗️Die Insights eines Flows bleiben maximal 14 Tage nach Beendigung des Flows gespeichert.

### Übersicht
Die Übersicht setzt sich wie folgt zusammen:

1️⃣ `Status`: Ein grüner Haken signalisiert, dass ein Durchlauf erfolgreich war. Ein rotes Ausrufezeichen hingegen signalisiert eine fehlgeschlagene Ausführung. Befindet sich ein Flow aktuell noch in einer laufenden Ausführung, wird das durch einen blauen Ladekreis signalisiert. Dies verschafft Ihnen einen schnellen, ersten Überblick. 

2️⃣ `Organisation`: Die Organisation, in welcher der Flow ausgeführt wurde. 

3️⃣ `Startzeitpunkt`: Der exakte Zeitpunkt, wann das Trigger-Element des Flows aktiviert wurde.

4️⃣ `Endzeitpunkt`: Der exakte Zeitpunkt, wann das letzte Element des Flows durchlaufen wurde.

5️⃣ Über den Pfeil auf der rechten Seite, gelangen Sie zu den Details der einzelnen Ausführungen.

![](https://storage.crisp.chat/users/helpdesk/website/91fefd8b4b0ac000/flowinsightsdeneu_9rn6q7.png)

### Details
In den Details lässt sich, ähnlich zu der vorherigen Übersicht, zunächst ein grober Überblick verschaffen.

Die Details setzen sich dabei wie folgt zusammen:

1️⃣ `Schritte`: Kennzeichnet das jeweilige Element des Flows, welches durchlaufen wurde.

2️⃣ `Status`: Wie auch auf der vorherigen Übersicht, signalisiert ein grüner Haken einen fehlerfreien Durchlauf des Elements, während ein rotes Ausrufezeichen auf ein Problem bei der Durchführung hinweist. 

| Das Symbol einer Uhr wird Ihnen hier angezeigt, wenn sich ein Flow aktuell noch in der Durchführung befindet und kennzeichnet jene Elemente, für welche eine Ausführung aussteht.

3️⃣ `Startzeitpunkt`: Der exakte Zeitpunkt, wann das Element gestartet wurde.

4️⃣ `Endzeitpunkt`: Der exakte Zeitpunkt, wann das Element vollständig durchlaufen war.

5️⃣ Das Informationssymbol auf der rechten Seite, erlaubt es Ihnen, weitere Details zu dem Durchlauf des einzelnen Elements aufzurufen.


![](https://storage.crisp.chat/users/helpdesk/website/91fefd8b4b0ac000/flowinsightszweide_1si2td6.png)

| 💡 In den Organisationseinstellungen können Sie eine E-Mail-Adresse hinterlegen, auf welche Sie dann eine Benachrichtigung erhalten, sollte die Ausführung eines Flows fehlschlagen. Die Organisationseinstellungen finden Sie unter Admin ⇾ Einstellungen.


# Flow vererben

Durch diese Funktion lässt sich ein Flow in alle angeschlossenen Unterorganisationen vererben. Die Struktur des Flows kann durch die erbenden Unterorganisationen nicht angepasst werden. Sie haben jedoch die Möglichkeit, im Rahmen der Konfiguration bestimmte Parameter für die Bearbeitung freizugeben.

In den Insights eines vererbten Flows lassen sich auch die Ausführungen der Unterorganisationen einsehen. So lässt sich auf einen Blick feststellen, ob die Flows in den Unterorganisationen wie gewünscht arbeiten.

Ressourcen wie Teilnehmer, Labels oder Einheiten sind je Organisation unterschiedlich und können somit nicht in der Oberorganisation definiert werden. Außerdem erhalten die Flows in den Unterorganisationen bei der Verwendung von `E-Mail empfangen` oder `HTTP Trigger` eigene E-Mail- / Web-Adressen, da diese einzigartig sein müssen.

| Ist der Flow z. B. mangels Parameter in der Oberorganisation nicht valide, beeinträchtigt dies nicht die Ausführung in der Unterorganisation. Der Flow muss nur in der jeweiligen Organisation valide sein, in welcher er ausgeführt werden soll.

###### Konfiguration

1️⃣ Über die Funktion `Vererben` lässt die Vererbung für einen Flow ein- und ausschalten.

2️⃣ Mithilfe des Dropdown-Menüs für `Konfigurierbare Parameter` können Parameter festgelegt werden, welche durch die Unterorganisation angepasst werden dürfen.

| Wird ein Parameter durch die Unterorganisation nicht konfiguriert, greift der Wert, welcher in der Oberorganisation definiert wurde.

3️⃣ Über den Button `Speichern` lassen sich die Änderungen übernehmen.

![](https://storage.crisp.chat/users/helpdesk/website/91fefd8b4b0ac000/flowvererbendeupdate_1q9la29.png)


# Flow Export / Import

Als Arbeitserleichterung im Zusammenspiel mit mehreren Organisationen besteht die Möglichkeit, einen Flow zu exportieren und anschließend wieder in einer anderen Organisation zu importieren.

||| ❗️Beachten Sie bitte, dass bei einem Export auch persönliche Informationen exportiert werden. Stellen Sie also vor einem Export sicher, dass der Flow nur Informationen enthält, welche Sie auch tatsächlich teilen möchten.


1️⃣ Um einen Flow zu exportieren, klicken Sie bitte in der Übersicht der Flows auf die drei Punkte auf der rechten Seite des Flows. Der entsprechende Flow steht dann als Download zur Verfügung.

2️⃣ Um einen Flow wieder zu importieren, wählen Sie bitte in der Übersicht der Flows oberhalb den Menüpunkt `Flow importieren` aus. Sie erhalten dann die Möglichkeit, die entsprechende Datei des Flows auszuwählen.

Nach dem Import gelangen Sie automatisch in die Bearbeiten-Ansicht der importierten Flows. 

|| ⚠️ Beachten Sie bitte, den Flow zunächst über den Button `Speichern` auf der rechten Seite zu sichern. Andernfalls wird der Flow wieder verworfen. 

Nach dem Speichern ist der Flow dann verfügbar und kann wie gewohnt verwendet werden.

![](https://storage.crisp.chat/users/helpdesk/website/91fefd8b4b0ac000/einleitungimportexportdeneu_5jv2er.png)

# Elemente des Flows

### Trigger

Trigger sind Ereignisse, die einen Flow starten können.

| Name | Beschreibung |
| ---- |
| [Alarm ausgelöst](/de/article/elemente-des-flows-alarm-ausgelost-15rnbrn/) | Mit diesem Trigger wird ein Flow gestartet, wenn ein Alarm in der Organisation ausgelöst wurde. |
| [Alarm geschlossen](/de/article/elemente-des-flows-alarm-geschlossen-136ahdy/) | Mit diesem Trigger wird ein Flow gestartet, wenn ein Alarm in der Organisation geschlossen wurde. |
| [Cronjob](/de/article/elemente-des-flows-cronjob-11yk16u/) | Mit diesem Trigger wird ein Flow gemäß einem durch den Cronjob-Ausdruck definierten Zeitplan gestartet. |
| [Deckungsgrad](/de/article/elemente-des-flows-deckungsgrad-1ahruf7/) | Dieser Trigger löst bei einer Veränderung des Deckungsgrades eines Labels aus. |
| [DWD Wetterwarnung](/de/article/elemente-des-flows-dwd-wetterwarnung-18h4ms5/) | Mit diesem Trigger wird ein Flow gestartet, wenn eine DWD Wetterwarnung mit den im Trigger konfigurierten Eigenschaften vorliegt. |
| [E-Mail empfangen](/de/article/elemente-des-flows-e-mail-empfangen-1ilypim/) | Mit diesem Trigger wird ein Flow gestartet, wenn eine E-Mail empfangen wurde. |
| [Ereignis ausgelöst](/de/article/elemente-des-flows-ereignis-ausgelost-kdd6e1/) | Mit diesem Trigger wird ein Flow gestartet, wenn ein Ereignis in der Organisation ausgelöst wurde. |
| [Ereignis geschlossen](/de/article/elemente-des-flows-ereignis-geschlossen-ljuhuc/) | Mit diesem Trigger wird ein Flow gestartet, wenn ein Ereignis in der Organisation geschlossen wurde. |
| [HTTP Trigger](/de/article/elemente-des-flows-http-trigger-1gjx7io/) | Mit diesem Trigger wird ein Flow gestartet, wenn ein HTTP-Aufruf auf die hinterlegte URL getätigt wurde. |
| [IMAP E-Mail Trigger](/de/article/elemente-des-flow-imap-trigger-ilqkmi/) | Mit dem IMAP E-Mail Trigger wird ein Flow gestartet, wenn eine neue E-Mail in einem konfigurierten Postfach empfangen wird. |
| [MQTT Trigger](/de/article/elemente-des-flows-mqtt-trigger-10x14i4/) | Mithilfe des MQTT Triggers lässt sich ein Flow starten, wenn eine MQTT Verbindung angesprochen wird. |
| [Pager Notruf](/de/article/elemente-des-flows-pager-notruf-15e9c8z/) | Der Pager Notruf startet einen Flow, wenn die Notruftaste an einem Pager betätigt wird. |
| [Statusänderung](/de/article/elemente-des-flows-statusanderung-1lkaczq/) | Mit diesem Trigger starten Sie einen Flow, wenn sich der Status einer Ihrer Einheiten ändert. |
| [Positionsänderung](/de/article/elemente-des-flows-positionsanderung-b0sc2f/) | Mit diesem Trigger starten Sie einen Flow, wenn sich die Position einer Ihrer Einheiten ändert. |
| [Tag ausgelöst](/de/article/elemente-des-flows-tag-ausgelost-z3ewls/) | Mit diesem Trigger wird ein Flow gestartet, wenn einer der hinterlegten Tags ausgelöst wurde. |
| [Verbindungsstatus geändert](/de/article/elemente-des-flows-verbindungsstatus-geandert-nx7kht/) | Startet einen Flow, wenn sich der Status einer Verbindung ändert. |
| [WDX3 Trigger](/de/article/elemente-des-flows-wdx3-trigger-1repek0/) | Dieser Trigger startet einen Flow, wenn Event des Operation Service von ISE Cobra empfangen wird. |
| [Websocket Trigger](/de/article/elemente-des-flows-websocket-trigger-1ga9oyf/) | Mit diesem Trigger wird ein Flow ausgelöst, sobald neue Daten über eine Websocket-Schnittstelle, wie KATSYS, empfangen werden. |

### Alarmierung

Mit diesen Elementen lassen sich Alarme und Ereignisse auslösen oder bearbeiten.

| Name | Beschreibung |
| ---- |
| [Alarm auslösen](/de/article/elemente-des-flows-alarm-auslosen-1b306g2/) | Löst einen Alarm mit den konfigurierten Ressourcen aus. |
| [Alarm formatieren](/de/article/elemente-des-flows-alarm-formatieren-rjve0d/) | Formatiert die Details eines Alarms mit der konfigurierten Zeichenkette. |
| [Alarm laden](/de/article/elemente-des-flows-alarm-laden-1hk5m62/) | Lädt die aktuellen Details eines Alarms. |
| [Ereignis abbrechen](/de/article/elemente-des-flows-ereignis-abbrechen-1sa3iig/) | Mithilfe dieses Elements kann gezielt ein definiertes Ereignis abgebrochen werden. |
| [Ereignis öffnen](/de/article/elemente-des-flows-ereignis-offnen-8n8bc2/) | Eröffnet ein neues Ereignis. |
| [Ereignis schließen](/de/article/elemente-des-flows-ereignis-schliessen-1bvzf49/) | Schließt ein offenes Ereignis. |
| [Ereignis suchen](/de/article/elemente-des-flows-ereignis-suchen-1udsd79/) | Sucht ein Ereignis innerhalb der Organisation. |
| [Position von Einheit setzen](https://docs.groupalarm.com/de/article/elemente-des-flows-position-von-einheit-setzen-ozrfx9/) | Ermöglicht es, die Position einer Einheit über den Flow zu setzen. |
| [Status von Einheit setzen](https://docs.groupalarm.com/de/article/elemente-des-flows-status-von-einheit-setzen-6ds9rj/) | Ermöglicht es, den Status einer Einheit über den Flow zu setzen |
| [Tag auslösen](/de/article/elemente-des-flows-tag-auslosen-1hoifwg/) | Löst einen Tag und die damit verbundenen Alarme in Unterorganisationen aus. |

### Things

| Name | Beschreibung |
| ---- |
| [Eintrag erstellen](/de/article/elemente-des-flows-eintrag-erstellen-things-18v53z9/) | Erstellt Einträge in Entitäten in Things. |
| [Eintrag laden](/de/article/elemente-des-flows-eintrag-laden-things-1huh9l6/) | Lädt Daten aus einer Entität in Things |
| [Eintrag löschen](/de/article/elemente-des-flows-eintrag-loschen-things-1xa52pd/) | Löscht Daten aus einer Entität in Things |

### Kommunikation

Elemente, welche eine Kommunikation ermöglichen.

| Name | Beschreibung |
| ---- |
| [E-Mail senden](/de/article/elemente-des-flows-e-mail-senden-9i63ol/) | Sendet eine E-Mail an die hinterlegten Empfänger. |
| [Fax senden](/de/article/elemente-des-flows-fax-senden-1feicex/) | Sendet ein hinterlegtes Dokument per Fax an die angegebene Rufnummer. |
| [HTTP Client](/de/article/elemente-des-flows-http-client-1w85trw/) | Sendet einen HTTP-Aufruf an die hinterlegte URL. |
| [Konferenzraum](/de/article/elemente-des-flows-konferenzraum-6744ie/) | Automatisierte Verwaltung Ihrer Konferenzen |
| [Messenger-Nachricht senden](/de/article/elemente-des-flows-messenger-nachricht-senden-1e78sl5/) | Sendet eine Nachricht im Messenger an einen Chatraum. |
| [Nachricht an Pager senden](/de/article/elemente-des-flows-nachricht-an-pager-senden-dqwio1/) | Sendet eine Nachricht an einen oder mehrere Pager. |

### Verarbeitung

Parser, welche das Filtern von Informationen erlauben.

| Name | Beschreibung |
| ---- |
| [JSON Parser](/de/article/elemente-des-flows-json-parser-1n4wf9c/) | Verarbeitet JSON-Input in konfigurierte Variablen. |
| [Text Parser](/de/article/elemente-des-flows-textparser-zqa8vz/) | Verarbeitet Text-Input in konfigurierte Variablen. |
| [XML Parser](/de/article/elemente-des-flows-xml-parser-o4bnou/) | Verarbeitet XML-Input in konfigurierte Variablen. |

### Text

Erlaubt das Zusammenführen von Daten zur weiteren Verarbeitung.

| Name | Beschreibung |
| ---- |
| [JSON-Zeichenkette](/de/article/elemente-des-flows-json-zeichenkette-1uo8gk/) | Dieses Element erlaubt die Erstellung einer JSON-Zeichenkette. |
| [Zusammenfügen von Zeichenketten](/de/article/elemente-des-flows-zusammenfugen-von-zeichenketten-14dugro/) | Fügt mehrere Zeichenketten mithilfe von eigenen Variablen dynamisch aneinander. |

### Kontrolle

Ermöglicht die Kontrolle der zu verarbeitenden Daten.

| Name | Beschreibung |
| ---- |
| [Prüfen auf eine oder mehrere Zeichenketten](/de/article/elemente-des-flows-prufen-auf-eine-oder-mehrere-zeichenketten-1cbcrq5/) | Ähnlich dem Element Prüfen auf Zeichenkette. Überprüft, ob eine oder mehrere angegebene Zeichenketten in einem Funktions-Ergebnis enthalten sind. |
| [Prüfen auf Zeichenkette](/de/article/elemente-des-flows-prufen-auf-zeichenkette-1vbj9zi/) | Überprüft, ob eine angegebene Zeichenkette in einem Funktions-Ergebnis enthalten ist. |
| [Variable mit Bedingungen](/de/article/elemente-des-flows-variable-mit-bedingungen-g2jxfj/) | Dieses Element erlaubt es, Variablen abhängig von Bedingungen verwenden zu können, um zum Beispiel verschiedene Einsatzstichwörter mit einer Szenario-ID zu verbinden. |
| [Warten](/de/article/elemente-des-flows-warten-1re888p/) | Diese Funktion verzögert die Ausführung der nächsten Funktion um die angegebenen Sekunden. |