Vai al contenuto principale

​
Panoramica

Questa guida ti accompagna nella migrazione dei tuoi dati da un’istanza Twenty self-hosted a Twenty Cloud. Il processo prevede la configurazione dello spazio di lavoro cloud, l’esportazione dei dati e la loro reimportazione.
Le viste, i flussi di lavoro e i ruoli devono essere ricreati manualmente dopo la migrazione. Pianifica il tempo per questo lavoro di configurazione.

​
Passaggio 1: Crea il tuo spazio di lavoro cloud

  1. Vai su app.twenty.com e crea un nuovo spazio di lavoro
  2. Completa la procedura guidata iniziale
  3. Annota l’URL del tuo nuovo spazio di lavoro

​
Passaggio 2: Ricrea il tuo modello dati

Prima di importare i dati, ricrea i tuoi oggetti e campi personalizzati:
  1. Vai a Impostazioni → Modello dati nella tua istanza cloud
  2. Crea oggetti personalizzati che corrispondano alla tua configurazione self-hosted
  3. Aggiungi campi personalizzati agli oggetti standard e personalizzati
  4. Configura le impostazioni dei campi (univoche, obbligatorie, ecc.)
Fai degli screenshot del tuo modello dati self-hosted come riferimento oppure tieni entrambe le istanze aperte affiancate.

​
Passaggio 3: Invita tutti gli utenti

Critico: invita gli utenti PRIMA di importare i dati.Gli utenti devono accettare i loro inviti prima di importare qualsiasi record che faccia riferimento a loro (come i campi Account Owner). Se gli utenti non esistono ancora, tali relazioni non possono essere mappate.
  1. Vai a Impostazioni → Membri nella tua istanza cloud
  2. Invita tutti i membri del team che avevano account sull’istanza self-hosted
  3. Attendi che tutti accettino il loro invito
  4. Verifica che tutti gli utenti compaiano nell’elenco Membri

​
Passaggio 4: Esporta i dati dall’istanza self-hosted

Esporta ogni oggetto dalla tua istanza self-hosted:
  1. Vai a ciascun oggetto (Aziende, Persone, Opportunità, ecc.)
  2. Configura la vista per mostrare tutte le colonne che vuoi migrare
  3. Fai clic su ⋮ → Esporta vista
  4. Salva ogni file CSV con un nome chiaro (ad es., companies-export.csv)
Esporta in questo ordine (come riferimento durante l’importazione):
  1. Aziende
  2. Persone
  3. Opportunità
  4. Oggetti personalizzati (seguendo le loro dipendenze)
  5. Attività, Note

​
Passaggio 5: Aggiorna i riferimenti ai membri dello spazio di lavoro

I CSV esportati contengono gli ID utente della tua istanza self-hosted. Questi ID non corrisponderanno alla tua istanza cloud, quindi devi sostituirli con le email. Per ogni file CSV con riferimenti utente (Owner, Assignee, ecc.):
  1. Apri il CSV in un’applicazione per fogli di calcolo
  2. Aggiungi una nuova colonna accanto a ciascuna colonna di ID utente (ad es., accountOwnerEmail accanto a accountOwnerId)
  3. Compila l’indirizzo email di ciascun utente
  4. Puoi eliminare la vecchia colonna ID oppure lasciarla (verrà ignorata durante l’importazione)
Esempio: Prima: 
name,domain,accountOwnerId
Acme Corp,https://acme.com,old-uuid-123
Dopo: 
name,domain,accountOwnerEmail
Acme Corp,https://acme.com,john@yourcompany.com
Usa gli stessi indirizzi email che gli utenti hanno usato per accettare l’invito allo spazio di lavoro cloud.

​
Passaggio 6: Pianifica l’ordine di importazione

Importa i file nel giusto ordine per mantenere le relazioni:
  1. Aziende per prime (nessuna dipendenza)
  2. Persone dopo (collegate alle Aziende)
  3. Opportunità al terzo posto (collegate ad Aziende e Persone)
  4. Oggetti personalizzati (seguendo le loro dipendenze)
  5. Attività e Note per ultime (collegate ad altri record)
Consulta Come importare le relazioni per i dettagli su come mantenere le relazioni.

​
Passaggio 7: Importa nel cloud

Per ogni file CSV, in ordine:
  1. Vai all’oggetto nella tua istanza cloud
  2. Fai clic su ⋮ → Importa record
  3. Carica il file CSV
  4. Mappa le colonne ai campi:
    • Mappa le colonne delle email degli utenti ai campi relazione appropriati
    • Mappa le altre colonne come al solito
  5. Controlla e correggi eventuali errori
  6. Conferma l’importazione
  7. Verifica alcuni record prima di passare al file successivo

​
Passaggio 8: Ricrea la configurazione

Dopo aver importato i dati, ricrea manualmente:

​
Viste

  • Ricrea le viste salvate con filtri, ordinamenti e configurazioni delle colonne
  • Configura eventuali viste kanban o calendario

​
Flussi di Lavoro

  • Ricrea le automazioni in Impostazioni → Flussi di lavoro
  • Testa ogni flusso di lavoro prima di farci affidamento

​
Ruoli e permessi

  • Configura i ruoli in Impostazioni → Ruoli
  • Assegna gli utenti ai ruoli appropriati

​
Integrazioni

  • Riconnetti la sincronizzazione di email e calendario per ogni utente
  • Riconfigura eventuali integrazioni API con nuove chiavi API

​
Lista di Verifica Post-Migrazione

Tutti i dati importati correttamente
Relazioni tra oggetti funzionanti correttamente
Assegnazioni utente (Owner, Assignee) mappate correttamente
Viste ricreate
Flussi di lavoro ricreati e testati
Ruoli e permessi configurati
Sincronizzazione email/calendario riconnessa
Integrazioni API aggiornate con nuove chiavi

​
FAQ

Al momento no. I flussi di lavoro devono essere ricreati manualmente nella tua istanza cloud.
Gli allegati non sono inclusi nelle esportazioni CSV. Dovrai ricaricare manualmente gli allegati, migrarli tramite API oppure contattare il nostro team per assistenza con migrazioni di grandi dimensioni.
Sì, consigliamo di mantenere attiva la tua istanza self-hosted finché non avrai verificato che la migrazione al cloud sia completa. Fai solo attenzione a non creare nuovi dati in entrambi gli ambienti.
I record che fanno riferimento a quell’utente non verranno importati oppure la relazione risulterà vuota. Assicurati che tutti gli utenti accettino gli inviti prima di importare i dati.

​
Hai Bisogno di Aiuto?

Per migrazioni complesse o set di dati di grandi dimensioni, contattaci all’indirizzo contact@twenty.com oppure scopri i nostri Servizi di Implementazione.