Zum Hauptinhalt springen

​
Übersicht

Diese Anleitung führt Sie durch den Import von Beziehungen zwischen Objekten – zum Beispiel das Verknüpfen von Personen mit Unternehmen oder von Opportunities mit Personen.
Was kann importiert werden: Nur Eins-zu-Viele-Beziehungen, die auf einen einzelnen Objekttyp verweisen. Beziehungen, die auf mehrere Objekttypen verweisen (z. B. Notizen, die sowohl mit Personen als auch mit Unternehmen verknüpft sind), werden beim Import noch nicht unterstützt.

​
Beziehungen verstehen

​
Was ist eine “Eins-zu-Viele”-Beziehung?

In einer Eins-zu-Viele-Beziehung:
  • Ein Unternehmen hat viele Personen (Mitarbeitende)
  • Ein Unternehmen hat viele Opportunities
  • Eine Person hat viele Aufgaben
Die “Eins”-Seite ist die übergeordnete. Die “Viele”-Seite ist die untergeordnete.

​
Häufige Beziehungen in Twenty

Beziehung”Eins”-Seite (übergeordnet)“Viele”-Seite (untergeordnet)
Unternehmen → PersonenUnternehmenPersonen
Unternehmen → OpportunitiesUnternehmenOpportunities
Personen → AufgabenPersonAufgaben
Personen → NotizenPersonNotizen

​
Schritt 1: Identifizieren Sie die “Eins”- und “Viele”-Seiten

Bestimmen Sie vor dem Import, welches Objekt übergeordnet und welches untergeordnet ist. Fragen Sie sich: “Hat EIN [Objekt A] VIELE [Objekt B]?”
  • Ein Unternehmen → Viele Personen ✓ (Unternehmen ist übergeordnet)
  • Eine Person → Viele Unternehmen ✗ (Das ist falsch – eine Person gehört zu einem Unternehmen)

​
Schritt 2: Importieren Sie zuerst die übergeordneten Datensätze

Das übergeordnete Objekt (“Eins”-Seite) muss in Twenty existieren, bevor Sie darauf verweisen können. Importreihenfolge:
  1. Zuerst Unternehmen (keine Abhängigkeiten)
  2. Personen an zweiter Stelle (mit Unternehmen verknüpfen)
  3. Opportunities an dritter Stelle (mit Unternehmen und/oder Personen verknüpfen)
  4. Aufgaben/Notizen (mit einem der oben genannten verknüpfen)
Wenn der übergeordnete Datensatz nicht existiert, schlägt der Import fehl.Stellen Sie stets sicher, dass Unternehmen importiert sind, bevor Sie Personen mit Unternehmensreferenzen importieren.

​
Schritt 3: Notieren Sie den eindeutigen Bezeichner des übergeordneten Objekts

Sie müssen auf den übergeordneten Datensatz mit einem eindeutigen Bezeichner verweisen. Verfügbare Optionen:
Übergeordnetes ObjektVerfügbare eindeutige Bezeichner
Unternehmenid (UUID), domain (empfohlen) oder ein beliebiges benutzerdefiniertes eindeutiges Feld
Personenid (UUID), email oder ein beliebiges benutzerdefiniertes eindeutiges Feld
Arbeitsbereichsmitgliederid (UUID), email (nicht Name)
Benutzerdefinierte Objekteid (UUID) oder ein beliebiges als eindeutig markiertes Feld
Empfehlung: Verwenden Sie domain für Unternehmen und email für Personen. Diese sind menschenlesbar und in Ihrer Tabelle leicht zu überprüfen.

​
Den Bezeichner finden

Wenn Sie die id benötigen:
  1. Exportieren Sie die übergeordneten Datensätze aus Twenty
  2. Der Export enthält die Spalte id
  3. Verwenden Sie diese IDs in Ihrer Datei mit untergeordneten Datensätzen

​
Schritt 4: Überprüfen Sie, ob das Beziehungsfeld existiert

Stellen Sie vor dem Import sicher, dass das Beziehungsfeld zwischen Ihren Objekten existiert. So prüfen oder erstellen Sie es:
  1. Gehen Sie zu Einstellungen → Datenmodell
  2. Wählen Sie Ihr untergeordnetes Objekt aus (z. B. Personen)
  3. Suchen Sie nach einem Beziehungsfeld, das auf das übergeordnete Objekt zeigt (z. B. Unternehmen)
  4. Wenn es nicht existiert, erstellen Sie es:
    • Klicken Sie auf + Feld hinzufügen
    • Wählen Sie den Typ Relation
    • Wählen Sie das übergeordnete Objekt

​
Schritt 5: Bereiten Sie Ihre CSV-Datei vor

Fügen Sie Ihrer untergeordneten CSV eine Spalte hinzu, die mit dem eindeutigen Bezeichner auf das übergeordnete Objekt verweist.

​
Beispiel: Personen, die mit Unternehmen verknüpft werden

Ihre Personen-CSV: 
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
Die Spalte companyDomain verweist auf die Domain des Unternehmens.

​
Formatvorgaben

