Salt la conținutul principal

​
Prezentare generală

Importul nu funcționează? Acest ghid vă ajută să identificați și să remediați, pas cu pas, erorile comune de import.

​
Cum funcționează validarea

După încărcarea fișierului și cartografierea coloanelor, douăzeci validează datele:
  1. Se execută validarea — Douăzeci de verificări pentru fiecare rând pentru erori
  2. Erorile sunt evidențiate - în galben apar rânduri problematice
  3. Poți repara la locul tău - editează celulele direct în interfața de import
  4. Sau eliminați rândurile - săriți peste înregistrările problematice în întregime
Repară erorile în UI. Nu trebuie să te întorci la foaia de calcul. Editează celulele direct în timpul importului pentru a economisi timp.

​
Depanare pas cu pas

​
Pasul 1: Identifică tipul de eroare

Dă click pe un rând evidențiat pentru a vedea mesajul de eroare specific. Tipuri de erori comune:
Mesaj de eroareCe înseamnă
Valori duplicate evidențiate în galbenValoarea există deja în 20 sau apare de două ori în fișierul dvs.
{field} nu este un {type} (planează pe celula galbenă)Datele nu corespund formatului așteptat
Câmp obligatoriu evidențiatUn câmp obligatoriu este gol
Nu se poate conecta la {object}. Nu s-a găsit nicio înregistrare unică... (import fails)Nu exista inregistrare referita
`Prea multe înregistrări. Până la 10000 permise” (încărcare blocată)Fișierul are mai mult de 10.000 de înregistrări

​
Pasul 2: Repară eroarea

Urmați instrucțiunile specifice de mai jos pentru fiecare tip de eroare.

​
Eroare: Valoare Duplicată

​
Ce veți vedea

Rândurile cu valori duplicat sunt evidențiate în galben în interfața de import înainte de începerea importului.

​
Ce înseamnă

Un câmp unic (e-mail, domeniu) fie:
  • Există deja în douăzeci de ani
  • Apare de două ori în fișier

​
Cum să repari

Opțiunea 1: Editare valoare duplicat
  1. Faceți clic pe celula cu eroare
  2. Schimbă la o valoare unică
  3. Continuă cu import
Opțiunea 2: eliminarea rândului duplicat
  1. Faceți clic pe X de lângă rând
  2. Rândul va fi omis în timpul importului
Opțiunea 3: permiterea actualizării a douăzeci de înregistrări existente
  1. Asigurați-vă că fișierul dvs. include un identificator unic (email, domain, sau id)
  2. Hartă câmp unic de identificator
  3. Douăzeci de persoane vor actualiza înregistrarea existentă în loc să creeze un duplicat
Puteți actualiza și câmpurile unice.
  • Dacă păstrați id dar schimbați e-mail → e-mail-ul va fi actualizat
  • Dacă păstraţi e-mail dar schimbaţi id → id-ul va fi actualizat
Atâta timp cât un identificator unic se potrivește, douăzeci actualizează înregistrarea.

​
Cum să preveniți această eroare

Înainte de import:
  1. Sortează foaia de calcul după câmpul unic
  2. Elimină rândurile duplicate
  3. Verificați dacă înregistrările există deja în douăzeci
Numar de inregistrari soft-eliminate catre unic.Verificaţi Meniul de Comenzi → Vezi înregistrările şterse. (Automatic Translation) Înregistrările de acolo trebuie încă să fie unice. Ștergeți definitiv sau restabiliți și actualizați.
Pentru mai multe detalii: Constrângeri de unicitate

​
Eroare: Format invalid

​
Ce veți vedea

Valoarea celulei este evidențiată în galben. Apasă pentru a vedea mesajul de eroare: 
{field name} is not a valid {field type}

​
Ce înseamnă

Datele nu corespund formatului așteptat pentru tipul de câmp.

​
Cum să repari — după tipul câmpului

​
Email

Problemă: Format e-mail nevalid Soluție: Folosiți formatul name@domain.com 
❌ john.smith@
❌ john smith@acme.com
✓ john.smith@acme.com

​
Domeniu

Problemă: Formatul consecvent poate cauza duplicate Soluție: Folosiți formatul https://domain.com (recomandat) 
⚠️ acme.com         (valid, but not recommended)
⚠️ www.acme.com     (valid, but not recommended)
✅ https://acme.com  (recommended)
Toate formatele sunt valide, dar https://domain.com este recomandat pentru că se potrivește cu formatul folosit de sincronizarea e-mail/calendar. Utilizarea altor formate poate crea companii duplicate.

​
Dată

Problemă: Format de dată nerecunoscut Soluție: Folosește formatul YYYY-MM-DD în mod consecvent în întregul fișier 
✓ 2024-03-15        (YYYY-MM-DD)
❌ 03/15/2024        (MM/DD/YYYY)
❌ 15/03/2024        (DD/MM/YYYY)

​
Telefon

Problemă: Lipsește coloanele necesare Soluție: Include toate coloanele de telefon
ColoanaExemplu
Telefon / Număr de telefon principal4159095555
Codul de țară al telefonului principal / TelefonuluiUS
Cod telefon / apel telefonic+1

​
Boolean

Problemă: Valoare booleană greșită Soluție: Folosește majuscule TRUE sau FALSE 
❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE

​
Selectați / Multi-Selectare

Problemă: Valoarea nu corespunde cu opțiunile existente Soluție: Folosiți nume API, nu afișați etichetele Cum să găsești numele API:
  1. Mergeți la Setări → Modelul de date
  2. Selectați obiectul și câmpul
  3. Activează Mod avansat (comutare în dreapta jos)
  4. Utilizați numele API (de exemplu, OPTION_1, nu “Opțiunea 1”)
❌ High Priority
✓ HIGH_PRIORITY

​
Monedă

Problemă: Lipsește suma sau codul monedei Soluție: Umple ambele coloane
ColoanaExemplu
Sumă / Sumă1234.56
Sumă / MonedăUSD

​
Număr

Problemă: Caractere nenumărate Soluţie: Doar numere, perioadă pentru zecimale 
❌ $1,234.56
❌ 1,234.56
✓ 1234.56
Pentru trimiterea completă a formatului: câmp Mapping

​
Eroare: Câmpul obligatoriu lipsește

​
Ce veți vedea

Rândul este evidențiat cu galben cu celula de câmp dorită.

​
Ce înseamnă

Un câmp obligatoriu este gol pentru acest rând.

​
Cum să repari

Opțiunea 1: Introduceți o valoare
  1. Faceți clic pe celula goală
  2. Introduceți o valoare
  3. Continuă cu import
Opțiunea 2: eliminarea rândului
  1. Dacă nu ai date, apasă X pentru a sări peste rând

​
Cum să preveniți această eroare

Înainte de import, identificați câmpurile obligatorii:
  1. Mergeți la Setări → Modelul de date
  2. Selectează obiectul tău
  3. Verificați care câmpuri sunt marcate ca obligatorii

​
Eroare: Relația nu a fost găsită

​
Ce veți vedea

Această eroare apare după începerea importului - importul eșuează cu un mesaj precum: 
Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
Aceasta înseamnă că nu există nicio societate comercială în douăzeci de exemplare cu acest identificator specific.
Spre deosebire de alte erori, aceasta nu este prinsă în timpul pasului de revizuire a datelor. Importul va începe şi apoi va eşua atunci când se întâlneşte cu relaţia lipsă.

​
Ce înseamnă

Încercați să vă conectați la o înregistrare care nu există în douăzeci de ani.

​
Cum să repari

Opțiunea 1: Importați mai întâi înregistrările părinte
  1. Anulează importul curent
  2. Importă înregistrările părinte (de exemplu, societăți)
  3. Apoi se importă înregistrările cu copii (de exemplu, oameni)
**Opțiunea 2: Repararea valorii de referință
  1. Verifică valoarea de referință din fișierul tău
  2. Asigurați-vă că se potrivește exact cu o înregistrare existentă
  3. Verificați formatul: domeniile ar trebui să fie https://domain.com
Opțiunea 3: Eliminarea relației
  1. Curăță celula de importat fără legătură
  2. Adaugă relația manual mai târziu

​
Cum să preveniți această eroare

  1. Importă în ordinea corectă:
    • Societăți primele
    • Persoane a doua (cu referința companiei)
    • Oportunități a treia
  2. Verificați valorile de referință:
    • Exporta inregistrarile parinte pentru a obtine identificatori exacti
    • Folosiți formatul de domeniu https://domain.com
    • Verificați dacă există caractere și senzitivitatea carcaselor
Importul va eşua dacă se face referire la o înregistrare inexistentă.Întotdeauna importă obiecte părinte înainte de obiecte copil.
Pentru mai multe detalii: Importă Relații

​
Eroare: Fișier prea mare

​
Ce veți vedea

Această eroare apare la încărcarea fișierului — încărcarea este blocată în întregime: 
Too many records. Up to 10000 allowed
Nu veți putea trece la pasul de revizuire a datelor până când nu reduceți dimensiunea fișierului.

​
Ce înseamnă

Fişierul are mai mult de 10.000 de înregistrări.

​
Cum să repari

Opțiunea 1: Împărțirea în mai multe fișiere
  1. Împărțiți datele în fișiere cu 10.000 de înregistrări sau mai puține
  2. Importă fiecare fișier separat
  3. Menține comanda de import (Companiile înainte de oameni)
Opțiunea 2: Utilizați API import pentru seturi de date foarte mari, utilizați API-ul care nu are o limită de înregistrare. Vedeți: Cum să importați date prin API

​
Eroare: Câmpul nu este recunoscut

​
Ce înseamnă

O coloană din fișierul dvs. nu poate fi cartografiată deoarece câmpul nu există în Twenty.

​
Cum să repari

  1. Mergeți la Setări → Modelul de date
  2. Selectați obiectul pe care îl importați
  3. Click **+ Adauga cîmp **
  4. Creați câmpul personalizat cu tipul corespunzător
  5. Reîncărcați fișierul
Importul CSV creează înregistrări, nu câmpuri. Toate câmpurile trebuie să existe înainte de import.

​
Eroare: Relația utilizatorului este goală

​
Ce înseamnă

Încercați să atribuiți o înregistrare unui utilizator (Owner, Assignee), dar relația nu este cartografiată.

​
Frecvente Cauze

  1. Utilizatorul nu și-a acceptat invitația — utilizatorul nu există încă în douăzeci de ani
  2. Folosind ID-ul utilizatorului din vechi — Douăzeci de utilizatori nu se pot potrivi ID-urile din alt sistem
  3. Format de e-mail greșit - e-mailul nu se potrivește cu contul de 20 de utilizatori

​
Cum să repari

  1. Asigurați-vă că toți utilizatorii și-au acceptat invitația în spațiul de lucru de douăzeci
  2. Folosiți adresa de e-mail a utilizatorului (nu numele sau vechea ID-ul de sistem)
  3. Folosiți același e-mail pe care l-au folosit pentru a se alătura celor douăzeci
Utilizatorii trebuie să accepte invitațiile înainte de import.Dacă un utilizator nu a acceptat invitația, înregistrările cu privire la ei vor avea relații de utilizator goale.

​
Lista de verificare pre-import

Evită erorile verificându-le înainte de import:

​
Fişier Cerinţe

Fișierul este CSV, XLSX sau formatul XLS
Fișierul are mai puțin de 10.000 înregistrări
Fișierul folosește codificarea UTF-8

​
Calitatea datelor

Nu există e-mailuri duplicate (pentru oameni)
Nu există domenii duplicate (pentru companii)
Toate datele folosesc formatul consistent
Toate domeniile folosesc `https://domain. formatul

​
Formate câmp

Câmpurile Boolean folosesc TRUE sau FALSE (majuscule)
Selectează câmpurile folosesc numele API, nu afișează etichetele
Câmpurile de telefon au toate coloanele obligatorii
Câmpurile valutare au atât Suma cât și Codul Valutar

​
Relații

Înregistrările părinte importate înainte de înregistrările copil
Coloane de referință înregistrările existente
Formatul domeniului corespunde formatului Twenty exact

​
Model de date

Toate câmpurile personalizate există în Setări → Modelul de date
Există opțiuni înainte de a importa

​
Încă aveți probleme?

Dacă aţi încercat soluţiile de mai sus:
  1. Descarcă eșantionul de fișier - vezi formatul exact pe care douăzeci îl așteaptă
  2. Exportă înregistrările existente - compară fișierul cu datele de lucru
  3. Testează cu un lot mic - încearcă mai întâi 5-10 rânduri
  4. Verificați articolele de referință: