Disponibile con il modulo `GIS` attivo nel progetto.
--- ### Preparare il file Shapefile Il file deve essere caricato in formato **ZIP** e deve contenere i principali componenti dello shapefile: - `.shp` - `.dbf` - `.shx` - `.prj` Tutti i file devono avere **lo stesso nome**. La dimensione massima del file ZIP è **10 MB**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/1-shapefile-structure.png)**È possibile caricare un solo file Shape alla volta.** Ogni caricamento permette di creare oggetti per **una sola classe oggetto**.
--- ### Importare uno Shapefile Per importare uno shapefile: **1)** Apri la tab **Tools** del progetto.  **2)** Clicca sul bottone **Upload Shape**.  **3)** Seleziona il file **ZIP** contenente lo shapefile. **4)** Seleziona la **classe oggetto** in cui importare i dati e clicca sul bottone **Validate** per verificare che il file caricato rispetti i requisiti necessari.  Durante questa fase il sistema esegue automaticamente alcune verifiche. In particolare controlla che: - il sistema di coordinate sia **WGS84** - il tipo di geometria dello shapefile sia compatibile con la classe oggetto selezionata - lo shapefile contenga attributi sufficienti per compilare quelli **obbligatori** della classe oggetto Se i controlli sono superati è possibile continuare con la configurazione dell’importazione. --- ### Associare gli attributi dello shapefile Dopo la verifica del file, viene visualizzata una schermata che consente di **configurare manualmente le associazioni** tra gli attributi. Il sistema propone automaticamente una prima corrispondenza tra gli **attributi presenti nello shapefile** e quelli della **classe oggetto**. La schermata è organizzata in due colonne: - **sinistra:** attributi presenti nello shapefile - **destra:** attributi della classe oggetto  Per ogni attributo della classe oggetto puoi selezionare quale attributo dello shapefile utilizzare. Durante la configurazione vengono mostrati alcuni indicatori visivi che aiutano a completare correttamente l’associazione. In particolare: - Gli attributi obbligatori della classe oggetto selezionata che non sono ancora compilati vengono evidenziati in **rosso**. - Gli attributi dello shapefile già utilizzati risultano **collegati** e vengono evidenziati in **verde**. - Un contatore indica quanti attributi dello shapefile non sono ancora **associati**. È possibile associare solo **attributi dello stesso tipo**. Se un attributo dello shapefile viene riutilizzato, l’associazione precedente viene automaticamente rimossa. Il bottone **Import** diventa disponibile solo quando tutti gli attributi obbligatori sono stati associati. --- ### Avviare l’importazione Quando confermi l’importazione cliccando su **Import**, il sistema avvia il processo di caricamento. Durante questa fase: - Vengono create automaticamente le **istanze della classe oggetto** - Le geometrie vengono importate dallo shapefile - I valori degli attributi vengono compilati secondo le associazioni configurate --- ### Monitorare lo stato dell’importazione Nella tab **Tools**, è disponibile la sezione **Uploads**, che permette di monitorare lo stato dell’importazione dello shapefile. La sezione mostra lo stato e il **progresso di un’importazione in corso** oppure l’**esito dell’ultima operazione completata**. Le informazioni relative all’ultimo upload restano visibili per **4 ore dall'avvio dell'importazione.** È possibile **caricare un solo file Shape alla volta**. Se necessario, il caricamento in corso può essere **annullato tramite il pulsante *Cancel***. --- ### Importazione completata Al termine dell’importazione le geometrie dello shapefile vengono create nella classe oggetto selezionata. Se alcune geometrie risultano **non valide** o **incomplete**, potrebbero non essere importate. La card dell’upload mostra il numero di geometrie create rispetto al totale presente nel file.  Al termine dell’operazione è sempre possibile scaricare il **report dell’importazione**, che contiene il riepilogo degli elementi elaborati e di eventuali problemi riscontrati. --- Suggerimenti utili 💡 **Verifica sempre il sistema di coordinate** Lo shapefile deve utilizzare il sistema di coordinate **WGS84** per essere importato correttamente. 💡 **Usa il report per verificare eventuali problemi** Se l’importazione è parziale, il report permette di identificare rapidamente le geometrie che non sono state importate. --- ### Collegamenti - [Creare una classe oggetto](https://wiki.eaglearca.com/books/oggetti-e-classi-oggetto/page/creare-una-nuova-classe-oggetto "Creare una nuova Classe Oggetto") - [Visualizzare oggetti nella vista 2D o 3D](https://wiki.eaglearca.com/books/oggetti-e-classi-oggetto/page/visualizzare-oggetti-nella-vista-2d-o-3d "Visualizzare oggetti nella vista 2D o 3D") --- ### Problemi comuni| Problema | Soluzione |
|---|---|
| Il file shapefile non viene accettato | Verifica che il file ZIP contenga i file .shp, .dbf, .shx e .prj con lo stesso nome |
| Alcune geometrie non vengono importate | Scarica il report dell’importazione per verificare eventuali errori nei dati |