Exporter un essai

Les copies transportables et le PDF généré d'un essai : ce qu'exige chaque verbe, comment les fichiers sont nommés, et exactement ce que contiennent un CSV, un XLSX, un GLAB et un PDF.

La bande au-dessus de l'essai ouvert porte d'abord les copies transportables, puis les documents générés (Le dossier d'essai). Les quatre verbes ci-dessous demandent la permission Exporter/importer les historiques, et tous les quatre sont des lectures du fichier d'essai : ils restent disponibles pendant que le runtime est arrêté et pendant qu'une unité enregistre, et aucun d'eux n'écrit quoi que ce soit dans l'essai.

La bande porte un cinquième verbe, Nouvelle étiquette, qui n'est ni un export ni une lecture : il émet une étiquette dans l'essai et y est enregistré comme preuve de son émission, donc il demande Exécuter les procédures au lieu de la permission d'export et il est décrit avec les documents auxquels il appartient (Étiquettes et rapports).

Un export CSV ou XLSX en cours d'essai est une copie partielle cohérente : l'en-tête figé est écrit au démarrage de l'essai, donc l'export porte le jeu complet de colonnes et les lignes enregistrées jusque-là, lues à travers l'enregistrement en cours plutôt que par une seconde connexion au fichier. Chaque date et chaque heure d'un export suivent le format configuré dans Paramètres, et chaque fichier déclare la référence dans laquelle ses horodatages se lisent : « UTC » ou « UTC±hh:mm », le décalage de la station au moment de l'export.

Noms de fichier

CSV, XLSX, GLAB et PDF partagent un même nom de base par essai : l'instant de démarrage au format de date et d'heure de la station avec des séparateurs compatibles avec un nom de fichier, puis les noms du modèle, de l'unité et de la procédure (« 02-09-2026 14-05-30 - Chambre climatique - Unité 1 - Essai de palier »), chaque partie raccourcie à 48 caractères et débarrassée des caractères que Windows refuse. La base est réservée durablement, donc des exports répétés d'un même essai gardent le même nom d'un redémarrage à l'autre, et seul un essai différent qui tomberait sur le même nom reçoit un court suffixe tiré de son identité. Un rapport émis par une action ajoute le nom du groupe après la base ; un PDF généré ici garde la base simple. Chaque fichier est achevé sous un nom temporaire et publié seulement une fois complet, donc un export annulé ne laisse jamais un fichier partiel portant l'extension du produit.

CSV

Une colonne Timestamp, intitulée « Timestamp (UTC-03:00) » avec la référence de temps, puis, par voie enregistrée et dans l'ordre de colonnes figé, une colonne de valeur intitulée par le nom de la voie avec son unité physique entre crochets (« Temperature [°C] ») et, à côté, une colonne de qualité (« Temperature [°C] Quality ») qui indique Good ou Unavailable. La colonne de valeur garde ce que le datalog a enregistré (vide quand il n'y avait rien), les booléens se lisent true/false, une voie de type date se lit au format de la station, et une valeur qui contient le séparateur, un guillemet ou un saut de ligne est mise entre guillemets. Une cellule de texte qui commence par =, +, - ou @ est préfixée d'une apostrophe pour qu'un tableur la lise comme du texte et non comme une formule : les noms de voie de l'en-tête et les lectures d'une voie de type texte, qui viennent de l'équipement. Les nombres ne sont jamais préfixés, donc une lecture négative reste un nombre.

Le fichier suit la préférence de séparateur décimal de la station : avec le point décimal, le séparateur de liste est , ; avec la virgule décimale, c'est ;, de sorte que le fichier s'ouvre proprement dans un tableur de cette langue. Les nombres sont écrits sans séparateur de milliers, à la précision entière conservée par le datalog. Le texte est en UTF-8.

XLSX

Le classeur s'ouvre sur une feuille Run, de deux colonnes intitulées Field et Value :

Un second en-tête, Metadata et Value, suit avec une ligne par champ de métadonnées enregistré au Démarrage, dans l'ordre des invites. Une ou plusieurs feuilles Datalog viennent ensuite, dans le même ordre de colonnes que le CSV, avec la ligne d'en-tête figée, un filtre automatique sur chaque feuille et sans quadrillage. Un datalog plus long que la limite de 1 048 576 lignes par feuille d'Excel se divise tout seul en Datalog 2, Datalog 3 et ainsi de suite, chacune avec son propre en-tête.

Les valeurs sont écrites en cellules typées : les entiers et les décimaux finis en nombres natifs, à la précision entière conservée par le datalog, et les booléens en TRUE/FALSE natifs. Excel lui-même travaille avec 15 chiffres significatifs au plus, donc les chiffres au-delà n'y sont pas montrés, même si le fichier les porte. Une lecture non finie, une voie de type date et les horodatages sont du texte ; une lecture dont la qualité est Unavailable laisse sa cellule de valeur vide, la colonne de qualité le disant. Un essai qui exigerait plus que les 16 384 colonnes d'Excel, ou une cellule de texte au-delà de sa limite de 32 767 caractères, est refusé avec la raison plutôt que de produire un classeur tronqué.

GLAB

Le fichier .glab est une copie cohérente, au niveau des pages, du fichier SQLite propre à l'essai, prise à chaud : pas d'enveloppe d'archive, pas de manifeste, pas de documents dérivés et pas de PDF publié. Il porte tout ce que porte le fichier d'essai : l'instantané figé, les lignes, les métadonnées, les écritures de recette, les critères, les occurrences, les commentaires, les annotations, les enregistrements de production, les artefacts d'étiquette avec leurs octets figés et les enregistrements de rapport avec la copie qu'ils ont gardée. Il emploie le même nom de base que les autres exports et n'est publié qu'une fois complètement écrit. Une autre station le reprend par Importer des essais.

PDF

Générer le PDF compose le rapport avec la mise en page que le sélecteur à côté de lui choisit. « (rapport de la procédure) » est la mise en page que nomme aujourd'hui la première commande de rapport de fin de la procédure, dans l'ordre d'émission (sa première commande de démarrage quand elle n'en émet aucune à la Fin) ; une procédure disparue ou qui n'émet aucun rapport, et une mise en page supprimée, retombent sur la mise en page par défaut à toutes les sections, donc une régénération survit à la configuration. Toute autre mise en page de la bibliothèque peut être choisie à la place, parce que le fichier d'essai se suffit à lui-même. Le PDF est publié dans le dossier des rapports sous le nom de base simple de l'essai, en remplaçant le rendu manuel précédent, et il n'enregistre rien sur l'essai.

Dans la fenêtre propre à la station, le PDF terminé s'ouvre dans la visionneuse PDF du système, avec un repli sur un téléchargement du navigateur quand cela échoue (« Le rapport n'a pas pu être ouvert. Il est téléchargé à la place. ») ; dans un navigateur, local ou distant, il s'ouvre dans un nouvel onglet. Ce que contiennent les pages est décrit sur Mises en page de rapport. Le rapport déjà enregistré pour un essai se réémet plutôt depuis Étiquettes et rapports, qui ne le compose jamais de nouveau.