> ## 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).

# GroupAlarm - Things

Things in GroupAlarm fungiert als eine Art Datenbank, welche es Ihnen erlaubt, Informationen in GroupAlarm zu hinterlegen, um damit bestimmte Prozesse einzuleiten. Dazu können bei Änderungen der Daten z. B. Alarmvorlagen ausgelöst werden. Das präsenteste Beispiel dafür ist die PNA Funktion in GroupAlarm, über welche die Informationen der GroupAlarm PNA App gesammelt werden, um damit dann Alarme auslösen zu können. Dieser Artikel beschränkt sich auf die Konfiguration von Things in der GroupAlarm WebApp. Weitere Hintergrundinformationen und Anwendungsbeispiele zu Things erhalten Sie in folgendem [Blog-Beitrag](https://www.groupalarm.com/blog/neue-erweiterung-groupalarm-things/). 

| 💡 Things ist eine Erweiterung, welche Sie über `Admin` → `Erweiterungen` hinzufügen können. Die Erweiterung selbst ist kostenlos und beinhaltet 100 Einträge über alle Entitäten hinweg. Wenn Sie mehr als 100 Einträge nutzen möchten, können Sie dazu kostenpflichtig im Bereich `Nutzung` das Limit erhöhen.

![](https://storage.crisp.chat/users/helpdesk/website/-/9/1/f/e/91fefd8b4b0ac000/appgroupalarmcomdedorganizatio_rwl2ci.png)

###### Entitäten

Um Things verwenden zu können, müssen Sie zunächst eine Entität erstellen. Die Entität ist praktisch die einzelne Datenbank, welcher Sie Einträge hinzufügen können, die dann wiederum mit den entsprechenden Daten befüllt werden. Zur eindeutigen Identifikation können Sie der Entität einen Namen und eine Beschreibung hinzufügen.

Des Weiteren können Sie den Lese- und Schreibzugriff der Entität einschränken. Standardmäßig hat jeder Teilnehmer Zugriff.

Im Bereich `Felder` werden die einzelnen Felder definiert, welche dann mit Daten befüllt werden können. Die einzelnen Einträge können Sie beim Erstellen oder Bearbeiten der Entität nach Ihren Wünschen benennen. Das eigentliche Pflegen der Daten erfolgt später.

Zur Auswahl stehen dabei:

**Text:** Ein Freitext, welcher beliebig befüllt werden kann.
**Zahl:** Ein Feld für einen numerischen Wert
**Datum:** Ein Feld für ein Datumsformat.
**Datum & Uhrzeit:** Ähnlich wie das Feld Datum, jedoch in Kombination mit der Uhrzeit. 
**Ja/Nein:** Ein Feld für eine Checkbox mit Ja/Nein, genauer gesagt true oder false.
**Auswahl:** Die Auswahl erlaubt es Ihnen, ein Auswahlfeld hinzuzufügen, welches individuell mit Optionen bestückt werden kann. Bitte nach dem Hinzufügen einer Option mit `Enter` bestätigen. 
**Koordinaten:** Ein Feld für Koordinaten im Format lat/long (Beispiel: 50.76273,6.0774249)
**Adresse:** Für Daten im Adressformat wie den Einsatzort.

| 💡 Die einzelnen Felder können via Drag and Drop in der Reihenfolge nach Belieben sortiert werden.

![](https://storage.crisp.chat/users/helpdesk/website/-/9/1/f/e/91fefd8b4b0ac000/appgroupalarmcomdedorganizatio_4v9azz.png)

###### Regeln

Wenn Sie eine Entität bearbeiten, können Sie Regeln definieren. Die Regeln dienen dazu, eine Aktion zu starten, wenn sich die Daten einer Entität verändern.

| 💡 Die Regeln stehen erst zur Wahl, wenn die Entität bereits angelegt wurde.

![](https://storage.crisp.chat/users/helpdesk/website/-/9/1/f/e/91fefd8b4b0ac000/regeln_13fki5a.png)

Zur besseren Identifikation der Regeln können Sie wie gewohnt einen Namen und eine Beschreibung hinzufügen. 

Unter `Auslöser` wählen Sie, wann die Aktion ausgelöst werden soll. Zur Auswahl stehen hier die drei Status der Daten `Bei Erstellung`, `Bei Äderung` und `Bei Löschung`. Sobald also eine entsprechende Änderung der Daten stattfindet, wird automatisch die Aktion gestartet, welche Sie unter Aktionstyp festlegen. Wie diese Änderung stattfindet, sprich also händisch, per [API](https://developer.groupalarm.com/api/things.html) oder [Flow](https://docs.groupalarm.com/de/article/flows-cpcy18/), spielt dabei keine Rolle. Aktuell stehen Alarmvorlagen als Aktionstyp zur auswahl.

Unter `Alarmvorlage Konfigurieren` wählen Sie die gewünschte Alarmvorlage aus, welche ausgelöst werden soll. 

Dazu können Sie optional Koordinaten festlegen, welche übermittelt werden sollen. Diese beziehen Sie aus dem `Koordinaten` Feld der Entität. Wenn Sie außerdem Dokumente mit dem Alarm ausliefern möchten, können Sie einen Dokumentenschlüssel festlegen. Diesen müssen Sie in der Entität in einem `Text` Feld hinterlegen.

Des Weiteren können Sie einen individuellen Ereignisnamen sowie einen Alarmtext hinterlegen. Dazu können Sie dem Text auch Variablen der jeweiligen Felder hinzufügen.

|| ⚠️ Ereignisname und Alarmtext aus der Regel greifen nur, wenn diese in der Vorlage nicht definiert sind.

Wenn die Regel nur bei bestimmten Bedingungen greifen soll, können Sie optional eine oder mehrere Bedingungen hinzufügen. Diese Bedingungen müssen dann erfüllt sein, damit die Regel greift. Beachten Sie dabei bitte, dass die Regel dann jedoch auch greift, wenn Sie z. B. eine Änderung eines anderen Feldes vornehmen, als Sie in der Bedingung definiert haben. Ein Beispiel: Wenn Sie die Checkbox Ja/Nein wie auf dem Screenshot zur Bedingung mit `JA` machen, dann greift die Regel auch, wenn die Checkbox der Bedingung bereits gesetzt war und lediglich die Koordinaten angepasst wurden.

|| ⚠️ Bei der Regel für die PNA App sollten Sie z. B. eine Bedingung hinzufügen, welche für das Feld `Alarm` den Wert `Ja` erwartet. Andernfalls kann es sein, dass Sie Alarme dazu mehrfach erhalten. Die PNA App sendet nach einer Auslösung auch immer ein `Alarm false` an das System, was wiederum ebenfalls eine Änderung darstellt und somit einen weiteren Alarm auslöst.

Die `Alarm-Sperrzeit` hilft Ihnen, Mehrfachauslösungen zu vermeiden. Das System prüft dabei immer das Feld, welches Sie auswählen. Sollte der Inhalt identisch zu einem vorangegangenen Eintrag innerhalb der Sperrfrist sein, greift die Regel nicht. So könnten Sie z. B. prüfen, ob die Adresse identisch ist. 

![](https://storage.crisp.chat/users/helpdesk/website/-/9/1/f/e/91fefd8b4b0ac000/appgroupalarmcomdedorganizatio_gpa1qa.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/9/1/f/e/91fefd8b4b0ac000/tingsneude_8izcqn.png)

Über `DATEN PFLEGEN`, erreichbar aus der Übersicht, können nun die einzelnen Felder mit Daten befüllt werden. Außerdem sind dort alle bestehenden Einträge gelistet und können bei Bedarf bearbeitet oder gelöscht werden. Neben dem händischen Pflegen von Daten, können Sie die Felder auch über die [GroupAlarm Flows](https://docs.groupalarm.com/de/article/flows-cpcy18/) sowie die [GroupAlarm API Schnittstelle](https://developer.groupalarm.com/api/things.html) befüllen, bearbeiten und entfernen. Zusätzlich können die Daten über `Importieren` via CSV eingefügt werden.

| 💡 Beim Pflegen der Daten der einzelnen Felder ist es wichtig, das entsprechende Format einzuhalten. Andernfalls kann es zu Problemen bei der weiteren Verarbeitung kommen.

![](https://storage.crisp.chat/users/helpdesk/website/-/9/1/f/e/91fefd8b4b0ac000/feldercut_srvvu2.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/9/1/f/e/91fefd8b4b0ac000/appgroupalarmcomdedorganizatio_noetjh.png)