Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Compilare i moduli

Le finestre per creare e modificare gruppi, impianti, circuiti, sensori, allarmi, dispositivi e canali di notifica usano gli stessi tipi di campo. Questa pagina descrive come funzionano, per non ripeterlo in ogni pagina della guida.

Codice

Quasi tutto ciò che si crea nel portale ha un Codice, che lo identifica nei percorsi della piattaforma (ad esempio /acme/europa/) e nelle API. Il codice:

  • viene proposto a partire dal nome mentre lo si scrive: le maiuscole diventano minuscole, e spazi, punteggiatura e lettere accentate diventano _ — ad esempio “Caffè Roma 2” diventa caff_roma_2. Finché è proposto in automatico il campo è grigio e segue il nome
  • si può scrivere a mano selezionando l’icona Modifica manualmente accanto al campo; l’icona Blocca auto-generazione torna alla proposta automatica, ricalcolata dal nome
  • può contenere solo lettere senza accenti, cifre e _: spazi e punteggiatura non si possono digitare, e un codice scritto a mano con lettere accentate viene rifiutato al salvataggio
  • non può essere una delle parole riservate alla piattaforma — ad esempio tenant, plant, device, user, alarm, job, search, me — e il portale lo segnala con “Questo codice è riservato dal sistema”
  • non si può cambiare dopo la creazione, perché altre parti della piattaforma lo usano per trovare l’elemento. Nome e descrizione invece si possono cambiare in ogni momento

Icona

Il campo Icona apre una griglia di icone tra cui scegliere quella che rappresenterà l’elemento nelle schede e nelle righe del portale. Rimuovi icona lascia l’elemento senza icona; Annulla chiude la griglia senza cambiare nulla.

Colore

I campi Colore — ad esempio delle fasce orarie e delle stagioni nel calendario — propongono un elenco di colori con nome (Rosso, Blu, Verde chiaro…) e Non impostato. Per un colore diverso, Seleziona colore apre una tavolozza in cui sceglierlo liberamente, oppure scegliere di nuovo tra i colori con nome; si conferma con Ok.

Numeri

Nei campi numerici i pulsanti ▲ e ▼, o i tasti freccia su e giù della tastiera, aumentano e diminuiscono il valore del passo previsto per quel campo. Il valore resta sempre dentro i limiti ammessi dal parametro.

Orari

I campi orario accettano l’ora anche senza i due punti: 8 diventa 08:00, 830 diventa 08:30, 1745 diventa 17:45. Uscendo dal campo l’orario viene arrotondato al passo del campo, di solito 15 minuti; i tasti freccia su e giù lo spostano di un passo. Quando si modifica un orario già salvato, passando il mouse sul campo si leggono l’orario originale e quello corrente.

Date

I campi data si compilano scrivendo solo le cifre: il formato gg/mm/aaaa viene applicato da solo, e la data è verificata uscendo dal campo o premendo Invio. L’icona del calendario accanto al campo apre un calendario in cui scegliere la data con il mouse.

Chiudere una finestra

Le finestre si chiudono con Annulla, con il tasto Esc oppure selezionando fuori dalla finestra: in tutti questi casi quello che si è scritto e non è stato salvato va perso. I pannelli che salgono dal basso, come quello dei parametri, si chiudono trascinandoli verso il basso.