Salvare, chiudere e ripristinare con Workspace e History

In GX-TXT Unified Documents 1.2.0 le operazioni Workspace e History sono integrate nei servizi condivisi del framework. Non è necessario creare un archivio separato del Viewer: una Session può contenere l’identità dei documenti scientifici e i Workspace che descrivono lo stato dell’interfaccia e delle revisioni.

Questa guida mostra come salvare un lavoro reale, chiuderlo, riaprirlo e ripristinarlo anche dopo un nuovo avvio di GX-TXT. Utilizziamo un datasheet elettronico bilingue, con testo OCR corretto, una regione selezionata e una tabella estratta. Verificheremo quali elementi vengono conservati, distinguendoli dai semplici messaggi temporanei dell’interfaccia.

1. Perché utilizzare Workspace

Un lavoro scientifico può richiedere più passaggi: scegliere il documento, impostare la pagina, estrarre un testo, correggere alcuni errori, delimitare una regione, ricostruire una tabella ed esaminare i risultati.

Un Workspace permette di conservare questo contesto per riprenderlo successivamente. Non va confuso con Publish text, Publish table o Publish page, che creano invece Dataset canonici derivati.

2. Workspace e Session non sono sinonimi

La Session è il contesto scientifico che contiene i Dataset disponibili e i relativi identificativi. Il Workspace registra uno stato di lavoro associato a un Viewer, comprendendo impostazioni, selezioni e revisioni dove supportate.

Un Workspace non sostituisce la sorgente PDF. Dopo una riapertura corretta, il Viewer deve ritrovare il Dataset originale nella Session e controllare che la sua identità sia ancora valida.

3. Il servizio condiviso di GX-TXT

I menu History e Workspace, presenti in Unified Documents, appartengono ai servizi comuni del framework. Le funzioni di salvataggio e apertura utilizzano gli stessi meccanismi generali dei Viewer che li supportano.

Non serve esportare manualmente un file di impostazioni del Digitalizzatore né costruire un secondo archivio di bozze per Unified Documents. Il salvataggio deve avvenire nel Workspace previsto da GX-TXT.

4. Il documento di riferimento

Utilizziamo il datasheet ZH0371BH001-01A del produttore, contenente 13 pagine fisiche con descrizioni in inglese e cinese semplificato.

Il materiale permette di verificare la conservazione di caratteri Unicode, valori elettrici, numero di pagina, regione di lavoro e struttura tabellare. Non è necessario intervenire sui byte del PDF originale.

5. Aprire la sorgente e impostare la pagina

Importa il datasheet con il normale Acquisition Handler PDF nella Session, apri Viewers → Unified Documents, seleziona il Dataset in Source e premi Open source.

Nella scheda PDF / Image imposta Page = 4 e DPI = 200, poi utilizza Render page.

Unified Documents originale con PDF sorgente del datasheet alla pagina 4
Figura 1. Il datasheet inglese/cinese è aperto come Dataset PDF canonico alla pagina 4, 200 DPI.

Il Viewer collega così la pagina renderizzata a un Dataset sorgente identificabile. Il Workspace potrà conservarne l’identificativo, la pagina, la risoluzione e la provenienza.

6. Preparare l’OCR bilingue

Apri Recognition settings e seleziona eng+chi_sim come lingue. Per l’esempio usa PSM = 3 e PDF text method = OCR.

Nella scheda OCR imposta OCR workflow = PDF OCR e Scope = Page.

Scheda OCR originale con impostazioni bilingui e area di revisione
Figura 2. La scheda OCR mostra lingue eng+chi_sim, PDF OCR e Scope Page.

Questi controlli definiscono il contesto del riconoscimento. I risultati effettivi vanno sempre confrontati con il datasheet, in particolare per cifre e sigle elettroniche.

7. Eseguire Run OCR

Premi Run OCR e attendi il completamento dell’elaborazione. Il testo compare nell’area Editable text review.

Editor del testo OCR inglese cinese dopo Run OCR
Figura 3. Il testo OCR effettivamente riconosciuto è disponibile nell’editor prima del salvataggio.

Nel nostro esempio il riconoscimento iniziale ha prodotto 1.143 caratteri Unicode, inclusi 137 caratteri cinesi. Questa quantità descrive l’output, non un indice di accuratezza.

8. Riconoscere una bozza revisionabile

Il testo nell’editor è una bozza legata alla sorgente che l’ha generata. Non viene automaticamente pubblicato come Dataset document.text e non va considerato già validato.

Prima di salvarlo nel Workspace, verifica quali correzioni sono necessarie. Il Workspace conserva il lavoro e il suo contesto, mentre una pubblicazione scientifica successiva richiede un’operazione distinta.

9. Correggere il testo OCR

Confrontando la pagina originale, abbiamo corretto la sigla del driver da 驱动 TC a 驱动 IC e la sequenza 3.5 Vv in 3.5 V.

Testo bilingue corretto nell’editor originale sulla riga Driver IC
Figura 4. La correzione del driver IC è visibile nell’editor prima di Workspace Save.

La bozza revisionata contiene 1.142 caratteri Unicode, con i 137 caratteri cinesi conservati. Nessuna di queste modifiche riscrive il PDF sorgente.

10. Delimitare una regione della pagina

Torna a PDF / Image, attiva Region e trascina il mouse intorno alla tabella 2.1.2 Electrical Characteristics.

Anteprima originale con regione rettangolare intorno alla tabella elettrica
Figura 5. La Region è stata tracciata con il mouse intorno alla tabella delle caratteristiche elettriche.

La selezione è registrata mediante coordinate normalizzate rispetto alla pagina sorgente. È distinta dalla dimensione della finestra a schermo e può essere conservata nel contesto del Workspace.

11. Estrarre una tabella dalla regione

Passa alla scheda Tables, apri temporaneamente Options e scegli Document Tables, con Expected columns = 0 e Table number = 1.

Workflow Document Tables selezionato nella vera GUI con Region attiva
Figura 6. La scheda Tables imposta Document Tables e Expected columns automatico per la regione.

Per la tabella selezionata utilizza Extract table. La ricostruzione appartiene alla revisione scientifica del Viewer: non è ancora un Dataset table.generic pubblicato.

12. Esaminare la tabella senza pannelli inutili

Terminata la configurazione, chiudi Options per lasciare più spazio alla griglia Editable table (Enter / Escape).

Tabella elettrica reale estratta con sei colonne e due righe iniziali bilingui
Figura 7. La griglia di sette righe e sei colonne è la bozza scientifica prima del salvataggio.

Nel nostro esempio il risultato comprende 7 righe e 6 colonne: due righe di intestazione bilingue e cinque righe di caratteristiche elettriche. La struttura è un elemento utile da confrontare dopo la riapertura.

13. Che cosa controllare prima di Save

Prima di salvare il Workspace, verifica la presenza della sorgente PDF corretta, Page = 4, DPI = 200, della regione selezionata, del testo OCR revisionato e della tabella estratta.

Non occorre pubblicare i dati come nuovi Dataset per poter verificare se il Workspace riesce a recuperare una revisione in corso. Tuttavia, un Workspace salvato non costituisce automaticamente una pubblicazione scientifica canonica.

14. Il menu History

Nella barra dei menu del Viewer trovi History. Tra i comandi disponibili ci sono Undo (Ctrl+Z), Redo (Ctrl+Y), la visualizzazione della barra Description / History, History details… e le funzioni di History denominata.

History appartiene al meccanismo di revisione condiviso. Non va confuso con la cronologia dei comandi di un programma di elaborazione OCR esterno.

15. Utilizzare Undo

Se esistono stati precedenti nella cronologia, scegli History → Undo oppure utilizza la scorciatoia indicata nel menu.

Scheda Tables della GUI durante la prova del comando Undo condiviso
Figura 8. History → Undo sposta il cursore della cronologia al precedente stato registrato.

Nell’esempio il cursore della History condivisa si è spostato dallo stato 20 allo stato 19. Questo controllo verifica la navigazione nella cronologia, ma non significa che un singolo carattere del testo debba necessariamente cambiare a ogni Undo.

16. Utilizzare Redo

Dopo Undo, il comando History → Redo torna allo stato successivo.

Scheda Tables dopo Redo con griglia della tabella ancora presente
Figura 9. History → Redo torna all’ultimo stato; la bozza della tabella rimane nel Viewer.

Nella nostra prova il cursore è ritornato da 19 a 20, mantenendo la bozza scientifica e la tabella esaminata. Il comportamento dipende dalla successione delle modifiche registrate nel Workspace.

17. History e modifica delle celle

Una revisione del testo OCR o di una cella può essere registrata nella storia del Viewer, ma il contenuto di History riguarda lo stato scientifico dell’interfaccia, non necessariamente un’azione isolata alla volta.

Prima di utilizzare Undo e Redo su un lavoro importante, controlla la provenienza e la revisione a cui stai ritornando. Non assumere che il comando annulli sempre soltanto l’ultimo tasto digitato.

18. Il menu Workspace

Apri Workspace nella barra dei menu. Sono presenti i comandi New workspace…, Open workspace…, Save, Save As…, Session Workspaces… e Close, insieme alle funzioni di gestione disponibili.

Per salvare la revisione corrente, usa Workspace → Save. Per cercare i Workspace disponibili e riaprirli, usa il gestore Session Workspaces….

19. Salvare con Workspace → Save

Con il documento, il testo e la tabella pronti, seleziona Workspace → Save. La GUI utilizza il servizio condiviso del framework e registra lo stato collegato alla Session.

Stato della scheda Tables dopo salvataggio del Workspace originale
Figura 10. La tabella revisionata è visibile dopo il comando Workspace Save e prima di Close.

Nel nostro esempio il salvataggio ha creato un Workspace chiamato Unified Documents. Il salvataggio non ha prodotto un Dataset numerico o testuale pubblicato: il PDF sorgente è rimasto l’unico Dataset canonico della Session di prova.

20. Che cosa viene salvato

Il Workspace comprende l’identificativo del Dataset sorgente, la sua impronta SHA-256, pagina, DPI, zoom, regione normalizzata, testo revisionato, righe della tabella e informazioni di provenienza delle due revisioni.

Sono conservati anche lo stato dei controlli e la cronologia supportata. I dati sorgente rimangono governati dalla Session; il Workspace non ne diventa una copia indipendente.

21. Aprire il gestore Session Workspaces

Scegli Workspace → Session Workspaces…. Si apre la finestra del gestore condiviso, con l’elenco dei Workspace disponibili.

Gestore condiviso GX-TXT Session Workspaces con Unified Documents selezionato e pulsanti Open Save
Figura 11. Session Workspaces mostra il Workspace salvato, selezionabile con Open.

Selezionando Unified Documents, il gestore mostra il tipo del Workspace, il provider e le azioni Open, Save e altre funzioni di gestione. La mancanza di un’anteprima gestita in questo esempio non significa che il contenuto salvato sia assente.

22. Salvare prima di chiudere

Prima di chiudere il Viewer, controlla che le modifiche più recenti siano state salvate. In caso di modifiche non salvate, la GUI può chiedere di confermare il comportamento da adottare.

Nel nostro esempio il comando Save ha completato l’operazione e lo stato del Workspace è risultato non modificato (clean) rispetto alla revisione appena registrata.

23. Chiudere il Viewer dal menu condiviso

Seleziona Workspace → Close. La finestra Unified Documents viene chiusa, ma il Workspace salvato e il PDF sorgente rimangono nella Session.

Questa operazione è diversa da eliminare un Workspace: Close chiude l’interfaccia corrente, non cancella il lavoro salvato.

24. Riaprire con il pulsante Open

Dal gestore Session Workspaces, seleziona il Workspace salvato e premi Open. GX-TXT apre una nuova istanza del Viewer associata alla stessa identità di Workspace.

L’apertura può richiedere che l’applicazione ricostruisca l’anteprima PDF. Attendi il completamento prima di interpretare un’immagine non ancora visibile come perdita del lavoro.

25. Verifica della prima riapertura

Dopo la normale chiusura e riapertura dal gestore condiviso, la scheda Tables è tornata attiva e la griglia ha nuovamente mostrato 7 righe e 6 colonne.

Viewer Unified Documents riaperto dal gestore Session Workspaces con tabella sette per sei
Figura 12. Dopo Close e Open dal gestore condiviso, la tabella e la scheda Tables vengono ripristinate.

Sono stati recuperati anche il testo revisionato e le coordinate della regione, senza creare una nuova copia del Dataset originale.

26. Perché verificare anche un nuovo avvio

Una riapertura nello stesso processo applicativo non dimostra da sola che i dati siano stati registrati su disco: una parte dello stato potrebbe trovarsi ancora nella memoria del programma.

Per questo è utile chiudere il Viewer, terminare normalmente GX-TXT e riavviare l’applicazione prima di eseguire una seconda verifica.

27. Riaprire la Session dopo il riavvio

Dopo il riavvio di GX-TXT, apri la stessa Session che conteneva il PDF e il Workspace salvato. Non creare una nuova Session vuota né importare di nuovo il documento solo per recuperare il lavoro.

Il gestore dei Workspace deve trovare la registrazione associata alla Session effettivamente aperta.

28. Riaprire il Workspace dopo il riavvio

Nel gestore condiviso seleziona nuovamente il Workspace Unified Documents e premi Open.

La finestra viene ricostruita dal Workspace salvato, usando i servizi esistenti di GX-TXT per recuperare il contesto del documento, la cronologia e i controlli.

29. Verificare la riapertura a freddo

Dopo la chiusura completa del programma e il nuovo avvio, la GUI ha ripristinato la scheda Tables, la tabella a sei colonne e la stessa sorgente documentale.

Viewer originale dopo riavvio completo di GX-TXT con la tabella e i parametri recuperati
Figura 13. Dopo la chiusura dell’applicazione e il nuovo avvio, il Workspace ripristina la stessa tabella.

Questa è una schermata autentica della nuova istanza: non è una riproduzione artificiale della finestra precedente. La corrispondenza è stata verificata anche sullo stato dei dati, non soltanto sull’aspetto grafico.

30. Controllare il testo bilingue ripristinato

La revisione OCR conservata dopo il nuovo avvio contiene ancora 1.142 caratteri Unicode, compresi i 137 caratteri cinesi.

La correzione Driver IC 驱动 IC ST7701 e quella dell’unità 3.5 V sono rimaste presenti. Le revisioni non richiedono di eseguire di nuovo OCR per essere semplicemente visualizzate.

31. Controllare ROI, origine e tabella

Anche dopo la riapertura a freddo risultano presenti le stesse quattro coordinate normalizzate della Region e la tabella di 7 righe e 6 colonne.

Le etichette Review: dei risultati continuano a riferirsi alla stessa sorgente PDF, alla pagina 4 e a 200 DPI. L’identificativo e l’impronta della fonte permettono di distinguere una revisione ripristinata da un nuovo riconoscimento.

32. Controllare History dopo il riavvio

La History condivisa risulta ancora disponibile con 20 stati e il cursore sull’ultimo stato nella Session della nostra prova.

Questo risultato conferma la persistenza della cronologia registrata; non implica che qualsiasi applicazione esterna o ogni modifica mai effettuata possa essere annullata. La cronologia mantiene il proprio contratto di gestione all’interno del Workspace.

33. Un solo Workspace, nessun archivio duplicato

Il ciclo di prova ha mantenuto un solo Workspace registrato e un solo Dataset PDF sorgente. Non è stata creata una seconda libreria di documenti né una collezione autonoma di copie OCR.

Per conservare risultati indipendenti e riutilizzabili dagli altri strumenti, continua a usare i comandi di pubblicazione canonica. Per riprendere l’interfaccia e le bozze, usa Workspace Save/Open.

34. Limiti e controlli finali

Un salvataggio è affidabile quando puoi ritrovare nella Session il Workspace corretto, aprirlo dal gestore, verificare la sorgente e confrontare le revisioni ripristinate. Il nome del Workspace da solo non è una garanzia di identità.

In caso di documento mancante o sorgente modificata, non dare per scontato il recupero automatico: controlla l’identità del Dataset e gli eventuali messaggi di provenienza. Nel nostro ciclo il PDF originale è rimasto invariato.

Nel prossimo capitolo, U15 — Ciclo di vita, interruzioni e rifiuti sicuri, esamineremo i casi negativi di cambio sorgente, richieste in corso, Cancel e chiusura del Viewer.