# Gestire gli oggetti nel progetto

Questa sezione spiega come creare oggetti all’interno del progetto. Gli oggetti possono essere **geometrie vettoriali**, come punti, linee o poligoni, oppure **oggetti non vettoriali**, detti **form**.

---

### Tipi di oggetti

Nel progetto puoi creare diverse tipologie di oggetti:

- **Punti**: Elementi singoli posizionabili su viste 2D e 3D.  
    *Esempio*: Sensore, segnaposto.
- **Linee**: Sequenze di punti collegati per formare percorsi.
    
    *Esempio*: Tracciati di infrastrutture.
- **Poligoni**: Aree delimitate da più vertici.  
    *Esempio: Delimitazione di zone di lavoro.*
- **Form**: Oggetti non vettoriali, senza geometria, usati per inserire dati tramite attributi.  
    *Esempio*: Moduli informativi.

---

### Creazione di Oggetti

#### Form (Oggetti non vettoriali)

- Apri la **vista Inventory** della classe oggetto desiderata.

[![1 - Inventory View.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/5uP1-inventory-view.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/5uP1-inventory-view.png)

- Clicca sul bottone **Nuovo oggetto** (con icona +) in alto a destra.
- Si apre il **pannello attributi** per la compilazione dei dati.

#### Geometrie (Oggetti vettoriali)

<p class="callout info">Disponibile con `modulo-gis-2d` e `modulo-3d` attivi nel progetto.</p>

**1. Seleziona lo strumento Disegna**: Clicca sull’icona della **matita con +** nella toolbar (appare in hover) nelle viste 2D e 3D. 2. **Seleziona il tipo di oggetto**: Clicca sul bottone accanto allo strumento Disegna.

- Usa la **searchbar** in cima alla lista per una ricerca rapida.
- Controlla l’**anteprima della stilizzazione**.

[![2 - Tool Draw.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-tool-draw.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/2-tool-draw.png)

**2. Disegna l’oggetto**:

- **Punto**: Clic sinistro per posizionare.
- **Linea**: Clic sinistro per inserire vertici, **Clic destro per chiudere**.
- **Poligono**: Clic sinistro per inserire vertici (l'anteprima appare dopo il 3° vertice), **Clic destro per chiudere**.
- **In vista 3D**: Assicurati che l'oggetto sia creato **sulla superficie** della mesh o della nuvola di punti.

**3. Conferma la geometria**: Si apre il **pannello attributi** per la compilazione.

<p class="callout warning">**Nella vista 2D** gli oggetti possono essere posizionati liberamente sulla mappa. **In quella 3D** gli oggetti devono essere creati necessariamente sulla superficie della mesh o della nuvola di punti.</p>

---

### Compilazione degli Attributi

Dopo la creazione, il **pannello attributi** permette di inserire le informazioni richieste.

<p class="callout info">*L’oggetto non può essere salvato finché tutti i **campi obbligatori** non sono compilati*.</p>

#### Struttura del Pannello

- **Bottoni Annulla** e **Salva** in alto a destra.
- **Searchbar** in alto, per individuare rapidamente gli attributi.
- **Bottone Espandi** in alto a sinistra per il full screen.

[![3 - Obj Details.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/3-obj-details.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/3-obj-details.png)

#### Tipi di Attributi

Gli oggetti possono avere i seguenti tipi di attributi:

- **Testo**: Lettere e numeri (possibile lunghezza massima).

[![4 - Text Box.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/4-text-box.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/4-text-box.png)

- **Numeri**: Valori numerici (possibile *range* predefinito).

[![5 - Numbers.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/5-numbers.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/5-numbers.png)

- **Lista valori**: Selezione di uno o più valori da un menu a tendina.

[![6 - Value List.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/6-value-list.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/6-value-list.png)

- **Data**: Scelta di una data.

[![7 - Date.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/7-date.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/7-date.png)

- **Allegati**: Caricamento di immagini, documenti o video.

[![8 - Attachments.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/8-attachments.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/8-attachments.png)

- **Dimensione**: (Solo vettoriali) Calcolata automaticamente dal sistema (coordinate/lunghezza/area).

[![9 - Size.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/9-size.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/9-size.png)

- **Vero/Falso**: Scelta tra i due valori vero/falso.

[![10 - True or False.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/10-true-or-false.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/10-true-or-false.png)

- **Lista oggetti**: Aggiunta di sotto-attributi correlati (possono essere di tipo Testo, Numeri, Lista valori, Data, Vero/Falso).

[![11 - Obj List.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/11-obj-list.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/11-obj-list.png)

#### Proprietà degli Attributi

<table border="1" id="bkmrk-icona%2Findicatore-pro" style="border-collapse: collapse; width: 100%; border-style: solid;"><thead><tr><td>**Icona/Indicatore**</td><td>**Proprietà**</td><td>**Descrizione**</td></tr></thead><tbody><tr><td>**\*** (Asterisco)</td><td>**Obbligatorio**</td><td>Il campo deve essere compilato per salvare l’oggetto. *Può avere un **valore precompilato** modificabile*.</td></tr><tr><td>**🔒** (Lucchetto)</td><td>**Bloccato**</td><td>Il campo non è modificabile.</td></tr><tr><td>**⚡** (Fulmine azzurro)</td><td>**Attributo principale**</td><td>È obbligatorio e aiuta a riconoscere rapidamente l’istanza.</td></tr></tbody></table>

---

### Assegnare Data Source ad un oggetto

<p class="callout info">Disponibile solo con `modulo-IoT` attivo nel progetto.</p>

Una data source è una fonte che raccoglie dati nel tempo; associata a un oggetto, consente di visualizzare tali dati come grafici nel menu Dettaglio attributi.

[![12 - Data Sources.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/12-data-sources.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/12-data-sources.png)

È possibile assegnare una data source in due momenti distinti:

- **Durante la creazione** Mentre si disegna la geometria per inserire il nuovo oggetto in mappa.
- **Dopo la creazione** Modificando i dati dell'oggetto esistente, se si hanno i permessi necessari.

#### Procedura di Assegnazione

##### Durante la Creazione di un Nuovo Oggetto

**1.** Durante l'inserimento dell'oggetto, si apre il menu di configurazione.

**2.** Spostati nella sezione **Data Sources**.

**3.** Clicca nel campo di selezione e scegli una delle opzioni disponibili dall'elenco (se la data source è già stata configurata per la classe oggetto).

##### Ad un Oggetto esistente

**1.** Apri il menu **Dettaglio attributi** dell'oggetto:

- Seleziona l'oggetto nella vista 2D/3D con un clic sinistro e clicca **Espandi** (icona con due frecce) nel *tooltip*.
- Oppure, fai clic sul sul **bottone Apri** che appare al passaggio del mouse sull'oggetto nella vista **Inventory**.

**2.** Clicca sul pulsante **Modifica** per accedere alla modalità di modifica.

**3.** Spostati nella sezione **Data Sources**.

Clicca nel campo di selezione e scegli una delle opzioni disponibili dall'elenco.

---

### Gestione e Modifica di Oggetti Vettoriali

Questa sezione fornisce le indicazioni schematiche relative allo spostamento, rotazione, modifica dei vertici e all'eliminazione degli oggetti.

<p class="callout info">Disponibile con `modulo-gis-2d` e `modulo-3d` attivi nel progetto.</p>

####   
Spostare un Oggetto

Lo strumento **Sposta** consente di riposizionare con precisione gli oggetti selezionati.

[![13 - Tool Move.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/13-tool-move.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/13-tool-move.png)

**1.** <span class="">Seleziona uno o più oggetti.</span>

**2.** <span class="">Clicca sul bottone </span>**Sposta**<span class=""> nella toolbar.</span>

**3.** <span class="">Afferra e sposta liberamente l'oggetto; è supportato lo </span>*snap*<span class=""> con altri oggetti sulla mappa.</span>

**4.** <span class="">Clicca </span>**Conferma**<span class=""> per salvare la nuova posizione (è disabilitato se non c'è stato spostamento). </span><span class="">Clicca </span>**Annulla**<span class=""> per ripristinare la posizione originale.</span>

<p class="callout warning"><span class="">Gli oggetti creati in </span>**2D**<span class=""> sono spostabili solo in </span>**2D**<span class="">.</span><span class=""> Linee e Poligoni </span>**non sono spostabili in 3D**<span class="">.</span></p>


####   
Ruotare un Oggetto

La rotazione modifica l'orientamento di oggetti di tipo **Linea** o **Poligono**.

[![14 - Rotate.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/14-rotate.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/14-rotate.png)

**1.** <span class="">Seleziona uno o più oggetti.</span>

**2.** Clicca sul bottone **Ruota** nella toolbar. Appare un rettangolo con una **maniglia** attorno all’oggetto.

**3.** Trascina la maniglia per ruotare l'oggetto. La rotazione multipla avviene attorno al **punto di pivot** centrale.

**4.** Clicca **Conferma** per salvare la nuova rotazione (è disabilitato se non c'è stata rotazione). Clicca **Annulla** per annullare e ripristinare l'orientamento originale.

<p class="callout warning">Gli oggetti creati in **2D** sono ruotabili solo in **2D**. Gli oggetti **non sono ruotabili in 3D**.</p>


####   
Modificare i Vertici di un Oggetto

Questo strumento modifica (sposta/aggiunge/corregge) i vertici di **Linee** e **Poligoni**.

[![15 - Edit Vertex.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/15-edit-vertex.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/15-edit-vertex.png)

**1.** <span class="">Seleziona una **linea** o un **poligono**.</span>

**2.** Clicca sul bottone **Modifica vertici** nella toolbar. Tutti i vertici diventano visibili (modalità edit).

**3. Modifica:**

- **Sposta** trascinando un vertice esistente.
- **Aggiungi** un vertice cliccando sul *vertice fantasma* che compare lungo il segmento.
- Nella **vista 2D** è possibile usare lo *snap* con altre geometrie.
- Nella **vista 3D** è possibile modificare i vertici di più oggetti selezionati contemporaneamente.

**4.** Clicca **Conferma** per salvare la modifica (è disabilitato finché non viene effettuata una modifica). Clicca **Annulla** per annullare tutte le modifiche ai vertici.

<p class="callout warning">Gli oggetti creati in **2D** possono essere modificati solo in **2D**. Gli oggetti creati in **3D** possono essere modificati solo in **3D**.</p>


####   
Eliminare un Oggetto

Questa funzione elimina definitivamente gli oggetti selezionati in tutte le viste.

**1.** Seleziona uno o più oggetti (in 2D/3D o Inventory).

**2.** Clicca sul bottone **Elimina** (nella toolbar per 2D/3D, in alto a destra per Inventory).

**3.** Si apre un modale con la lista delle classi oggetto selezionate, ciascuna con una *checkbox*.

[![16 - Delete.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/16-delete.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/16-delete.png)

**4.** Usa le *checkbox* per specificare cosa eliminare.

**5.** Clicca **Conferma** per procedere con l'eliminazione. Clicca **Annulla** per chiudere il modale senza modifiche.

<p class="callout info">Il bottone **Conferma** è disabilitato se tutte le classi oggetto sono deselezionate.</p>

**5. Feedback:** In basso a sinistra compare una **scritta informativa** che indica l'esito dell’operazione.

---

### Suggerimenti

**💡 Ricerca rapida** Usa la **searchbar** nella *select* degli oggetti (in fase di disegno) o nel pannello attributi per trovare rapidamente l’elemento desiderato.

**💡 Attributi Precompilati** Verifica che i valori precompilati (se presenti in campi obbligatori) siano corretti prima di salvare.

**💡 Vista Corretta per la Modifica** Modifica l’oggetto nella vista corrispondente alla sua origine (2D se creato in 2D, 3D se creato in 3D).

**💡 Verifica Classi durante l'eliminazione** Controlla sempre le *checkbox* nel modale prima di confermare per evitare di eliminare oggetti non desiderati.

---

### Collegamenti

- *[Creare e gestire le Classi Oggetto](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-le-classi-oggetto "Creare e gestire le Classi Oggetto")*
- *[Introduzione alle Classi Oggetto](https://wiki.eaglearca.com/books/access-and-overview/page/introduzione-alle-classi-oggetto "Introduzione alle Classi Oggetto")*
- [*Navigare tra le viste*](https://wiki.eaglearca.com/books/funzionalita-dellapp/page/navigare-tra-le-viste "Navigare tra le viste")

---

### Problemi comuni

<table border="1" id="bkmrk-problema-soluzione-n-1" style="border-collapse: collapse; width: 100%; border-style: solid; height: 301.766px;"><thead><tr style="height: 29.7969px;"><td style="width: 39.4492%; height: 29.7969px;">**Problema**</td><td style="width: 60.5508%; height: 29.7969px;">**Soluzione**</td></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 39.4492%; height: 29.7969px;">Non riesco a salvare l’oggetto.</td><td style="width: 60.5508%; height: 29.7969px;">Assicurati di aver compilato **tutti i campi obbligatori** (indicati con asterisco).</td></tr><tr style="height: 46.5938px;"><td style="width: 39.4492%; height: 46.5938px;">Non riesco a creare un oggetto in 3D.</td><td style="width: 60.5508%; height: 46.5938px;">Verifica che la geometria sia posizionata **sulla superficie** della mesh o della nuvola di punti.</td></tr><tr style="height: 29.7969px;"><td style="width: 39.4492%; height: 29.7969px;">La linea e il poligono non si chiudono.</td><td style="width: 60.5508%; height: 29.7969px;">Usa il **clic destro** per completare la geometria.</td></tr><tr style="height: 29.7969px;"><td style="width: 39.4492%; height: 29.7969px;">L'oggetto non si muove.</td><td style="width: 60.5508%; height: 29.7969px;">Verifica di aver selezionato lo strumento **Sposta**.</td></tr><tr style="height: 29.7969px;"><td style="width: 39.4492%; height: 29.7969px;">L'oggetto non ruota.</td><td style="width: 60.5508%; height: 29.7969px;">Verifica di aver selezionato lo strumento **Ruota**.</td></tr><tr style="height: 29.7969px;"><td style="width: 39.4492%; height: 29.7969px;">Non riesco a spostare un vertice.</td><td style="width: 60.5508%; height: 29.7969px;">Verifica di aver selezionato lo strumento **Modifica vertici**.</td></tr><tr style="height: 46.5938px;"><td style="width: 39.4492%; height: 46.5938px;">Non riesco ad aggiungere un nuovo vertice.</td><td style="width: 60.5508%; height: 46.5938px;">Avvicina il mouse a un segmento per far comparire il vertice fantasma, quindi clicca o trascina.</td></tr><tr style="height: 29.7969px;"><td style="width: 39.4492%; height: 29.7969px;">Non riesco a eliminare un oggetto.</td><td style="width: 60.5508%; height: 29.7969px;">Verifica di aver selezionato almeno un oggetto nella mappa o in Inventory.</td></tr></tbody></table>

---

***Ultimo aggiornamento:** 10 Novembre 2025*