# Commenti e annotazioni

> Note libere registrate con un istante e un autore nel file della prova, e i marcatori posati a un dato tempo sul grafico del datalog, con i gesti di aggiunta, modifica ed eliminazione di ciascuno.

Un file di prova porta due generi di nota. Un **commento** è testo libero registrato con un
istante e, quando la superficie che scrive ne ha nominato uno, un autore; un'**annotazione**
è un marcatore posato a un dato tempo sul grafico del datalog. I due vivono nel file della
prova, quindi una copia GLAB se li porta dietro e un rapporto li può stampare, e i due si
disegnano sul grafico: un commento scritto mentre la prova registrava sta al proprio
istante, e uno scritto dopo sta appuntato alla fine del tracciato, dove sta l'ultimo
campione della prova. Le due sezioni stanno in fondo al registro, e ogni scrittura richiede
Gestire gli storici e una stazione che accetti scritture: su una stazione in sola
lettura le caselle e i verbi di riga passano in grigio e dicono "Runtime fermo".

A un ruolo senza quel permesso vengono mostrate entrambe le sezioni per intero e nessun modo
di aggiungervi qualcosa: nessuna casella, nessun verbo di aggiunta e nessuna eliminazione su
una riga.

## Commenti {#comments}

Un commento scritto su una prova che sta ancora registrando atterra sulla sua cronologia;
uno scritto su una prova terminata è contrassegnato **Dopo la prova**. L'autore è chi è
connesso sulla schermata che lo ha scritto, oppure la stazione quando non c'è nessuno; la
colonna Autore resta vuota per una nota registrata da una superficie che non ha nominato
nessuno.

| Comando | Che cosa fa |
| --- | --- |
| La casella ("Nota libera registrata con una marca temporale nel file della prova") e **Aggiungi una nota** | Registra il testo con l'istante attuale; anche Invio aggiunge. Una casella vuota lascia il verbo in grigio con "Digitare prima la nota: una nota vuota non registra nulla.", e il servizio rifiuta allo stesso modo un testo in bianco ("Un commento ha bisogno di un testo."). |
| La griglia | Una riga per commento, dal più vecchio: **Alle**, **Fase** (Prova o Dopo la prova), **Autore**, **Commento**. |
| La cella Commento | Si modifica in linea e viene confermata quando si lascia il campo: un testo in bianco o immutato lascia stare il registro, una vera riscrittura timbra l'istante della modifica, e una riscrittura che la stazione rifiuta rimette il testo memorizzato. |
| L'eliminazione della riga | Chiede prima ("Elimina il commento", citando la nota: "Questo rimuove la nota dal file della prova."), perché una nota è una prova documentale e lascia il file della prova soltanto quando lo decide l'operatore. |

I commenti scritti durante la prova dal pannello di un'unità, dal componente Comments di una
dashboard o attraverso il punto `Commands.Comment` compaiono qui insieme agli altri ([Prove e
commenti](process-runs#the-comments-card)).

## Annotazioni {#annotations}

| Comando | Che cosa fa |
| --- | --- |
| **Secondi** | Il tempo del marcatore, in secondi dal primo campione della prova; le frazioni decimali sono accettate e si scrivono con il separatore decimale della stazione (il punto è letto anche su qualsiasi stazione). Qualsiasi altra cosa è rifiutata ("Inserisci il tempo dell'annotazione in secondi dall'avvio della prova."). |
| La casella di testo ("Testo dell'annotazione mostrato accanto al marcatore") e **Aggiungi un'annotazione** | Registra il marcatore; anche Invio aggiunge. Un testo vuoto lascia il verbo in grigio con "Digitare prima il testo dell'annotazione: un marcatore che non dice nulla non segna nulla." |
| La griglia | **Alle** (l'istante assoluto a cui i secondi si sono risolti) e **Annotazione**. |
| L'eliminazione della riga | Chiede prima ("Elimina l'annotazione", citando il testo: "Questo rimuove il marcatore dal file della prova."). |

Un'annotazione ha bisogno di una prova con almeno un campione registrato, dato che i
secondi si contano dal primo; su una prova senza righe il verbo non fa nulla. Le annotazioni
si possono aggiungere tanto a una prova che sta ancora registrando quanto a una terminata, e
sono ciò che stampa l'opzione del rapporto "Disegnavi sopra le annotazioni del grafico della
prova".