Configurare e gestire relazioni tra oggetti
Le relazioni permettono di collegare tra loro oggetti appartenenti a classi oggetto diverse, creando legami strutturati tra gli elementi del progetto.
Questo meccanismo consente di rappresentare relazioni logiche tra istanze. Ad esempio, puoi collegare una strada ai pali dell’illuminazione presenti lungo il suo tracciato oppure associare una strada ai segnali stradali installati lungo di essa.
Le relazioni vengono configurate nel Backoffice e utilizzate nei progetti dell'app EA.
Disponibile per backoffice con il modulo modulo-asset-manager attivo nel progetto.
Come funzionano le relazioni
Una relazione collega due classi oggetto:
- Corrente: la classe che stai configurando in questo momento nel Backoffice.
- Collegata: la classe con cui gli oggetti di quella classe saranno collegati.
Quando una relazione è configurata tra due classi, ogni oggetto può essere collegato a una o più istanze della classe relazionata.
Il numero di oggetti collegabili dipende dalla cardinalità della relazione.
Configurare una relazione nel Backoffice
Per configurare una relazione tra classi oggetto, apri il Backoffice, accedi al dettaglio della classe oggetto e seleziona la tab Relations.
Per creare una nuova relazione:
- Clicca sul bottone Add relation.
- Seleziona la classe oggetto collegata.
- Configura le proprietà della relazione.
La configurazione è suddivisa in due sezioni: This object class e Is related to.
Classe oggetto corrente
La sezione This object class rappresenta la classe oggetto che stai modificando.
Questa classe è già definita automaticamente.
In questa sezione puoi configurare:
Cardinalità: seleziona 1 oppure N per indicare quanti oggetti della classe corrente possono essere collegati agli oggetti dell'altra classe.
Required: attiva lo switch se la relazione deve essere obbligatoria per questa classe. Se attivo, un oggetto di questa classe può esistere solo se collegato a almeno un oggetto della classe relazionata.
Solo una delle due classi può essere obbligatoria, rendendo una classe necessaria per l'esistenza dell'altra.
Displayed name: Inserisci il nome con cui questa classe verrà mostrata nella relazione. Se non viene impostato, il sistema utilizza automaticamente il nome della classe collegata.
Attributes to show: Seleziona gli attributi dell’oggetto relazionato mostrati nel dettaglio attributi.
Non possono essere mostrati:
- attributi di tipo relazione
- attributi di tipo Object List
Classe oggetto collegata
La sezione Is related to permette di definire la classe con cui gli oggetti verranno collegati.
Nel campo Object class seleziona la classe oggetto tramite il menu a tendina.
Anche per questa classe puoi configurare:
- cardinalità (1 o N)
- lo switch Required
- il Displayed name
- gli Attributes to show
Cardinalità della relazione
La cardinalità complessiva della relazione dipende dalla combinazione dei valori impostati nelle due sezioni.
Configurazione | Significato |
|---|---|
1 → 1 | un oggetto può essere collegato a un solo oggetto |
1 → N | un oggetto può essere collegato a più oggetti |
N → 1 | più oggetti possono essere collegati a uno |
N → N | più oggetti possono essere collegati tra loro |
Limiti della configurazione
Per garantire la coerenza dei dati, alcune proprietà non possono essere modificate dopo il salvataggio.
Dopo il salvataggio di una relazione, non è possibile modificare:
- la cardinalità
- la classe oggetto collegata
- lo stato Required
Se una relazione viene eliminata, il sistema rimuove automaticamente il collegamento da tutte le istanze coinvolte.
Inoltre, le relazioni tra oggetti possono essere configurate solo tra classi compatibili, in particolare:
- gli oggetti di tipo Global List possono essere relazionati solo con altre Global List;
- gli oggetti di tipo Form o vettoriale possono essere relazionati solo con oggetti dello stesso tipo.
Visualizzare le relazioni nei progetti
Nei progetti, le relazioni tra oggetti sono visibili nel pannello Dettaglio attributi.
Le relazioni vengono mostrate come attributi di tipo relazione, identificabili dall’icona con la doppia freccia. Questo attributo mostra gli oggetti collegati all’oggetto di cui stai visualizzando i dettagli.
Per ogni relazione vengono mostrati:
- il Displayed name dell'oggetto collegato
- il Main Attribute dell’oggetto collegato
- eventuali Attributes to show configurati nel Backoffice
Se la relazione è di tipo 1:N o N:N, viene mostrata una lista di oggetti relazionati.
Modificare le relazioni tra oggetti
Per modificare le relazioni di un oggetto:
- Apri il dettaglio attributi dell’oggetto.
- Clicca sul bottone Edit.
- Aggiungi, sostituisci o rimuovi gli oggetti relazionati.
Gli oggetti possono essere selezionati:
Se la relazione è Required, il sistema blocca il salvataggio finché non viene selezionato almeno un oggetto collegato.
Se stai relazionando un oggetto vettoriale puoi utilizzare la funzione Select on map per scegliere gli oggetti relazionati direttamente dalla mappa.
Puoi selezionare gli oggetti:
- direttamente dalla mappa
- dalla vista Inventory
La selezione è sincronizzata tra le due viste.
Il bottone Save diventa disponibile solo dopo aver selezionato almeno un oggetto valido.
Suggerimenti utili
💡 Configura le relazioni prima di creare molti oggetti
Modificare cardinalità o Required dopo la creazione degli oggetti può essere bloccato dal sistema.
💡 Mostra solo gli attributi necessari
Limitare gli Attributes to show rende il pannello attributi più leggibile.
💡 Usa la selezione da mappa per oggetti geografici
Per oggetti vettoriali la selezione da mappa è spesso più rapida rispetto alla ricerca nella lista.
Collegamenti
- Creare una nuova Classe Oggetto
- Selezionare gli oggetti
- Visualizzare oggetti nella vista Inventory
- Navigare fra le viste
Problemi comuni
Problema | Soluzione |
|---|---|
Non riesco a modificare la cardinalità della relazione | La cardinalità non può essere modificata se esistono già oggetti collegati |
Non riesco a salvare la relazione | Controlla che tutti i campi obbligatori siano compilati |
Non trovo un oggetto da collegare | Verifica che esistano oggetti della classe selezionata |
Ultimo aggiornamento: 9 marzo 2026