Salt la conținutul principal

​
Prezentare generală

Acest ghid vă arată cum să importați relațiile dintre obiecte — de exemplu, să asociați Persoane la Companii sau Oportunități la Persoane.
Ce poate fi importat: Doar relații de tip unu-la-mulți care indică către un singur tip de obiect. Relațiile care indică către mai multe tipuri de obiect (cum ar fi Notele care se leagă de Persoane ȘI Companii) nu sunt încă acceptate pentru import.

​
Înțelegerea relațiilor

​
Ce este o relație “unu-la-mulți”?

Într-o relație unu-la-mulți:
  • O companie are multe persoane (angajați)
  • O companie are multe oportunități
  • O persoană are multe sarcini
Partea “unu” este părintele. Partea “mulți” este copilul.

​
Relații obișnuite în Twenty

​
Pasul 1: Identificați părțile „unu” și „mulți”

Înainte de import, stabiliți care obiect este părinte și care este copil. Întrebați-vă: “Are UN [Obiect A] MULTE [Obiect B]?”
  • O companie → Multe persoane ✓ (Compania este părinte)
  • O persoană → Multe companii ✗ (Greșit — o persoană aparține unei singure companii)

​
Pasul 2: Importați mai întâi înregistrările părinte

Înregistrarea părinte (partea „unu”) trebuie să existe în Twenty înainte de a o putea referi. Ordinea importului:
  1. Companii mai întâi (fără dependențe)
  2. Persoane în al doilea rând (legate de Companii)
  3. Oportunități în al treilea rând (legate de Companii și/sau Persoane)
  4. Sarcini/Note (legate de oricare dintre cele de mai sus)
Dacă înregistrarea părinte nu există, importul va eșua.Verificați întotdeauna că companiile au fost importate înainte de a importa persoane cu referințe la companie.

​
Pasul 3: Notați identificatorul unic al părintelui

Trebuie să faceți referire la înregistrarea părinte folosind un identificator unic. Opțiuni disponibile:
Recomandat: Folosiți domain pentru Companii și email pentru Persoane. Acestea sunt ușor de citit de către oameni și ușor de verificat în foaia de calcul.

​
Găsirea identificatorului

Dacă aveți nevoie de id:
  1. Exportați înregistrările părinte din Twenty
  2. Exportul include coloana id
  3. Folosiți aceste ID-uri în fișierul cu înregistrări copil

​
Pasul 4: Verificați existența câmpului de relație

Înainte de import, asigurați-vă că există câmpul de relație între obiectele dvs. Pentru a verifica sau crea:
  1. Accesați Setări → Model de date
  2. Selectați obiectul copil (de ex., Persoane)
  3. Căutați un câmp de relație care indică către părinte (de ex., Companie)
  4. Dacă nu există, creați-l:
    • Faceți clic pe + Adaugă câmp
    • Selectați tipul Relație
    • Alegeți obiectul părinte

​
Pasul 5: Pregătiți fișierul CSV

Adăugați o coloană în CSV-ul obiectului copil care face referire la părinte folosind identificatorul său unic.

​
Exemplu: Persoane asociate cu Companii

CSV-ul dvs. cu Persoane:
Coloana companyDomain face referire la domeniul companiei.

​
Cerințe de format

Formatul domeniului contează!Folosiți https://domain.com (nu doar domain.com). Acest lucru corespunde modului în care Twenty stochează domeniile companiilor și previne erorile de potrivire.

​
Reguli importante

  1. Potrivire exactă necesară — valoarea trebuie să corespundă exact înregistrării părinte
  2. Mapați doar UN identificator unic — nu includeți atât companyId, cât și companyDomain
  3. Sensibil la majuscule/minuscule — Acme.com ≠ acme.com

​
Pasul 6: Încărcați și mapați relația

  1. Navigați la obiectul copil (de ex., Persoane)
  2. Faceți clic pe ⋮ → Import records
  3. Încărcați fișierul CSV
  4. În etapa de mapare a câmpurilor:
    • Găsiți coloana relației (de ex., companyDomain)
    • Mapați-o la câmpul de relație Company
  5. Finalizați maparea rămasă
  6. Revizuiți erorile și confirmați
Twenty va lega automat fiecare înregistrare copil de părintele corespunzător.

​
Pasul 7: Verificați importul

După import:
  1. Deschideți câteva înregistrări copil (de ex., Persoane)
  2. Verificați că câmpul de relație arată părintele corect (de ex., Companie)
  3. Deschideți o înregistrare părinte și verificați secțiunea de înregistrări asociate

​
Greșeli comune de evitat

​
Legarea la membrii spațiului de lucru

Când legați la membrii spațiului de lucru (echipa dvs.):
  • Folosiți adresa de email, nu numele
  • Exemplu: owner@yourcompany.com, nu “John Smith”

​
Întrebări frecvente

Aveți două opțiuni:
  1. Folosiți id-ul Twenty (exportați înregistrările părinte pentru a obține ID-urile lor)
  2. Creați un câmp unic personalizat în modelul dvs. de date pentru a stoca un ID extern din sistemul anterior
Da! Includeți identificatorul unic al înregistrării copil (de ex., email pentru Persoane) și noua valoare a relației. Importul va actualiza relația.
Relațiile mulți-la-mulți nu sunt încă acceptate pentru import. Aceasta este planificată pentru S1 2026.
Relațiile care indică către mai multe tipuri de obiecte nu sunt încă acceptate pentru import/export. Această funcționalitate este în planul nostru de dezvoltare.
Importul va afișa o eroare pentru acel rând. Puteți fie să:
  • Importați mai întâi înregistrarea părinte, apoi reimportați
  • Corectați valoarea de referință
  • Eliminați rândul din import
Cauze comune:
  • Format greșit (folosiți https://domain.com pentru domenii)
  • Nepotrivire de majuscule/minuscule (verificați ortografia exactă)
  • Părintele nu există (importați mai întâi părinții)
  • Maparea mai multor identificatori (folosiți doar unul)
Rețineți: Înregistrările șterse logic se iau în calcul pentru unicitate.Dacă primiți erori „not found”, dar înregistrarea pare să existe, verificați Command Menu → See deleted records. Este posibil ca părintele să fi fost șters logic.

​
Depanare

Aveți probleme? Verificați: