Configurare relazioni tra classi oggetto
Gestire le 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 nel FrontOffice durante la gestione degli oggetti.
Disponibile per backoffice con il modulo modulo-asset-manager attivo nel progetto.
Come funzionano le relazioni
Una relazione collega due classi oggetto:
Classe oggetto corrente
La classe che stai configurando nel BackOffice.
Classe oggetto collegata
La classe con cui gli oggetti possono essere 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.
Required
Attiva lo switch Required se la relazione deve essere obbligatoria per questa classe.
Se attiva, l’oggetto non potrà essere salvato senza almeno un collegamento.
Displayed name
Inserisci il nome con cui la relazione verrà mostrata nel progetto.
Se non viene impostato, il sistema utilizza automaticamente il nome della classe collegata.
Attributes to show
Seleziona gli attributi dell’oggetto relazionato che devono essere mostrati nel FrontOffice.
Non possono essere selezionati:
- 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.
Se esistono già oggetti collegati, 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.
Visualizzare le relazioni nel FrontOffice
Nel FrontOffice puoi visualizzare le relazioni nel pannello attributi di un oggetto.
Quando un oggetto è collegato ad altri oggetti, compare una sezione dedicata alle relazioni.
Per ogni relazione vengono mostrati:
- il Displayed name della relazione
- 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.
Selezione da mappa
Per oggetti vettoriali puoi utilizzare la funzione Select on map per scegliere gli oggetti relazionati direttamente dalla mappa.
Quando questa modalità è attiva:
- la mappa viene mostrata a schermo intero
- vengono evidenziate solo le istanze compatibili con la relazione
- gli altri oggetti risultano non selezionabili
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 classe oggetto
- Selezionare gli oggetti
- Visualizzare oggetti nella vista Inventory
- Navigare tra 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 |
| Il salvataggio è bloccato | Se la relazione è Required, seleziona almeno un oggetto collegato |
| Non trovo un oggetto da collegare | Verifica che esistano oggetti della classe selezionata |
Ultimo aggiornamento: 4 marzo 2026