Zum Hauptinhalt springen

​
Übersicht

Diese Anleitung führt dich durch die Vorbereitung deiner CSV-Datei für einen erfolgreichen Import. Befolge diese Schritte, um Fehler zu vermeiden.

​
Schritt 1: Dateianforderungen prüfen

Bevor du beginnst, stelle sicher, dass deine Datei diese Anforderungen erfüllt:
AnforderungDetails
FormatCSV, XLSX oder XLS
Größenbeschränkung10.000 Datensätze pro Datei
ZeichenkodierungUTF-8 empfohlen
StrukturEin Objekttyp pro Datei
Für Datenmengen mit mehr als 10.000 Datensätzen teile die Daten in mehrere Dateien auf oder verwende den API-Import.

​
Schritt 2: Beispieldatei herunterladen

Dies ist der wichtigste Schritt. Die Beispieldatei zeigt dir die exakten Spaltennamen und das Format, das Twenty erwartet.
  1. Wechsle zur Objektansicht (Personen, Unternehmen usw.)
  2. Klicke auf ⋮ → Datensätze importieren
  3. Klicke auf Beispieldatei herunterladen
  4. Verwende diese Datei als Vorlage
Profi-Tipp: Exportiere stattdessen einige vorhandene Datensätze. So erhältst du reale Beispiele dafür, wie Daten formatiert sein sollten, und die Spaltennamen werden beim Import automatisch zugeordnet.

​
Schritt 3: Doppelte Werte entfernen

Twenty erzwingt die Eindeutigkeit bestimmter Felder. Duplikate führen zu Importfehlern.
ObjektEindeutige Felder
Personenid, email
Unternehmenid, domain
Benutzerdefinierte Objekteid, plus jedes Feld, das du als eindeutig markiert hast
Vor dem Import:
  1. Sortiere deine Tabelle nach dem eindeutigen Feld (E-Mail oder Domain)
  2. Entferne oder führe doppelte Zeilen zusammen
  3. Prüfe auf Duplikate, die in Twenty bereits existieren
Softgelöschte Datensätze zählen für die Eindeutigkeit. Datensätze unter Befehlsmenü → Gelöschte Datensätze anzeigen führen zu Duplikatfehlern. Lösche sie dauerhaft oder stelle sie wieder her und aktualisiere sie.

​
Schritt 4: Jeden Feldtyp korrekt formatieren

Verschiedene Feldtypen erfordern spezifische Formate. Hier ist die vollständige Übersicht:

​
Textfelder

  • Keine spezielle Formatierung erforderlich
  • Führende und nachgestellte Leerzeichen werden automatisch entfernt

​
E-Mail-Felder

  • Muss ein gültiges E-Mail-Format haben: [email protected]
  • Muss eindeutig sein (keine Duplikate in der Datei oder in Twenty)
  • Für zusätzliche E-Mails verwende dieses Format in der Spalte Emails / Additional Emails:
["[email protected]","[email protected]"]

​
Domain-Felder

  • Empfohlenes Format: https://domain.com
  • Dies entspricht dem Format der Postfach-/Kalendersynchronisierung (verhindert Duplikate)
  • Beide Spalten ausfüllen:
    • Domain / Domain Label: domain.com
    • Domain / Domain URL: https://domain.com
  • Muss innerhalb deiner Datei und in Twenty eindeutig sein

​
Telefonfelder

Telefon ist ein verschachteltes Feld, das mehrere Spalten benötigt:
SpalteBeispiel
Phones / Primary Phone Number4159095555
Phones / Primary Phone Country CodeUS
Phones / Primary Phone Calling Code+1

​
Adressfelder

Adresse ist ein verschachteltes Feld mit mehreren Spalten (einige können leer bleiben):
  • Adresse / Adresse 1: Straßenadresse Zeile 1
  • Adresse / Adresse 2: Straßenadresse Zeile 2 (optional)
  • Adresse / Stadt: Stadtname
  • Adresse / Bundesland: Bundesstaat oder Provinz
  • Adresse / Land: Name des Landes
  • Adresse / Postleitzahl: Postleitzahl/ZIP-Code

​
Datumsfelder

Verwenden Sie in Ihrer Datei ein einheitliches Format:
  • YYYY-MM-DD (empfohlen): 2024-03-15
  • MM/DD/YYYY: 03/15/2024
  • DD/MM/YYYY: 15/03/2024
  • ISO 8601: 2024-03-15T10:30:00Z

​
Zahlenfelder

  • Nur Zahlen (kein Text)
  • Verwenden Sie den Punkt für Dezimalstellen: 1234.56
  • Keine Tausendertrennzeichen (nicht 1,234.56)

​
Währungsfelder

Währung ist ein verschachteltes Feld und erfordert zwei Spalten, die beide ausgefüllt werden müssen:
SpalteBeispiel
Betrag / Betrag1234.56
Betrag / WährungUSD

​
Boolesche Felder

Großschreibung verwenden: TRUE oder FALSE
Kleinschreibung true oder false funktioniert nicht.

​
Auswahlfelder

