Einen Lauf exportieren

Die tragbaren Kopien und das erzeugte PDF eines Laufs: was jeder Befehl verlangt, wie die Dateien benannt werden und was genau eine CSV, eine XLSX, eine GLAB und ein PDF enthalten.

Der Streifen über dem geöffneten Lauf trägt zuerst die tragbaren Kopien, dann die erzeugten Dokumente (Die Laufaufzeichnung). Die vier Befehle weiter unten verlangen die Berechtigung Historien exportieren/importieren, und alle vier sind Lesevorgänge auf der Laufdatei: Sie bleiben verfügbar, solange die Runtime gestoppt ist und während eine Einheit aufzeichnet, und keiner von ihnen schreibt etwas in den Lauf.

Der Streifen trägt einen fünften Befehl, Neues Etikett, der weder ein Export noch ein Lesevorgang ist: Er gibt ein Etikett in den Lauf aus und wird dort als Nachweis dafür aufgezeichnet, er verlangt also Abläufe ausführen statt der Exportberechtigung und ist bei den Dokumenten beschrieben, zu denen er gehört (Etiketten und Berichte).

Ein Export nach CSV oder XLSX mitten im Lauf ist eine in sich stimmige Teilkopie: Der eingefrorene Kopf wird beim Start des Laufs geschrieben, der Export trägt also den vollständigen Satz Spalten und die bis dahin aufgezeichneten Zeilen, gelesen über die laufende Aufzeichnung statt über eine zweite Verbindung zur Datei. Jedes Datum und jede Uhrzeit in einem Export folgt dem Format, das in den Einstellungen festgelegt ist, und jede Datei erklärt den Bezug, in dem ihre Stempel zu lesen sind: "UTC" oder "UTC±hh:mm", der Zeitversatz der Station beim Export.

Dateinamen

CSV, XLSX, GLAB und PDF teilen je Lauf einen Grundnamen: den Startzeitpunkt im Datums- und Zeitformat der Station, dessen Trennzeichen dateisicher gemacht wurden, dann die Namen von Modell, Einheit und Ablauf ("02-09-2026 14-05-30 - Klimakammer - Einheit 1 - Dauerprüfung"), jeder Teil auf 48 Zeichen gekürzt und um Zeichen bereinigt, die Windows abweist. Der Grundname wird dauerhaft reserviert, wiederholte Exporte eines Laufs behalten also über Neustarts hinweg denselben Namen, und nur ein anderer Lauf, der auf denselben Namen fiele, erhält aus seiner Kennung ein kurzes Anhängsel. Ein Bericht, den eine Aktion ausgibt, hängt den Namen der Gruppe an den Grundnamen; ein hier erzeugtes PDF behält den schlichten Grundnamen. Jede Datei wird unter einem vorläufigen Namen fertig geschrieben und erst dann veröffentlicht, wenn sie vollständig ist, ein abgebrochener Export lässt also nie eine Teildatei mit der Endung des Produkts zurück.

CSV

Eine Spalte Timestamp, überschrieben mit "Timestamp (UTC-03:00)" samt Zeitbezug, dann, je aufgezeichnetem Kanal in der eingefrorenen Spaltenreihenfolge, eine Wertespalte, überschrieben mit dem Namen des Kanals und seiner technischen Einheit in eckigen Klammern ("Temperature [°C]"), und daneben eine Qualitätsspalte ("Temperature [°C] Quality"), die Good oder Unavailable lautet. Die Wertespalte behält, was das Datalog gespeichert hat (leer, wenn nichts gespeichert war), Wahrheitswerte lauten true/false, ein als Datum typisierter Kanal liest sich im Format der Station, und ein Wert, der das Trennzeichen, ein Anführungszeichen oder einen Zeilenumbruch enthält, wird in Anführungszeichen gesetzt. Einer Textzelle, die mit =, +, - oder @ beginnt, wird ein Apostroph vorangestellt, damit eine Tabellenkalkulation sie als Text und nicht als Formel liest: den Namen der Kanäle in der Kopfzeile und den Messwerten eines Textkanals, die von der Anlage kommen. Zahlen erhalten nie ein Anhängsel, ein negativer Messwert bleibt also eine Zahl.

Die Datei folgt der Einstellung der Station für das Dezimaltrennzeichen: Bei Dezimalpunkt ist das Listentrennzeichen ,, bei Dezimalkomma ist es ;, so dass die Datei in einer Tabellenkalkulation dieser Region sauber öffnet. Zahlen werden ohne Tausendertrennzeichen geschrieben, in der vollen gespeicherten Genauigkeit des Datalogs. Der Text ist UTF-8.

XLSX

Die Arbeitsmappe öffnet mit einem Blatt Run, zwei Spalten mit den Überschriften Field und Value:

Es folgt eine zweite Überschrift, Metadata und Value, mit einer Zeile je Metadatenfeld, das bei Start aufgezeichnet wurde, in der Reihenfolge der Abfrage. Danach folgen ein oder mehrere Blätter Datalog, in derselben Spaltenreihenfolge wie die CSV, mit fixierter Kopfzeile, einem Autofilter auf jedem Blatt und ohne Gitternetzlinien. Ein Datalog, das länger ist als die Grenze von 1.048.576 Zeilen eines Excel-Blattes, teilt sich von selbst auf Datalog 2, Datalog 3 und so weiter auf, jedes mit eigener Kopfzeile.

Die Werte werden als typisierte Zellen geschrieben: ganze Zahlen und endliche Dezimalzahlen als echte Zahlen in der vollen gespeicherten Genauigkeit des Datalogs, Wahrheitswerte als echtes TRUE/FALSE. Excel selbst rechnet mit höchstens 15 signifikanten Stellen, weitere Stellen werden dort also nicht gezeigt, obwohl die Datei sie trägt. Ein nicht endlicher Messwert, ein als Datum typisierter Kanal und die Zeitstempel sind Text; ein Messwert, dessen Qualität Unavailable ist, lässt seine Wertezelle leer, und die Qualitätsspalte sagt es. Ein Lauf, der mehr als die 16.384 Spalten von Excel bräuchte, oder eine Textzelle über deren Grenze von 32.767 Zeichen wird mit dem Grund abgewiesen, statt eine abgeschnittene Arbeitsmappe zu erzeugen.

GLAB

Die .glab-Datei ist eine in sich stimmige, seitengenaue Kopie der eigenen SQLite-Datei des Laufs, im laufenden Betrieb genommen: keine Archivhülle, kein Manifest, keine abgeleiteten Dokumente und kein veröffentlichtes PDF. Sie trägt alles, was die Laufdatei trägt: die eingefrorene Momentaufnahme, die Zeilen, die Metadaten, die Schreibvorgänge des Rezepts, die Kriterien, die Ereigniseinträge, die Kommentare, die Anmerkungen, die Aufzeichnungen zur Produktivität, die Etikettenartefakte mit ihren eingefrorenen Bytes und die Berichtsregistrierungen mit jeder Kopie, die sie behalten haben. Sie verwendet denselben Grundnamen wie die anderen Exporte und wird erst veröffentlicht, wenn sie vollständig geschrieben ist. Eine andere Station nimmt sie über Läufe importieren wieder auf.

PDF

PDF erzeugen setzt den Bericht mit dem Layout zusammen, das die Auswahl daneben trifft. "(Bericht des Ablaufs)" ist das Layout, das der heute erste Abschlussberichtsbefehl des Ablaufs in der Reihenfolge der Ausgabe nennt (sein erster Startbefehl, wenn er bei Abschluss keinen ausgibt); ein Ablauf, der fort ist oder keinen Bericht ausgibt, und ein gelöschtes Layout fallen auf die Vorgabe mit allen Abschnitten zurück, eine erneute Erzeugung überlebt die Konfiguration also. Es kann stattdessen jedes andere Layout der Bibliothek gewählt werden, denn die Laufdatei genügt sich selbst. Das PDF wird im Berichtsordner unter dem schlichten Grundnamen des Laufs veröffentlicht, ersetzt die vorherige Fassung von Hand und registriert nichts auf dem Lauf.

Im Fenster der Station selbst öffnet das fertige PDF im PDF-Betrachter des Systems und fällt auf einen Browser-Download zurück, wenn das misslingt ("Der Bericht konnte nicht geöffnet werden. Er wird stattdessen heruntergeladen."); in einem Browser, lokal oder entfernt, öffnet es in einer neuen Registerkarte. Was die Seiten enthalten, steht unter Berichtslayouts. Der bereits für einen Lauf registrierte Bericht wird stattdessen aus Etiketten und Berichte erneut ausgegeben, das ihn nie neu zusammensetzt.