# Le dossier d'essai

> Ce que montre un essai ouvert : la bande de verbes au-dessus de lui, l'en-tête avec son statut, les métadonnées enregistrées au démarrage et les deux acteurs, l'avis de verrouillage, le graphique du datalog, les critères jugés et les épisodes d'occurrence.

Sélectionner un essai ouvre son dossier sur la moitié droite du navigateur : une bande de verbes qui
reste en place pendant que le dossier défile, puis l'en-tête, le graphique du datalog, les critères
jugés, les dossiers **Rapport** et **Étiquettes** ([Étiquettes et
rapports](histories-documents)), le dossier **Lignes de base de données** sur un essai qui a
écrit dans une base de données, les occurrences, et les commentaires et annotations
([Commentaires et annotations](histories-notes)). Sans rien de sélectionné, le volet indique
« Sélectionnez un essai pour examiner son datalog, son verdict, ses critères jugés, ses étiquettes et
ses occurrences. »

## La bande {#the-strip}

Les verbes agissent sur l'essai ouvert, donc ils voyagent avec le dossier et non sur la barre propre
à la page. Les copies portables viennent d'abord, puis les documents produits, puis le verbe de
danger. Un rôle qui ne détient pas ce qu'un verbe demande ne voit pas ce verbe du tout : la bande est
de la taille de ce que le rôle dont la session est ouverte peut faire. Un verbe que la situation
refuse demeure à sa place, grisé, et son infobulle dit ce qui manque (« Choisissez d'abord un
essai. », « Cet essai enregistre encore. Terminez-le d'abord. », « Une autre commande d'essai est
encore en cours. »).

| Commande | Ce qu'elle fait | Grisée quand (situation) | Demande (non dessinée sans cela) |
| --- | --- | --- | --- |
| Exporter en CSV | Télécharge le datalog brut en CSV. | Un autre verbe de la bande est encore en cours. | Exporter/importer les historiques |
| Exporter en XLSX | Télécharge l'identité de l'essai, les métadonnées et le datalog typé sous forme de classeur Excel. | Idem. | Exporter/importer les historiques |
| Exporter en GLAB | Télécharge l'essai entier sous forme de fichier `.glab` portable. | L'essai n'est pas Terminé, Interrompu ou En échec. | Exporter/importer les historiques |
| Générer le PDF, avec **Rapport utilisé par Générer le PDF** | Compose le PDF de l'essai avec la mise en page choisie (« (rapport de la procédure) » ou toute mise en page de la bibliothèque) et l'ouvre. | L'essai est encore En cours ou Suspendu. | Exporter/importer les historiques |
| Nouvelle étiquette, avec **Modèle utilisé par Nouvelle étiquette** | Enregistre un nouvel artefact d'étiquette à partir de l'une des étiquettes que la procédure de l'essai configure, dans la section Étiquettes de l'essai, et n'envoie rien. | Aucune étiquette n'est configurée (« La procédure de cet essai ne configure aucune étiquette. »), le modèle de document de l'étiquette choisie a disparu ou est vide, la station est en lecture seule. | Voir les historiques, Exécuter les procédures |
| Supprimer | Supprime l'essai et son fichier après confirmation. | L'essai est En cours, Suspendu ou en Écriture; la station est en lecture seule. | Gérer les historiques |

Ce que contient chaque export, et où le PDF s'ouvre, se trouve dans
[Exporter un essai](histories-export); le sélecteur d'étiquette est décrit avec le dossier
Étiquettes.

## L'en-tête {#the-header}

Le nom de l'essai, une ligne de statut (« Consultation · nom »; « En cours · nom (instantané en
attente) » pour un essai qui n'a encore rien enregistré; « Aucune donnée · nom » pour un essai
terminé dont le fichier ne porte aucune ligne), les métadonnées que l'essai a enregistrées au
démarrage, et les deux acteurs.

Les métadonnées forment une paire par champ que l'essai a enregistré au démarrage, dans l'ordre des
invites et sous le nom que le champ portait au démarrage de l'essai : le numéro de série, le lot et
tout autre champ, lus dans le fichier d'essai, de sorte qu'un champ renommé ou retiré depuis ne
change rien ici. Un champ **Nombre** se lit dans le format de nombre de la station
([Localisation](settings-localization)), avec les décimales que l'opérateur a saisies : `12.50`
garde ses deux décimales et se lit `12,50` sur une station qui écrit les décimales avec une virgule.
Il ne prend jamais de séparateur de milliers : un lot ou un numéro de pièce enregistré comme nombre
est un identifiant et non une quantité, de sorte que `1024` se lit `1024` sur toute station. Toute
autre valeur, identifiant séquentiel compris, se lit exactement telle qu'elle a été enregistrée, et
un champ que l'opérateur a laissé vide au démarrage montre la marque de vide. Un nom ou un texte
trop long pour la colonne est tronqué par des points de suspension et se lit au complet dans son
infobulle; un nombre n'est jamais tronqué. Un essai qui n'a enregistré aucune métadonnée, comme un
instantané ou une évaluation, n'en montre aucune.

Les deux acteurs :

- **Démarré par** vient de l'index des essais, donc il est présent pour tout essai, même un essai qui
  enregistre encore : le nom de l'opérateur tel qu'il était alors, « La station », « Automatisme »
  ou « Agent logiciel ».
- **Arrêté par** ne vit que dans le fichier d'essai figé. Il indique **Enregistrement en cours**
  tant que l'essai est actif, nomme qui a demandé l'arrêt ou l'interruption, ou explique une fin que
  personne n'a demandée : **Verrouillage**, **Personne (l'essai a échoué)**, ou **Personne (terminé
  de lui-même)** pour une fenêtre qui est allée à son terme, un essai Instantané ou une commande
  unique.

Quand l'essai a été suspendu, **Suspendu par** et **Repris par** s'insèrent entre les deux : qui
a fait la dernière suspension et la dernière reprise, avec le moment, nommés de la même façon (le
nom de l'opérateur tel qu'il était alors, « La station », « Automatisme » ou « Agent logiciel »).
Un essai jamais suspendu n'affiche ni l'un ni l'autre.

Un essai importé ajoute `Importé <quand> · depuis <fichier>`. Les pastilles répètent les marques
Automatisme et Importé, montrent **Enregistrement** tant que l'essai est actif, et le badge de
verdict une fois qu'il ne l'est plus. Un essai auquel le verrouillage d'arrêt de l'unité a mis fin
porte l'avis **Terminé par le verrouillage** : « Cet essai reste Interrompu avec le verdict Non
conforme. Le motif de fin indique que le signal d'arrêt externe de cette unité l'a terminé. »

Un essai qui a échoué à l'intérieur de la station porte l'avis **Terminé par une défaillance** : une
phrase qui nomme l'étape défaillante, suivie de « Le journal technique de la station en conserve le
détail. » La phrase est l'une des suivantes, dans la langue de la station; l'erreur elle-même n'est
écrite que dans le journal technique.

| Phrase | Quand |
| --- | --- |
| Le fichier d'essai n'a pas pu être écrit, l'enregistrement s'est donc arrêté. | Le fichier d'essai a refusé une ligne que l'essai enregistrait. |
| L'échantillonnage s'est arrêté sur une erreur en lisant ou en jugeant une ligne. | L'échantillonnage a échoué en prenant ou en jugeant une ligne. |
| La progression de l'essai n'a pas pu être enregistrée dans l'historique de la station, l'enregistrement s'est donc arrêté. | L'écriture périodique qui marque l'essai comme vivant dans l'historique a échoué. |
| La recette s'est arrêtée sur une erreur interne. | Le moteur qui envoie les consignes de la recette a échoué. |
| La minuterie des cycles de l'essai s'est arrêtée sur une erreur interne. | L'horloge qui cadence les cycles d'un essai avec fenêtre de temps et sans recette a échoué. |
| L'essai a échoué pendant son démarrage. | Quelque chose a échoué après la création de l'essai et avant qu'il n'enregistre. |
| L'essai n'a pas pu reprendre après le redémarrage de la station. | Après un redémarrage, l'essai n'a pas pu être repris : son fichier, sa procédure ou son unité était inaccessible, ou un essai plus ancien occupait déjà l'unité. |
| La station s'est fermée pendant l'enregistrement de l'essai. | La station s'est arrêtée pendant l'écriture de la fin de l'essai. |
| La fin de l'essai n'a pas pu être enregistrée. | L'enregistrement de la fin de l'essai, ou la fermeture de son fichier, a échoué. |

Un essai qui a échoué dans une version antérieure, ou dont l'entrée dans l'historique a été
reconstruite à partir de son fichier, se lit En échec sans avis. Un essai arrêté ou interrompu, et
un essai terminé par le verrouillage, ne le portent jamais.

## Le graphique du datalog {#the-datalog-chart}

Le dossier trace les voies enregistrées de l'essai directement dans la page, sur un axe en secondes
relatives depuis le premier échantillon, chaque série dans la couleur figée avec l'essai et étiquetée
par le nom que la voie portait sur l'unité. Les bandes empilées sont figées avec l'essai elles aussi,
donc le dossier et le rapport dessinent l'image que la station montrait même après que le modèle a
été regroupé : une règle par bande, le long de l'axe de temps unique. Les annotations se dessinent en
repères marqués et les commentaires horodatés pendant l'essai en repères atténués. Les bandes de
plage approuvée de l'évaluation de la procédure sont résolues de nouveau dans la configuration
actuelle à chaque ouverture de l'essai, parce que le fichier d'essai ne porte les limites que sous
forme de texte d'affichage : une évaluation supprimée les fait disparaître, et une limite relative
n'est pas dessinée. Le graphique porte la barre de commandes commune ([Graphiques](view-charts)), y
compris le bouton qui ouvre le même graphique dans une fenêtre à lui (`/chart/run/<id>`), laquelle
recharge l'essai depuis son fichier et lie son zoom à celui du graphique de la page; cette fenêtre
est en lecture seule et demande la même permission que le navigateur.

## Critères jugés {#judged-criteria}

Quand la procédure de l'essai a jugé des critères, le dossier liste une ligne par fenêtre jugée :

| Colonne | Contenu |
| --- | --- |
| N° de cycle | Le cycle dans lequel le critère a été jugé, à partir de 1. |
| Critère | Le nom du critère tel qu'il était configuré quand l'essai a enregistré. |
| Voie | La voie qu'il surveillait. |
| Limites | La plage approuvée, sous forme de texte d'affichage figé dans l'essai. |
| Gravité | Le poids que le critère était configuré à porter sur le verdict. |
| Résultat | Conforme, Non conforme ou Indéterminé pour cette fenêtre. |
| Preuve | Le tronçon jugé, puis les quatre compteurs d'échantillons : « n évaluées · n hors bande · n indisponibles · n non valides ». Le tronçon est « Essai entier », « Cycle N » dans un essai cyclique, « 2 s à 10 s » ou « 2 s jusqu'à la fin » pour une fenêtre temporelle, « Segment de recette 3 » ou « Segment de recette 3, après 5 s » pour un segment et sa stabilisation, « Cycle N, 2 s à 10 s » à l'intérieur d'un cycle; un critère en mode Un seul point ajoute « dernier échantillon » (« Essai entier, dernier échantillon »), et ses compteurs sont ceux de ce seul échantillon. Un essai enregistré par une version antérieure n'affiche que les compteurs. |
| Voies concernées | Les voies dont les échantillons indisponibles ou invalides ont affaibli la preuve, ou la marque de vide quand la preuve était complète. |
| Pire écart | Le plus grand écart au-delà d'une borne parmi les échantillons comptés, écrit avec trois décimales, ou davantage quand trois se liraient zéro : 0 quand des échantillons ont été évalués et qu'aucun n'était hors bande, vide quand rien n'a été évalué. Un essai enregistré par une version antérieure le laisse vide là où rien n'était hors bande. |
| Remarque | Pourquoi le résultat est indéterminé, quand il l'est. |

## Occurrences {#occurrences}

Quand l'essai a observé des occurrences, le dossier dérive des **épisodes**, une ligne par activation
plutôt qu'une par transition brute :

| Colonne | Contenu |
| --- | --- |
| Occurrence surveillée | Le nom de l'occurrence. |
| Gravité | Critique, Avertissement ou Information, telle qu'elle a été figée à l'observation. |
| Début | Quand l'épisode a commencé, ou « Inconnu ». |
| Fin / statut | Quand et comment il s'est terminé (« Levé »), ou son statut ouvert : « Actif · en direct », « Actif à la fin de l'essai », « Interrompu », « Incomplet », « Incohérent ». |
| Temps actif | Combien de temps la condition s'est maintenue, avec « · en direct » tant qu'elle se maintient encore et « · observé » quand la fin de l'essai l'a bornée. |
| Signal indisponible | Combien de temps le signal surveillé a été illisible pendant l'épisode (« Aucun » quand il ne l'a jamais été, « · partiel » quand la perte n'a pas pu être entièrement mesurée). |
| Texte | Le message figé avec l'occurrence. |

Sous les épisodes, un dépliant **Chronologie technique** (son résumé compte les événements et les sessions d'observation) liste chaque front brut enregistré (Activée, Levée, Indisponible,
Rétablie) et chaque limite de session d'observation, avec l'occurrence, la gravité, la transition,
l'instant et le message. Une ligne de limite explique pourquoi une nouvelle session d'observation a
commencé : après la reprise de l'essai, après le redémarrage du surveillant, après la modification de
la définition. Une ligne de limite est dessinée avant chaque session d'observation d'une occurrence
après la première; la première session n'en a pas.

Tant que l'essai sélectionné enregistre encore, sa preuve d'occurrence demeure vivante : les
horloges avancent chaque seconde, la preuve et la ligne d'index de l'essai sont relues toutes les
deux secondes, donc l'état terminal apparaît sans presser Actualiser.

## Ce que le dossier ne fait pas {#what-the-record-does-not-do}

Il ne montre pas les lignes enregistrées sous forme de tableau : le datalog se lit sur le graphique
ou dans un export CSV ou XLSX. Il ne rejuge rien : les critères sont les résultats figés de l'essai,
et les bandes du graphique sont un contexte venu de la configuration d'aujourd'hui, jamais un
verdict. Et il ne modifie rien de l'essai sauf ses notes, ses annotations et ses documents.