Le dossier d'essai

Ce qu'un essai ouvert montre : 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.

Afficher en Markdown

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), 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). 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

Les verbes agissent sur l'essai ouvert, donc ils voyagent avec le dossier et non sur la barre propre à la page. Les copies transportables viennent d'abord, puis les documents générés, puis le verbe de danger. Un rôle qui ne porte pas ce qu'un verbe exige ne voit pas ce verbe du tout : la bande est de la taille de ce que le rôle connecté peut faire. Un verbe que la situation refuse reste où il est, 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) Exige (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 transportable. L'essai n'est ni Terminé, ni Interrompu, ni 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 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, est décrit sur Exporter un essai ; le sélecteur d'étiquette est décrit avec le dossier Étiquettes.

L'en-tête

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 contient 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, si bien qu'un champ renommé ou supprimé depuis ne change rien ici. Un champ Nombre se lit dans le format de nombre de la station (Localisation), 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é, si bien 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 lacune. Un nom ou un texte trop long pour la colonne est tronqué par des points de suspension et se lit en entier 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 badges répètent les marques Automatisme et Importé, montrent Enregistrement tant que l'essai est actif, et le badge de verdict dès 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

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 échelle par bande, le long de l'unique axe de temps. Les annotations se tracent en marqueurs bien visibles et les commentaires horodatés pendant l'essai en marqueurs discrets. Les bandes de plage approuvée de l'évaluation de la procédure sont re-résolues depuis 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 tracée. Le graphique porte la barre d'outils commune (Graphiques), y compris le bouton qui ouvre le même graphique dans une fenêtre à lui (/chart/run/<id>), qui recharge l'essai depuis son fichier et lie son zoom à celui du graphique inséré ; cette fenêtre est en lecture seule et demande la même permission que le navigateur.

Critères jugés

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é au moment de l'enregistrement de l'essai.
Voie La voie qu'il surveillait.
Limites La plage approuvée, sous forme de texte d'affichage figé dans l'essai.
Gravité La façon dont le critère a été configuré pour peser 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 lacune 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é, lorsqu'il l'est.

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 que 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 mesurée entièrement).
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 frontière de session d'observation, avec l'occurrence, la gravité, la transition, l'instant et le message. Une ligne de frontière 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 le changement de définition. Une ligne de frontière 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 reste 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 final apparaît sans appuyer sur Actualiser.

Ce que le dossier ne fait pas

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, hormis ses notes, ses annotations et ses documents.