# Commentaires et annotations

> Les notes libres enregistrées dans le fichier d'essai avec un horodatage et un auteur, et les marqueurs placés à un instant du graphique du datalog, avec les gestes d'ajout, de modification et de suppression de chacun.

Un fichier d'essai porte deux sortes de note. Un **commentaire** est un texte libre enregistré avec
un horodatage et, quand la surface qui l'écrit en a nommé un, un auteur ; une **annotation** est un
marqueur placé à un instant du graphique du datalog. Les deux vivent dans le fichier d'essai, donc
une copie GLAB les emporte et un rapport peut les imprimer, et les deux se tracent sur le graphique :
un commentaire écrit pendant que l'essai enregistrait se place à son propre instant, et un
commentaire écrit après se place épinglé à la fin du sous-graphique, là où se trouve le dernier échantillon de
l'essai. Les deux sections se tiennent au pied du dossier, et chaque écriture demande Gérer les
historiques et une station qui accepte les écritures : sur une station en lecture seule, les champs
et les verbes de ligne grisent et disent « Runtime arrêté ».

Un rôle qui n'a pas cette permission voit les deux sections en entier et aucun moyen d'y
ajouter quoi que ce soit : pas de champ, pas de verbe d'ajout, pas de suppression sur une ligne.

## Commentaires {#comments}

Un commentaire écrit sur un essai qui enregistre encore se pose sur sa chronologie ; un commentaire
écrit sur un essai terminé est marqué **Après l'essai**. L'auteur est la personne connectée sur l'écran
qui l'a écrit, ou la station quand personne ne l'est ; la colonne Auteur reste vide pour une note
enregistrée par une surface qui n'a nommé personne.

| Contrôle | Ce qu'il fait |
| --- | --- |
| Le champ (« Remarque libre enregistrée avec un horodatage dans le fichier d'essai ») et **Ajouter une remarque** | Enregistre le texte avec l'instant courant ; Entrée ajoute aussi. Un champ vide laisse le verbe grisé avec « Saisissez d'abord la remarque : une remarque vide n'enregistre rien. », et le service refuse un texte blanc de la même façon (« Un commentaire a besoin d'un texte. »). |
| La grille | Une ligne par commentaire, du plus ancien au plus récent : **À**, **Moment** (Essai ou Post-essai), **Auteur**, **Commentaire**. |
| La cellule Commentaire | Se modifie sur place et est validée quand le champ est quitté : un texte blanc ou inchangé laisse le dossier tel quel, une vraie réécriture horodate la modification, et une réécriture que la station refuse remet le texte enregistré. |
| La suppression de la ligne | Demande d'abord (« Supprimer le commentaire », en citant la note : « Ceci retire la remarque du fichier d'essai. »), parce qu'une note est une preuve et ne quitte le fichier d'essai que si vous le dites. |

Les commentaires écrits pendant l'essai depuis le volet d'une unité, depuis le composant
Commentaires d'un tableau de bord ou par le point `Commands.Comment` apparaissent ici avec les
autres ([Essais et
commentaires](process-runs#the-comments-card)).

## Repères du graphique {#annotations}

| Contrôle | Ce qu'il fait |
| --- | --- |
| **Secondes** | L'instant du marqueur, en secondes depuis le premier échantillon de l'essai ; les fractions décimales sont acceptées, écrites avec le séparateur décimal de la station (le point est lu aussi sur toute station). Tout le reste est refusé (« Saisissez l'instant de l'annotation en secondes depuis le début de l'essai. »). |
| Le champ de texte (« Texte du repère affiché à côté du marqueur ») et **Ajouter un repère** | Enregistre le marqueur ; Entrée ajoute aussi. Un texte vide laisse le verbe grisé avec « Saisissez d'abord le texte du repère : un marqueur qui n'a rien à dire ne marque rien. » |
| La grille | **À** (l'instant absolu auquel les secondes se sont résolues) et **Repère**. |
| La suppression de la ligne | Demande d'abord (« Supprimer le repère », en citant le texte : « Ceci retire le marqueur du fichier d'essai. »). |

Une annotation exige un essai qui a au moins un échantillon enregistré, puisque les secondes sont
comptées depuis le premier ; sur un essai sans lignes, le verbe ne fait rien. Des annotations
peuvent être ajoutées aussi bien à un essai qui enregistre encore qu'à un essai terminé, et ce sont
elles que l'option « Y tracer les repères du graphique de l'essai » du rapport imprime.