Přejít na hlavní obsah

Documentation Index

Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt

Use this file to discover all available pages before exploring further.

​
Přehled

Twenty podporuje import relací mezi objekty během importu CSV. To vám umožní propojit záznamy (např. přiřadit Lidi ke Společnostem) jako součást migrace dat.
V současnosti podporováno pro import: Relace jedna ku mnoha směřující na jeden typ objektu na každé straně (např. Lidé → Společnosti). Relace směřující k více typům objektů zatím nejsou pro import/export podporovány.

​
Jak relace fungují v Twenty

​
Jedna ku mnoha / Mnoho ku jedné

Twenty podporuje standardní relace, kde se jeden záznam propojuje s mnoha dalšími:
  • Jedna Společnost → Mnoho Lidí: Společnost může mít více zaměstnanců, ale každá osoba patří do jedné společnosti
  • Jedna Společnost → Mnoho Příležitostí: Společnost může mít více obchodů, ale každá příležitost patří k jedné společnosti

​
Relace, které mohou směřovat k více typům objektů

Některé relace mohou propojit různé typy objektů. To funguje dvěma způsoby: Vzor 1: Mnoho záznamů se odkazuje vždy na jeden záznam u různých typů objektů Několik Poznámek, Úkolů nebo Aktivit může být současně připojeno k více typům objektů:
  • Poznámky mohou být současně propojeny s jednou Osobou, jednou Společností a jednou Příležitostí
  • Úkoly mohou být současně propojeny s jednou Osobou, jednou Společností a jednou Příležitostí
Zde jsou Poznámky/Úkoly na straně „mnoho“. Každý z nich se váže na jeden záznam pro každý typ objektu. Vzor 2: Jeden záznam přijímá odkazy od mnoha záznamů různých typů objektů Projekt může přijímat odkazy od více záznamů napříč různými typy objektů:
  • Projekt může mít k sobě připojeno mnoho Lidí, mnoho Společností a mnoho Poznámek
Zde je Projekt na straně „jedna“. Více záznamů z různých objektů se může odkazovat na tentýž Projekt.
Omezení importu/exportu: Relace, které směřují k více typům objektů (např. Poznámky → Lidé/Společnosti/Příležitosti), zatím nejsou podporovány při importu nebo exportu CSV.
  • Import: Lze importovat pouze relace jedna ku mnoha směřující na jeden typ objektu na každé straně
  • Export: Sloupce pro relace směřující k více typům objektů jsou aktuálně ponechány prázdné
Je to v našem plánu.

​
Co dnes není podporováno

Relace mnoho ku mnoha zatím nejsou k dispozici. Například aktuálně nemůžete vytvořit relaci, kde:
  • Mnoho Lidí je propojeno s mnoha Projekty
Relace mnoho ku mnoha jsou plánovány na 1. pololetí 2026.

​
Propojování záznamů během importu

Připomenutí: Importovat lze pouze relace jedna ku mnoha směřující na jeden typ objektu (např. Lidé → Společnosti). Relace směřující k více typům objektů (např. Poznámky → Lidé/Společnosti/Příležitosti) zatím nejsou podporovány.

​
Krok 1: Určete strany „jedna“ a „mnoho“

Nejprve určete, který objekt je na straně „jedna“ a který je na straně „mnoho“ dané relace. Příklad:
  • Společnost je strana „jedna“ (jedna společnost má mnoho zaměstnanců)
  • Lidé jsou strana „mnoho“ (každá osoba patří do jedné společnosti)

​
Krok 2: Ujistěte se, že záznamy na straně „jedna“ existují

Před importem strany „mnoho“ musí záznamy na straně „jedna“ již v Twenty existovat.
  • Nejprve importujte nebo vytvořte záznamy strany „jedna“ (např. Společnosti)
  • Ověřte jejich jedinečný identifikátor. Může to být:
    • Pole id (UUID v Twenty)
    • Pole nastavené jako jedinečné (např. domain u Společností nebo externí ID z vašeho předchozího systému)
Import selže, pokud je odkazováno na záznam, který neexistuje.

​
Krok 3: Připravte svůj soubor CSV

Přidejte do souboru CSV pro stranu „mnoho“ sloupec, který odkazuje na záznam strany „jedna“. Příklad: Pro soubor CSV Lidé propojený se Společnostmi: 
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
Důležité:
  • Hodnota se musí přesně shodovat s jedinečným polem v záznamu Společnosti
  • U domén používejte URL domény (např. https://acme.com), nikoli označení domény
  • Mapujte pouze jeden jedinečný identifikátor na relaci: povede to k hladšímu importu

​
Krok 4: Ujistěte se, že relační pole existuje

Před nahráním souboru se ujistěte, že mezi vašimi objekty existuje relační pole. Pokud neexistuje:
  1. Přejděte do Nastavení → Datový model
  2. Vyberte svůj objekt (např. Lidé)
  3. Vytvořte relační pole směřující na cílový objekt (např. Společnost)

​
Krok 5: Nahrajte a namapujte relaci

  1. Nahrajte svůj soubor CSV prostřednictvím rozhraní pro import
  2. V kroku mapování polí najděte svůj relační sloupec (např. companyDomain)
  3. Namapujte jej na relační pole (např. Společnost)
  4. Twenty automaticky propojí každý záznam s odpovídajícím nadřazeným objektem

​
Dostupná jedinečná pole pro relace

ObjektDostupná jedinečná pole
Společnostiid, domain, jakékoli vlastní jedinečné pole
Lidéid, email, jakékoli vlastní jedinečné pole
Členové pracovního prostoruid, email (ne jméno)
Další standardní a vlastní objektyid, jakékoli pole označené jako jedinečné
Propojení na členy pracovního prostoru: Pokud relace směřuje na členy pracovního prostoru (váš tým přihlašující se do Twenty), odkazujte je pomocí jejich e-mailové adresy, nikoli jména.
Doporučujeme používat domain pro Společnosti a email pro Lidi, protože jsou srozumitelné pro člověka a snadno se udržují v tabulkách.
Připomenutí: Měkce smazané záznamy (viditelné v Command Menu → Zobrazit smazané záznamy) se započítávají do kritérií jedinečnosti. Pokud naimportujete záznam se stejnou jedinečnou hodnotou jako má smazaný záznam, smazaný záznam bude obnoven. Více podrobností naleznete v Omezeních jedinečnosti.

​
Pořadí importu

Vždy nejprve importujte stranu „jedna“!
  1. Společnosti jako první (bez závislostí)
  2. Lidé jako druzí (propojeni se Společnostmi)
  3. Příležitosti jako třetí (propojené se Společnostmi/Lidmi)
  4. Vlastní objekty podle jejich závislostí
Nadřazený záznam musí existovat dříve, než na něj můžete odkazovat.