Importare file Shape
Lo strumento Upload Shape permette di importare dati geografici in formato Shapefile e creare automaticamente nuovi oggetti all’interno di una classe oggetto del progetto.
Durante l’importazione, le geometrie presenti nello shapefile vengono convertite in istanze della classe oggetto selezionata e gli attributi vengono compilati utilizzando i valori presenti nel file.
Disponibile con il modulo GIS attivo nel progetto.
Preparare il file Shapefile
Prima di procedere con l’importazione è necessario preparare correttamente lo 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.
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 (punto, linea o poligono)
- 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, il sistema propone una prima associazione tra gli attributi dello shapefile e quelli della classe oggetto.
Cliccando sul bottone Continue si apre una schermata che permette di configurare manualmente le associazioni.
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 non compilati vengono evidenziati
- gli attributi dello shapefile già utilizzati risultano collegati
- 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
La versione aggiornata dello strumento introduce una sezione che permette di monitorare lo stato dell’importazione.
Nella tab Tools, sotto il bottone Upload Shape, è disponibile la sezione Uploads., che permette di monitorare lo stato dell’importazione dello shapefile.
QuestaLa sezione mostra lo stato dell’ultimoe tentativoil progresso di un’importazione edin ècorso visibileoppure l’esito dell’ultima operazione completata.
Le informazioni relative all’ultimo upload restano visibili per circa 4 ore dopo il termine dell’importazione.
Mentre
Importazioneun caricamento è in corso
Durante il caricamento viene mostrata una card con:
barra di avanzamentopercentuale di completamentonumero di elementi elaborati
Durante questa fasecorso, il bottone Upload Shape è temporaneamentedisabilitato disabilitato.
l’operazione non sarà terminata. È inoltre disponibile anche il bottone Cancel, che permette di interrompere l’importazione.importazione.
Importazione completata
Quando l’importazione termina, la sezione Uploads mostraSe il risultatoprocesso finale.
Sonocompletato possibili due risultati:
Importazione completata con successo
Tuttecorrettamente, le geometrie dello shapefile sono statevengono importate correttamente.
Importazioneclasse completataoggetto parzialmente
AlcuneIn alcuni casi potrebbero non essere importati tutti gli elementi presenti nel file, ad esempio se alcune geometrie non sono state importate perchérisultano non valide o incomplete.
In
Al itermine casidell’operazione è sempre possibile scaricare il report dell’importazione., che contiene il riepilogo degli elementi elaborati e di eventuali problemi riscontrati.
Report dell’importazione
Al termine del processo viene generato automaticamente un file di report scaricabile.
Il report contiene informazioni utili sull’importazione, tra cui:
numero totale di geometrie elaborateelementi importati con successoeventuali elementi ignoratipossibili problemi riscontrati durante l’importazione
Il report può essere scaricato nuovamente dalla sezione Uploads.
Suggerimenti utili
💡 Verifica sempre il sistema di coordinate
Lo shapefile deve utilizzare il sistema di coordinate WGS84 per essere importato correttamente.
💡 Controlla gli attributi obbligatori
Prima di avviare l’importazione assicurati che tutti gli attributi obbligatori della classe oggetto siano associati.
💡 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
Definire gli attributi di una classe oggettoImportare dati nel progetto- 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 |
| L’importazione non parte | Controlla che tutti gli attributi obbligatori della classe oggetto siano associati |
| Alcune geometrie non vengono importate | Scarica il report dell’importazione per verificare eventuali errori nei dati |
| Il bottone Import non è disponibile | Completa l’associazione degli attributi obbligatori nella schermata di configurazione |
Ultimo aggiornamento: 5 marzo 2026