Esportare una prova
Le copie portabili e il PDF generato di una prova: che cosa richiede ciascun verbo, come si chiamano i file e che cosa contengono esattamente un CSV, un XLSX, un GLAB e un PDF.
La striscia sopra la prova aperta porta prima le copie portabili, poi i documenti generati (Il registro della prova). I quattro verbi qui sotto richiedono il permesso Esportare/importare gli storici, e tutti e quattro sono letture del file della prova: restano disponibili mentre il runtime è fermo e mentre un'unità registra, e nessuno di essi scrive alcunché dentro la prova.
La striscia porta un quinto verbo, Nuova etichetta, che non è né un'esportazione né una lettura: emette un'etichetta dentro la prova e vi è registrato come prova documentale di ciò, quindi richiede Eseguire le procedure invece del permesso di esportazione ed è descritto insieme ai documenti a cui appartiene (Etichette e rapporti).
| Verbo | Produce | Disponibile per | Dove arriva |
|---|---|---|---|
| Esporta CSV | Il datalog grezzo come testo. | Qualsiasi prova, compresa una che sta ancora registrando. | Uno scaricamento del browser, anche sulla finestra propria della stazione ("Esportato CSV · file"). |
| Esporta XLSX | Una cartella di lavoro Excel con l'identità della prova, i metadati e il datalog tipizzato. | Qualsiasi prova, compresa una che sta ancora registrando; una prova che non ha ancora registrato nulla risponde "La prova non ha ancora un'istantanea di intestazione. Riprova fra un momento." | Uno scaricamento del browser ("Esportato XLSX · file"). |
| Esporta GLAB | L'intera prova come un unico file portabile .glab che un'altra stazione può importare. |
Soltanto prove Completate, Interrotte o Fallite. | Uno scaricamento del browser ("Esportato GLAB · file (dimensione)"). |
| Genera PDF | Un rapporto PDF fresco composto dall'intera prova con il layout che il selettore sceglie. | Qualsiasi prova che abbia finito di registrare. | La cartella dei rapporti della radice dei dati, poi aperto. |
Un'esportazione CSV o XLSX fatta a metà prova è una copia parziale coerente: l'intestazione congelata è scritta quando la prova parte, quindi l'esportazione porta l'insieme completo delle colonne e le righe registrate fino a quel momento, lette attraverso la registrazione dal vivo anziché da una seconda connessione al file. Ogni data e ogni ora di un'esportazione seguono il formato configurato in Impostazioni, e ciascun file dichiara il riferimento in cui vanno letti i suoi timbri: "UTC" oppure "UTC±hh:mm", lo scarto della stazione al momento dell'esportazione.
Nomi dei file
CSV, XLSX, GLAB e PDF condividono un solo nome di base per prova: l'istante di avvio nel formato di data e ora della stazione con i separatori resi sicuri per un nome di file, poi i nomi del modello, dell'unità e della procedura ("02-09-2026 14-05-30 - Climatic chamber - Unit 1 - Soak test"), ciascuna parte accorciata a 48 caratteri e ripulita dei caratteri che Windows rifiuta. La base è riservata in modo duraturo, così esportazioni ripetute di una prova conservano lo stesso nome attraverso i riavvii, e soltanto una prova diversa che finirebbe sullo stesso nome riceve un breve suffisso ricavato dalla sua identità. Un rapporto emesso da un'azione aggiunge il nome del gruppo dopo la base; un PDF generato qui conserva la base semplice. Ogni file è completato sotto un nome temporaneo e pubblicato solo quando è completo, così un'esportazione annullata non lascia mai un file parziale con l'estensione del prodotto.
CSV
Una colonna Timestamp, intestata "Timestamp (UTC-03:00)" con il riferimento temporale,
poi, per canale registrato nell'ordine di colonna congelato, una colonna di valore
intestata con il nome del canale e la sua unità ingegneristica fra parentesi quadre
("Temperature [°C]") e accanto una colonna di qualità ("Temperature [°C] Quality") che dice
Good oppure Unavailable. La colonna di valore conserva ciò che il datalog ha
memorizzato (vuota quando non c'era nulla), i booleani si leggono true/false, un canale
di tipo data si legge nel formato della stazione, e un valore che contiene il separatore,
una virgoletta o un'interruzione di riga è messo fra virgolette. Una cella di testo che
comincia con =, +, - o @ è preceduta da un apostrofo perché un foglio di calcolo la
legga come testo e non come formula: i nomi dei canali nell'intestazione e le letture di un
canale di testo, che vengono dall'apparecchiatura. I numeri non sono mai preceduti da nulla,
così una lettura negativa resta un numero.
Il file segue la preferenza di separatore decimale della stazione: con i decimali a punto il
separatore di elenco è ,; con i decimali a virgola è ;, così il file si apre pulito in un
foglio di calcolo di quella lingua. I numeri sono scritti senza separatore delle migliaia,
alla piena precisione memorizzata del datalog. Il testo è UTF-8.
XLSX
La cartella di lavoro si apre con un foglio Run, due colonne intestate Field e Value:
| Campo | Contenuto |
|---|---|
| Run ID | L'identità univoca della prova. |
| Run Name, Model, Model Revision, Unit, Procedure | I nomi congelati quando la prova ha registrato; un campo per cui la prova non ha valore resta vuoto. |
| Started At, Finished At | I limiti della prova. Una prova che sta ancora registrando dice In progress per Finished At. |
| Time Zone | Il riferimento in cui va letto ogni istante della cartella di lavoro. |
| State | Lo stato del ciclo di vita al momento dell'esportazione. |
| Result | Il verdetto, oppure In progress mentre la prova sta ancora registrando. |
| Termination | None, oppure StopInterlock. |
| Interval (ms) | L'intervallo di registrazione. |
| Imported At, Imported From | Soltanto su una copia importata da un'altra installazione: quando è arrivata qui e il file ricevuto da cui viene. Una prova registrata qui non porta né l'una né l'altra riga. |
| Notes | Le note della prova. |
Segue una seconda intestazione, Metadata e Value, con una riga per campo di metadati registrato all'Avvio, nell'ordine delle richieste. Seguono uno o più fogli Datalog, nello stesso ordine di colonna del CSV, con la riga di intestazione bloccata, un filtro automatico su ogni foglio e nessuna griglia. Un datalog più lungo del limite di 1.048.576 righe per foglio di Excel si divide da sé in Datalog 2, Datalog 3 e così via, ciascuno con la propria intestazione.
I valori sono scritti come celle tipizzate: interi e decimali finiti come numeri nativi alla piena precisione memorizzata del datalog, booleani come TRUE/FALSE nativi. Excel stesso lavora con al massimo 15 cifre significative, quindi le cifre oltre quel limite non vi si vedono, anche se il file le porta. Una lettura non finita, un canale di tipo data e gli istanti sono testo; una lettura la cui qualità è Unavailable lascia vuota la propria cella di valore, e la colonna di qualità lo dice. Una prova che avrebbe bisogno di più delle 16.384 colonne di Excel, o una cella di testo oltre il suo limite di 32.767 caratteri, è rifiutata con il motivo invece di produrre una cartella di lavoro troncata.
GLAB
Il file .glab è una copia coerente, a livello di pagina, del file SQLite proprio della
prova, presa in linea: nessun involucro di archivio, nessun manifesto, nessun documento
derivato e nessun PDF pubblicato. Porta tutto ciò che porta il file della prova:
l'istantanea congelata, le righe, i metadati, le scritture della ricetta, i criteri, le
occorrenze, i commenti, le annotazioni, le registrazioni di produttività, gli artefatti di
etichetta con i loro byte congelati e le registrazioni di rapporto con l'eventuale copia che
hanno conservato. Usa lo stesso nome di base delle altre esportazioni ed è pubblicato solo
una volta scritto per intero. Un'altra stazione lo riprende dentro attraverso
Importare prove.
Genera PDF compone il rapporto con il layout che il selettore accanto sceglie. "(rapporto della procedura)" è il layout nominato oggi dal primo comando di rapporto di completamento della procedura in ordine di emissione (il suo primo comando di avvio quando non ne emette al Completamento); una procedura che non c'è più o che non emette alcun rapporto, e un layout eliminato, ripiegano sul valore predefinito con tutte le sezioni, così una rigenerazione sopravvive alla configurazione. Al suo posto si può scegliere qualsiasi altro layout della biblioteca, perché il file della prova basta a se stesso. Il PDF è pubblicato nella cartella dei rapporti sotto il nome di base semplice della prova, sostituendo la composizione manuale precedente, e non registra nulla sulla prova.
Sulla finestra propria della stazione il PDF finito si apre nel visualizzatore PDF del sistema, ripiegando su uno scaricamento del browser quando ciò non riesce ("Impossibile aprire il rapporto. Viene scaricato invece."); in un browser, locale o remoto, si apre in una nuova scheda. Che cosa contengono le pagine sta in Layout del rapporto. Il rapporto già registrato per una prova si riemette invece da Etichette e rapporti, che non lo compone mai di nuovo.