Salt la conținutul principal

​
Cum funcționează maparea câmpurilor

Când încărcați un fișier, Twenty analizează coloanele și încearcă să le potrivească cu câmpurile existente.

​
Mapare automată

Twenty încearcă să potrivească coloanele pe baza:
  • Numele antetelor de coloană (potriviri exacte sau similare)
  • Detecția tipului de date (date, numere, e-mailuri)
  • Tipare comune de câmp
Sfat rapid: Exportați câteva rânduri din obiectul pe care doriți să-l importați. Fișierul exportat va avea exact numele de coloane pe care Twenty le așteaptă, ceea ce face ca maparea automată să fie fără probleme în timpul importului.

​
Opțiuni de mapare manuală

Pentru fiecare coloană, puteți:
  • Mapați la un câmp: Selectați câmpul Twenty corespunzător dintr-un meniu derulant
  • Nu mapați: Omiteți complet coloana (datele nu vor fi importate)
Câmpurile trebuie să existe înainte de import. Importul creează înregistrări, nu câmpuri. Creați câmpuri personalizate în Setări → Model de date înainte de import.

​
Compatibilitatea tipurilor de câmp

Toate tipurile de câmp disponibile în Modelul de date sunt acceptate pentru import. Puteți importa și valori id pentru a atribui un ID specific înregistrărilor noi sau pentru a le actualiza pe cele existente.

​
Cerințe privind formatul datelor

Unele câmpuri au o sintaxă specială. Vă recomandăm să descărcați fișierul exemplu înainte de pregătirea importului, pentru a vedea sintaxa așteptată pentru fiecare tip de câmp.

​
Câmpuri de adresă

Adresa este un câmp îmbricat cu mai multe coloane. Unele pot fi lăsate necompletate.
  • Adresă / Adresă 1: Linia 1 a adresei stradale
  • Adresă / Adresă 2: Linia 2 a adresei stradale
  • Adresă / Oraș: Numele orașului
  • Adresă / Stat: Stat sau provincie
  • Adresă / Țară: Numele țării
  • Adresă / Cod poștal: Cod poștal/ZIP

​
Câmpuri de tip array

Folosiți următorul format: 
["value1","value2"]

​
Câmpuri booleene

Folosiți TRUE sau FALSE (cu majuscule) - nu true sau false

​
Câmpuri de monedă

Moneda este un câmp îmbricat cu două coloane care trebuie ambele completate:
  • Sumă / Sumă: Valoarea numerică (de ex., 1234.56)
  • Sumă / Monedă: Codul monedei (de ex., USD, EUR)

​
Câmpuri de dată

Formate acceptate:
  • YYYY-MM-DD (recomandat)
  • MM/DD/YYYY
  • DD/MM/YYYY
  • Format ISO 8601

​
Câmpuri de domeniu

  • Este recomandat să folosiți formatul https://domain.com pentru a evita crearea de duplicate, deoarece acesta este formatul folosit pentru Companiile create de sincronizările cu căsuța poștală și calendarul
  • Se pot completa un Domain Label și un Domain URL: cea mai bună practică este să completați domain.com în etichetă și https://domain.com în URL
  • Domeniile trebuie să fie unice în obiectul Companii
  • Domeniile trebuie să fie unice în fișierul de importat

​
Câmpuri de e-mail

  • Trebuie să fie în format de e-mail valid
  • E-mailurile trebuie să fie unice în obiectul Persoane
  • E-mailurile trebuie să fie unice în fișierul de importat
  • Pentru e-mailuri suplimentare: folosiți E-mailuri / E-mail principal pentru e-mailul principal și E-mailuri / E-mailuri suplimentare cu acest format:
["[email protected]","[email protected]"]

​
Câmpuri ID

Specificarea unui id în timpul importului este opțională. Twenty generează automat unul dacă nu este furnizat. Cazuri de utilizare pentru maparea unei coloane id:
  • Setați un ID specific: Alegeți UUID-ul pentru înregistrările nou create
  • Actualizați înregistrările existente: Potriviți cu înregistrările existente pentru a le actualiza în loc să creați duplicate. În acest caz, se recomandă să nu mapați celelalte câmpuri unice: maparea unui singur câmp unic asigură un import mai lin.
Dacă furnizați un id, acesta trebuie să fie în format UUID (de ex., c776ee49-f608-4a77-8cc8-6fe96ae1e43f).

​
Câmpuri JSON

Folosiți un format JSON valid: 
{"key":"value","key2":"value2"}

​
Câmpuri pentru linkuri

Similar cu câmpurile de domeniu:
  • Completați ambele coloane, eticheta și URL-ul: Linkuri / URL link și Linkuri / Etichetă link
  • Folosiți formatul URL complet: https://example.com
  • Pentru linkurile secundare, folosiți coloana Linkuri / Linkuri secundare cu acest format:
[{"url":"https://twenty.com","label":"Twenty"}]

​
Câmpuri cu selecție multiplă

Folosiți numele API (nu etichetele de afișare) în următorul format: 
["VALUE1","VALUE2"]
Consultați aici unde puteți găsi numele API.
Opțiunile noi de selectare nu vor fi create automat de import. Acestea trebuie adăugate în Setări → Model de date înainte de import.
Importul suprascrie, nu adaugă.Dacă o înregistrare are deja selectate VALUE2 și VALUE3, iar importați ["VALUE1"], înregistrarea va avea doar VALUE1 după import. Selecțiile anterioare sunt înlocuite, nu îmbinate.

​
Câmpuri numerice

  • Doar numere
  • Zecimalele folosesc punctul: 1234.56
  • Fără separatori pentru mii

​
Câmpuri de telefon

Telefonul este un câmp îmbricat cu mai multe coloane care trebuie completate
  • Telefoane / Număr de telefon principal: Numărul de telefon (de ex., 4159095555)
  • Telefoane / Codul de țară al telefonului principal: Codul de țară (de ex., US)
  • Telefoane / Prefixul de apelare al telefonului principal: Prefixul de apelare (de ex., +1)

​
Câmpuri de rating

Folosiți formatul numelui API: RATING_1, RATING_2, RATING_3, RATING_4, RATING_5

​
Câmpuri de relație

Consultați articolul nostru dedicat: Importul relațiilor dintre obiecte

​
Câmpuri de selectare

Folosiți numele API al opțiunii (nu eticheta de afișare): 
VALUE1
Consultați aici unde puteți găsi numele API.
Opțiunile noi de selectare nu vor fi create automat în urma importului. Acestea trebuie adăugate în Setări → Model de date înainte de import.

​
Câmpuri text

  • Nu este necesară nicio formatare specială
  • Spațiile de la început și de la sfârșit sunt eliminate

​
Găsirea numelor API

Pentru câmpurile Select, Multi-Select și Array cu opțiuni predefinite, trebuie să utilizați numele API, nu etichetele de afișare.

​
Cum găsiți numele API

  1. Accesați Setări → Model de date
  2. Selectați obiectul și câmpul
  3. Activați Modul avansat (comutator în dreapta jos a paginii de setări)
  4. Vizualizați numele API pentru fiecare opțiune