# Access and Overview

This book collects the **introductory guides** for getting started with **EagleArca** independently.  
Here you will find clear, practical instructions for **accessing the platform**, understanding the structure of **roles, groups, and users**, entering **projects** or the **Backoffice**, and becoming familiar with the core concepts of **object classes** and **Global List** objects.

Questo libro raccoglie le **guide introduttive** per iniziare a utilizzare **EagleArca** in modo autonomo.  
Qui trovi indicazioni chiare e pratiche per **accedere alla piattaforma**, comprendere la struttura di **ruoli, gruppi e utenze**, entrare nei **progetti** o nel **Backoffice**, e familiarizzare con i concetti fondamentali di **classi oggetto** e oggetti **Global List**.

# Access to the platform

#### <span style="white-space: pre-wrap;"> </span>[![image.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/XVWimage.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/XVWimage.png)<span style="white-space: pre-wrap;"> </span>[IT](https://wiki.eaglearca.com/link/129#bkmrk-italiano)

---

#### [![eng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/jQPeng.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/jQPeng.png)<span style="white-space: pre-wrap;"> </span>**English**

<span style="white-space: pre-wrap;">Logging into EagleArca allows you to use both the </span>[**Backoffice**](https://wiki.eaglearca.com/books/backoffice) (user management, roles, groups, projects, objects and object classes) and the **Inventory App**<span style="white-space: pre-wrap;"> (data collection and fieldwork).</span>

<span style="white-space: pre-wrap;">This page describes the steps for </span>**logging into the system**<span style="white-space: pre-wrap;">, </span>**setting a password**<span style="white-space: pre-wrap;"> and </span>**selecting an organization and application**.

<p class="callout info"><span style="white-space: pre-wrap;">To log in, the user account must be </span>**created and enabled**<span style="white-space: pre-wrap;"> by an administrator with </span>`<span class="editor-theme-code">backoffice</span>`<span style="white-space: pre-wrap;"> permissions.</span></p>

---

### Requirements

- User account created and enabled by a back-office administrator
- Access to an email account to receive a welcome link or password reset link

---

### First-time login

**1.**<span style="white-space: pre-wrap;"> Open the </span>**welcome email**<span style="white-space: pre-wrap;"> you received after creating your account and click the </span>**activation link**.

[![1 - Mail First Access.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/Oau1-mail-first-access.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/Oau1-mail-first-access.png)

**2.**<span style="white-space: pre-wrap;"> Set your </span>**new password**, making sure it meets the minimum requirements:

- at least 8 characters
- one uppercase letter
- one number
- one special character

**3.**<span style="white-space: pre-wrap;"> Confirm to </span>**save the password**.

**4.** You will be redirected to the **login pag**<span style="white-space: pre-wrap;">e: enter your email address and password, then click </span>**Login**.

[![2-Login.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/Y3Z2-login.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/Y3Z2-login.png)

<p class="callout warning">The activation link is valid for a limited time. If it has expired, please request account creation again.</p>

**💡 TIP**<span style="white-space: pre-wrap;">: If the </span>**welcome link has expired**, ask the project contact for a new invitation or reset.

---

### Reset your password

**1.** <span style="white-space: pre-wrap;">Go to the EagleArca </span>**login** page.

**2.**<span style="white-space: pre-wrap;"> Click on </span>**Forgot your password?**

[![3-Link Password Dimenticata.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/8a13-link-password-dimenticata.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/8a13-link-password-dimenticata.png)

**3.** <span style="white-space: pre-wrap;">Enter the </span>**email** <span style="white-space: pre-wrap;">address associated with your account and click </span>**Send**.

**4.**<span style="white-space: pre-wrap;"> Check your email inbox and open the</span> **reset link**<span style="white-space: pre-wrap;"> you received.</span>

[![4 - Mail Reset Password.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/4-mail-reset-password.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/4-mail-reset-password.png)

**5.**<span style="white-space: pre-wrap;"> Set and confirm your </span>**new password**, making sure it meets the minimum requirements:

- at least 8 characters
- one uppercase letter
- one number
- one special character

then click **Change Password**.

[![5-Password Requirements.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/Lkg5-password-requirements.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/Lkg5-password-requirements.png)

**6.** Go back to the login page and sign in with your new password.

<p class="callout warning"><span style="white-space: pre-wrap;">If you don't receive the email, check your </span>**Spam** <span style="white-space: pre-wrap;">or </span>**Junk folder**.</p>

---

### Select organization and app

**1.**<span style="white-space: pre-wrap;"> After logging in, the </span>**app selection page**<span style="white-space: pre-wrap;"> opens.</span>

- <span style="white-space: pre-wrap;">Choose the </span>**organization**<span style="white-space: pre-wrap;"> from the top menu.</span>
- <span style="white-space: pre-wrap;">Select the desired </span>**app**<span style="white-space: pre-wrap;"> (Backoffice or App Inventory).</span>
- <span style="white-space: pre-wrap;">Click </span>**Open**<span style="white-space: pre-wrap;"> on the app card.</span>

[![6 - App Selection.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/qTi6-app-selection.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/qTi6-app-selection.png)

**2.**<span style="white-space: pre-wrap;"> If you are associated with </span>**only one organization and one application**, access is granted automatically.

- <span style="white-space: pre-wrap;">With </span>**App Inventory**<span style="white-space: pre-wrap;"> permissions, you access the application directly.</span>
- <span style="white-space: pre-wrap;">With </span>**Backoffice**<span style="white-space: pre-wrap;"> permissions, you enter the configuration console.</span>

**3.**<span style="white-space: pre-wrap;"> If you access an organization but </span>**you are not associated with any app**<span style="white-space: pre-wrap;">, an </span>**empty page**<span style="white-space: pre-wrap;"> is displayed.</span>

- The page indicates that no apps are available for the selected organization.
- <span style="white-space: pre-wrap;">You are asked to </span>**contact the administrator**<span style="white-space: pre-wrap;"> to obtain the necessary authorizations.</span>

**4.**<span style="white-space: pre-wrap;"> To change organization or app after entering, click the current </span>**organization and app name**<span style="white-space: pre-wrap;"> at the top left and select a new item.</span>

[![7 - Header (Organization - App).png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/VnY7-header-organization-app.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/VnY7-header-organization-app.png)

---

### Access the project

<span style="white-space: pre-wrap;">Once you open the Inventory app, the </span>**project selection home page**<span style="white-space: pre-wrap;"> appears.</span>  
You can change the view (to cards, list, or table) using the selector in the top-right corner.  
Projects can be filtered using the search bar.

[![8 - Layout + Searchbar.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/TyJ8-layout-searchbar.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/TyJ8-layout-searchbar.png)

Each project represents a separate workspace, containing its own groups, object classes, and data.

- To view a project's details, click on it to open a side panel with the information.
- <span style="white-space: pre-wrap;">To open a project, click the </span>**Open** button, which appears when you hover over the item or at the top of the details panel.
- Please wait for the main view to load.

[![9 - Project Detail.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/9-project-detail.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/9-project-detail.png)

<p class="callout warning">Project availability depends on the groups and roles assigned to you: if you don't see a project in the list, check with an administrator to make sure your account is properly assigned.</p>

---

### Managing concurrent sessions

**Only one session can be active**<span style="white-space: pre-wrap;"> per account at a time.</span>

If you try to log in while your account is already logged in from another browser or device, the platform will display a message indicating that a session is already active.

[![10 - Active Session Detected.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/cdF10-active-session-detected.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/cdF10-active-session-detected.png)

In this case, you can choose between two options:

- **Cancel:**<span style="white-space: pre-wrap;"> Stops the login and keeps the already open session active.</span>
- **Access anyway:**<span style="white-space: pre-wrap;"> Completes access in the new session and automatically disconnects the previous one.</span>

<span style="white-space: pre-wrap;">It is not possible to be connected simultaneously from a </span>**mobile device and computer**.  
<span style="white-space: pre-wrap;">If you log in from </span>**mobile**<span style="white-space: pre-wrap;"> while already connected from a </span>**computer**<span style="white-space: pre-wrap;"> (or vice versa) you will be </span>**automatically disconnected**<span style="white-space: pre-wrap;"> from the other device.</span>

---

### Links

- [Overview of users, roles and groups](https://wiki.eaglearca.com/books/access-and-overview/page/overview-of-users-roles-and-groups "Overview of users, roles and groups")

---

#### [![ita.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/ita.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/ita.png)<span style="white-space: pre-wrap;"> </span>**Italiano**

<span style="white-space: pre-wrap;">Accedere a EagleArca permette di utilizzare sia il </span>[**Backoffice**](https://wiki.eaglearca.com/books/backoffice "Backoffice") (gestione utenti, ruoli, gruppi, progetti, oggetti e classi oggetto) sia l’**App Inventory** (raccolta dati e lavoro sul campo).

<span style="white-space: pre-wrap;">Questa pagina descrive i passaggi per </span>**entrare nel sistema**<span style="white-space: pre-wrap;">, </span>**impostare la password**<span style="white-space: pre-wrap;"> e </span>**selezionare organizzazione e applicazione**.

<p class="callout info"><span style="white-space: pre-wrap;">Per accedere è necessario che l’utenza sia </span>**creata e abilitata**<span style="white-space: pre-wrap;"> da un amministratore con permesso di </span>`<span class="editor-theme-code">backoffice</span>`.</p>

---

### Requisiti

- Utenza creata e abilitata da amministratore backoffice
- Accesso alla casella email per ricevere link di benvenuto o reset password

---

### Primo accesso

**1.**<span style="white-space: pre-wrap;"> Apri la </span>**mail di benvenuto**<span style="white-space: pre-wrap;"> ricevuta dopo la creazione dell’utenza e clicca il </span>**link di attivazione**.

[![1 - Mail First Access.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/Oau1-mail-first-access.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/1-mail-first-access.png)

**2.**<span style="white-space: pre-wrap;"> Imposta la </span>**nuova password**<span style="white-space: pre-wrap;"> rispettando i requisiti minimi:</span>

- almeno 8 caratteri
- una lettera maiuscola
- un numero
- un carattere speciale

**3.**<span style="white-space: pre-wrap;"> Conferma per </span>**salvare la password**.

**4.**<span style="white-space: pre-wrap;"> Verrai reindirizzato alla </span>**pagina di login**<span style="white-space: pre-wrap;">: inserisci email e password, quindi clicca su </span>**Login**.

[![2-Login.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/Y3Z2-login.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/Y3Z2-login.png)

<p class="callout warning">Il link di attivazione ha validità limitata. Se risulta scaduto, richiedi nuovamente la creazione dell’utenza.</p>

**💡 Suggerimento**<span style="white-space: pre-wrap;">: Se il </span>**link di benvenuto è scaduto**, richiedi un nuovo invito o un reset al referente del progetto.

---

### Reimpostare la password

**1.**<span style="white-space: pre-wrap;"> Vai alla pagina di </span>**login**<span style="white-space: pre-wrap;"> di EagleArca.</span>

**2.**<span style="white-space: pre-wrap;"> Clicca su </span>**Hai dimenticato la password?**

[![3-Link Password Dimenticata.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/8a13-link-password-dimenticata.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/8a13-link-password-dimenticata.png)

**3.**<span style="white-space: pre-wrap;"> Inserisci l’</span>**email**<span style="white-space: pre-wrap;"> associata all’utenza e clicca su </span>**Invia**.

**4.**<span style="white-space: pre-wrap;"> Controlla la tua casella email e apri il </span>**link di reset**<span style="white-space: pre-wrap;"> ricevuto.</span>

[![4 - Mail Reset Password.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/4-mail-reset-password.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/4-mail-reset-password.png)

**5.**<span style="white-space: pre-wrap;"> Imposta e conferma la </span>**nuova password**<span style="white-space: pre-wrap;"> rispettando i requisiti minimi:</span>

- almeno 8 caratteri
- una lettera maiuscola
- un numero
- un carattere speciale

<span style="white-space: pre-wrap;">quindi clicca su </span>**Cambia password**.

[![5-Password Requirements.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/scaled-1680-/Lkg5-password-requirements.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-11/Lkg5-password-requirements.png)

**6.**<span style="white-space: pre-wrap;"> Torna alla pagina di login e accedi con la nuova password.</span>

<p class="callout warning"><span style="white-space: pre-wrap;">Se la mail non arriva, controlla la cartella </span>**Spam** <span style="white-space: pre-wrap;">o </span>**Posta indesiderata**.</p>

---

### Selezionare organizzazione e app

**1.**<span style="white-space: pre-wrap;"> Dopo il login, si apre la </span>**pagina di selezione app**.

- Scegli l’**organizzazione**<span style="white-space: pre-wrap;"> dal menu in alto.</span>
- Seleziona l’**app**<span style="white-space: pre-wrap;"> desiderata (Backoffice o App Inventory).</span>
- <span style="white-space: pre-wrap;">Clicca su </span>**Apri**<span style="white-space: pre-wrap;"> nella card dell’app.</span>

[![6 - App Selection.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/qTi6-app-selection.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/6-app-selection.png)

**2.**<span style="white-space: pre-wrap;"> Se si è associati a </span>**una sola organizzazione e a una sola applicazione**, l’accesso avviene automaticamente.

- Con permessi per l’**App Inventory**, si accede direttamente all’applicazione.
- <span style="white-space: pre-wrap;">Con permessi </span>**Backoffice**, si entra nella console di configurazione.

**3.**<span style="white-space: pre-wrap;"> Se accedi a un’organizzazione ma </span>**non sei associato a nessuna app**<span style="white-space: pre-wrap;">, viene mostrata una </span>**pagina vuota**.

- La pagina indica che non sono disponibili app per l’organizzazione selezionata.
- <span style="white-space: pre-wrap;">Viene richiesto di </span>**contattare l’amministratore**<span style="white-space: pre-wrap;"> per ottenere le autorizzazioni necessarie.</span>

**4.**<span style="white-space: pre-wrap;"> Per cambiare organizzazione o app una volta entrato, clicca in alto a sinistra sul </span>**nome dell'organizzazione e dell'app**<span style="white-space: pre-wrap;"> correnti e seleziona una nuova voce.</span>

![7 - Header (Organization - App).png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/VnY7-header-organization-app.png)

---

### Accedere al progetto

<span style="white-space: pre-wrap;">Una volta aperta l’App Inventory, viene mostrata la </span>**pagina iniziale di selezione progetto**.  
La visualizzazione può essere cambiata (a card, a lista o a tabella) con un selettore in alto a destra.  
I progetti possono essere filtrati tramite searchbar.

[![8 - Layout + Searchbar.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/TyJ8-layout-searchbar.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/TyJ8-layout-searchbar.png)

Ogni progetto rappresenta un ambiente di lavoro indipendente, che contiene i propri gruppi, classi oggetto e dati.

- Per visualizzare i dettagli di un progetto, clicca su di esso, si apre un pannello laterale con le informazioni.
- <span style="white-space: pre-wrap;">Per aprire un progetto, clicca sul bottone </span>**Apri**, visibile al passaggio del mouse sopra l'elemento o in alto sul pannello dei dettagli.
- Attendere il caricamento della vista principale.

[![9 - Project Detail.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/9-project-detail.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/9-project-detail.png)

<p class="callout warning"><span style="white-space: pre-wrap;">La disponibilità dei progetti dipende dai </span>**gruppi** <span style="white-space: pre-wrap;">e dai </span>**ruoli** assegnati: se non vedi un progetto nella lista, verifica con un amministratore che l’utenza sia associata correttamente.</p>

---

### Gestione degli accessi contemporanei

<span style="white-space: pre-wrap;">Per ogni account può essere attiva </span>**una sola sessione alla volta**.

Se provi ad accedere mentre la tua utenza è già collegata da un altro browser o dispositivo, la piattaforma mostra un messaggio che segnala la presenza di una sessione già attiva.

[![10 - Active Session Detected.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/cdF10-active-session-detected.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/10-active-session-detected.png)

In questo caso puoi scegliere tra due opzioni:

- **Annulla:**<span style="white-space: pre-wrap;"> Interrompe il login e mantiene attiva la sessione già aperta.</span>
- **Accedi comunque:**<span style="white-space: pre-wrap;"> Completa l’accesso nella nuova sessione e disconnette automaticamente quella precedente.</span>

<span style="white-space: pre-wrap;">Non è possibile essere collegati contemporaneamente da </span>**dispositivo mobile**<span style="white-space: pre-wrap;"> e </span>**computer**.  
<span style="white-space: pre-wrap;">Se accedi da </span>**mobile**<span style="white-space: pre-wrap;"> mentre sei già collegato da </span>**computer** <span style="white-space: pre-wrap;">(o viceversa), verrai </span>**automaticamente disconnesso**<span style="white-space: pre-wrap;"> dall’altro dispositivo.</span>

---

### Collegamenti

- [Panoramica utenti, ruoli e gruppi](https://wiki.eaglearca.com/books/access-and-overview/page/overview-of-users-roles-and-groups "Overview of users, roles and groups")

---

***Last update:** *06 May 2026**

# Overview of users, roles and groups

### [![image.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/XVWimage.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/XVWimage.png) [IT](https://wiki.eaglearca.com/link/130#bkmrk-italiano)

---

#### [![eng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/jQPeng.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/jQPeng.png) **English**

In EagleArca, each user’s access and permissions are managed through **users**, **roles** and **groups**.  
These three elements work together to control **who can access which projects** and **what editing privileges they have**.

---

### Users

A **user** is a person who accesses the platform.

<p class="callout info">Each user can belong to one or more organizations, but access to projects depends on the roles and groups to which they are assigned.</p>

Within EagleArca, users are classified as:

- **Internal**, if created directly within the organization.
- **External**, if already registered in another organization and added as collaborators.

[![1 - Users.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/cQm1-users.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/cQm1-users.png)

When a new user is created, they receive a **welcome email** containing a link to set their password and complete their first login.  
Each user account can have different permissions for the **App Inventory** and the **Backoffice**, and consume separate licenses based on the access granted.

<p class="callout info">**Users are created and managed in the Backoffice** ([Create and Manage Users](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-utenze "Create and Manage Users")).</p>

---

### Roles

A **role** defines which actions a user can perform on the platform's data.  
It is a set of **permissions** that determine what is visible or editable.

- **Object classes** can be set to be invisible, visible, or editable.
- **Resources** can be either visible or invisible.

[![3 - Roles.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/lk63-roles.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/lk63-roles.png)

Each role can be linked to one or more groups.  
This allows you to automatically apply the same permissions to multiple users without having to configure them one by one.

---

<p class="callout info">**Roles are defined and assigned in the Backoffice** ([Create and Manage Roles](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-ruoli "Create and Manage Roles")).</p>

**💡 TIP**: Create **clear, reusable roles** to avoid redundant configurations.

---

### Groups

A **group** is a collection of users who share the same role and have access to the same projects.  
Each group is associated with:

- a **role**, which determines permissions;
- one or more **projects**, which define where users can work.

[![2 - Groups.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-groups.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/2-groups.png)

Groups simplify access management, especially in complex organizations.  
Assigning users to a group allows you to:

- Quickly assign consistent permissions to multiple people.
- Centrally manage role changes.
- Reduce configuration errors in projects.

If a user belongs to multiple groups, after logging in, they can select which group to work with to access the corresponding projects.

<p class="callout info">**Groups are created in the Backoffice** ([Create and Manage Groups](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-gruppi "Create and Manage Groups")).</p>

**💡 TIP**: Keep the names consistent (e.g., “Northern Operators” / “Southern Operators”) to make searching easier.

---

### Relationship between users, roles and groups

<table border="1" class="align-left" id="bkmrk-elemento-funzione-pr" style="width: 100%; border-collapse: collapse; border-width: 1px;"><thead><tr style="height: 29.7969px;"><th style="width: 12.6794%; height: 29.7969px;">**Element**</th><th style="width: 42.3445%; height: 29.7969px;">**Main function**</th><th style="width: 44.9761%; height: 29.7969px;">**Assigned to / by**</th></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 12.6794%; height: 29.7969px;">**User**</td><td style="width: 42.3445%; height: 29.7969px;">Identifies a person</td><td style="width: 44.9761%; height: 29.7969px;">Is included in one or more groups</td></tr><tr style="height: 29.7969px;"><td style="width: 12.6794%; height: 29.7969px;">**Role**</td><td style="width: 42.3445%; height: 29.7969px;">Defines operational permissions</td><td style="width: 44.9761%; height: 29.7969px;">Is assigned to a group</td></tr><tr style="height: 29.7969px;"><td style="width: 12.6794%; height: 29.7969px;">**Group**</td><td style="width: 42.3445%; height: 29.7969px;">Collects multiple users with the same purpose</td><td style="width: 44.9761%; height: 29.7969px;">Is associated with a role and one or more projects</td></tr></tbody></table>

---

#### [![ita.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/ita.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/ita.png) **Italiano**

In EagleArca, l’accesso e i permessi di ogni persona vengono gestiti attraverso **utenti**, **ruoli** e **gruppi**.  
Questi tre elementi lavorano insieme per controllare **chi può accedere**, **a quali progetti** e **con quali possibilità di modifica**.

---

### Utenti

Un **utente** rappresenta una persona che accede alla piattaforma.

<p class="callout info">Ogni utente può appartenere a una o più organizzazioni, ma l’accesso ai progetti dipende dai ruoli e dai gruppi a cui è assegnato.</p>

All’interno di EagleArca, gli utenti sono classificati come:

- **Interni**, se creati direttamente all’interno dell’organizzazione.
- **Esterni**, se già registrati in un’altra organizzazione e aggiunti come collaboratori.

[![1 - Users.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/cQm1-users.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/cQm1-users.png)

Quando si crea un nuovo utente, questo riceve una **mail di benvenuto** con il link per impostare la password e completare il primo accesso.  
Ogni utenza può avere permessi diversi per l'**App Inventory** e per il **Backoffice**, e consumare licenze separate in base all’accesso concesso.

<p class="callout info">**Gli utenti vengono creati e gestiti nel Backoffice** ([*Creare e gestire utenze*](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-utenze "Creare e gestire utenze")).</p>

---

### Ruoli

Un **ruolo** definisce quali azioni può svolgere un utente sui dati della piattaforma.  
È un insieme di **permessi** che determinano cosa è visibile o modificabile.

- Le **classi oggetto** possono essere impostate come *non visibili*, *visibili* o *modificabili*.
- Le **risorse** possono essere solo *visibili* o *non visibili*.

[![3 - Roles.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/lk63-roles.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/lk63-roles.png)

Ogni ruolo può essere collegato a uno o più gruppi.  
Questo consente di applicare automaticamente gli stessi permessi a più utenti senza doverli configurare uno per uno.

<p class="callout info">**I ruoli vengono definiti e associati nel Backoffice** ([*Creare e gestire ruoli*](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-ruoli "Creare e gestire i ruoli")).</p>

**💡 Suggerimento**: Crea **ruoli chiari e riutilizzabili** per evitare configurazioni ridondanti.

---

### Gruppi

Un **gruppo** è un insieme di utenti che condividono lo stesso ruolo e accedono agli stessi progetti.  
Ogni gruppo è associato a:

- un **ruolo**, che stabilisce i permessi;
- uno o più **progetti**, che definiscono dove gli utenti possono operare.

[![2 - Groups.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-groups.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/2-groups.png)

I gruppi semplificano la gestione degli accessi, specialmente in organizzazioni complesse.  
Associare utenti a un gruppo consente di:

- Assegnare rapidamente permessi coerenti a più persone.
- Gestire in modo centralizzato le modifiche dei ruoli.
- Ridurre gli errori di configurazione nei progetti.

Se un utente appartiene a più gruppi, dopo l’accesso può selezionare con quale gruppo lavorare per accedere ai progetti corrispondenti.

<p class="callout info">**I gruppi vengono creati nel Backoffice** ([*Creare e gestire gruppi*](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-gruppi "Creare e gestire i gruppi")).</p>

**💡 Suggerimento**: Mantieni i nomi coerenti (es. “Operatori Nord” / “Operatori Sud”) per facilitare la ricerca.

---

### Relazione tra utenti, ruoli e gruppi

<table border="1" class="align-left" id="bkmrk-elemento-funzione-pr-1" style="border-collapse: collapse; width: 100%; border-style: solid; border-width: 1px;"><thead><tr><th>**Elemento**</th><th>**Funzione principale**</th><th>**Assegnato a / da**</th></tr></thead><tbody><tr><td>**Utente**</td><td>Identifica una persona</td><td>È inserito in uno o più gruppi</td></tr><tr><td>**Ruolo**</td><td>Definisce i permessi operativi</td><td>È assegnato a un gruppo</td></tr><tr><td>**Gruppo**</td><td>Raccoglie più utenti con lo stesso scopo</td><td>È associato a un ruolo e uno o più progetti</td></tr></tbody></table>

---

***Last update:** 06 May 2026*

# Introduction to Object Classes

#### [![image.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/XVWimage.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/XVWimage.png) [IT](https://wiki.eaglearca.com/link/131#bkmrk-italiano)

---

#### [![eng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/jQPeng.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/jQPeng.png) **English**

**Object Classes** define the data structure in EagleArca projects.  
Each class represents a **type of surveyable element** (such as a plant, a pole, a pipeline or a sensor) and specifies **what information should be collected** and **how the object should appear on the map**.

Once created and published, a class becomes available to all projects within the organization and can be used to [*create new objects*](https://wiki.eaglearca.com/books/funzionalita-dellapp/page/gestire-gli-oggetti-nel-progetto "create new objects").

---

### Types of Object Classes

In EagleArca, there are two categories of Object Classes:

##### Vector Object Classes

These allow you to create objects **displayed on the map**.  
Each class defines a basic **geometry**, which can be:

- **Point** – for individual elements such as trees or sensors
- **Line** – for extended elements such as pipes or paths
- **Polygon** – for areas such as flower beds, buildings or operational zones

[![1 - Objects Type.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/EDK1-objects-type.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/EDK1-objects-type.png)

Geometric classes can be **styled** with basic shapes, colors and **conditional styles**.  
Conditional styles automatically change the appearance of objects on the map based on the value of one or more attributes, for example to distinguish operational statuses, criticality levels, or numerical thresholds.  
(e.g. status = active → green color).

[![2 - Conditional style.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/lB42-conditional-style.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/lB42-conditional-style.png)

<p class="callout info">You can make a point an **oriented point**, that is, a point oriented in a specific direction on the map, which is useful for representing elements such as cameras or headlights.</p>

##### Non-vector Object Classes

Known as **Form** classes. They define the attributes of objects that **do not have a geographic representation**.  
They are used to manage non-mapped information, such as inspection reports, technical checks or reference lists that can be used within projects.

[![3 - Form.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/5ho3-form.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/5ho3-form.png)

---

### Global List

**Global Lists** are *Form-type* object classes that exist at the organizational level and **are not tied to a single project**.  
They serve as shared, centralized repositories of reusable data.  
For example:

- lists of suppliers or sensor models
- material types or risk categories
- code tables or references used by multiple projects

<p class="callout info">Global List objects are added from the **Home** screen and not within the project.</p>

---

### Object Class Attributes

Each Object Class consists of **attributes**, which are the data fields that describe the information to be entered for each object in the class.

An attribute can be of the following types:

- **Text field** – for names or descriptions
- **Numeric field** – for quantitative values or measurements
- **List of values** – for selecting an option from a predefined list
- **Date** – for entering dates or deadlines
- **Attachments** – for uploading files, images, or videos
- **Dimensions** – for automatically recording measurable quantities (e.g., length, area, coordinates)
- **True/False** – for Boolean fields
- **Object list** – for fields composed of multiple sub-attributes, such as a set of repeated measurements or parameters

[![4 - Attributes.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/aFR4-attributes.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/aFR4-attributes.png)

Each attribute also has configurable properties:

- **Name** – the field label
- **Required** – indicates whether the field must be filled in
- **Default value** – the preset value, which can be changed if necessary
- **Locked** – the field is visible but cannot be edited
- **Main attribute** – the primary attribute displayed when querying the object, useful for quickly identifying it

[![5 - Attribute configuration.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/Zsc5-attribute-configuration.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Zsc5-attribute-configuration.png)

---

### Creation and Management

Object classes are created and modified in the [**Backoffice**](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-le-classi-oggetto), which is accessible only to users with the appropriate permissions.  
Once published, the class becomes available in projects and can be used to create new objects.

---

### In summary

- **Object Classes** define the structure and representation of data.
- They can be **geometric** (displayed on the map) or **form-based** (data sheets only).
- **Global Lists** are forms shared across projects, useful for standardized lists.
- **Attributes** define the information that each object must contain.
- **Oriented points** allow for the representation of directed points.
- Only users with *backoffice permissions* can create or modify classes.

---

#### [![ita.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/ita.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/ita.png) **Italiano**

Le **Classi Oggetto** definiscono la struttura dei dati nei progetti EagleArca.  
Ogni classe rappresenta un **tipo di elemento censibile,** per esempio una pianta, un palo, una condotta o un sensore, e stabilisce **quali informazioni devono essere raccolte** e **come l’oggetto deve apparire sulla mappa**.

Una volta creata e pubblicata, una classe diventa disponibile per tutti i progetti dell’organizzazione e può essere utilizzata per *[creare nuovi oggetti](https://wiki.eaglearca.com/books/funzionalita-dellapp/page/gestire-gli-oggetti-nel-progetto "Gestire gli oggetti nel progetto")*.

---

### Tipologie di Classe Oggetto

In EagleArca esistono due categorie di Classi Oggetto:

##### Classi Oggetto vettoriali

Permettono di creare oggetti **visualizzati sulla mappa**.  
Ogni classe definisce una **geometria** di base, che può essere:

- **Punto** – per elementi singoli come alberi o sensori
- **Linea** – per elementi estesi come tubazioni o percorsi
- **Poligono** – per aree come aiuole, edifici o zone operative

[![1 - Objects Type.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/5M41-objects-type.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/5M41-objects-type.png)

Le classi geometriche possono essere **stilizzate** con forme di base, colori e **stili condizionali**.  
Gli stili condizionali permettono di cambiare automaticamente l’aspetto degli oggetti in mappa in base al valore di uno o più attributi, ad esempio per distinguere stati operativi, livelli di criticità o soglie numeriche.  
(es: *stato = attivo → colore verde*).

[![2 - Conditional style.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/lB42-conditional-style.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/lB42-conditional-style.png)

<p class="callout info">È possibile rendere un **punto *oriented point***, cioè un punto orientato in una direzione specifica della mappa, utile per rappresentare elementi come telecamere o fari.</p>

#####   
Classi Oggetto non vettoriali

Chiamati **Form**. Definiscono gli attributi di oggetti che **non hanno rappresentazione geografica**.  
Servono per gestire informazioni non mappate, come schede di ispezione, controlli tecnici o elenchi di riferimento utilizzabili all’interno dei progetti.

[![3 - Form.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/5ho3-form.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/5ho3-form.png)

---

### Global List

Le **Global List** sono classi oggetto di tipo *Form* che esistono a livello di organizzazione e **non dipendono da un singolo progetto**.  
Servono come archivi condivisi e centralizzati di dati riutilizzabili.  
Ad esempio:

- elenco dei fornitori o dei modelli di sensori;
- tipologie di materiali o categorie di rischio;
- tabelle di codici o riferimenti usati da più progetti.

<p class="callout info">Gli oggetti delle Global List vengono aggiunti dalla **Home** e non dentro al progetto.</p>

---

### Attributi delle Classi Oggetto

Ogni Classe Oggetto è composta da **attributi**, ovvero i campi di dati che descrivono le informazioni da compilare per ogni oggetto della classe.

Un attributo può essere di tipo:

- **Campo di testo** – per nomi o descrizioni
- **Campo numerico** – per valori quantitativi o misurazioni
- **Lista di valori** – per scegliere un’opzione da un elenco predefinito
- **Data** – per inserire date o scadenze
- **Allegati** – per caricare file, immagini o video
- **Dimensioni** – per registrare automaticamente grandezze misurabili (es. lunghezza, area, coordinate)
- **Vero/Falso** – per campi booleani
- **Lista oggetti** – per campi composti da più sotto-attributi, ad esempio un set di misure o parametri ripetuti

[![4 - Attributes.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/bfA4-attributes.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/bfA4-attributes.png)

Ogni attributo ha inoltre proprietà configurabili:

- **Nome** – etichetta del campo
- **Obbligatorietà** – indica se deve essere compilato
- **Valore di default** – valore preimpostato ma modificabile se necessario
- **Bloccato** – campo visibile ma non modificabile
- **Main attribute** – l’attributo principale mostrato quando si interroga l’oggetto, utile per identificarlo rapidamente

[![5 - Attribute configuration.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/Zsc5-attribute-configuration.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Zsc5-attribute-configuration.png)

---

### Creazione e gestione

La creazione e la modifica delle Classi Oggetto avvengono dal [**Backoffice**](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-le-classi-oggetto), accessibile solo agli utenti con permessi adeguati.  
Dopo la pubblicazione, la classe diventa disponibile nei progetti e può essere usata per creare nuovi oggetti.

---

### In sintesi

- Le **Classi Oggetto** definiscono la struttura e la rappresentazione dei dati.
- Possono essere **geometriche** (visualizzate sulla mappa) o **form** (solo schede dati).
- Le **Global List** sono Form condivisi tra progetti, utili per elenchi standardizzati.
- Gli **attributi** definiscono le informazioni che ogni oggetto deve contenere.
- Gli **oriented point** permettono di rappresentare punti direzionati.
- Solo utenti con *permesso backoffice* possono creare o modificare classi.

---

***Last update:** 07 May 2026*