Caso di studio Wrycan / NAVSEA

Panoramica

The Cantiere navale di Portsmouth A Kittery, nel Maine, è una divisione del Naval Sea Systems Command (NAVSEA), la più grande dei cinque comandi di sistema della Marina degli Stati Uniti. Si sono rivolti Wrycan, un partner Altova specializzato in tecnologie XML orientate ai contenuti, che ha richiesto assistenza per convertire alcuni dei loro manuali tecnici, realizzati con formati obsoleti, in formato XML, seguendo le specifiche DTD XML per i dati di manutenzione della Marina Militare e ricreandoli in formato PDF. Il cantiere navale aveva ricevuto l'incarico di iniziare a utilizzare XML come formato principale per i dati e l'archiviazione, e necessitava di una soluzione di pubblicazione economica e affidabile, che potesse essere facilmente gestita dal proprio personale.

Wrycan aveva già maturato una certa esperienza nell'utilizzo di Altova MissionKit per lo sviluppo XML, oltre a una vasta competenza nelle tecnologie XML, tra cui XML, XSL:FO e DTD. Hanno scelto di utilizzare XMLSpy, StyleVision e Authentic come strumenti di sviluppo per questa implementazione, grazie alla loro intuitività, facilità d'uso e al loro costo contenuto.

La sfida

Lo stabilimento navale di Portsmouth aveva bisogno di convertire circa 10.000 pagine di contenuti da un formato obsoleto a XML, in conformità con il proprio DTD. Questo processo comprendeva una conversione automatica, una revisione e correzione manuale, e uno strumento da riga di comando per pubblicare nuovamente il file XML nel suo formato PDF originale. Come in qualsiasi operazione di pubblicazione e conversione di grandi dimensioni, il progetto richiedeva una rigorosa fase di controllo qualità post-conversione, gran parte della quale poteva essere svolta da dipendenti dello stabilimento navale non specializzati, a condizione che avessero a disposizione uno strumento che li aiutasse a interpretare e accedere al codice XML. Inoltre, a causa della relativa complessità del formato della documentazione, che includeva dettagli complessi sulla disposizione delle pagine, come un numero variabile di colonne per pagina e diverse larghezze dei margini, elementi grafici inseriti all'interno delle sezioni e liste numerate, nonché numerosi modelli schematici di grandi dimensioni, alcuni dei quali su pagine pieghevoli, la codifica XSL:FO prometteva di presentare una sfida notevole.

La soluzione

Wrycan ha eseguito la maggior parte della conversione dei contenuti internamente, utilizzando script personalizzati e alcuni processi manuali, oltre a effettuare controlli di qualità tecnici. Una volta convertiti i contenuti, Wrycan ha utilizzato l'interfaccia di progettazione "drag and drop" di StyleVision per creare moduli elettronici (e-Forms) autentici, destinati alla modifica, utilizzando il DTD XML della Navy ETM come componente strutturale. Sono state inserite funzioni avanzate dei fogli di stile, come modelli condizionali e calcoli automatici, per facilitare i processi di controllo qualità e di modifica.

Dopo la conversione dei contenuti, Wrycan ha implementato uno strumento di elaborazione da riga di comando che include diverse fasi, tra cui:

• Assemblaggio di volumi a partire da frammenti di file XML Per una maggiore flessibilità e usabilità, i manuali tecnici della Marina sono stati suddivisi in sezioni, tra cui l'introduzione, i capitoli, le sezioni conclusive e i file di immagini. Questo ha permesso a Wrycan di rendere disponibili alcune parti di questi file per il riutilizzo. I componenti che apparivano identici in più punti all'interno dei manuali potevano essere segmentati in modo che le modifiche apportate in un punto si propagassero a tutta la documentazione.
• Conversione da XML a XSL-FO Wrycan ha utilizzato XMLSpy, il software completo di Altova Editor XML per scrivere manualmente il codice XSL:FO avanzato necessario per i manuali. La complessità dell'output XML e PDF può essere apprezzata nei seguenti esempi: Sorgente del volume, Front Matter: fonte, Fonte del capitolo, e Documento finale (File PDF di 3,8 MB).
• Formattazione personalizzata delle pagine Questo progetto richiedeva l'utilizzo di diverse dimensioni di pagina all'interno dello stesso documento, ad esempio una pagina in formato verticale seguita da una pagina orizzontale più grande (11" x 17"). Esistono specifiche normative della Marina che stabiliscono che diversi formati di pagina richiedono requisiti di stampa differenti. Ad esempio, le pagine pieghevoli vengono stampate solo su un lato, mentre le altre pagine vengono stampate su entrambi i lati.
• Fasi di post-elaborazione Erano inoltre previste specifiche esigenze relative alla numerazione delle pagine, come ad esempio l'obbligo che ogni capitolo iniziasse su una pagina con un numero dispari. Se ciò comportava la presenza di pagine vuote, veniva inserito un messaggio sulla pagina stessa per indicare che era stata lasciata intenzionalmente vuota. Queste esigenze vengono soddisfatte automaticamente dallo strumento di elaborazione di Wrycan.
• Creazione di file PDF Wrycan ha integrato il software XEP di RenderX nel processo di elaborazione per convertire l'output XSL:FO, comprese tutte le immagini e i contenuti, in un unico file PDF.

La modifica dei contenuti viene effettuata con Authentic tramite Stylevision, che è stato recentemente aggiornato alla versione più recente per offrire un supporto più avanzato per le tabelle e opzioni di creazione più complete. Di seguito è riportata un'immagine di esempio di uno dei moduli elettronici Authentic per la modifica XML WYSIWYG, generato per NAVSEA sulla base del modello di stile StyleVision.

I risultati

Lo stabilimento navale di Portsmouth dispone ora di una soluzione di pubblicazione XML con funzionalità di editing XML integrate. Possono riprodurre i loro manuali tecnici in formato PDF utilizzando XML come fonte dei contenuti. Ora sono pronti a passare alla fase successiva, che consiste nell'implementare un sistema completo di gestione dei contenuti con funzionalità di workflow e pubblicazione personalizzata. Scoprite come gli strumenti Altova possono aiutarvi a risolvere le vostre sfide relative alla documentazione e alla pubblicazione. Scaricate una versione completamente funzionante Prova gratuita di Altova MissionKit Oggi!