snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/it/user-guide/data-model/capabilities/fields.mdx

@@ -0,0 +1,122 @@
+---
+title: Campi
+description: Comprendere il ruolo dei campi e come gestirli.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Informazioni sui Campi
+
+I campi sono come colonne in un foglio di calcolo. Memorizzano diversi tipi di dati come testo, numeri o date. I campi possono essere standard (di sistema) o personalizzati (quelli che crei tu).
+
+### Campi Standard
+
+I campi standard sono integrati in Twenty per gestire esigenze aziendali comuni.
+
+Ad esempio, `Nome` e `Cognome` sono campi standard nell'oggetto `People`. Memorizzano dati di testo per nomi individuali.
+
+Non puoi eliminare i campi standard, ma puoi disattivarli se non ne hai bisogno.
+
+Puoi anche personalizzare le opzioni dei campi standard di tipo `SELECT`, ad esempio le opzioni della `Fase` nelle Opportunità.
+
+<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
+
+### Campi Personalizzati
+
+I campi personalizzati possono essere aggiunti a qualsiasi oggetto. Puoi memorizzare testo, numeri, date, selezioni a discesa e altro. Usa campi personalizzati per tracciare informazioni specifiche per la tua attività.
+
+Ad esempio, un campo personalizzato per SpaceX potrebbe essere `Stato operativo razzo`, che indica se un razzo è operativo.
+
+<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
+
+## Tipi di campo
+
+Twenty supporta vari tipi di campo:
+
+| Tipo            | Descrizione                                                        | Esempio                        |
+| --------------- | ------------------------------------------------------------------ | ------------------------------ |
+| Indirizzo       | Indirizzo strutturato con via, città, stato, paese, codice postale | Indirizzo dell'ufficio         |
+| Array           | Elenco di valori di testo                                          | Etichette                      |
+| Booleano        | Casella di controllo vero/falso                                    | Attivo                         |
+| Valuta          | Valore monetario con codice valuta                                 | Importo della trattativa (USD) |
+| Data            | Valori di data                                                     | Data di chiusura               |
+| Data e ora      | Data con orario                                                    | Ora della riunione             |
+| Dominio         | Dominio del sito web (utilizzato per le Aziende)                   | acme.com                       |
+| Email           | Indirizzi email (con principale + aggiuntivi)                      | Email del contatto             |
+| JSON            | Dati JSON strutturati                                              | Metadati personalizzati        |
+| Collegamenti    | URL con etichette (principale + secondaria)                        | Sito web, LinkedIn             |
+| Testo lungo     | Testo multilinea                                                   | Descrizione, Note              |
+| Multi-selezione | Scelte multiple da un elenco predefinito                           | Etichette, Categorie           |
+| Numero          | Valori numerici (interi o decimali)                                | Quantità, Punteggio            |
+| Telefono        | Numeri di telefono con prefisso internazionale                     | Telefono di lavoro             |
+| Valutazione     | Valutazione a stelle (1-5)                                         | Priorità, Punteggio            |
+| Relazione       | Collegamenti a record in altri oggetti                             | Azienda → Persone              |
+| Seleziona       | Scelta singola da un elenco predefinito                            | Fase, Stato                    |
+| Testo           | Testo su una riga                                                  | Nome, Titolo                   |
+
+## Crea un campo personalizzato
+
+Per aggiungere un campo personalizzato a qualsiasi oggetto, segui questi passaggi:
+
+1. Vai su `Impostazioni` nella barra laterale sinistra.
+2. Vai su `Modello di dati`, quindi seleziona l'oggetto che desideri personalizzare.
+3. Procedi cliccando su `+ Nuovo Campo`.
+4. Scegli un nome e un tipo di campo che si adattano alle tue esigenze. Considera l'aggiunta di una descrizione del campo per una migliore comprensione.
+
+Il tuo nuovo campo è ora disponibile nei campi dell'applicazione. Per visualizzarlo in una vista specifica, fai clic sul menu delle opzioni, quindi seleziona `Campi`.
+
+<VimeoEmbed videoId="927628219" title="Dimostrazione video" />
+
+**Modo rapido:** Fai clic sul pulsante **+** in alto a destra di ogni tabella oggetto, quindi seleziona `Personalizza campi`. Ciò ti porterà direttamente alle impostazioni del Modello di Dati.
+
+<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
+
+## Disattiva un campo
+
+Puoi disattivare un campo per nasconderlo dall'app senza perdere i tuoi dati. Pensalo come un nascondimento del campo invece di un'eliminazione.
+
+Ecco come puoi farlo:
+
+1. Trova il campo che desideri disattivare nelle impostazioni del tuo oggetto.
+2. Clicca sui tre punti `⋮` accanto al campo per aprire il menu.
+3. Seleziona `Disattiva` dall'elenco a discesa.
+
+<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
+
+Cosa succede quando disattivi un campo?
+
+1. **Nell'app:** Il campo scompare e non puoi aggiungervi nuovi valori.
+2. **Relazioni esistenti:** Se è un campo di relazione, le connessioni esistenti rimangono, ma non puoi crearne di nuove.
+3. **Accesso API:** Puoi ancora accedere al campo e ai suoi dati tramite l'API.
+
+Puoi riattivare i campi Standard e Personalizzati o avere l'opzione di eliminarli permanentemente.
+
+## Rendi Unici i Campi
+
+Rendi un campo unico per garantire che i record distinti non possano avere lo stesso valore. Ad esempio, gli indirizzi email sono unici per ogni persona.
+
+Se ottieni un errore impostando l'unicità, controlla i valori duplicati nei tuoi dati (inclusi i record eliminati).
+
+## Indici (Avanzato)
+
+Gli indici del database sono gestiti automaticamente — aggiungerne di propri è raramente necessario ed è facile commettere errori. Con la modalità Avanzata attiva, ogni oggetto ha una sezione **Indici** in `Impostazioni → Modello dati → <object>` per i casi in cui sai di averne bisogno.
+
+## Procedure Migliori per la Configurazione dei Campi
+
+### Convenzioni e Limitazioni sui Nomi
+
+* **I nomi singolari e plurali devono essere distinti**: La nostra API GraphQL necessita di nomi distinti per le mutazioni
+* **Nomi di campo protetti**: alcuni nomi sono riservati all'uso di sistema (ad es., `Type`, `Application`)
+
+### Campi Valuta e Telefono
+
+* **Valuta predefinita**: può essere configurata tramite il modello di dati
+* **Codici paesi predefiniti**: possono essere configurati per i campi telefono tramite il modello di dati
+
+### Campi Selezione
+
+* **Può essere selezionata un'opzione predefinita** per ogni campo Selezione
+
+### Campi di Testo dei Record
+
+* **Ogni oggetto ha un campo di visualizzazione principale**: Questo campo appare nella colonna più a sinistra e rappresenta il record quando collegato a altri oggetti. Deve essere un campo di testo. Ad esempio, Persone usa `Nome` come campo principale, quindi quando colleghi una persona a un'azienda, vedrai il loro nome nella vista dell'azienda.

packages/twenty-docs/l/it/user-guide/data-model/capabilities/objects.mdx

@@ -0,0 +1,92 @@
+---
+title: Oggetti
+description: Scopri gli oggetti standard e personalizzati in Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Oggetti standard
+
+Gli oggetti standard sono entità predefinite nel tuo spazio di lavoro per aiutarti a iniziare. Fanno parte di un modello di dati condiviso accessibile a tutti gli utenti di Twenty. Puoi usarli così come sono, personalizzarli o disattivarli.
+
+<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
+
+### Persone
+
+L'oggetto `Persone` memorizza i tuoi contatti. Include dettagli di contatto e cronologia delle interazioni, così puoi vedere tutte le tue interazioni con i clienti in un unico posto.
+
+### Aziende
+
+L'oggetto `Aziende` memorizza i tuoi account aziendali. Include dettagli come settore, dimensioni e posizione. Le aziende si collegano sia agli oggetti `Persone` che `Opportunità`.
+
+### Opportunità
+
+L'oggetto `Opportunità` memorizza i dati relativi alle trattative. Traccia la progressione delle potenziali vendite, dalla prospezione alla chiusura, registrando fasi, dimensioni dell'accordo, account associato e data di chiusura prevista. Puoi visualizzare il tuo pipeline di vendita in un layout kanban.
+
+### Note
+
+L'oggetto `Notes` memorizza note in formato libero che possono essere allegate a Persone, Aziende, Opportunità e ad altri record. Usa le note per raccogliere riepiloghi delle riunioni, dettagli importanti o qualsiasi informazione contestuale.
+
+### Attività
+
+L'oggetto `Tasks` memorizza attività da fare e azioni. Le attività possono essere collegate a Persone, Aziende, Opportunità e ad altri record. Tieni traccia delle scadenze, degli assegnatari e dello stato di completamento per restare al passo con i follow-up.
+
+## Oggetti personalizzati
+
+Gli oggetti personalizzati ti permettono di memorizzare informazioni uniche della tua organizzazione che gli oggetti standard non possono gestire. Ad esempio, se sei SpaceX, potresti voler creare un oggetto personalizzato per Razzi e Lanci.
+
+<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
+
+### Creare un nuovo oggetto personalizzato
+
+Per creare un nuovo oggetto personalizzato:
+
+1. Vai a Impostazioni nella barra laterale a sinistra.
+2. Sotto Workspace, vai al Data Model. Qui potrai vedere una panoramica di tutti gli oggetti standard e personalizzati esistenti (sia attivi che disattivati).
+
+<VimeoEmbed videoId="926288174" title="Dimostrazione video" />
+
+3. Clicca su `+ Nuovo oggetto` in alto. Inserisci il nome (sia singolare che plurale), scegli un'icona, aggiungi una descrizione per il tuo oggetto personalizzato e clicca Salva (in alto a destra). Utilizzando Annuncio come esempio di oggetto personalizzato, il singolare sarebbe "annuncio" e il plurale sarebbe "annunci" insieme a una descrizione come "Annunci che gli host hanno creato per mostrare la loro proprietà."
+4. Il tuo oggetto personalizzato è stato creato e apparirà nella barra laterale. Puoi iniziare subito ad aggiungere record.
+
+## Gestione degli oggetti
+
+### Disattivazione degli oggetti
+
+Se non hai bisogno di un oggetto standard o personalizzato:
+
+1. Vai a Impostazioni → Modello dati
+2. Trova l'oggetto che vuoi disattivare e fai clic su di esso
+3. Vai alla scheda **Impostazioni** dell'oggetto
+4. Clicca sul pulsante `Deactivate`
+5. L'oggetto sarà nascosto dal tuo spazio di lavoro, ma i dati verranno conservati
+
+### Riattivazione degli oggetti
+
+Per riattivare un oggetto disattivato:
+
+1. Vai a Impostazioni → Modello dati
+2. Abilita il filtro `Disattivato`
+3. Cerca oggetti disattivati (hanno `Deactivated` accanto al loro nome)
+4. Fai clic su `⋮` e quindi su `Attiva` per riattivarlo
+5. L'oggetto e tutti i suoi dati verranno ripristinati
+
+## Migliori Pratiche
+
+### Quando creare oggetti personalizzati
+
+* **Entità aziendali uniche**: elementi specifici del tuo settore o processo
+* **Relazioni complesse**: quando devi tenere traccia dei collegamenti tra più entità
+* **Dati scalabili**: quando potresti avere molte istanze di qualcosa
+
+### Quando usare invece i campi
+
+* **Attributi semplici**: proprietà che descrivono oggetti esistenti
+* **Categorie o etichette**: modi per classificare i record esistenti
+* **Valori singoli**: informazioni che non necessitano di un proprio ciclo di vita
+
+### Denominazione degli oggetti
+
+* **Usa nomi chiari e descrittivi**: rendi evidente che cosa rappresenta l'oggetto
+* **Segui le convenzioni**: usa il singolare per il nome dell'oggetto, il plurale per la raccolta
+* **Considera il tuo team**: scegli nomi che tutti possano comprendere

packages/twenty-docs/l/it/user-guide/data-model/capabilities/relation-fields.mdx

@@ -0,0 +1,94 @@
+---
+title: Campi di Relazione
+description: Collega i record tra oggetti diversi utilizzando campi di relazione.
+---
+
+## Tipi di relazioni
+
+### Uno-a-molti
+
+Un record nell'Oggetto A può essere collegato a molti record nell'Oggetto B.
+
+**Esempio:** Un'Azienda può avere molte Persone (dipendenti).
+
+### Molti-a-uno
+
+Molti record nell'Oggetto A possono essere collegati a un record nell'Oggetto B.
+
+**Esempio:** Molte Persone possono appartenere a un'Azienda.
+
+### Relazioni che puntano a più tipi di oggetto
+
+Alcuni oggetti possono collegarsi a più tipi di oggetto su un lato della relazione.
+
+**Esempio:** Una Nota può essere collegata a una Persona E a un'Azienda E a un'Opportunità contemporaneamente. La Nota si trova sul lato "molti", collegandosi a più lati "uno".
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+Analogamente, un Progetto (sul lato "uno") potrebbe ricevere collegamenti da più Persone, più Aziende e più Note.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**Limitazione di importazione/esportazione**: Le relazioni che puntano a più tipi di oggetto non sono ancora supportate per l'importazione/esportazione CSV. È nella nostra roadmap.
+</Warning>
+
+### Molti-a-molti
+
+Molti record nell'Oggetto A possono essere collegati a molti record nell'Oggetto B.
+
+**Esempio:** Molte Persone possono essere collegate a molti Progetti, e viceversa.
+
+Le relazioni molti-a-molti utilizzano lo schema dell'**oggetto di giunzione**: un oggetto intermedio che collega entrambe le parti. Con la funzionalità delle relazioni di giunzione, Twenty visualizza direttamente i record collegati finali, nascondendo l'oggetto intermedio dall'interfaccia utente.
+
+<Warning>
+**Funzionalità beta**: le relazioni di giunzione devono essere abilitate in **Impostazioni → Community → Funzionalità** prima dell'uso.
+</Warning>
+
+Vedi [Come creare molte relazioni](/l/it/user-guide/data-model/how-tos/create-many-to-many-relations) per una guida completa passo-passo.
+
+## Creazione di un campo di relazione
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto in cui vuoi aggiungere la relazione
+3. Clicca su **+ Nuovo campo**
+4. Seleziona **Relazione** come tipo di campo
+5. Scegli l'oggetto o gli oggetti di destinazione a cui collegare
+6. Configura le impostazioni della relazione:
+   * **Nome del campo sull'oggetto di origine**: il nome del campo di relazione sull'oggetto che stai modificando
+   * **Nome del campo sull'oggetto di destinazione**: il nome del campo di relazione che apparirà sull'oggetto di destinazione
+   * Tipo di relazione (uno-a-molti, molti-a-uno)
+7. Clicca su **Salva**
+
+## Relazioni standard
+
+Twenty offre relazioni predefinite tra oggetti standard:
+
+| Oggetto di origine | Oggetto di destinazione | Tipo di relazione |
+| ------------------ | ----------------------- | ----------------- |
+| Persone            | Aziende                 | Molti-a-uno       |
+| Opportunità        | Aziende                 | Molti-a-uno       |
+| Opportunità        | Persone                 | Molti-a-uno       |
+
+## Migliori Pratiche
+
+### Pianificazione delle relazioni
+
+* **Mappa il tuo modello di dati**: pianifica le relazioni prima di crearle
+* **Considera la direzione**: pensa a quale oggetto "possiede" la relazione
+* **Evita le dipendenze circolari**: mantieni pulito il tuo modello di dati
+
+### Denominare le relazioni
+
+* **Usa nomi chiari**: rendi evidente ciò che la relazione rappresenta
+* **Sii coerente**: usa schemi di denominazione simili tra le relazioni
+* **Considera entrambi i lati**: assegna un nome appropriato a entrambi i lati della relazione
+
+### Prestazioni
+
+* **Non esagerare con le relazioni**: troppe relazioni possono rallentare il tuo spazio di lavoro
+
+## Limitazioni
+
+* **L'eliminazione delle relazioni** rimuove il collegamento ma non i record correlati
+* **Le relazioni circolari** dovrebbero essere evitate per l'integrità dei dati