# Sincronizzare gli oggetti

La sincronizzazione permette di inviare al server centrale gli oggetti creati o modificati localmente, rendendoli disponibili anche su altri dispositivi e sul portale web.  
Solo gli oggetti **non sincronizzati** possono essere inviati. Dopo la sincronizzazione, non sono più modificabili.

<p class="callout info">Assicurati di essere connesso a internet prima di avviare la sincronizzazione.</p>

---

### Riconoscere gli oggetti non sincronizzati

In **mappa** e nella sezione **Inventory**, gli oggetti non sincronizzati sono indicati da un **pallino azzurro**.  
Questo simbolo mostra che l’oggetto è salvato solo sul dispositivo e deve ancora essere caricato nel progetto web.

[![1 - Oggetto selezionato non sincronizzato.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/1-oggetto-selezionato-non-sincronizzato.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/1-oggetto-selezionato-non-sincronizzato.png)

---

### La pagina di sincronizzazione

Nella sezione **Inventory**, in alto a destra, è presente il bottone **Sincronizza**.  
Premendolo si apre una nuova pagina che mostra tutte le **classi oggetto** presenti nel progetto. Se sono presenti istanze non sincronizzate queste vengono elencate sotto la rispettiva classe oggetto.

[![2 - Button Sincronizza.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/2-button-sincronizza.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/2-button-sincronizza.png)  
  
Gli oggetti possono essere selezionati in tre modi:

1. **Oggetti singoli** – spunta le istanze tramite la checkbox accanto a ciascun elemento.  
    Esempio: se ci sono 10 cartelli stradali, puoi selezionarne 8.

[![3 - Sincronizza (Oggetti Singoli).png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/3-sincronizza-oggetti-singoli.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/3-sincronizza-oggetti-singoli.png)

**2. Intera classe oggetto** – spunta la checkbox accanto al nome della classe per selezionare tutte le istanze di quella classe.  
Esempio: selezionando la classe *Cartelli stradali*, vengono selezionati tutti e 10 gli oggetti. Possono comunque essere deselezionati singolarmente.

[![4 - Sincronizza (Intera Classe Oggetto).png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/4-sincronizza-intera-classe-oggetto.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/4-sincronizza-intera-classe-oggetto.png)

**3. Tutto** – spunta la checkbox accanto a **“Seleziona tutto”** per selezionare tutti gli oggetti.  
Esempio: se ci sono 10 cartelli stradali e 12 pozzetti, verranno selezionati 22 oggetti in totale. Possono comunque essere deselezionati singolarmente.

[![5 - Sincronizzza (Tutto).png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/5-sincronizzza-tutto.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/5-sincronizzza-tutto.png)

<p class="callout info">Puoi selezionare solamente oggetti non sincronizzati e/o classi oggetto contenenti oggetti non ancora sincronizzati.</p>

---

### Metadati e allegati

Nella schermata di sincronizzazione, a destra di ogni classe e di ogni oggetto, sono presenti due colonne che indicano il tipo di dati disponibili per la sincronizzazione:

[![6 - Icon Metadati e Allegati.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/6-icon-metadati-e-allegati.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/6-icon-metadati-e-allegati.png)

- **Metadati:** includono informazioni testuali e numeriche, come nomi, valori, date e attributi descrittivi. Sono dati leggeri e vengono caricati più rapidamente.
- **Allegati:** comprendono file associati all’oggetto, come immagini, video o documenti. Sono più pesanti e richiedono più tempo per il caricamento.

Dopo aver selezionato uno o più oggetti, premi il bottone **Sincronizza** in basso nella schermata.  
Si apre un modale che chiede **quali di questi dati sincronizzare**. Puoi selezionarne solo uno dei due o entrambi.

[![7 - Modale Sincronizzazione.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/7-modale-sincronizzazione.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/7-modale-sincronizzazione.png)

<p class="callout info">La scelta è utile per gestire il tempo e la connessione del dispositivo:  
i metadati si caricano più velocemente, mentre gli allegati possono essere inviati in un secondo momento, quando è disponibile più tempo o una connessione stabile.</p>

---

### Completamento della sincronizzazione

Una volta confermata la scelta, parte il processo di caricamento. Durante la sincronizzazione l’app è temporaneamente bloccata per evitare modifiche ai dati in upload.  
Al termine, gli oggetti sincronizzati non mostrano più il pallino azzurro.  
Diventano a tutti gli effetti oggetti sincronizzati e non possono più essere modificati localmente.

Se sono stati sincronizzati solo i **metadati**, ma non gli **allegati**, l’oggetto resta non modificabile, ma può essere nuovamente selezionato in seguito nella pagina di sincronizzazione per caricare gli allegati mancanti.

---

### Suggerimenti utili

💡 **Sincronizza regolarmente**  
Esegui la sincronizzazione appena torni online per evitare la perdita di dati o conflitti tra dispositivi.

💡 **Gestisci i tempi di upload**  
Con connessioni lente, sincronizza prima i metadati e rimanda gli allegati a quando avrai più tempo o una rete stabile.

💡 **Non interrompere la sincronizzazione**  
Durante l’upload non chiudere l’app o il progetto, per evitare errori o perdita di dati.

💡 **Verifica i dati sincronizzati**  
Dopo la sincronizzazione, apri il progetto online per assicurarti che gli oggetti siano stati caricati correttamente.

---

### Problemi comuni

<table border="1" id="bkmrk-sincronizzare-oggetti" style="border-collapse: collapse; border-style: solid;"><tbody><tr><th>Problema</th><th>Soluzione</th></tr><tr><td>Il bottone Sincronizza non è attivo</td><td>Controlla di aver selezionato almeno un oggetto o una classe da sincronizzare.</td></tr><tr><td>La connessione si interrompe</td><td>Riprova la sincronizzazione quando la rete è stabile.</td></tr><tr><td>Non vedo il pallino azzurro sull'oggetto</td><td>L’oggetto è già sincronizzato o non è modificabile.</td></tr></tbody></table>

---

***Ultimo aggiornamento:** 24 ottobre 2025*