> For the complete documentation index, see [llms.txt](https://docs.polyteia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.polyteia.com/datensaetze.md).

# Datensätze

Datensätze sind eine zentrale Ressource in der Polyteia-Plattform und dienen als grundlegendes Modul zur Speicherung von Daten in Tabellenform. Diese Daten können erkundet und in anderen Ressourcen genutzt werden. Nutzer können externe Daten durch manuelle [Datei-Uploads](/datensaetze/daten-hochladen.md), [Zugriffsschlüssel (PAK)](/konto/zugriffsschlussel-pak.md) oder [Formulare](/formulare.md) importieren.

Datensatz-Administratoren verwalten den Datenzugriff durch die Zuweisung von Rollen, wie beispielsweise Bearbeiter. Mit entsprechendem Zugriff können Nutzer Auswertungen und Berichte aus einem oder mehreren Datensätzen generieren.

### Funktionen

* **Daten hochladen und speichern**\
  Laden Sie CSV-, Excel-, JSON- oder Parquet-Dateien hoch, um strukturierte Daten zu speichern
* **Schema-Bearbeitung**\
  Benennen Sie Spalten um und ändern Sie Datentypen unter der Reiter **Details**
* **Spaltenreihenfolge-Einstellungen**\
  Passen Sie an, wie Spalten in der Datensatzansicht angezeigt werden
* **Tags und Dokumentation**\
  Fügen Sie Kontext und Kategorisierung direkt auf der Übersichtsseite hinzu
* **Erkunden und Visualisieren**\
  Öffnen Sie einen Datensatz im Editor, um ihn zu analysieren oder Auswertungen zu erstellen

{% hint style="info" %}
**Datenschutz**: Beim Hochladen von Daten müssen Sie möglicherweise die dokumentierten Verarbeitungstätigkeiten im [Weisungsregister](/sicherheit/weisungsregister.md) bestätigen, wenn Ihre Lösung Einträge zur Auftragsverarbeitungsvereinbarung (AVV) konfiguriert hat.
{% endhint %}

### Zugriff auf Datensätze

#### Von einer Lösung aus

1. Gehen Sie zu **Startseite** → **Arbeitsbereich aufklappen** → **Lösung**
2. Klicken Sie in der Seitenleiste auf **Datensätze**
3. Im Fenster sehen Sie alle Datensätze dieser Lösung
4. Klicken Sie auf einen Datensatz zum Anzeigen oder Bearbeiten

#### So erstellen Sie einen neuen Datensatz:

1. Öffnen Sie eine Lösung
2. Klicken Sie in der Seitenleiste auf **Datensätze**
3. Im Fenster klicken Sie auf das **+** Symbol

***

### Verwaltung von Datensätzen

Klicken Sie auf das Menü **...** oben rechts auf der Datensatz-Übersichtsseite, um auf diese Aktionen zuzugreifen:

* **Datensatz öffnen** - zeigt die Datenvorschau in der Tabellenansicht
* **Datensatzdetails bearbeiten** - Titel, Quelle oder Beschreibung ändern
* **Daten hochladen** - bestehende Daten ersetzen oder hinzufügen
* **Teilen** - Freigabeoptionen kopieren oder verwalten (falls aktiviert)
* **Datensatz duplizieren** - eine Kopie des Datensatzes erstellen
* **Herunterladen als** - den Datensatz in einem unterstützten Format exportieren
* **Datensatz-ID kopieren** - die eindeutige Kennung in die Zwischenablage kopieren
* **Datensatz löschen** - den Datensatz dauerhaft löschen (nur Eigentümer)

### Rollen und Berechtigungen

Datensätze in der Polyteia-Plattform haben drei Rollen:

* **Eigentümer** haben vollständige Kontrolle, einschließlich der Verwaltung von Einstellungen, Freigabezugriff und Eigentumsübertragung
* **Bearbeiter** können Daten ändern, aber keine Datensatzeinstellungen oder -berechtigungen ändern
* **Betrachter** können nur die Metadaten des Datensatzes sehen, nicht dessen Inhalt

**Alle Mitglieder der Lösung können Datensätze erstellen.** Der **Ersteller eines Datensatzes ist der Standard-Eigentümer**, kann aber bei Bedarf den Zugriff teilen oder das Eigentum übertragen.

**Berechtigungen für Auswertungen werden von Datensatzrollen übernommen**, was bedeutet, dass nur Eigentümer und Bearbeiter von Datensätzen Auswertungen erstellen und ausführen können, während Betrachter nur Datensatz- und Auswertungsmetadaten sehen können.

### Datensatz-Berechtigungen

Berechtigungen in Datensätzen bestimmen, wer Daten **erstellen, ändern, teilen und analysieren** kann. Alle Mitglieder der Lösung können **Datensätze erstellen**, und der Ersteller wird automatisch zum **Standard-Eigentümer** mit der Möglichkeit, bei Bedarf **Eigentum zu teilen oder zu übertragen**. Diese Berechtigungen wirken sich auch direkt auf **Auswertungen** aus, da nur Datensatz-Eigentümer und -Bearbeiter **Auswertungen erstellen und ausführen** können, während Betrachter nur Datensatz- und Auswertungsmetadaten sehen können.

<table><thead><tr><th width="363.12890625">Berechtigung</th><th align="center">Eigentümer</th><th align="center">Bearbeiter</th><th align="center">Bertrachter</th></tr></thead><tbody><tr><td>Datensatz-Metadaten bearbeiten (z. B. Name, Schema)</td><td align="center">✓</td><td align="center">✕</td><td align="center">✕</td></tr><tr><td>Datensatz teilen und Eigentümerschaft übertragen</td><td align="center">✓</td><td align="center">✕</td><td align="center">✕</td></tr><tr><td>Datensatz löschen</td><td align="center">✓</td><td align="center">✕</td><td align="center">✕</td></tr><tr><td>Datensatz duplizieren</td><td align="center">✓</td><td align="center">✓</td><td align="center">✕</td></tr><tr><td>Daten anzeigen, hinzufügen, ändern und löschen</td><td align="center">✓</td><td align="center">✓</td><td align="center">✕</td></tr><tr><td>Abfragen ausführen &#x26; Auswertungen generieren</td><td align="center">✓</td><td align="center">✓</td><td align="center">✕</td></tr><tr><td>Datensatz-Metadaten anzeigen</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr></tbody></table>

### Wie Datensatz-Berechtigungen Auswertungen steuern

Auswertungen **erben Berechtigungen** von den Datensätzen, auf denen sie basieren, was bedeutet, dass Datensatz-Eigentümer und -Bearbeiter Auswertungen **erstellen, bearbeiten und ausführen** können, während Datensatz-Betrachter eingeschränkten oder keinen Zugriff haben. Da Datensatz-Berechtigungen bestimmen, wer mit Auswertungen interagieren kann, **müssen Nutzer die entsprechende Datensatzrolle haben**, um Auswertungen zu generieren oder zu ändern.

Allerdings sind Verwaltungsaktionen für Auswertungen — wie Umbenennen oder Löschen — dem Auswertungs-Eigentümer (dem Ersteller der Auswertung) vorbehalten. **Das Eigentum an Auswertungen kann nicht übertragen werden**, aber Nutzer können eine Auswertung duplizieren, um eine neue Version unter ihrer eigenen Kontrolle zu erstellen.

### Bewährte Praktiken

* **Weisen Sie Bearbeiter-Rollen sorgfältig zu**, um unerwünschte Datenänderungen zu verhindern
* **Verwenden Sie Betrachter-Rollen** für Nutzer, die nur die Metadaten und das Schema des Datensatzes kennen müssen
* **Wenn ein anderer Nutzer vollständige Kontrolle benötigt**, machen Sie den Nutzer zu einem zusätzlichen Eigentümer des Datensatzes


---

# 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:

```
GET https://docs.polyteia.com/datensaetze.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
