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

RelațiePartea “unu” (părinte)Partea “mulți” (copil)
Companii → PersoaneCompaniePersoane
Companii → OportunitățiCompanieOportunități
Persoane → SarciniPersoanăSarcini
Persoane → NotePersoanăNotițe

​
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:
Obiect părinteIdentificatori unici disponibili
Companiiid (UUID), domain (recomandat) sau orice câmp unic personalizat
Persoaneid (UUID), email sau orice câmp unic personalizat
Membri ai Spațiului de Lucruid (UUID), email (nu numele)
Obiecte personalizateid (UUID) sau orice câmp marcat ca unic
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: 
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
Coloana companyDomain face referire la domeniul companiei.

​
Cerințe de format

IdentificatorFormatExemplu
DomeniuFormat URLhttps://acme.com
EmailEmail standardjohn@acme.com
IDUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
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

GreșealăProblemăSoluție
Ordine greșită a importuluiImportarea Persoanelor înaintea CompaniilorImportați întotdeauna mai întâi părinții, apoi copiii
Format de domeniu greșitFolosirea acme.com în loc de https://acme.comFolosiți formatul URL complet cu https://
Câmpuri unice multipleMaparea atât a companyId, cât și a companyDomainMapați un singur identificator unic
Câmp de relație lipsăCâmpul de relație nu există în modelul de dateCreați-l în Setări → Model de date înainte de import
Înregistrări inexistenteÎnregistrarea părinte nu există în TwentyImportați mai întâi înregistrările părinte sau verificați greșelile de tastare
Nepotrivire de majuscule/minusculeAcme.com în fișier, dar acme.com în TwentyAsigurați potrivirea exactă a majusculelor/minusculelor

​
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”
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com

​
Î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: