Připravte své soubory CSV

Přehled

Tento průvodce vás provede přípravou vašeho souboru CSV pro úspěšný import. Postupujte podle těchto kroků, abyste předešli chybám.

Krok 1: Zkontrolujte požadavky na soubor

Než začnete, ujistěte se, že váš soubor splňuje tyto požadavky:

Požadavek	Podrobnosti
Formát	CSV, XLSX nebo XLS
Limit velikosti	10 000 záznamů na soubor
Kódování	Doporučeno: UTF-8
Struktura	Jeden typ objektu na soubor

U datasetů větších než 10 000 záznamů je rozdělte do více souborů nebo použijte import přes API.

Krok 2: Stáhněte si ukázkový soubor

Toto je nejdůležitější krok. Ukázkový soubor ukazuje přesné názvy sloupců a formát, který Twenty očekává.

Přejděte do zobrazení objektu (Osoby, Společnosti atd.)
Klikněte na ⋮ → Importovat záznamy
Klikněte na Stáhnout ukázkový soubor
Tento soubor použijte jako svou šablonu

Profesionální tip: Místo toho exportujte několik existujících záznamů. Tím získáte reálné příklady, jak mají být data naformátována, a názvy sloupců se během importu namapují automaticky.

Krok 3: Odstraňte duplicitní hodnoty

Twenty vynucuje jedinečnost u některých polí. Duplicity způsobí chyby při importu.

Objekt	Jedinečná pole
Osoby	`id`, `email`
Společnosti	`id`, `domain`
Vlastní objekty	`id`, plus jakékoli pole, které jste označili jako jedinečné

Před importem:

Seřaďte tabulku podle jedinečného pole (e‑mailu nebo domény)
Odstraňte nebo sloučte duplicitní řádky
Zkontrolujte duplicity, které už v Twenty existují

Dočasně smazané záznamy se započítávají do jedinečnosti. Záznamy v Command Menu → See deleted records způsobí chyby kvůli duplicitám. Trvale je smažte, nebo je obnovte a aktualizujte.

Krok 4: Správně naformátujte každý typ pole

Různé typy polí vyžadují specifické formáty. Zde je úplný přehled:

Textová pole

Není vyžadováno žádné speciální formátování
Počáteční a koncové mezery jsou automaticky oříznuty

E‑mailová pole

Musí být ve validním formátu e‑mailu: [email protected]
Musí být jedinečné (žádné duplicity v souboru ani v Twenty)
Pro další e‑maily použijte tento formát ve sloupci E‑maily / Další e‑maily:

[\"[email protected]\",\"[email protected]\"]

Doménová pole

Doporučený formát: https://domain.com
Odpovídá formátu používanému synchronizací schránky/kalendáře (předchází duplicitám)
Vyplňte oba sloupce:
- Doména / Štítek domény: domain.com
- Doména / URL domény: https://domain.com
Musí být jedinečné v rámci vašeho souboru i v Twenty

Telefonní pole

Telefon je vnořené pole, které vyžaduje více sloupců:

Sloupec	Příklad
Telefony / Hlavní telefonní číslo	`4159095555`
Telefony / Kód země hlavního telefonu	`US`
Telefony / Mezinárodní předvolba hlavního telefonu	`+1`

Adresní pole

Adresa je vnořené pole s více sloupci (některé mohou zůstat prázdné):

Adresa / Adresa 1: Řádek adresy 1
Adresa / Adresa 2: Řádek adresy 2 (volitelné)
Adresa / Město: Název města
Adresa / Stát: Stát nebo provincie
Adresa / Země: Název země
Adresa / PSČ: Poštovní/ZIP kód

Datumová pole

Používejte jednotný formát v celém souboru:

YYYY-MM-DD (doporučeno): 2024-03-15
MM/DD/YYYY: 03/15/2024
DD/MM/YYYY: 15/03/2024
ISO 8601: 2024-03-15T10:30:00Z

Číselná pole

Pouze čísla (bez textu)
Pro desetinná místa použijte tečku: 1234.56
Bez oddělovačů tisíců (ne 1,234.56)

Měnová pole

Měna je vnořené pole vyžadující dva sloupce, které musí být oba vyplněny:

Sloupec	Příklad
Částka / Částka	`1234.56`
Částka / Měna	`USD`

Booleovská pole

Používejte velká písmena: TRUE nebo FALSE

Malá písmena true nebo false nebudou fungovat.

Výběrová Pole

Použijte název API možnosti, nikoli zobrazovaný štítek. Jak najít názvy API:

Přejděte na Nastavení → Datový model
Vyberte objekt a pole
Zapněte Pokročilý režim (přepínač vpravo dole)
Zkopírujte název API (např. OPTION_1, nikoli “Option 1”)

Nové možnosti výběru se nevytvářejí automaticky. Přidejte je v Nastavení → Datový model před importem.

Pole s vícenásobným výběrem

Použijte názvy API ve formátu pole:

["VALUE1","VALUE2"]

Pole typu array

Použijte formát JSON pole:

["value1","value2"]

Hodnoticí pole

Použijte formát: RATING_1, RATING_2, RATING_3, RATING_4 nebo RATING_5

Pole odkazů/URL

Vyplňte oba sloupce:

Odkazy / Štítek odkazu: Twenty
Odkazy / URL odkazu: https://twenty.com

Pro sekundární odkazy použijte sloupec Odkazy / Sekundární odkazy:

[{"url":"https://twenty.com","label":"Twenty"}]

JSON pole

Použijte platný formát JSON:

{"key":"value","key2":"value2"}

ID pole

Volitelné: Twenty automaticky generuje ID, pokud nejsou zadána
Formát: UUID (např. c776ee49-f608-4a77-8cc8-6fe96ae1e43f)
Využití: Zahrňte ID pro aktualizaci existujících záznamů místo vytváření nových

Krok 5: Přidejte relační sloupce (pokud propojujete záznamy)

Chcete-li propojit záznamy s jinými objekty (např. lidi se společnostmi), přidejte sloupec s jedinečným identifikátorem souvisejícího záznamu. Příklad: Propojení lidí se společnostmi Přidejte do svého souboru CSV s lidmi sloupec:

firstName,lastName,email,companyDomain
John,Smith,[email protected],https://acme.com
Jane,Doe,[email protected],https://widgets.co

Důležitá pravidla pro relace:

Nadřazený záznam musí v Twenty již existovat
Použijte formát Domain URL (https://domain.com), nikoli štítek
Mapujte pouze JEDEN jedinečný identifikátor (nezahrnujte zároveň companyId i companyDomain)
U členů pracovního prostoru použijte jejich e-mail (ne jméno)

Pořadí importu je důležité!Importujte stranu “one” před stranou “many”:

Společnosti jako první
Lidé jako druzí (s odkazem na společnost)
Příležitosti jako třetí

Nadřazený záznam musí existovat dříve, než na něj můžete odkazovat.

Podrobné pokyny najdete v Jak importovat relace.

Krok 6: Ujistěte se, že pole v Twenty existují

Import vytváří záznamy, nikoli pole. Všechna pole, která chcete importovat, musí již existovat ve vašem datovém modelu. Před importem:

Přejděte na Nastavení → Datový model
Vyberte požadovaný objekt
Vytvořte všechna vlastní pole, která potřebujete
Poznamenejte si přesné názvy polí (musí odpovídat názvům sloupců)

Krok 7: Závěrečný kontrolní seznam

Před nahráním souboru ověřte:

Soubor je ve formátu CSV, XLSX nebo XLS

Soubor obsahuje méně než 10 000 záznamů

Kódování je UTF-8

Žádné duplicitní e-maily (pro lidi) nebo domény (pro společnosti)

Data používají jednotný formát v celém souboru

Domény používají formát https://domain.com

Booleovská pole používají TRUE nebo FALSE (velká písmena)

Výběrová pole používají názvy API, nikoli zobrazované štítky

Všechna vlastní pole existují v Nastavení → Datový model

Nadřazené záznamy byly importovány před podřízenými

Relační sloupce odkazují na existující záznamy

Časté chyby, kterým se vyhnout

Chyba	Řešení
Použití `true` místo `TRUE`	Booleovské hodnoty musí být velkými písmeny
Použití zobrazovaných štítků u výběrových polí	V Nastavení najděte a používejte názvy API
Importování lidí před společnostmi	Vždy nejprve importujte nadřazené objekty
Chybějící kód měny u měnových polí	Vyplňte sloupce Částka i Měna
Nesprávný formát domény	Používejte konzistentně `https://domain.com`
Mapování více jedinečných polí pro relace	Mapujte pouze JEDNO (doména NEBO id, ne obojí)

Další kroky

Váš soubor je připraven! Nyní:

Importovat společnosti (importujte je jako první)
Importovat kontakty
Opravit chyby importu

Discover Twenty

Datový model

Data Migration

Calendar & Emails

Pracovní postupy

AI

Views & Pipelines

Panely

Permissions & Access

Fakturace

Nastavení

Přehled

Krok 1: Zkontrolujte požadavky na soubor

Krok 2: Stáhněte si ukázkový soubor

Krok 3: Odstraňte duplicitní hodnoty

Krok 4: Správně naformátujte každý typ pole

Textová pole

E‑mailová pole

Doménová pole

Telefonní pole

Adresní pole

Datumová pole

Číselná pole

Měnová pole

Booleovská pole

Výběrová Pole

Pole s vícenásobným výběrem

Pole typu array

Hodnoticí pole

Pole odkazů/URL

JSON pole

ID pole

Krok 5: Přidejte relační sloupce (pokud propojujete záznamy)

Krok 6: Ujistěte se, že pole v Twenty existují

Krok 7: Závěrečný kontrolní seznam

Časté chyby, kterým se vyhnout

Další kroky

Discover Twenty

Datový model

Data Migration

Calendar & Emails

Pracovní postupy

AI

Views & Pipelines

Panely

Permissions & Access

Fakturace

Nastavení

​Přehled

​Krok 1: Zkontrolujte požadavky na soubor

​Krok 2: Stáhněte si ukázkový soubor

​Krok 3: Odstraňte duplicitní hodnoty

​Krok 4: Správně naformátujte každý typ pole

​Textová pole

​E‑mailová pole

​Doménová pole

​Telefonní pole

​Adresní pole

​Datumová pole

​Číselná pole

​Měnová pole

​Booleovská pole

​Výběrová Pole

​Pole s vícenásobným výběrem

​Pole typu array

​Hodnoticí pole

​Pole odkazů/URL

​JSON pole

​ID pole

​Krok 5: Přidejte relační sloupce (pokud propojujete záznamy)

​Krok 6: Ujistěte se, že pole v Twenty existují

​Krok 7: Závěrečný kontrolní seznam

​Časté chyby, kterým se vyhnout

​Další kroky

Přehled

Krok 1: Zkontrolujte požadavky na soubor

Krok 2: Stáhněte si ukázkový soubor

Krok 3: Odstraňte duplicitní hodnoty

Krok 4: Správně naformátujte každý typ pole

Textová pole

E‑mailová pole

Doménová pole

Telefonní pole

Adresní pole

Datumová pole

Číselná pole

Měnová pole

Booleovská pole

Výběrová Pole

Pole s vícenásobným výběrem

Pole typu array

Hodnoticí pole

Pole odkazů/URL

JSON pole

ID pole

Krok 5: Přidejte relační sloupce (pokud propojujete záznamy)

Krok 6: Ujistěte se, že pole v Twenty existují

Krok 7: Závěrečný kontrolní seznam

Časté chyby, kterým se vyhnout

Další kroky