snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/de/user-guide/data-migration/capabilities/field-mapping.mdx

@@ -0,0 +1,198 @@
+---
+title: Feldzuordnung
+description: Wie die Feldzuordnung beim Datenimport funktioniert.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Wie die Feldzuordnung funktioniert
+
+Wenn Sie eine Datei hochladen, analysiert Twenty Ihre Spalten und versucht, sie bestehenden Feldern zuzuordnen.
+
+### Automatische Zuordnung
+
+Twenty versucht, Spalten anhand der folgenden Kriterien abzugleichen:
+
+* Spaltenüberschriften (genaue oder ähnliche Übereinstimmungen)
+* Erkennung des Datentyps (Datum, Zahlen, E-Mails)
+* Häufige Feldmuster
+
+<Note>**Schneller Tipp:** Exportieren Sie ein paar Zeilen aus dem Objekt, das Sie importieren möchten. Die exportierte Datei enthält genau die Spaltennamen, die Twenty erwartet, sodass die automatische Zuordnung beim Import reibungslos funktioniert.</Note>
+
+### Optionen für die manuelle Zuordnung
+
+Für jede Spalte können Sie:
+
+* **Einem Feld zuordnen**: Wählen Sie das passende Twenty-Feld aus einem Dropdown aus
+* **Nicht zuordnen**: Überspringen Sie die Spalte vollständig (Daten werden nicht importiert)
+
+<Note>**Felder müssen vor dem Import existieren.** Der Import erzeugt Datensätze, nicht Felder. Erstellen Sie benutzerdefinierte Felder vor dem Import unter **Einstellungen → Datenmodell**.</Note>
+
+## Kompatibilität der Feldtypen
+
+Alle im Datenmodell verfügbaren Feldtypen werden für den Import unterstützt.
+
+Sie können auch `id`-Werte importieren, um neuen Datensätzen eine bestimmte ID zuzuweisen oder vorhandene zu aktualisieren.
+
+<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
+
+## Anforderungen an das Datenformat
+
+<Note>**Einige Felder haben eine spezielle Syntax.** Wir empfehlen, vor der Vorbereitung Ihres Imports die Beispieldatei herunterzuladen, um die erwartete Syntax für jeden Feldtyp zu sehen.</Note>
+
+### Adressfelder
+
+Adresse ist ein verschachteltes Feld mit mehreren Spalten. Einige können leer bleiben.
+
+* **Adresse / Adresszeile 1**: Adresszeile 1
+* **Adresse / Adresszeile 2**: Adresszeile 2
+* **Adresse / Stadt**: Stadtname
+* **Adresse / Bundesland**: Bundesland oder Provinz
+* **Adresse / Land**: Ländername
+* **Adresse / Postleitzahl**: Postleitzahl/ZIP-Code
+
+### Array-Felder
+
+Verwenden Sie folgendes Format:
+
+```
+["value1","value2"]
+```
+
+### Boolesche Felder
+
+Verwenden Sie `TRUE` oder `FALSE` (Großbuchstaben) – nicht `true` oder `false`
+
+### Währungsfelder
+
+Währung ist ein verschachteltes Feld mit zwei Spalten, die **beide ausgefüllt werden müssen**:
+
+* **Betrag / Betrag**: Der Zahlenwert (z. B. `1234.56`)
+* **Betrag / Währung**: Der Währungscode (z. B. `USD`, `EUR`)
+
+### Datumsfelder
+
+Unterstützte Formate:
+
+* `YYYY-MM-DD` (empfohlen)
+* `MM/DD/YYYY`
+* `DD/MM/YYYY`
+* ISO-8601-Format
+
+### Domain-Felder
+
+* Es wird empfohlen, das Format `https://domain.com` zu verwenden, um Duplikate zu vermeiden, da dies das Format für Unternehmen ist, die durch die Postfach- und Kalender-Synchronisierungen erstellt werden.
+* Es können ein `Domain Label` und eine `Domain URL` ausgefüllt werden: Best Practice ist, im Label `domain.com` und in der URL `https://domain.com` anzugeben
+* Domains müssen im Objekt Unternehmen eindeutig sein
+* **Domains müssen innerhalb der zu importierenden Datei eindeutig sein**
+
+### E-Mail-Felder
+
+* Müssen ein gültiges E-Mail-Format haben
+* E-Mails müssen im Objekt Personen eindeutig sein
+* **E-Mails müssen innerhalb der zu importierenden Datei eindeutig sein**
+* Für zusätzliche E-Mails: Verwenden Sie **E-Mails / Primäre E-Mail** für die Haupt-E-Mail und **E-Mails / Zusätzliche E-Mails** mit diesem Format:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### ID-Felder
+
+Die Angabe einer `id` während des Imports ist optional. Twenty erzeugt automatisch eine, wenn keine angegeben wird.
+
+Anwendungsfälle für die Zuordnung einer `id`-Spalte:
+
+* **Spezifische ID festlegen**: Wählen Sie die UUID für neu erstellte Datensätze
+* **Vorhandene Datensätze aktualisieren**: Gegen vorhandene Datensätze abgleichen, um sie zu aktualisieren, anstatt Duplikate zu erstellen. In diesem Fall wird empfohlen, die anderen eindeutigen Felder nicht zuzuordnen: Die Zuordnung nur eines eindeutigen Feldes sorgt für einen reibungsloseren Import.
+
+<Note>Wenn Sie eine `id` angeben, muss sie im UUID-Format sein (z. B. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+### JSON-Felder
+
+Verwenden Sie gültiges JSON-Format:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### Link-Felder
+
+Ähnlich wie Domain-Felder:
+
+* Füllen Sie sowohl die Spalten für Label und URL aus: **Links / Link-URL** und **Links / Link-Label**
+* Verwenden Sie das vollständige URL-Format: `https://example.com`
+* Für sekundäre Links verwenden Sie die Spalte **Links / Sekundäre Links** mit diesem Format:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### Mehrfachauswahl-Felder
+
+Verwenden Sie die **API-Namen** (nicht die Anzeigenamen) in folgendem Format:
+
+```
+["VALUE1","VALUE2"]
+```
+
+Siehe [hier](#finding-api-names-for-select-fields), wo Sie die API-Namen finden.
+
+<Note>Neue Auswahloptionen werden durch den Import nicht automatisch erstellt. Sie müssen vor dem Import unter **Einstellungen → Datenmodell** hinzugefügt werden.</Note>
+
+<Warning>
+**Importiere Überschreibungen, es fügt nicht hinzu.**
+
+Wenn ein Datensatz bereits `VALUE2` und `VALUE3` ausgewählt hat und Sie `["VALUE1"]` importieren, hat der Datensatz nach dem Import nur noch `VALUE1`. Die bisherigen Auswahlen werden ersetzt, nicht zusammengeführt.
+</Warning>
+
+### Zahlenfelder
+
+* Nur Zahlen
+* Dezimalzahlen verwenden einen Punkt: `1234.56`
+* Keine Tausendertrennzeichen
+
+### Telefonfelder
+
+Telefon ist ein verschachteltes Feld mit mehreren Spalten, die **ausgefüllt werden müssen**
+
+* **Telefone / Primäre Telefonnummer**: Die Telefonnummer (z. B. `4159095555`)
+* **Telefone / Ländercode der primären Telefonnummer**: Ländercode (z. B. `US`)
+* **Telefone / Vorwahl der primären Telefonnummer**: Vorwahl (z. B. `+1`)
+
+### Bewertungsfelder
+
+Verwenden Sie das API-Namensformat: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`
+
+### Relationsfelder
+
+Weitere Informationen finden Sie in unserem dedizierten Artikel: [Beziehungen zwischen Objekten importieren](/l/de/user-guide/data-migration/capabilities/import-relations)
+
+### Auswahlfelder
+
+Verwenden Sie den **API-Namen** der Option (nicht den Anzeigenamen):
+
+```
+VALUE1
+```
+
+Siehe [hier](#finding-api-names-for-select-fields), wo Sie die API-Namen finden.
+<Note>Neue Auswahloptionen werden durch den Import nicht automatisch erstellt. Sie müssen vor dem Import unter **Einstellungen → Datenmodell** hinzugefügt werden.</Note>
+
+### Textfelder
+
+* Keine besondere Formatierung erforderlich
+* Führende/abschließende Leerzeichen werden entfernt
+
+## API-Namen finden
+
+Für Select-, Multi-Select- und Array-Felder mit vordefinierten Optionen müssen Sie die **API-Namen** verwenden, nicht die Anzeigenamen.
+
+### So finden Sie API-Namen
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie das Objekt und das Feld aus
+3. Aktivieren Sie den **Erweiterten Modus** (Schalter unten rechts auf der Einstellungsseite)
+4. Zeigen Sie den API-Namen für jede Option an
+
+<VimeoEmbed videoId="1144910809" title="Video-Demonstration" />