---
title: Oggetti
section: User Guide
weight: 1
description: Lavorare con gli oggetti nella Piattaforma IIoT — l'elenco e la mappa degli oggetti e la procedura guidata passo dopo passo per creare un oggetto.
related:
  - user-guide
  - user-guide/working-with-platform/equipment
  - user-guide/working-with-platform/customers
  - basic-modules
---

import Image from '@/components/docs/Image.astro';
import Alert from '@/components/docs/Alert.astro';

Un **oggetto** è un sito fisico monitorato dalla piattaforma — un punto di distribuzione del gas, un edificio, un impianto industriale e così via. Un oggetto può ospitare un intero **complesso di misura** (un contatore insieme al suo correttore e all'unità di telemetria) accanto ad apparecchiature ausiliarie come sensori di pressione e temperatura, valvole di intercettazione comandabili da remoto e sensori di sicurezza (apertura porta, presenza di gas e simili).

Gli oggetti sono l'entità centrale della piattaforma — letture, pianificazioni e monitoraggio sono tutti organizzati attorno ad essi. Apri **Oggetti** dal menu a sinistra per gestirli.

## L'elenco degli oggetti

L'**Elenco unità** è una tabella, ricercabile e ordinabile, di ogni oggetto a cui puoi accedere.

<Image
  src="/images/user-guide/objects-light.webp"
  srcDark="/images/user-guide/objects-dark.webp"
  alt="L'elenco degli oggetti nella Piattaforma IIoT, con una tabella di oggetti"
  caption="L'elenco degli oggetti (vista Elenco unità)"
  width={1440}
  height={560}
/>

Ogni riga riepiloga lo stato attuale di un oggetto:

- **ID** e **Nome** — l'identificativo e l'etichetta dell'oggetto.
- **Risorsa** — la risorsa misurata (ad esempio gas, acqua o elettricità).
- **Stato unità di misura** — lo stato operativo dell'oggetto.
- **Modello dispositivo** e **Numero di serie** — il dispositivo di misura collegato.
- **Data letture** / **Data sessione** — quando sono state registrate le ultime letture e l'ultima sessione di comunicazione.
- **Stato sessione di comunicazione** — l'esito della sessione più recente (ad esempio, _Successo_ o _Ricezione dati_).
- **Azioni** — visualizza o modifica l'oggetto.

### Trovare gli oggetti

- **Ricerca** — digita in **Cerca nella tabella** per filtrare le righe per nome o altri campi.
- **Filtra per stato** — usa il menu a discesa **Tutti gli stati** oppure apri **Filtro** per condizioni più dettagliate.
- **Ordina** — seleziona l'intestazione di una colonna ordinabile per ordinare l'elenco.
- **Colonne ed esportazione** — scegli quali colonne mostrare e scarica l'elenco con il comando di esportazione.

<Alert type="tip">
  Contrassegna come preferiti (la stella) gli oggetti che controlli più spesso per raggiungerli
  rapidamente da **Tutti i preferiti**.
</Alert>

## Vista mappa

Passa a **Mappa unità di misura** per vedere i tuoi oggetti posizionati geograficamente. La mappa aiuta a individuare i problemi per area e a navigare visivamente nelle installazioni di grandi dimensioni.

## Creare un oggetto

Seleziona **+ Nuovo oggetto** per aprire la procedura guidata passo dopo passo che costruisce la scheda dell'oggetto.

<Image
  src="/images/user-guide/object-wizard-light.webp"
  srcDark="/images/user-guide/object-wizard-dark.webp"
  alt="La procedura guidata Nuovo oggetto nella Piattaforma IIoT, al passo Informazioni generali"
  caption="La procedura guidata Nuovo oggetto — passo 1 di 5"
  width={1165}
  height={835}
/>

La procedura guidata si articola in cinque passi:

1. **Informazioni generali** — il tipo di risorsa, il cliente e nome, indirizzo e geolocalizzazione dell'oggetto (inserisci le coordinate manualmente o posiziona l'indicatore sulla mappa).
2. **Complesso di misura** — lo stato e la categoria dell'oggetto, le società di fornitura della risorsa e di servizio, l'account o il contratto, i dati di contatto e se è presente un complesso di misura.
3. **Apparecchiature** — il dispositivo di misura (produttore e modello) e le sue impostazioni, insieme a eventuali apparecchiature ausiliarie installate sull'oggetto — sensori, valvole di intercettazione e così via.
4. **Sorgente dati** — come la telemetria dell'oggetto raggiunge la piattaforma e i relativi dati di riferimento.
5. **Riepilogo** — un controllo finale di tutto prima che l'oggetto venga creato.

Nel passo **Complesso di misura** imposti lo stato e la categoria dell'oggetto, le sue società di fornitura della risorsa e di servizio, l'account o il contratto e i dati di contatto, e indichi se è installato un complesso di misura:

<Image
  src="/images/user-guide/object-wizard-step2-light.webp"
  srcDark="/images/user-guide/object-wizard-step2-dark.webp"
  alt="La procedura guidata Nuovo oggetto, passo Complesso di misura"
  caption="La procedura guidata Nuovo oggetto — passo 2, Complesso di misura"
  width={1165}
  height={835}
/>

Il passo **Apparecchiature** configura il dispositivo di misura — produttore, modello, numero di serie, indirizzo di rete, calibro e fonte di energia — e può aggiungere un contatore supplementare accanto a quello principale:

<Image
  src="/images/user-guide/object-wizard-step3-light.webp"
  srcDark="/images/user-guide/object-wizard-step3-dark.webp"
  alt="La procedura guidata Nuovo oggetto, passo Apparecchiature"
  caption="La procedura guidata Nuovo oggetto — passo 3, Apparecchiature"
  width={1165}
  height={835}
/>

Nel passo **Sorgente dati** scegli come la telemetria dell'oggetto raggiunge la piattaforma — il canale di comunicazione e il dispositivo di telemetria:

<Image
  src="/images/user-guide/object-wizard-step4-light.webp"
  srcDark="/images/user-guide/object-wizard-step4-dark.webp"
  alt="La procedura guidata Nuovo oggetto, passo Sorgente dati"
  caption="La procedura guidata Nuovo oggetto — passo 4, Sorgente dati"
  width={1165}
  height={835}
/>

Infine, il passo **Riepilogo** mostra un resoconto di tutto ciò che hai inserito, raggruppato per sezione, così puoi verificarlo — oppure tornare a **Modifica** una qualsiasi sezione — prima che l'oggetto venga creato:

<Image
  src="/images/user-guide/object-wizard-step5-light.webp"
  srcDark="/images/user-guide/object-wizard-step5-dark.webp"
  alt="La procedura guidata Nuovo oggetto, passo Riepilogo"
  caption="La procedura guidata Nuovo oggetto — passo 5, Riepilogo"
  width={1165}
  height={835}
/>

Usa **Avanti** e **Indietro** per spostarti tra i passi. Una volta terminato, seleziona **Crea oggetto**; comparirà quindi nell'elenco e inizierà a trasmettere i dati secondo la propria pianificazione.
