Vai al contenuto principale

​
Panoramica

Questa guida ti accompagna nell’importazione delle relazioni tra oggetti — ad esempio, collegare Persone ad Aziende o Opportunità a Persone.
Cosa può essere importato: Solo relazioni uno-a-molti che puntano a un singolo tipo di oggetto. Le relazioni che puntano a più tipi di oggetto (come Note collegate a Persone E Aziende) non sono ancora supportate per l’importazione.

​
Comprendere le relazioni

​
Che cos’è una relazione “uno-a-molti”?

In una relazione uno-a-molti:
  • Una Azienda ha molte Persone (dipendenti)
  • Una Azienda ha molte Opportunità
  • Una Persona ha molte Attività
Il lato “uno” è il genitore. Il lato “molti” è il figlio.

​
Relazioni comuni in Twenty

RelazioneLato “uno” (genitore)Lato “molti” (figlio)
Aziende → PersoneAziendaPersone
Aziende → OpportunitàAziendaOpportunità
Persone → AttivitàPersonaAttività
Persone → NotePersonaNote

​
Passaggio 1: Identifica i lati “Uno” e “Molti”

Prima di importare, determina quale oggetto è il genitore e quale è il figlio. Chiediti: “Un [Oggetto A] ha molti [Oggetto B]?”
  • Un’Azienda → Molte Persone ✓ (l’Azienda è il genitore)
  • Una Persona → Molte Aziende ✗ (Questo è sbagliato: una persona appartiene a un’azienda)

​
Passaggio 2: Importa prima i record genitore

Il genitore (lato “uno”) deve esistere in Twenty prima di potervi fare riferimento. Ordine di importazione:
  1. Aziende per prime (nessuna dipendenza)
  2. Persone dopo (collegate alle Aziende)
  3. Opportunità al terzo posto (collegate ad Aziende e/o Persone)
  4. Attività/Note (collegate a uno qualsiasi dei precedenti)
Se il record genitore non esiste, l’importazione fallirà.Verifica sempre che le Aziende siano importate prima di importare le Persone con riferimenti all’Azienda.

​
Passaggio 3: Annota l’identificatore univoco del genitore

Devi fare riferimento al record genitore usando un identificatore univoco. Opzioni disponibili:
Oggetto genitoreIdentificatori univoci disponibili
Aziendeid (UUID), domain (consigliato) o qualsiasi campo univoco personalizzato
Personeid (UUID), email o qualsiasi campo univoco personalizzato
Membri dello spazio di lavoroid (UUID), email (non il nome)
Oggetti personalizzatiid (UUID) o qualsiasi campo contrassegnato come univoco
Consigliato: Usa domain per le Aziende ed email per le Persone. Sono leggibili e facili da verificare nel tuo foglio di calcolo.

​
Trovare l’identificatore

Se ti serve l’id:
  1. Esporta i record genitore da Twenty
  2. L’esportazione include la colonna id
  3. Usa questi ID nel file dei record figlio

​
Passaggio 4: Verifica che il campo di relazione esista

Prima di importare, assicurati che esista il campo di relazione tra i tuoi oggetti. Per verificare o creare:
  1. Vai a Impostazioni → Modello dati
  2. Seleziona il tuo oggetto figlio (ad es., Persone)
  3. Cerca un campo di relazione che punti al genitore (ad es., Azienda)
  4. Se non esiste, crealo:
    • Fai clic su + Aggiungi campo
    • Seleziona il tipo Relazione
    • Scegli l’oggetto genitore

​
Passaggio 5: Prepara il tuo file CSV

Aggiungi al CSV dei record figlio una colonna che faccia riferimento al genitore usando il suo identificatore univoco.

​
Esempio: Persone collegate ad Aziende

Il tuo CSV delle Persone: 
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
La colonna companyDomain fa riferimento al dominio dell’Azienda.

​
Requisiti di formato

IdentificatoreFormatoEsempio
DominioFormato URLhttps://acme.com
EmailEmail standardjohn@acme.com
IDUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
Il formato del dominio è importante!Usa https://domain.com (non solo domain.com). Questo corrisponde a come Twenty archivia i domini delle Aziende e previene errori di corrispondenza.

​
Regole importanti

  1. Corrispondenza esatta richiesta — il valore deve corrispondere esattamente al record genitore
  2. Mappa un solo identificatore univoco — non includere sia companyId che companyDomain
  3. Sensibile alle maiuscole/minuscole — Acme.com ≠ acme.com

​
Passaggio 6: Carica e mappa la relazione

  1. Vai all’oggetto figlio (ad es., Persone)
  2. Fai clic su ⋮ → Importa record
  3. Carica il tuo file CSV
  4. Nella fase di mappatura dei campi:
    • Trova la tua colonna di relazione (ad es., companyDomain)
    • Mappala al campo di relazione Azienda
  5. Completa le restanti mappature
  6. Controlla gli errori e conferma
Twenty collegherà automaticamente ogni record figlio al genitore corrispondente.

​
Passaggio 7: Verifica l’importazione

Dopo l’importazione:
  1. Apri alcuni record figlio (ad es., Persone)
  2. Verifica che il campo di relazione mostri il genitore corretto (ad es., Azienda)
  3. Apri un record genitore e controlla la sezione dei record correlati

​
Errori comuni da evitare

ErroreProblemaSoluzione
Ordine di importazione erratoImportare le Persone prima delle AziendeImporta sempre prima i genitori, poi i figli
Formato del dominio erratoUso di acme.com invece di https://acme.comUsa il formato URL completo con https://
Più campi univociMappare sia companyId che companyDomainMappa un solo identificatore univoco
Campo di relazione mancanteIl campo di relazione non esiste nel modello datiCrealo in Impostazioni → Modello dati prima dell’importazione
Record inesistentiIl record genitore non esiste in TwentyImporta prima i record genitore oppure verifica la presenza di errori di battitura
Discrepanza tra maiuscole e minuscoleAcme.com nel file ma acme.com in TwentyAssicurati che le maiuscole/minuscole corrispondano esattamente

​
Collegamento ai membri del Workspace

Quando colleghi i membri del Workspace (il tuo team):
  • Usa il loro indirizzo email, non il nome
  • Esempio: owner@yourcompany.com, non “John Smith”
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com

​
FAQ

Hai due opzioni:
  1. Usa l’id di Twenty (esporta i record genitore per ottenere i loro ID)
  2. Crea un campo univoco personalizzato nel tuo modello dati per archiviare un ID esterno dal sistema precedente
Sì! Includi l’identificatore univoco del record figlio (ad es., email per Persone) e il nuovo valore della relazione. L’importazione aggiornerà la relazione.
Le relazioni molti-a-molti non sono ancora supportate per l’importazione. È previsto per H1 2026.
Le relazioni che puntano a più tipi di oggetto non sono ancora supportate per importazione/esportazione. È nella nostra roadmap.
L’importazione mostrerà un errore per quella riga. Puoi:
  • Importa prima il record genitore, poi ripeti l’importazione
  • Correggi il valore di riferimento
  • Rimuovi la riga dall’importazione
Cause comuni:
  • Formato errato (usa https://domain.com per i domini)
  • Discrepanza tra maiuscole e minuscole (controlla l’ortografia esatta)
  • Il genitore non esiste (importa prima i genitori)
  • Mappatura di più identificatori (usane uno solo)
Ricorda: i record eliminati in modo non definitivo contano ai fini dell’unicità.Se ricevi errori “not found” ma il record sembra esistere, controlla Menu comandi → Visualizza record eliminati. Il genitore potrebbe essere stato eliminato in modo non definitivo.

​
Risoluzione dei problemi

Hai problemi? Controlla: