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

# Oggetti personalizzati

> Crea tipi di record custom per modellare entità specifiche del tuo business.

Gli **oggetti personalizzati** permettono di modellare entità non coperte dagli oggetti standard di Arya. Esempi: `Pratica legale`, `Asset`, `Polizza`, `Fornitore`, `Immobile`, `Macchinario`.

## Quando crearne uno

<AccordionGroup>
  <Accordion title="Hai un'entità ricorrente non coperta">
    Se tracci "Pratiche legali" con data udienza, giudice, ruolo, controparte — nessun oggetto standard basta. Crea un oggetto custom.
  </Accordion>

  <Accordion title="Relazioni complesse">
    Es. `Contratto` collegato a `Cliente` + `Progetto` + `Dipendente responsabile` con campi custom. Oggetto dedicato mantiene relazioni esplicite.
  </Accordion>

  <Accordion title="Automazioni specifiche">
    Vuoi workflow su eventi dell'entità (es. "pratica passa a In giudizio"). Solo oggetti (standard o custom) triggerano workflow.
  </Accordion>
</AccordionGroup>

<Note>
  Prima di creare custom: verifica che un oggetto standard + attributi custom non basti. Es. `Fornitore` spesso è solo `Company` con tipo = Fornitore.
</Note>

## Crea un oggetto custom

<Steps>
  <Step title="Impostazioni → Oggetti → + Nuovo oggetto">Solo Admin.</Step>

  <Step title="Definisci">
    * **Nome** singolare (es. `Pratica legale`) e plurale (`Pratiche legali`)
    * **Icona** (Lucide / Font Awesome)
    * **Descrizione**
    * **URL slug** (per API, es. `legal-cases`)
  </Step>

  <Step title="Attributi">
    Aggiungi i campi: nome, data, select, riferimento ad altri record. Vedi [Attributi](/it/arya-101/lezione-3-attributi).
  </Step>

  <Step title="Viste default">
    Quali colonne, quali filtri, vista Kanban (se ha uno status) o tabella.
  </Step>

  <Step title="Permessi">
    Chi può creare, leggere, modificare, eliminare record di questo tipo.
  </Step>

  <Step title="Salva">
    L'oggetto appare nella sidebar. Puoi creare subito il primo record.
  </Step>
</Steps>

## Feature incluse

Ogni oggetto custom ha automaticamente:

<CardGroup cols={2}>
  <Card title="Viste multiple">Kanban, tabella, calendario, Gantt (se ha date).</Card>
  <Card title="Filtri e liste">Statiche e dinamiche come per oggetti standard.</Card>
  <Card title="Automazioni">Trigger e azioni come per oggetti standard.</Card>
  <Card title="AI">AryaChat vede l'oggetto e può rispondere domande.</Card>
  <Card title="Import/export">CSV, Excel.</Card>
  <Card title="API">Accesso programmatico via REST e webhook.</Card>
</CardGroup>

## Relazioni con altri oggetti

Aggiungi attributo **Riferimento** per collegare l'oggetto custom ad altri:

* `Pratica legale → Cliente (Company)`: ogni pratica ha un cliente
* `Pratica legale → Avvocato (Employee)`: chi la segue
* `Cliente → Pratiche legali (lookup inverso)`: sul cliente vedi tutte le sue pratiche

## Modifiche successive

Puoi sempre aggiungere/rimuovere attributi. **Attenzione**:

* Rinominare un attributo è sicuro
* Eliminare un attributo con dati esistenti richiede conferma (Admin)
* Eliminare un attributo lo rimuove **subito** ovunque: maschere di creazione/modifica e tabella dell'oggetto (nessun campo residuo)
* Cambiare tipo di attributo (es. da Text a Number) fallisce se i dati esistenti non sono convertibili

## Eliminazione oggetto

<Warning>
  Eliminare un oggetto custom elimina tutti i suoi record. Irreversibile. Arya richiede doppia conferma e export automatico di backup.
</Warning>

## Limiti

* Max 50 oggetti custom per workspace
* Max 100 attributi per oggetto
* Max 10 livelli di annidamento di riferimenti (per evitare loop)

Limiti estendibili su piani Enterprise.

## Domande frequenti

<AccordionGroup>
  <Accordion title="Posso condividere oggetto custom con altri workspace?">Sì, export come JSON → import. Struttura definizione viene replicata; dati no.</Accordion>
  <Accordion title="Gli oggetti custom appaiono nei report?">Sì. Chart builder li vede come qualsiasi oggetto.</Accordion>
  <Accordion title="Ci sono template di oggetti custom già pronti?">Sì, libreria template in **Impostazioni → Oggetti → Template** — coprono settori come legale, immobiliare, manutenzione, sanità.</Accordion>
</AccordionGroup>