KennungFormatBeispiel
DomäneURL-Formathttps://acme.com
E-MailStandard-E-Mailjohn@acme.com
IDUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
Das Domain-Format ist wichtig!Verwenden Sie https://domain.com (nicht nur domain.com). Dies entspricht der Art, wie Twenty Unternehmensdomains speichert, und verhindert Zuordnungsfehler.

​
Wichtige Regeln

  1. Exakte Übereinstimmung erforderlich — der Wert muss exakt dem übergeordneten Datensatz entsprechen
  2. Nur EINEN eindeutigen Bezeichner zuordnen — geben Sie nicht sowohl companyId als auch companyDomain an
  3. Groß-/Kleinschreibung beachten — Acme.com ≠ acme.com

​
Schritt 6: Beziehung hochladen und zuordnen

  1. Navigieren Sie zum untergeordneten Objekt (z. B. Personen)
  2. Klicken Sie auf ⋮ → Datensätze importieren
  3. Laden Sie Ihre CSV-Datei hoch
  4. Im Schritt zur Feldzuordnung:
    • Suchen Sie Ihre Beziehungsspalte (z. B. companyDomain)
    • Ordnen Sie sie dem Company-Beziehungsfeld zu
  5. Schließen Sie die übrige Zuordnung ab
  6. Prüfen Sie Fehler und bestätigen Sie
Twenty verknüpft automatisch jeden untergeordneten Datensatz mit dem passenden übergeordneten Datensatz.

​
Schritt 7: Überprüfen Sie den Import

Nach dem Import:
  1. Öffnen Sie einige untergeordnete Datensätze (z. B. Personen)
  2. Überprüfen Sie, ob das Beziehungsfeld das richtige übergeordnete Objekt anzeigt (z. B. Unternehmen)
  3. Öffnen Sie einen übergeordneten Datensatz und prüfen Sie den Bereich mit den zugehörigen Datensätzen

​
Häufige Fehler, die Sie vermeiden sollten

FehlerProblemLösung
Falsche ImportreihenfolgePersonen vor Unternehmen importierenImportieren Sie immer zuerst übergeordnete, dann untergeordnete Datensätze
Falsches Domain-FormatVerwendung von acme.com statt https://acme.comVerwenden Sie das vollständige URL-Format mit https://
Mehrere eindeutige FelderZuordnung sowohl von companyId als auch companyDomainOrdnen Sie nur EINEN eindeutigen Bezeichner zu
Beziehungsfeld fehltDas Beziehungsfeld existiert nicht im DatenmodellErstellen Sie es vor dem Import unter Einstellungen → Datenmodell
Nicht vorhandene DatensätzeDer übergeordnete Datensatz existiert in Twenty nichtImportieren Sie zunächst übergeordnete Datensätze oder prüfen Sie auf Tippfehler
Unterschiedliche Groß-/KleinschreibungAcme.com in der Datei, aber acme.com in TwentyAchten Sie auf exakt übereinstimmende Groß-/Kleinschreibung

​
Verknüpfen mit Teammitgliedern

Beim Verknüpfen mit Teammitgliedern (Ihrem Team):
  • Verwenden Sie ihre E-Mail-Adresse, nicht ihren Namen
  • Beispiel: owner@yourcompany.com, nicht “John Smith”
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com

​
FAQ

Sie haben zwei Optionen:
  1. Verwenden Sie die Twenty-id (exportieren Sie übergeordnete Datensätze, um ihre IDs zu erhalten)
  2. Erstellen Sie ein benutzerdefiniertes eindeutiges Feld in Ihrem Datenmodell, um eine externe ID aus Ihrem vorherigen System zu speichern
Ja! Geben Sie den eindeutigen Bezeichner des untergeordneten Datensatzes (z. B. email für Personen) und den neuen Beziehungswert an. Beim Import wird die Beziehung aktualisiert.
Viele-zu-Viele-Beziehungen werden beim Import noch nicht unterstützt. Dies ist für H1 2026 geplant.
Beziehungen, die auf mehrere Objekttypen zeigen, werden für Import/Export noch nicht unterstützt. Dies steht auf unserer Roadmap.
Der Import zeigt für diese Zeile einen Fehler an. Sie können entweder:
  • Importieren Sie zuerst den übergeordneten Datensatz und importieren Sie dann erneut
  • Korrigieren Sie den Referenzwert
  • Entfernen Sie die Zeile aus dem Import
Häufige Ursachen:
  • Falsches Format (verwenden Sie für Domains https://domain.com)
  • Abweichende Groß-/Kleinschreibung (prüfen Sie die exakte Schreibweise)
  • Übergeordneter Datensatz existiert nicht (zuerst übergeordnete Datensätze importieren)
  • Zuordnung mehrerer Bezeichner (verwenden Sie nur einen)
Denken Sie daran: soft gelöschte Datensätze zählen für die Eindeutigkeit.Wenn Sie “not found”-Fehler erhalten, der Datensatz aber zu existieren scheint, prüfen Sie im Befehlsmenü → Gelöschte Datensätze anzeigen. Der übergeordnete Datensatz wurde möglicherweise soft gelöscht.

​
Fehlerbehebung

Gibt es Probleme? Prüfen Sie: