> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arya.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Lezione 3 — Attributi e campi personalizzati

> Aggiungi i campi che servono al tuo business, in qualsiasi oggetto.

<Note>
  **Lezione 3 di 10** · Circa 5 minuti · Prerequisito: [Lezione 2 — Oggetti e record](/it/arya-101/lezione-2-oggetti-e-record)
</Note>

## Cosa imparerai

* Quali tipi di attributo esistono
* Come aggiungere un campo personalizzato
* Quando usare una formula invece di un campo manuale

## Attributi standard e personalizzati

Ogni oggetto ha **attributi standard** (nome, owner, data creazione, stato) e puoi aggiungere **attributi personalizzati** per adattare Arya al tuo modello di business.

Esempi utili:

* Su `Deal`: campo `Fonte lead` (select), `Probabilità` (numero), `Costo acquisizione` (valuta)
* Su `Company`: campo `Settore NACE` (select), `Fatturato annuo` (valuta)
* Su `Invoice`: campo `Progetto collegato` (riferimento)

## Tipi di attributo

<AccordionGroup>
  <Accordion title="Testo">
    Stringa libera su una sola riga. Usato per nomi brevi, codici, etichette.
  </Accordion>

  <Accordion title="Testo lungo">
    Campo multi-riga per descrizioni, note e contenuti estesi. Si modifica nell'editor avanzato (doppio click in vista spreadsheet).
  </Accordion>

  <Accordion title="Numero">
    Intero o decimale. Puoi impostare unità di misura (€, %, pezzi, ore).
  </Accordion>

  <Accordion title="Valuta">
    Numero con simbolo valuta. Supporta multi-valuta con conversione automatica.
  </Accordion>

  <Accordion title="Data / Data e ora">
    Seleziona giorno o timestamp preciso. Supporta fusi orari.
  </Accordion>

  <Accordion title="Select (dropdown)">
    Scelta tra opzioni predefinite. Puoi permettere selezione multipla o singola.
  </Accordion>

  <Accordion title="Checkbox">
    Vero/falso. Per flag come `VIP`, `Pagata`, `Archiviato`.
  </Accordion>

  <Accordion title="Riferimento a record">
    Link a un altro record. Es. `Responsabile` (riferimento a `Employee`), `Azienda madre` (riferimento a `Company`).
  </Accordion>

  <Accordion title="Formula">
    Calcolato automaticamente da altri attributi. Es. `Valore ponderato = valore_deal × probabilità / 100`.
  </Accordion>

  <Accordion title="Percentuale">
    Valore percentuale (es. sconto, margine, probabilità). Mostrato con il simbolo `%`.
  </Accordion>

  <Accordion title="Email">
    Indirizzo email con validazione del formato. Cliccabile per scrivere un messaggio.
  </Accordion>

  <Accordion title="URL">
    Link web con validazione. Cliccabile per aprire la pagina in una nuova scheda.
  </Accordion>

  <Accordion title="Indirizzo">
    Indirizzo postale strutturato (via, città, CAP, paese).
  </Accordion>

  <Accordion title="Immagine">
    Immagine associata al record (es. foto prodotto, logo azienda).
  </Accordion>

  <Accordion title="Campo AI">
    Valore generato automaticamente dall'AI di Arya in base al contenuto del record.
  </Accordion>

  <Accordion title="UUID">
    Identificativo univoco generato automaticamente. Utile per integrazioni e riferimenti tecnici.
  </Accordion>

  <Accordion title="Stato (status)">
    Select speciale con workflow. Gli stati possono essere raggruppati (es. `Aperto → Qualificato → Vinto / Perso`).
  </Accordion>
</AccordionGroup>

## Aggiungi un campo personalizzato

<Steps>
  <Step title="Apri la configurazione dell'oggetto">
    Vai su **Impostazioni → Oggetti** e seleziona l'oggetto (es. `Deal`).

    <Frame>
      <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-03/it/object-settings.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=1f98081bc383a5d8d89b422c4773588a" alt="Pannello configurazione oggetto Deal con elenco attributi" width="1200" height="720" data-path="images/arya-101/lesson-03/it/object-settings.svg" />
    </Frame>
  </Step>

  <Step title="Aggiungi attributo">
    Click **+ Nuovo attributo**. Assegna un nome, scegli il tipo, decidi se è obbligatorio.
  </Step>

  <Step title="Definisci opzioni (se select)">
    Per attributi select, inserisci le opzioni con colore (utile nella pipeline Kanban e nei filtri).
  </Step>

  <Step title="Controlla la visibilità">
    Decidi chi può vedere e modificare il campo: tutti, solo alcuni ruoli, solo l'owner del record.
  </Step>

  <Step title="Salva">
    Il campo è subito disponibile su tutti i record dell'oggetto, nelle viste, nei filtri e nelle automazioni.
  </Step>
</Steps>

<Tip>
  Il toggle **Obbligatorio** vale sia per gli attributi personalizzati sia per quelli di sistema (es. il **Cognome** dei Contatti). Quando è attivo, il campo mostra l'asterisco ed è richiesto nei form e negli import; quando è disattivo, il campo è facoltativo. La gestisci interamente tu da **Impostazioni → Oggetti → Attributi**.
</Tip>

## Usare una formula

Le formule permettono calcoli automatici. Esempio pratico su `Deal`:

```
weighted_value = value * (probability / 100)
```

<Frame>
  <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-03/it/formula-editor.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=f7348090839beb04fee6303bcd37e26f" alt="Editor formula con espressione e anteprima risultato" width="1200" height="720" data-path="images/arya-101/lesson-03/it/formula-editor.svg" />
</Frame>

Operatori supportati: aritmetici (`+ - * /`), confronto (`> < == !=`), logici (`AND OR NOT`), testo (`CONCAT LOWER UPPER`), data (`DAYS_BETWEEN TODAY`).

<Warning>
  Se un campo referenziato dalla formula viene eliminato, la formula va in errore finché non la correggi. Arya ti avvisa.
</Warning>

## Buone pratiche

* **Non creare mille campi**: aggiungili quando ti servono davvero. Troppi campi rallentano il team.
* **Usa sezioni**: raggruppa i campi correlati (Dati commerciali, Dati legali, Note interne).
* **Standardizza i valori**: preferisci `Select` a `Testo libero` quando possibile (evita `Roma`, `ROMA`, `roma`).

## Verifica

<Check>Conosci i principali tipi di attributo</Check>
<Check>Hai aggiunto almeno un campo personalizzato a un oggetto</Check>
<Check>Sai scrivere una formula semplice</Check>

## Prossima lezione

<Card title="Lezione 4 — Liste, viste e filtri" icon="arrow-right" href="/it/arya-101/lezione-4-liste-e-viste">
  Crea la tua prima lista dinamica e condividila col team.
</Card>