Configure relations between objects

IT

---

English

Relations are an attribute type that allows you to connect objects belonging to different object classes, creating structured links between the elements of the project.

This function allows you to represent logical relationships between instances. For example, you can connect a road to the lighting poles along its route, or associate a road with the road signs installed along it.

Relations are configured during the creation or editing of an object class, inside a dedicated section.

Available only to users with backoffice permissions.

---

How relations work

A relation always connects two object classes:

• Current object class
  This is the class you are configuring at that moment in the Backoffice.
  
• Linked object class
  This is the class with which the objects of the current class can be linked.

When a relation is configured between two classes, objects can be associated with one or more instances of the related class.

The number of objects that can be linked depends on the cardinality set in the relation.

---

Set up relations

To configure a relationship between object classes, open the Backoffice, access the edit page of an object class, and select the Relations tab.

To create a new relationship, click the Add relation button.

The configuration is divided into two sections: This object class and Is related to.

Current object class

The This object class section represents the object class you are editing.
The Object class field is filled in automatically and cannot be edited.

In this section, you can configure:

• Cardinality: select 1 or N to indicate how many objects of the current class can be linked to objects of the other class.
  
• Required: activate the switch if this object class is necessary for the existence of the other one.
  If the switch is active, an object of the other class can exist only if it is linked to an object of this class.
  
• Displayed name: when an object with a relationship is created and displayed in the app, the relationship attribute has a name. If necessary, you can enter the name with which this class is shown in the relationship.
  If no name is set, the system automatically uses the name of the object class.
  
• Attributes to show: when an object with a relationship is created and displayed in the app, the related object class appears in the relationship attribute. The related class can be expanded to show a preview of its attributes. With this field, you can choose which attributes to show. You cannot select attributes of type relationship or object list.

Linked object class

The Is related to section allows you to define the object class to link to the current class.
In the Object class field, select from the dropdown menu the class with which to create the relationship.

You can also configure the following fields for this class:

• Cardinality: select 1 or N to indicate how many objects of the linked class can be associated with an object of the current class.
  
• Required: activate the switch if the linked object class is necessary for the existence of the current class.
  If the switch is active, an object of the current class can exist only if it is linked to an object of this class.
  
• Displayed name: if necessary, you can enter the name with which the linked class is shown in the relationship.
  If no name is set, the system automatically uses the name of the linked object class.
  
• Attributes to show: with this field, you can choose which attributes to show, but only after selecting the class. You cannot select attributes of type relationship or object list.

Relationship cardinality

The overall cardinality of the relationship depends on the combination of the values set in the two sections.

Configuration	Meaning
1 → 1	one object can be linked to one object only
1 → N	one object can be linked to multiple objects
N → 1	multiple objects can be linked to one object
N → N	multiple objects can be linked to each other

Only one of the two classes can be required, making one class necessary for the existence of the other.

💡 Tip: Limit the attributes to display to keep the attributes panel more readable.

---

Configuration rules and conditions

A current object class cannot be set as required if the linked object class already has created instances.

After saving a relationship, it is not possible to edit:

• the cardinality
• the linked object class
• the required status

To configure a relationship on an object class of type Form or Global Form, the class must be saved first. After saving, re-enter edit mode for the object class and open the Relations section to create the relationship.

If a relationship is deleted, the system automatically removes the link from all involved instances.

---

Links

• Introduction to Object Classes

---

Italiano

Le relazioni permettonosono una tipologia di attributo che permette di collegare tra loro oggetti appartenenti a classi oggetto diverse, creando legami strutturati tra gli elementi del progetto.

QuestoQuesta meccanismofunzione consente di rappresentare relazioni logiche tra istanze. Ad esempio, puoi collegare una strada  ai pali dell’illuminazione presenti lungo il suo tracciato oppure associareassociarre una stradastarada  ai segnali stradali installati lungo di essa.

Le relazioni vengono configurate neldurante la Backofficecreazione eo utilizzatela neimodifica progettidi dell'appuna EA.classe oggetto, all’interno di una sezione dedicata.

Disponibile solo per utenti con permesso backoffice con il modulo modulo-asset-manager attivo nel progetto..

---

Come funzionano le relazioni

Una relazione collega duesempre due classi oggetto:

• CorrenteClasse oggetto corrente:
  È la classe che stai configurando in questoquel momento nel Backoffice.Backoffice.
  
• CollegataClasse oggetto collegata:
  È la classe con cui gli oggetti di quelladella classe sarannocorrente possono essere collegati.

Quando una relazione èviene configurata tra due classi, ognigli oggettooggetti puòpossono essere collegatoassociati a una o più istanze della classe relazionata.

Il numero di oggetti collegabili dipende dalla cardinalità dellaimpostata relazione.nella relazione.

---

Configurare una relazione nel Backoffice

Per configurare una relazione tra classi oggetto, apri il Backoffice, accedi alalla dettagliopagine delladi modifica di una classe oggetto e seleziona la tab RelationsRelazioni.

Per creare una nuova relazione:

1. Cliccarelazione clicca sul bottone AddAggiungi relationrelazione.
2. Seleziona la classe oggetto collegata.
3. Configura le proprietà della relazione.

La configurazione è suddivisa in due sezioni: ThisQuesta objectclasse classoggetto e IsÈ relatedlegata toa.

---

Classe oggetto corrente

La sezione ThisQuesta objectclasse classoggetto rappresenta la classe oggetto che stai modificando.

