# Daten importieren

Mit einem Import übernimmst du CSV-Daten in eine App, ohne Datensätze manuell einzugeben.

{% hint style="info" %}
Du kannst Daten nur in eine Tabelle importieren, wenn du Schreibrechte für diese Tabelle hast.
{% endhint %}

Du kannst Daten auf zwei Arten importieren:

* in eine vorhandene Tabelle
* in eine neue Tabelle, die Ninox aus der Datei erstellt

Während des Imports steuerst du, wie Ninox die Datei liest und wohin jede Spalte zugeordnet wird. Dazu gehört:

* zu wählen, ob neue Datensätze eingefügt, vorhandene Datensätze aktualisiert oder beide Aktionen ausgeführt werden
* Parse-Einstellungen wie Kodierung, Trennzeichen und Datumsformate zu prüfen
* CSV-Spalten vorhandenen Ninox Feldern zuzuordnen oder neue Felder zu erstellen
* das Ergebnis zu prüfen, bevor du etwas importierst

### Was du beim Import steuern kannst

Im Import-Dialog legst du fest, wie Ninox die Datei liest und wie jede CSV-Spalte verarbeitet wird.

Zwei Bereiche sind besonders wichtig:

* **Parse-Einstellungen** steuern, wie Ninox das Dateiformat liest.
* **Felder zuordnen** steuert, wohin die CSV-Daten in Ninox gehen.

#### Parse-Einstellungen

In **Parse-Einstellungen** legst du fest, wie Ninox die Importdatei liest.

Wähle zuerst, wie Ninox mit den Datensätzen umgehen soll:

* **Nur aktualisieren** aktualisiert vorhandene Datensätze
* **Nur einfügen** fügt neue Datensätze hinzu
* **Aktualisieren und einfügen** aktualisiert vorhandene Datensätze und fügt neue hinzu

Prüfe dann die Optionen für das Dateiformat:

* **Kodierung** definiert den Zeichensatz, zum Beispiel **UTF-8 (Unicode)**
* **Datumsformat** definiert, wie Ninox Datumswerte liest
* **Zahlenformat** definiert, wie Ninox Dezimal- und Tausendertrennzeichen liest
* **Spaltentrennzeichen** definiert, wie Spalten getrennt werden, zum Beispiel durch Balken, Komma, Semikolon oder Tabulator
* **Textbegrenzungszeichen** definiert, welche Anführungszeichen Textwerte umschließen

Du kannst außerdem zwei Importdetails steuern:

* **Kopfzeile einschließen** teilt Ninox mit, dass die erste Zeile Spaltennamen enthält
* **Leere Felder als `null` behandeln** importiert leere Werte als `null`. Das bedeutet, dass das Feld keinen Wert hat. Es ist kein leerer Textwert und nicht die Zahl `0`. Nutze diese Option, wenn leere Zellen nach dem Import nicht gesetzt bleiben sollen.

Nutze die Vorschau rechts, um zu prüfen, ob Ninox die Datei korrekt liest.

Die Vorschau verwendet außerdem Farblabels, um zu zeigen, was beim Import passiert:

* **Neu** zeigt Datensätze, die Ninox hinzufügt
* **Aktualisiert** zeigt Datensätze, die Ninox ändert
* **Entfernt** zeigt Datensätze, die während der Importvorschau aus der Ergebnismenge entfernt werden
* **Unverändert** zeigt Datensätze, die gleich bleiben

#### Felder zuordnen

In **Felder zuordnen** zeigt Ninox eine Zeile für jede CSV-Spalte.\
Mit dem Schalter **Importieren** legst du fest, ob Ninox diese Spalte überhaupt importieren soll. Wenn der Schalter aus ist, überspringt Ninox die Spalte.\
In **CSV-Felder** siehst du die Spaltennamen aus der CSV-Datei.\
In **Vorhandene Ninox-Felder** legst du fest, was Ninox mit jeder CSV-Spalte machen soll.\
Du kannst:

* **Nicht zuordnen** wählen, um die Spalte zu ignorieren
* ein vorhandenes Ninox Feld wählen, um die Werte in dieses Feld zu importieren
* **+ Feld erstellen** wählen, um ein neues Feld für diese Spalte zu erstellen

