> For the complete documentation index, see [llms.txt](https://docs.g-iot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.g-iot.io/de/plattform-benutzerhandbuch/gruppen/gruppenseite-cockpit-ansicht.md).

# Gruppenseite - Cockpit-Ansicht

<figure><img src="/files/KaQlpEapWgGKNAkAQseU" alt=""><figcaption></figcaption></figure>

### Zugriff auf die Gruppenseite

1. **Cockpit-Menü öffnen**\
   Klicken Sie in der linken Seitenleiste auf das Cockpit-Menü, um die verfügbaren Bereiche zu erweitern.
2. **„Gruppen“ auswählen**\
   Wählen Sie *Gruppen*, um die entsprechende Seite zu öffnen.
3. **Gruppenstruktur anzeigen**\
   Hier können Sie alle bestehenden Gruppen oder – abhängig von Ihrem Zugriffslevel – nur die Gruppen einsehen, die Ihrer Benutzerrolle zugewiesen sind.

<figure><img src="/files/9oXUBF61TluO5yGP9NGx" alt=""><figcaption></figcaption></figure>

### Gruppenseiten-Funktionen

In der oberen rechten Ecke der Gruppenseite finden Super-Admins oder Benutzer mit entsprechenden Berechtigungen alle verfügbaren Gruppenverwaltungsfunktionen:

#### **Nach Gruppentyp filtern**

Sie können die folgenden Filter anwenden:

**Gruppentyp:**

* **Alle Gruppen** – Zeigt jede Gruppe und Untergruppe an.
* **Top-Level-Gruppen** – Zeigt nur die übergeordneten Hauptgruppen.
* **Nur Untergruppen** – Zeigt ausschließlich die Untergruppen ohne übergeordnete Gruppen an.

**Filter „Gruppe mit Geräten“:**

* **„Gruppe ohne Geräte“ EIN** – Zeigt nur Gruppen an, denen derzeit keine Geräte zugewiesen sind.
* **„Gruppe ohne Geräte“ AUS** – Zeigt alle Gruppen an, unabhängig davon, ob Geräte zugewiesen sind oder nicht.

**Gruppe erstellen**\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/7MM4qMpFROaIGLQwO80c/plattform-benutzerhandbuch/gruppen/gruppen-erstellen](/de/plattform-benutzerhandbuch/gruppen/gruppen-erstellen.md)

Klicken Sie auf **Gruppe erstellen**, um:

* Manuell eine neue Gruppe zu erstellen.
* Oder eine Geräteliste per **CSV-Datei** hochzuladen.

> Die CSV-Datei muss eine einzelne Spalte enthalten, beginnend bei Zelle A1. Jede Zeile muss eine **Device ID** enthalten.

**Gruppenoperationen verwalten**

<https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/7MM4qMpFROaIGLQwO80c/plattform-benutzerhandbuch/gruppen/gerate-einer-gruppe-zuweisen>

Klicken Sie auf das **Verwalten-Symbol**, um:

* **Geräte zuzuweisen**: Fügen Sie ausgewählte Geräte von einer Gruppe zu einer anderen hinzu (das Gerät gehört dann zu beiden Gruppen).
* **Geräte zu verschieben**: Verschieben Sie Geräte in eine neue Gruppe (sie werden aus der Quellgruppe entfernt).
  * Wird die Quellgruppe dadurch leer, werden Sie aufgefordert, diese zu löschen.
* Eine übersichtliche Benutzeroberfläche zeigt Quell- und Zielgruppe nebeneinander für eine einfache Verwaltung.

**Ansicht wechseln**\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/7MM4qMpFROaIGLQwO80c/\~/changes/195/plattform-benutzerhandbuch/gruppen/gruppen-seite-karten-und-baumansicht](/de/plattform-benutzerhandbuch/gruppen/gruppen-seite-karten-und-baumansicht.md)

Wechseln Sie zwischen:

* **Kartenansicht**: Schneller Überblick mit Gruppenstatistiken.
* **Baumansicht**: Darstellung der vollständigen Gruppenhierarchie einschließlich aller Untergruppen.

**Gruppen sortieren**\
Sortieren Sie die Liste nach:

* **Erstellungsdatum**
* **Alphabetischer Reihenfolge**

<figure><img src="/files/RhhQgGzjWxwGPaxMLRzi" alt=""><figcaption></figcaption></figure>

### **Gruppenkarten-Optionen**

Jede Gruppenkarte enthält ein ⋮ (Ellipsen-)Menü mit mehreren Verwaltungsaktionen. Diese sind nur für Super-Admins oder Benutzer mit entsprechenden Berechtigungen verfügbar.

**Verwalten**

* **Geräte zuweisen oder entfernen** – Geräte zur Gruppe hinzufügen oder aus der Gruppe entfernen.
* **Geräte zwischen Gruppen verschieben** – Ausgewählte Geräte in eine andere Gruppe übertragen.
* **Gruppennamen und Beschreibung bearbeiten** – Wichtige Identifikatoren zur besseren Organisation anpassen.

**Bearbeiten**

* **Gruppenname** – Umbenennen der Gruppe.
* **Gruppenbeschreibung** – Eine Beschreibung hinzufügen oder aktualisieren, um Kontext zu geben.
* **Gruppensymbol und Farbe** – Eine visuelle Identität für die Gruppe auswählen.
* **Avatar hochladen** – Optional ein eigenes Bild oder Logo für die Gruppenkarte hochladen.

**Löschen**\
Löscht die Gruppe dauerhaft, einschließlich:

* aller Untergruppen
* aller Gerätezuweisungen

**Hinweis:** Diese Aktion ist irreversibel und muss mit Vorsicht durchgeführt werden.

{% hint style="warning" %}
**Berechtigungshinweis:** Nur Super-Admins oder Benutzer mit explizit gewährten Berechtigungen können auf die Funktionen **Verwalten**, **Bearbeiten** oder **Löschen** zugreifen.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.g-iot.io/de/plattform-benutzerhandbuch/gruppen/gruppenseite-cockpit-ansicht.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.