Questa
Il classecampo Classe oggetto è giàcompilato definitaautomaticamente automaticamente.e non può essere modificato.

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:Obbligatoria: attiva lo switch se laquesta relazioneclasse deveoggetto essereè obbligatorianecessaria per questal’esistenza classe.dell’altra.
  Se Selo switch è attivo, un oggetto di questadell’altra classe può esistere solo se è collegato a almeno un oggetto delladi classequesta relazionata.classe.
  

  Solo

• Nome visualizzato: quando un oggetto con una dellerelazione dueviene classicreato puòe esserevisualizzato obbligatoria,nell’app, rendendol’attributo unadella classerelazione necessariaha perun l'esistenzanome. dell'altra.

  DisplayedSe name:necessario, Inseriscipuoi inserire il nome con cui questa classe verràviene mostrata nella relazione. 
  Se non viene impostato,impostato un nome, il sistema utilizza automaticamente il nome della classe collegata.

  oggetto.
  

• AttributesAttributi toda showmostrare: Selezionaquando gliun oggetto con una relazione viene creato e visualizzato nell’app, la classe oggetto relazionata compare nell’attributo della relazione. La classe relazionata può essere espansa per mostrare un’anteprima dei suoi attributi. Con questo campo puoi scegliere quali attributi dell’oggettomostrare. relazionato mostrati nel dettaglio attributi.

  Non possonopuoi essereselezionare mostrati:

  • attributi di tipo relazione
  • attributi di tipoo Objectlista Listoggetti.

  ---

  
  

  Classe oggetto collegata

  La sezione IsÈ relatedlegata toa permette di definire la classe conoggetto cuida glicollegare oggettialla verrannoclasse collegati.corrente.

  
  Nel campo ObjectClasse classoggetto, seleziona dal menu a tendina la classe oggettocon tramitecui ilcreare menula a tendina.relazione.

  

  Anche per questa classe puoi configurare:

  • cardinalitàCardinalità: seleziona 1 (1oppure oN N)per indicare quanti oggetti della classe collegata possono essere associati a un oggetto della classe corrente.
    
  • Obbligatoria: attiva lo switch Requiredse la classe oggetto collegata è necessaria per l’esistenza della classe corrente.
    Se lo switch è attivo, un oggetto della classe corrente può esistere solo se è collegato a un oggetto di questa classe.
    
  • Nome visualizzato: Se necessario, puoi inserire il nome con cui la classe collegata viene mostrata nella relazione.
    Se non viene impostato un nome, il sistema utilizza automaticamente il nome della classe oggetto collegata.
    
  • Attributi da mostrare: ilcon questo campo puoi scegliere Displayedquali nameattributi mostrare
  • gli, ma Attributessolo todopo showaver selezionato la classe. Non puoi selezionare attributi di tipo relazione o lista oggetti.

  ---

  
  

  Cardinalità della relazione

  La cardinalità complessiva della relazione dipende dalla combinazione dei valori impostati nelle due sezioni.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

  
  

  Solo una delle due classi può essere obbligatoria, rendendo una classe necessaria per l'esistenza dell'altra.

  💡 Suggerimento: Limita gli attributi da visualizzare per lasciare il pannello attributi più leggibile.

  ---

  LimitiRegole dellae condizioni di configurazione

  PerUna garantireclasse oggetto corrente non può essere impostata come obbligatoria se la coerenzaclasse deioggetto dati,collegata alcuneha proprietàgià nondelle possonoistanze essere modificate dopo il salvataggio.create.

  

  Dopo il salvataggio di una relazione, non è possibile modificare:

  • la cardinalità
  • la classe oggetto collegata
  • lo stato Requiredobbligatorio

  Per configurare una relazione su una classe oggetto di tipo Form o Form globale, la classe deve essere prima salvata. Dopo il salvataggio, rientra in modifica nella classe oggetto e apri la sezione Relazioni per creare la relazione.

  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 Form o vettoriale possono essere relazionati solo con oggetti dello stesso tipo.
  • gli oggetti di tipo Global List possono essere relazionati solo con altre Global List;

  ---

  Relazioni nei progetti

  Quando crei un nuovo oggetto utilizzando lo strumento Disegna della toolbar, il sistema segnala se la classe oggetto richiede relazioni obbligatorie.

  Nel menu di selezione delle classi oggetto compare un’icona di relazione accanto alle classi che richiedono collegamenti obbligatori. Passando il cursore sull’icona viene mostrato un tooltip con l’elenco delle classi da collegare.

  

  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.

  Relazioni obbligatorie

  Quando una relazione è configurata come Required, un oggetto non può esistere senza essere collegato ad almeno un oggetto dell’altra classe.

  Questo comportamento ha alcune implicazioni operative nei progetti:

  • per utilizzare correttamente una relazione nel progetto, assicurati che entrambe le classi oggetto coinvolte siano incluse nella configurazione del progetto;
  • non è possibile salvare un oggetto senza aver selezionato almeno un oggetto relazionato;
  • eliminando un oggetto necessario per l’esistenza di un altro oggetto collegato, il sistema elimina anche l’oggetto relazionato.

  

  ---

  Modificare le relazioni tra oggetti

  Per modificare le relazioni di un oggetto:

  1. Apri il dettaglio attributi dell’oggetto.
  2. Clicca sul bottone Edit.
  3. Aggiungi, sostituisci o rimuovi gli oggetti relazionati.

  Gli oggetti possono essere selezionati:

  • tramite menu a tendina
  • tramite selezione da mappa per oggetti vettoriali.

  

  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

  • CreareIntroduzione unaalle nuova ClasseClassi 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

  ---

  UltimoLast aggiornamento:update: 908 marzoMay 2026