Verwenden Sie den API-Namen der Option, nicht den 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)
  4. Kopieren Sie den API-Namen (z. B. OPTION_1, nicht “Option 1”)
Neue Auswahloptionen werden nicht automatisch erstellt. Fügen Sie sie vor dem Import unter Einstellungen → Datenmodell hinzu.

​
Mehrfachauswahlfelder

Verwenden Sie API-Namen im Array-Format: 
["VALUE1","VALUE2"]

​
Array-Felder

Verwenden Sie das JSON-Array-Format: 
["value1","value2"]

​
Bewertungsfelder

Verwenden Sie das Format: RATING_1, RATING_2, RATING_3, RATING_4 oder RATING_5

​
Links/URL-Felder

Füllen Sie beide Spalten aus:
  • Links / Link-Label: Twenty
  • Links / Link-URL: https://twenty.com
Für sekundäre Links verwenden Sie die Spalte Links / Sekundäre Links: 
[{"url":"https://twenty.com","label":"Twenty"}]

​
JSON-Felder

Verwenden Sie ein gültiges JSON-Format: 
{"key":"value","key2":"value2"}

​
ID-Felder

  • Optional: Twenty erstellt IDs automatisch, wenn sie nicht angegeben werden
  • Format: UUID (z. B. c776ee49-f608-4a77-8cc8-6fe96ae1e43f)
  • Anwendungsfall: ID angeben, um bestehende Datensätze zu aktualisieren, statt neue zu erstellen

​
Schritt 5: Beziehungsspalten hinzufügen (bei Verknüpfung von Datensätzen)

Um Datensätze mit anderen Objekten zu verknüpfen (z. B. Personen mit Unternehmen), fügen Sie eine Spalte mit dem eindeutigen Bezeichner des zugehörigen Datensatzes hinzu. Beispiel: Verknüpfung von Personen mit Unternehmen Fügen Sie Ihrer Personen-CSV eine Spalte hinzu: 
firstName,lastName,email,companyDomain
John,Smith,[email protected],https://acme.com
Jane,Doe,[email protected],https://widgets.co
Wichtige Regeln für Beziehungen:
  • Der übergeordnete Datensatz muss bereits in Twenty vorhanden sein
  • Verwenden Sie das Domain-URL-Format (https://domain.com), nicht die Bezeichnung
  • Ordnen Sie nur EINEN eindeutigen Bezeichner zu (nicht sowohl companyId ALS AUCH companyDomain)
  • Für Workspace-Mitglieder verwenden Sie deren E-Mail (nicht den Namen)
Die Importreihenfolge ist wichtig!Importieren Sie die “One”-Seite vor der “Many”-Seite:
  1. Unternehmen zuerst
  2. Personen als Zweites (mit Unternehmensreferenz)
  3. Opportunities als Drittes
Der übergeordnete Datensatz muss vorhanden sein, bevor Sie darauf verweisen können.
Siehe Beziehungen importieren für detaillierte Anleitungen.

​
Schritt 6: Sicherstellen, dass Felder in Twenty vorhanden sind

Der Import erstellt Datensätze, nicht Felder. Alle Felder, die Sie importieren möchten, müssen bereits in Ihrem Datenmodell vorhanden sein. Vor dem Import:
  1. Gehen Sie zu Einstellungen → Datenmodell
  2. Wählen Sie Ihr Objekt aus
  3. Erstellen Sie alle benötigten benutzerdefinierten Felder
  4. Notieren Sie die exakten Feldnamen (sie müssen mit Ihren Spaltenüberschriften übereinstimmen)

​
Schritt 7: Abschluss-Checkliste

Überprüfen Sie vor dem Hochladen Ihrer Datei:
Datei ist im CSV-, XLSX- oder XLS-Format
Datei enthält weniger als 10.000 Datensätze
Zeichencodierung ist UTF-8
Keine doppelten E-Mails (für Personen) oder Domains (für Unternehmen)
Datumsangaben verwenden durchgehend ein einheitliches Format
Domains verwenden das Format https://domain.com
Boolesche Felder verwenden TRUE oder FALSE (Großschreibung)
Auswahlfelder verwenden API-Namen, nicht Anzeigenamen
Alle benutzerdefinierten Felder existieren in Einstellungen → Datenmodell
Übergeordnete Datensätze vor untergeordneten Datensätzen importiert
Beziehungsspalten verweisen auf vorhandene Datensätze

​
Häufige Fehler, die Sie vermeiden sollten

FehlerLösung
Verwendung von true statt TRUEBoolesche Werte müssen in Großbuchstaben sein
Verwendung von Anzeigenamen für AuswahlfelderAPI-Namen in den Einstellungen suchen und verwenden
Import von Personen vor UnternehmenImportieren Sie stets zuerst die übergeordneten Objekte
Fehlender Währungscode für WährungsfelderSowohl die Spalte Betrag als auch die Spalte Währung ausfüllen
Falsches Domain-Formathttps://domain.com konsequent verwenden
Zuordnung mehrerer eindeutiger Felder für BeziehungenNur EINES zuordnen (Domain ODER ID, nicht beides)

​
Nächste Schritte

Ihre Datei ist bereit! Jetzt: