App - Funzionalità del progetto

Una guida completa per l’utilizzo delle principali funzionalità dei progetti EagleArca. Include la navigazione in mappa e nell'Inventory, la misurazione, la creazione di oggetti e visualizzazione dei loro dettagli e la sincronizzazione dei dati con il progetto online.

Nozioni di base sulle classi oggetto

Le classi oggetto costituiscono la base strutturale di EagleArca. Definiscono la forma, le proprietà e il comportamento dei dati all’interno della piattaforma.
Ogni elemento che crei o gestisci deriva da una classe oggetto, che funge da modello di riferimento per organizzare i dati in modo coerente e uniforme.


Cos'è una classe oggetto?

Una classe oggetto è una struttura che definisce un tipo di oggetto all’interno di EagleArca.
Stabilisce quali informazioni l’oggetto deve contenere e come questi dati devono essere organizzati.
Ad esempio, una classe oggetto chiamata Albero può prevedere attributi come altezza, latitudine e longitudine.

La classe non contiene i dati effettivi, ma funge da modello per la creazione delle istanze, ovvero gli oggetti reali creati nei progetti.
Ogni istanza segue la struttura stabilita dalla classe di riferimento, garantendo uniformità e coerenza nei dati.

1 - Dettaglio oggetto selezionato.jpg


Concetti chiave


Oggetti Vettoriali: Punto, Linea e Poligono

Gli oggetti vettoriali hanno una geometria associata e sono sempre georiferiti nello spazio. Questi oggetti sono visualizzabili e interrogabili sia dalla mappa che dall'inventory.

Esempio: Un albero può essere rappresentato come un oggetto di tipo punto, con la sua posizione geografica (latitudine, longitudine).

Gli oggetti vettoriali possono essere di tre tipi:

2 - Type oggetti (On map).jpg


Stile degli Oggetti

Gli oggetti vettoriali possono avere una stilizzazione gestita da backoffice per migliorare la loro visualizzazione. Ad esempio:


Global Lists

Le Global Lists sono Classi oggetto che contengono istanze prive di geometria e non vengono visualizzate sulla mappa. Questi oggetti prescindono dal progetto e sono associati a tutta l'organizzazione. Le Global Lists sono utili per memorizzare dati come:

Gli oggetti di tipo Global List sono raggiungibili scegliendo Global Lists dal selettore nella pagina principale dei progetti.


Ultimo aggiornamento: 23 ottobre 2025

Nozioni di base sugli attributi

Gli attributi rappresentano le informazioni che descrivono le caratteristiche di un oggetto in EagleArca.
Ogni oggetto, che si tratti di un albero, di una persona o di un edificio, è composto da uno o più attributi, ciascuno definito da un nome e da un valore.


Cos'è un attributo?

Un attributo è un dato associato a un oggetto. Ogni attributo è composto da:

Ad esempio, un oggetto Albero potrebbe avere l’attributo Altezza con valore 5 metri e l’attributo Sempreverde con valore .

Ogni attributo viene mostrato in modo coerente con il tipo di dato previsto: ad esempio, una barra di testo per un campo testuale, un calendario per una data, un menu a tendina per un elenco di opzioni, o altri elementi dedicati per ogni formato supportato.

1 - Edit attributi.jpg


Attributi di sistema: ID e Unique Identifier

Ogni oggetto ha sempre almeno un attributo: il Codice Univoco, anche chiamato ID. È un codice assegnato automaticamente dal sistema per identificare l’oggetto in modo unico all’interno della piattaforma. Non può essere modificato né eliminato.

Se un oggetto non ha altri attributi configurati, il sistema userà l’ID come riferimento per identificarlo.

2 - ID.jpg


Main Attribute

Il Main Attribute, identificato da un fulmine azzurro, è l’attributo principale dell’oggetto, quello consente di riconoscere rapidamente un oggetto.

3 - Main Attribute.jpg


Attributi obbligatori e bloccati


Tipologie di attributo

Queste sono le tipologie di attributi disponibili per la struttura dati degli oggetti:

5 - Testo (Attribute Type).jpg

6 - Numero (Attribute Type).jpg

7 - Lista Valori (Attribute Type).jpg

8 - Data (Attribute Type).jpg

9 - Allegato (Attribute Type).jpg

10 - Vero  Falso (Attribute Type).jpg

11 - Lista Oggetti (Attribute Type).jpg


Ultimo aggiornamento: 23 ottobre 2025

Visualizzare oggetti in mappa

All’apertura di un progetto visualizzerai la mappa satellitare che si posizionerà automaticamente per inquadrare gli oggetti presenti. Se il progetto è vuoto, la mappa si aprirà in una posizione predefinita generica.


Gestire la visibilità ed il blocco degli oggetti

Per scegliere quali oggetti visualizzare in mappa, premi sul bottone Layers, l’icona con tre pannelli sovrapposti, in alto a destra della mappa. Si apre così il pannello Layer. Per trovare rapidamente una classe oggetto, usa la barra di ricerca posta in alto nel pannello.

1 - Button Layers.png

Per mostrare o nascondere oggetti attiva la modalità Visibility premendo sull'icona dell’occhio nel selettore in alto a destra (già selezionata di default). Premi quindi l'icona con l'occhio sulla destra della classe oggetto che vuoi nascondere o mostrare in mappa.

2 - Visibility Mode.png

Per bloccare la selezione di oggetti attiva la modalità Lock premi sull'icona del lucchetto nel selettore in alto a destra. Premi quindi l'icona con il lucchetto sulla destra della classe oggetto che vuoi bloccare o sbloccare in mappa.

3 - Lock Mode.png


Navigazione in mappa

Puoi visualizzare sulla mappa la tua posizione attuale premendo l'icona con il mirino in alto a destra.

4 - Go To.png

L'inquadratura della mappa si centrerà sulla tua posizione, che visualizzerai come un indicatore azzurro.

Puoi navigare in mappa con pochi semplici gesti


Selezionare oggetti in mappa

Selezione diretta (Direct)

Icona: dito
Stato predefinito: attivo all’ingresso nel progetto
Attivazione: Premi la sua icona nella toolbar, altrimenti apri il menu di selezione e scegli “Direct” dal menu degli strumenti di selezione
Azioni: Premi su un oggetto in mappa per selezionarlo; l’oggetto si evidenzia in blu
Controlli: la selezione compare nel pannello inferiore; premi X nel pannello inferiore a destra per deselezionare

5 - Selezione Diretta (Tool).png

Selezione ad area (Polygon)

Icona: selettore a poligono
Stato predefinito: disattivo
Attivazione: premi la freccia verso il basso accanto all’icona dello strumento corrente e scegli Plygon
Azioni: tieni premuto in mappa per creare il primo vertice, poi premi altrove in mappa per aggiungere altri vertici e definire il poligono di selezione
Controlli (prima della conferma):

6 - Selezione ad area (Tool).png


Gestire la selezione attiva

Il pannello selezione (in basso nello schermo) appare quando c’è almeno un oggetto selezionato e rimane persistente passando tra Mappa e Inventory.

7 - Pannello Selezione.png

Aprire il dettaglio di un oggetto dalla mappa

Dopo la selezione, nel pannello in basso premi il bottone Espandi dell’oggetto per aprire la pagina attributi (come da comportamento in Inventory). Nella pagina attributi puoi consultare (e, se consentito, modificare) i campi; in alto a sinistra c’è l’icona per tornare indietro.

8 - Button Espandi.png

Le stesse dinamiche di multiselezione, apertura dettagli e deselezione descritte nella pagina Inventory valgono anche partendo dalla mappa.


Suggerimenti utili

💡 Ottimizzare la visualizzazione
Se il progetto contiene un numero elevato di oggetti, apri il pannello Layers e usa la modalità Visibility per nascondere le classi non necessarie. In questo modo manterrai la visualizzazione più rapida e facile da consultare.


Ultimo aggiornamento: 20 ottobre 2025

Visualizzare oggetti nell'Inventory

L'Inventory raccoglie tutte le classi oggetto del progetto e, per ciascuna, la lista dei relativi oggetti. Si apre dal progetto premendo Inventory in basso a destra. Da qui è possibile trovare rapidamente una classe, consultare gli oggetti, aprire la mappa sull’elemento selezionato e gestire la selezione attiva senza perdere il contesto.


Cercare e aprire una classe

1 - Inventory View.png


Agire su un oggetto

Vai a mappa

Sull’elenco oggetti, premi su Vai a (icona mirino) per aprire la mappa centrata sull’oggetto. La mappa si posiziona in modo da rendere l’elemento immediatamente visibile

2 - Button Go To.png

Quando usarla: per raggiungere velocemente la posizione di un oggetto o confrontarne la collocazione rispetto ad altri elementi.

Apri dettaglio attributi

3 - Button Espandi.png

Quando usarla: per controlli puntuali, aggiornamenti di campi, verifica di allegati o valori critici.


Gestire la selezione attiva (pannello in basso)

Cosa permette di fare:

4 - Pannello Selezione.png

Quando usarlo: per mantenere il contesto tra più passi (ad esempio, selezionare alcuni oggetti, controllarli in mappa, rientrare in Inventory e rifinire la selezione senza ricominciare da zero).


Sincronizzare

5 - Button Sincronizza.png

Quando usarla: dopo una sessione di rilievo o aggiornamento sul campo, prima di cambiare area o chiudere il turno, o comunque prima di passare il lavoro al team in sede.


Ultimo aggiornamento: 24 ottobre 2025

Creare un oggetto

All’interno di un progetto è possibile creare nuovi oggetti in mappa.
Dopo l’accesso al progetto si apre la vista mappa, da cui puoi disegnare le geometrie e compilare gli attributi associati.


Creare e disegnare un oggetto

Nella parte superiore della schermata è visibile il nome del progetto e un bottone con una X per chiudere e tornare alla lista dei progetti.
Subito sotto si trova la toolbar principale, che contiene gli strumenti di disegno e una chip con il nome dell’oggetto da disegnare selezionato.
All’apertura del progetto, l’oggetto selezionato di default è il primo della lista, in ordine alfabetico.

1_Header + Toolbar.png

Premendo la chip si apre un modale con la lista completa degli oggetti disponibili nel progetto.
Nel modale è presente anche una search bar per filtrare rapidamente.
Dopo aver selezionato l’oggetto desiderato, premi Select per confermare oppure Cancel per chiudere senza modifiche.

2_Modale Selezione Oggetto.png

Le geometrie che puoi creare sono di tre tipi: punto, linea e poligono.
Quando il tool di disegno è attivo, nella parte bassa dello schermo appare una toolbar dedicata con i comandi: Indietro, Avanti, Annulla e Conferma:

3_Toolbar Comandi.png

Punti

Per creare un punto, tieni premuto sulla mappa nel punto desiderato, la geometria viene posizionata.
Per spostarla, tieni premuto su una nuova posizione della mappa.
Quando il punto è corretto, premi Conferma per accettare la geometria.

Linee

Per creare una linea, tieni premuto sulla mappa per aggiungere i vertici.
I vertici con contorno blu e interno bianco rappresentano i punti effettivi della geometria, mentre quelli con contorno blu e interno azzurro sono vertici “fantasma” che puoi aggiungere premendoli e trascinandoli nello spazio di lavoro.
Per eliminare un vertice, tieni premuto su di esso.
Quando la linea è completa, premi Conferma per salvare la geometria.

Poligoni

Per creare un poligono, tieni premuto sulla mappa per aggiungere i vertici, dal terzo vertice in poi appare un’anteprima del poligono chiuso.
Puoi continuare ad aggiungere punti, dividere segmenti usando i vertici "fantasma" o eliminare vertici tenendo premuto su di essi.
Quando il poligono è completo, premi Conferma per salvare la geometria.


Compilare gli attributi

Dopo aver confermato la geometria, si apre la pagina di compilazione degli attributi.
Qui puoi inserire tutte le informazioni richieste per completare l’istanza dell’oggetto.
In fondo alla pagina si trovano i bottoni Annulla e Salva.
Il bottone Save potrebbe essere disabilitato nel caso siano presenti attributi obbligatori. In questo caso si abilita solo quando tutti i campi obbligatori sono compilati.

Gli oggetti possono includere diversi tipi di attributi, ciascuno con modalità di inserimento specifiche:

4 - Compilazione Attributi.jpg


Proprietà degli attributi

Alcuni attributi possono avere proprietà specifiche, segnalate da icone accanto al nome del campo:

Alcuni attributi obbligatori possono avere un valore precompilato per facilitare il salvataggio rapido.
Questi valori possono comunque essere modificati prima della conferma definitiva.


Salvataggio e sincronizzazione

Dopo il salvataggio, l’oggetto viene mostrato in mappa e nella sezione Inventory con lo stato non sincronizzato.
Significa che l’oggetto è salvato solo nel dispositivo e può ancora essere modificato o eliminato.
Se il progetto viene rimosso dal dispositivo prima della sincronizzazione, l’oggetto viene perso definitivamente.

Consulta la pagina Sincronizzare gli oggetti per conoscere i passaggi per la sincronizzazione.


Suggerimenti utili

💡 Controlla l’oggetto selezionato
Verifica che la chip mostri l’oggetto corretto prima di iniziare il disegno.

💡 Compila sempre i campi obbligatori
Il salvataggio è possibile solo quando tutti i campi richiesti sono completati.

💡 Sincronizza regolarmente
Gli oggetti non sincronizzati restano solo sul dispositivo; sincronizzali per renderli disponibili su altri dispositivi e sul web.


Problemi comuni

Problema Soluzione
Non riesco a creare la geometria Verifica che il tool di disegno sia selezionato nella toolbar
Il bottone Save è disabilitato Controlla che tutti i campi obbligatori siano compilati
Ho perso un oggetto non sincronizzato Gli oggetti non sincronizzati vengono eliminati se il progetto viene rimosso dal dispositivo

Ultimo aggiornamento: 24 ottobre 2025

Modificare o eliminare un oggetto

È possibile modificare o eliminare solo gli oggetti non sincronizzati, ovvero quelli creati sul dispositivo e non ancora inviati al server.
Gli oggetti già sincronizzati o scaricati insieme al progetto possono essere solo visualizzati.


Modificare le geometrie

Quando si seleziona un oggetto non sincronizzato sulla mappa, la toolbar cambia automaticamente mostrando gli strumenti di modifica.
Gli strumenti disponibili dipendono dal tipo di geometria:

1 - Toolbar Edit (Point).png

2 - Toolbar Edit (Line o Polygon).png

Selezionando Sposta, il punto entra in modalità modifica.
Compare la toolbar inferiore con i comandi Undo, Redo, Annulla e Conferma.
Per spostare il punto, tienilo premuto sulla mappa e trascinalo nella nuova posizione.

Quando la posizione è corretta, premi Conferma per salvare la modifica e tornare alla vista del progetto.

Per le linee e i poligoni, premendo Modifica vertici la geometria entra in modalità di modifica.
Anche in questo caso compare la toolbar inferiore con i comandi Indietro, Avanti, Annulla e Conferma.
Nella geometria vengono mostrati i vertici esistenti e i vertici “fantasma”, che possono essere spostati o modificati liberamente.

3 - Toolbar (Edit).png

Nel caso delle linee, la geometria non può essere salvata con meno di due vertici.
Nel caso dei poligoni, non può essere salvata con meno di tre vertici.
Dopo aver completato le modifiche, premi Conferma per salvare e tornare alla schermata principale del progetto.


Modificare gli attributi

Per modificare gli attributi di un oggetto non sincronizzato, apri i dettagli dell’oggetto.
In alto a destra è presente il bottone Modifica, rappresentato da un’icona a forma di matita.
Premendolo, la schermata passa in modalità di compilazione: tutti gli attributi diventano modificabili, a eccezione di quelli bloccati.

4 - Button Edit Attribute + Badge.png

In fondo alla pagina si trovano i bottoni Annulla e Salva.

5 - Button Cancel + Save.png


Eliminare un oggetto

Gli oggetti non sincronizzati possono essere eliminati direttamente dalla mappa.
Seleziona l’oggetto: la toolbar mostrerà il bottone Elimina.
Premendolo, viene mostrato un modale di conferma che chiede di procedere o annullare l’operazione.

6 - Eliminare un oggetto.jpg

Confermando, l’oggetto viene rimosso dal progetto e scompare dalla mappa.
Se si sceglie Annulla, il modale si chiude senza modifiche e l’oggetto resta disponibile.

L’eliminazione rimuove l’oggetto solo dal dispositivo locale e non influisce sulle versioni sincronizzate o presenti su altri dispositivi.
Una volta eliminato, l’oggetto non può essere recuperato.


Suggerimenti utili

💡 Verifica lo stato dell’oggetto
Solo gli oggetti non sincronizzati possono essere modificati. Gli altri sono in sola lettura.

💡 Controlla i campi obbligatori
Un attributo vuoto impedisce il salvataggio. Completa tutti i campi richiesti prima di confermare.

💡 Elimina solo quando necessario
La rimozione di un oggetto è definitiva sul dispositivo. Controlla sempre che sia quello corretto prima di confermare l’eliminazione.


Problemi comuni

Problema Soluzione
Non vedo i tool di modifica Verifica che l’oggetto non sia sincronizzato e che sia selezionato in mappa
Non riesco a modificare un oggetto sincronizzato Se l'oggetto che stai tentando di modificare è stato sincronizzato, devi accedere da piattaforma web per poter procedere con la modifica.
Il bottone Save è disabilitato Controlla che tutti i campi obbligatori siano compilati
Non riesco a salvare la geometria Assicurati che la linea abbia almeno due vertici o il poligono almeno tre

Ultimo aggiornamento: 24 ottobre 2025

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.

Assicurati di essere connesso a internet prima di avviare la sincronizzazione.


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


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

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

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

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

Puoi selezionare solamente oggetti non sincronizzati e/o classi oggetto contenenti oggetti non ancora sincronizzati.


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

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

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.


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

Problema Soluzione
Il bottone Sincronizza non è attivo Controlla di aver selezionato almeno un oggetto o una classe da sincronizzare.
La connessione si interrompe Riprova la sincronizzazione quando la rete è stabile.
Non vedo il pallino azzurro sull'oggetto L’oggetto è già sincronizzato o non è modificabile.

Ultimo aggiornamento: 24 ottobre 2025