Wenn du ein vorhandenes Ninox-Feld auswählst, ordnet Ninox die CSV-Spalte diesem Feld zu.

In diesem Fall kannst du auch eine **Aktualisierungsrichtlinie** wählen:

* **Aktualisieren** ersetzt den vorhandenen Wert
* **Leere aktualisieren** füllt nur leere Werte

Wenn du **+ Feld erstellen** auswählst, fügt Ninox darunter eine zweite Auswahl hinzu. Nutze sie, um den Feldtyp zu wählen, zum Beispiel **Text**.

### Daten in eine vorhandene Tabelle importieren

Nutze diesen Ablauf, wenn die Tabelle bereits existiert.

{% stepper %}
{% step %}
**Den Import-Dialog öffnen**

Öffne die Tabelle in der **Tabellenansicht**.\
Klicke in der **Top-Bar** auf **Import/Export**.\
Klicke dann auf **Daten importieren**.
{% endstep %}

{% step %}
**Deine Datei hochladen**

Ziehe deine CSV-Datei in den Import-Dialog. Oder wähle die Datei auf deinem Gerät aus.
{% endstep %}

{% step %}
**Parse-Einstellungen prüfen**

Wähle aus, wie Ninox die Datei lesen soll.

Starte mit dem Importmodus:

* **Nur einfügen** fügt neue Datensätze hinzu
* **Nur aktualisieren** ändert vorhandene Datensätze
* **Aktualisieren und einfügen** macht beides

Prüfe dann diese Optionen:

* **Kodierung**, zum Beispiel **UTF-8 (Unicode)**
* **Datumsformat**
* **Zahlenformat**
* **Spaltentrennzeichen**
* **Textbegrenzungszeichen**
* **Kopfzeile einschließen**
* **Leere Felder als `null` behandeln**

Nutze die Vorschau rechts, um das Ergebnis zu prüfen.
{% endstep %}

{% step %}
**Die Dateispalten zuordnen**

Öffne **Felder zuordnen**.

Wähle für jede CSV-Spalte das passende vorhandene Feld.\
Du kannst außerdem:

* **Importieren** deaktivieren, um eine Spalte zu überspringen
* bei Bedarf ein neues Feld erstellen
* eine **Aktualisierungsrichtlinie** für zugeordnete Felder wählen

Nutze **Aktualisieren**, um vorhandene Werte zu ersetzen.\
Nutze **Leere aktualisieren**, um nur leere Werte zu füllen.
{% endstep %}

{% step %}
**Die Datensätze importieren**

Prüfe die Vorschau ein letztes Mal.\
Klicke dann auf **Datensätze importieren**.
{% endstep %}
{% endstepper %}

### Tabelle aus CSV erstellen

Nutze diesen Ablauf, wenn die Tabelle noch nicht existiert.

{% stepper %}
{% step %}
**Einen neuen Tabellenimport starten**

Klicke in der App-Navigation auf den Pfeil neben **+ Tabelle erstellen**.\
Wähle **Tabelle aus CSV importieren**.
{% endstep %}

{% step %}
**Deine Datei hochladen**

Lade deine CSV-Datei hoch.\
Ninox öffnet den Import-Dialog.
{% endstep %}

{% step %}
**Tabellendetails und Parse-Einstellungen prüfen**

Prüfe den vorgeschlagenen **Tabellennamen**.\
Prüfe den vorgeschlagenen **Internen Namen**.\
Prüfe dann dieselben Parse-Einstellungen wie beim Import in eine vorhandene Tabelle.
{% endstep %}

{% step %}
**Die Felder zuordnen**

Öffne **Felder zuordnen**.\
Erstelle für jede CSV-Spalte entweder ein neues Feld oder ordne sie einem vorhandenen Feld zu.\
Wenn du ein neues Feld erstellst, wähle den Feldtyp.
{% endstep %}

{% step %}
**Die Tabelle erstellen**

Prüfe die Vorschau.\
Klicke dann auf **Tabelle erstellen**.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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.ninox.com/builder-hub/de/design-your-app/import-and-export-data/import-data.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.
