Exporter un essai

Les copies portables et le PDF produit d'un essai : ce que demande 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 portables, puis les documents produits (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 demeurent disponibles tant 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 passage, donc il demande Exécuter les procédures plutôt que la permission d'export et est décrit avec les documents auxquels il appartient (Étiquettes et rapports).

Un export CSV ou XLSX fait en pleine exécution 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 de colonnes complet 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 fichiers

Le CSV, le XLSX, le GLAB et le PDF partagent un seul 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 aboutirait au 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 produit ici garde la base seule. 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 du nom de la voie avec son unité physique entre crochets (« Température [°C] ») et une colonne de qualité à côté (« Température [°C] Quality ») indiquant Good ou Unavailable. La colonne de valeur conserve ce que le datalog a stocké (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 voies de l'en-tête et les lectures d'une voie de texte, qui viennent de l'équipement. Les nombres ne sont jamais préfixés, donc une lecture négative demeure 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 ;, pour que le fichier s'ouvre proprement dans un tableur de cette langue. Les nombres sont écrits sans séparateur de milliers, à la précision complète stockée par le datalog. Le texte est en UTF-8.

XLSX

Le classeur s'ouvre sur une feuille Run, 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 suivent, 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 aucun quadrillage. Un datalog plus long que la limite de 1 048 576 lignes d'une feuille Excel se scinde automatiquement 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 complète stockée par le datalog, les booléens en TRUE/FALSE natifs. Excel lui-même ne travaille qu'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 demanderait 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, page par page, du fichier SQLite propre à l'essai, prise en ligne : 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 productivité, les artefacts d'étiquette avec leurs octets figés et les enregistrements de rapport avec toute 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é choisit. « (rapport de la procédure) » est la mise en page que nomme la première commande de rapport de fin de la procédure dans l'ordre d'émission d'aujourd'hui (sa première commande de démarrage quand elle n'émet rien à la fin); une procédure disparue ou qui n'émet aucun rapport, et une mise en page supprimée, retombent sur le réglage par défaut, toutes sections comprises, pour qu'une régénération survive à 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 seul de l'essai, en remplaçant le rendu manuel précédent, et n'enregistre rien sur l'essai.

Dans la fenêtre propre à la station, le PDF achevé s'ouvre dans le lecteur PDF du système, avec un repli sur un téléchargement du navigateur quand cela échoue (« Impossible d'ouvrir le rapport. Téléchargement à la place. »); dans un navigateur, local ou distant, il s'ouvre dans un nouvel onglet. Ce que contiennent les pages se trouve dans 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.