> ## 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.

# Vincoli di unicità

> Come Twenty applica l'unicità dei dati durante l'importazione.

export const VimeoEmbed = ({videoId, title = 'Video'}) => <div style={{
  padding: '69.01% 0 0 0',
  position: 'relative',
  margin: '32px 0px'
}}>
    <iframe src={`https://player.vimeo.com/video/${videoId}?autoplay=1&loop=1&autopause=0&background=1&app_id=58479`} frameBorder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write" style={{
  position: 'absolute',
  top: 0,
  left: 0,
  width: '100%',
  height: '100%',
  borderRadius: '16px',
  border: '2px solid black'
}} title={title} />
  </div>;

## Panoramica

Twenty applica l'unicità su determinati campi per prevenire record duplicati e garantire l'integrità dei dati. Comprendere questi vincoli è essenziale per importazioni riuscite.

## Campi univoci predefiniti

| Oggetto                    | Campi univoci                            |
| -------------------------- | ---------------------------------------- |
| **Persone**                | `id`, `email`                            |
| **Aziende**                | `id`, `domain`                           |
| **Oggetti personalizzati** | Solo `id` (per impostazione predefinita) |

<Note>Il campo `id` è l'identificatore interno di Twenty, generato automaticamente per ciascun record. Utilizza il formato UUID (ad es., `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>

## Campi univoci personalizzati

Puoi definire campi univoci aggiuntivi in **Impostazioni → Modello dati**:

1. Vai a **Impostazioni → Modello dati**
2. Seleziona l'oggetto
3. Fai clic su un campo
4. Abilita **Univoco** nelle impostazioni del campo

### Casi d'uso per campi univoci personalizzati

* **ID esterni**: Memorizza ID provenienti da altri sistemi (Salesforce ID, HubSpot ID)
* **Identificativi aziendali**: numeri dei dipendenti, codici cliente
* **Informazioni di contatto alternative**: profilo LinkedIn, numero di telefono

<Note>Il nome del campo `id` è riservato all'ID interno di Twenty. Usa un nome diverso come `externalId` o `legacyId` per gli identificatori esterni.</Note>

## Comportamento dell'importazione

### Creazione di nuovi record

Se il valore di un campo univoco non esiste, viene creato un nuovo record.

### Aggiornamento dei record esistenti

Se il valore di un campo univoco corrisponde a un record esistente, quel record viene **aggiornato** con i nuovi dati.
<Warning>Per **aggiornare i record esistenti**, si consiglia di **associare un solo campo univoco**.</Warning>

### Record eliminati in modo non definitivo

<Warning>
  **I record eliminati contano ai fini dell'unicità.**

  I record eliminati in modo non definitivo (visibili in Menu Comandi → Vedi record eliminati) sono inclusi nei controlli di unicità. Se importi un record con lo stesso valore univoco di un record eliminato, il record eliminato verrà **ripristinato** con i nuovi dati.
</Warning>

## Rilevamento dei duplicati durante l'importazione

Durante la fase di convalida:

* I duplicati presenti nel tuo file sono evidenziati in giallo
* Puoi modificare o rimuovere le righe duplicate dall'interfaccia utente prima di avviare l'importazione

<VimeoEmbed videoId="1145246326" title="Dimostrazione video" />

## Migliori Pratiche

1. **Rimuovi i duplicati** dal tuo file prima di importare
2. **Verifica la presenza di record esistenti** in Twenty prima di importare
3. **Usa ID esterni** quando esegui una migrazione da altri sistemi
4. **Includi campi univoci** se vuoi aggiornare i record esistenti