Vai al contenuto principale

​
Panoramica

Devi aggiornare molti record in una sola volta? Invece di modificarli uno per uno, usa l’importazione CSV per aggiornare in blocco i record esistenti. Casi di utilizzo:
  • Aggiorna i titoli professionali per più persone
  • Modifica in blocco le informazioni sulle aziende
  • Aggiungi dati ai nuovi campi personalizzati
  • Correggi gli errori dei dati su molti record

​
Come Funziona

Quando importi un file che contiene un identificatore univoco corrispondente a un record esistente, Twenty aggiorna quel record invece di crearne un duplicato.
Se l’identificatore univoco…Twenty farà…
Corrisponde a un record esistenteAggiorna il record esistente
Non corrisponde ad alcun recordCrea un nuovo record
Manca nel tuo fileCrea un nuovo record (con ID generato automaticamente)
I campi Multi-Select vengono sovrascritti, non uniti.Se un record ha Option A e Option B selezionate e importi ["Option C"], il record avrà solo Option C dopo l’importazione. L’importazione sostituisce tutte le selezioni precedenti: non le aggiunge.Per mantenere i valori esistenti, includili tutti nella tua importazione: ["Option A","Option B","Option C"]

​
Passaggio 1: Esporta i tuoi dati correnti

Per prima cosa, esporta i record che vuoi aggiornare:
  1. Vai all’oggetto (Persone, Aziende, ecc.)
  2. Aggiungi le colonne necessarie — fai clic su Options → Fields per mostrare i campi che vuoi aggiornare
  3. Filtra se necessario — limita ai soli record che vuoi aggiornare
  4. Fai clic su ⋮ → Esporta vista
  5. Salva il file CSV
Perché esportare prima? Il file esportato ha il formato corretto, include gli identificatori univoci e viene mappato automaticamente durante l’importazione.

​
Cosa viene esportato

  • Tutte le colonne visibili nella vista corrente
  • Gli identificatori univoci del record (id, email, domain)
  • Valori attuali dei campi che puoi modificare

​
Passaggio 2: Modifica il file CSV

Apri il file esportato nella tua applicazione di fogli di calcolo (Excel, Google Sheets, ecc.):
  1. Mantieni la colonna dell’identificatore univoco — non eliminare id, email o domain
  2. Aggiorna i valori nelle colonne che vuoi modificare
  3. Rimuovi le colonne che non devi aggiornare (opzionale, ma più pulito)
  4. Non modificare i valori dell’identificatore univoco — altrimenti Twenty creerà nuovi record

​
Esempio: aggiornare i titoli professionali

File esportato: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,[email protected],John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,[email protected],Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,[email protected],Bob,Johnson,Sales Rep
Dopo le tue modifiche: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,[email protected],John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,[email protected],Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,[email protected],Bob,Johnson,Account Executive
Non modificare i valori dell’identificatore univoco.Se modifichi [email protected] in [email protected], Twenty creerà un nuovo record invece di aggiornare quello esistente.

​
Passaggio 3: Importa il file aggiornato

  1. Vai all’oggetto
  2. Fai clic su ⋮ → Importa record
  3. Carica il file CSV modificato
  4. Assicurati che l’identificatore univoco sia mappato — verifica che email, domain o id siano mappati correttamente
  5. Rivedi le mappature dei campi
  6. Verifica la presenza di errori
  7. Fai clic su Conferma
Twenty abbina i record in base all’identificatore univoco e li aggiorna con i nuovi valori.

​
Scegliere l’identificatore univoco giusto

OggettoConsigliatoAlternativaNote
PersoneemailidL’email è leggibile
AziendedominioidIl dominio è leggibile
Oggetti personalizzatiQualsiasi campo univocoidUsa il tuo campo univoco personalizzato
Usa un solo identificatore univoco. Non mappare sia email che id. Questo può causare confusione ed errori.

​
Utilizzo di campi univoci personalizzati

Se hai un campo personalizzato contrassegnato come univoco (come un ID esterno da un altro sistema):
  1. Includi quel campo nell’esportazione e nell’importazione
  2. Mappalo durante l’importazione
  3. Twenty abbinerà in base a quel campo

​
Passaggio 4: Verifica gli aggiornamenti

Dopo l’importazione:
  1. Apri alcuni record aggiornati
  2. Verifica che le modifiche siano state applicate
  3. Controlla che non siano stati creati record duplicati

​
Che cosa succede ai campi non presenti nel tuo file?

I campi non inclusi nel file di importazione rimangono invariati.
Il tuo file include…Risultato
email, jobTitleViene aggiornato solo jobTitle; gli altri campi restano invariati
email, jobTitle, phoneVengono aggiornati jobTitle e phone
Ciò significa che devi includere solo i campi che vuoi modificare (più l’identificatore univoco).

​
Combinare aggiornamenti e nuovi record

Puoi aggiornare i record esistenti E creare nuovi record nella stessa importazione: 
email,firstName,lastName,jobTitle
[email protected],John,Smith,Senior Manager    ← Aggiorna esistente (l'email corrisponde)
[email protected],New,Person,Analyst      ← Crea nuovo (l'email non corrisponde)

​
Errori comuni da evitare

ErroreProblemaRisultatoSoluzione
Modifica dell’identificatore univocoModificato [email protected] in [email protected]Crea un nuovo record invece di aggiornareMantieni invariati gli identificatori univoci
Più campi univociMappare sia email che idPossibili conflitti di corrispondenzaMappa un solo identificatore univoco
Nessun identificatore univocoIl file contiene solo firstName, lastName, jobTitleTutte le righe creano nuovi recordIncludi sempre email, domain o id
Discrepanza tra maiuscole e minuscoleIl file ha [email protected] ma Twenty ha [email protected]Crea un nuovo recordEsporta da Twenty per ottenere i valori esatti

​
FAQ

I record con identificatori univoci che non corrispondono a record esistenti verranno creati come nuovi record. Questo ti consente di aggiornare e creare nella stessa importazione.
Sì, lascia la cella vuota nel tuo CSV. L’importazione cancellerà il valore di quel campo nel record esistente.
I campi non presenti nel file di importazione rimangono invariati nei record esistenti. Vengono aggiornati solo i campi che includi.
Sì! Includi l’identificatore univoco della relazione (ad es., companyDomain) e mappalo sul campo di relazione. La relazione verrà aggiornata.
Durante la fase di revisione dell’importazione, Twenty ti mostra quanti record verranno aggiornati e quanti creati in base alle corrispondenze dell’identificatore univoco.
Non è disponibile un annullamento automatico. Ti consigliamo di esportare i tuoi dati come backup prima di effettuare aggiornamenti in blocco.

​
Migliori Pratiche

  1. Esporta per prima cosa — inizia sempre da un’esportazione per assicurarti del formato corretto
  2. Fai un backup prima di aggiornare — esporta i tuoi dati prima di effettuare modifiche in blocco
  3. Esegui una prova con pochi record — prova ad aggiornare prima 5-10 record, prima di eseguire un lotto di grandi dimensioni
  4. Usa identificatori leggibili — email e domain sono più facili da verificare rispetto a id
  5. Includi solo le colonne necessarie — meno colonne significa meno possibilità di errori

​
Risoluzione dei problemi

Hai problemi? Controlla: