Convertitore PDF (WSO2PDF) Manuale Sistemista Pagina 1 di 12
SOMMARIO 1 Introduzione 3 2 Moduli dell applicazione 3 3 Installazione 4 3.1 Installazione da Setup Manager 4 3.2 Installazione da pacchetto autoinstallante 5 4 Configurazione 6 4.1 Configurazione del servizio 6 4.2 WSO2PDF Monitor 7 4.3 Configurazione utente locale 8 4.4 Configurazione sistemi configurati (aziende) 8 5 Utilizzo del convertitore 9 6 Appendice 10 6.1 File di configurazione 10 6.2 Possibili conflitti con altre applicazioni Errore. Il segnalibro non è definito. 6.3 Note per l aggiornamento Errore. Il segnalibro non è definito. 6.4 Installazione manuale del servizio di conversione 10 6.5 Integrazione con Office 10 6.6 PSG PS Virtual Printer 11 6.7 Utente locale 11 6.8 Interagisci col Desktop 11 6.9 Integrazione Adobe Reader XI 12 6.10 Prova conversione 12 6.11 Directory per l automazione 12 Pagina 2 di 12
1 INTRODUZIONE Il convertitore PDF è un applicazione utilizzata per la conversione dei documenti archiviati su AS400 tramite Database Links. Installando l applicazione su una macchina Windows ed associandola al sistema AS400 con Database Links ogni volta che un documento viene creato o modificato in archivio il convertitore ne creerà una copia in formato PDF in maniera totalmente automatica. In questo modo è sempre possibile avere nel proprio archivio due copie dei propri documenti, una in formato originale, disponibile per la modifica da parte degli utenti autorizzati ed una in formato PDF per l apertura in sola lettura, la distribuzione e la stampa. I formati di documento supportati per la conversione sono: - Documenti di testo (.txt,.rtf) - Documenti di testo formato Word (.doc,.docx) - Fogli di calcolo formato Excel (.xls,.xlsx) - Documenti StarOffice (.sdw,.sdc,.sdd,.sds,.sgl,.smf,.sda) - Immagini e in generale qualunque tipo di file a cui è associata un applicazione che fornisce servizi di stampa per il suddetto file. NOTA. La compatibilità dei tipi di files è subordinata all installazione delle relative applicazioni per la loro gestione. Ad esempio non è possibile convertire documenti in formato Microsoft Word se Microsoft Word non è installato e funzionante sul sistema. 2 MODULI DELL APPLICAZIONE Il convertitore PDF è composto da 4 moduli eseguibili per Microsoft Windows. Per il corretto funzionamento è richiesto Microsoft Windows 2000 o superiore. - WSO2PDF.EXE servizio che recupera i files da convertire - WSX2PDF.EXE effettua la conversione e carica il file PDF prodotto su AS400 - WSO2PDFM.EXE (vecchia) utilità per la configurazione e il monitoraggio dell applicazione - WGO2PDFMonitor.exe utilità per la configurazione e il monitoraggio dell applicazione - WSO2PDFT.EXE icona nella traybar per l accesso rapido al WSO2PDFM Nota WSO2PDFT ha anche la funzione di notificare al servizio di conversione se sulla macchina c è un utente loggato. La sua terminazione potrebbe comportare un malfunzionamento delle operazioni di conversione (solo per sistemi operativi precedenti a Windows 7 ed a Windows Server 2008). Oltre ai moduli citati il convertitore PDF ha le seguenti dipendenze: - PSGRES.PKG drivers della stampante virtuale e le librerie per la conversione in PDF - EZCMPL32.DLL libreria per la compressione e la decompressione del traffico di rete Questi sono già presenti sul sistema se è stato installato il Runtime WebGate o un'altra applicazione che li richiede (ad esempio il Processore Stampe Grafiche), verranno installati assieme al convertitore PDF se ancora non lo sono. Pagina 3 di 12
3 INSTALLAZIONE Sono disponibili due metodi per installare il convertitore PDF, dal Setup Manager oppure da un pacchetto autoinstallante. Prima di effettuare l installazione leggere i capitoli Conflitti con l applicazione Processore Stampe Grafiche e Note per l aggiornamento. 3.1 Installazione da Setup Manager Setup Manager consente l installazione di applicazioni servendosi di un catalogo distribuito sugli AS400 su cui è installato il sistema Webgate400. Una volta avviato il setup manager si presenta la schermata di login. Inserire le credenziali per accedere all AS400 di riferimento e premere il pulsante Login. Si presenta la lista delle applicazioni disponibili per l installazione. Scorrere fino a trovare la voce Modulo di conversione PDF, spuntare la check box al suo fianco, quindi premere il pulsante Install. Confermare l operazione quindi attendere che si concluda. Pagina 4 di 12
E consigliabile installare anche il Runtime Webgate. Per farlo, scorrere la lista delle applicazioni fino a trovare la voce Runtime Windows 2K/XP/Vista (oblig. un Runtime), spuntare la checkbox al suo fianco e premere il pulsante Install. Confermare l operazione quindi attendere che si concluda. Al termine chiudere la finestra del Setup Manager. E ora possibile passare alla fase di configurazione. 3.2 Installazione da pacchetto autoinstallante I pacchetti autoinstallanti racchiudono all interno di un unico file eseguibile tutte le componenti del programma e le sue dipendenze. La procedura di installazione è la seguente: Avviare il file WSO2PDFSetup.exe L autoinstallante decomprime i files che contiene in una directory temporanea quindi mostra a video la schermata di installazione. Avviare la procedura cliccando il pulsante Install quindi confermare l operazione. Al termine dell installazione verrà mostrato un messaggio di notifica. Chiudere la finestra del Setup Manager. E ora possibile passare alla fase di configurazione. Pagina 5 di 12
4 CONFIGURAZIONE La configurazione del convertitore PDF consta di 3 passi: - Configurazione del servizio Windows WSObject 2 PDF Service - Configurazione dell utente utilizzato per la conversione - Configurazione dei sistemi AS400 per i quali si offre il servizio di conversione La configurazione del servizio si effettua attraverso l utilità Servizi del sistema operativo, cui si può accedere anche dal Pannello di Controllo di Windows. La configurazione dell utente e quella dei sistemi AS400 per i quali offrire il servizio di conversione viene invece effettuata attraverso l utilità WSO2PDF Monitor, che viene installata assieme al convertitore PDF. 4.1 Configurazione del servizio Aprire la finestra dei servizi di Windows (Start -> Esegui quindi digitare services.msc e dare invio). Cercare nella lista la voce WSObject 2 PDF Service, tasto destro Proprietà. Nella prima scheda (Generale) specificare come tipo di avvio Automatico. Nella seconda scheda (Connessione) spuntare la Check Box Consenti al servizio di interagire col desktop. Premere OK e chiudere la scheda servizi. Se non è possibile trovare il servizio tra quelli di Windows probabilmente l installazione ha fallito la sua registrazione. In questo caso è possibile aggiungerlo manualmente (vedi capitolo Installazione manuale del servizio di conversione ). Pagina 6 di 12
4.2 WSO2PDF Monitor Per agevolare la configurazione del programma di conversione e monitorare lo stato del servizio è stata realizzata un applicazione denominata WSO2PDF Monitor. Il processo di installazione ha creato una voce nel menù di sistema per richiamarla, va lanciata con permessi di amministratore: Start -> Programmi -> Applicazioni Webgate -> UTIL-OBJECT 2 PDF MONITOR Accedere alla configurazione cliccando Unlock configure Configure La finestra di configurazione consente l inserimento dell utente locale che sarà impersonato dal servizio per accedere alle risorse esterne (applicativi e stampante virtuale PSG PS Virtual Printer) e la configurazione dei sistemi. Dalle finestre di configurazione premere il pulsante Save and exit per confermare le modifiche fatte; chiudere con il pulsante in alto a destra o con il tasto Escape per annullare le modifiche in corso. Pagina 7 di 12
4.3 Configurazione utente locale Dal pannello di configurazione inserire Nome utente, Dominio e password; cliccare il pulsante Check per verificare che i dati inseriti siano corretti. Se il PC non fa parte di un dominio inserire il nome del PC al posto del dominio. Premere il pulsante New per aggiungere un nuovo sistema informativo a cui collegarsi. 4.4 Configurazione sistemi configurati (aziende) Specificare un nome per la connessione, indirizzo IP dell iseries, utente, password e libreria DBLink da convertire; cliccare il pulsante Check per verificare che i dati inseriti siano corretti. Pagina 8 di 12
5 UTILIZZO DEL CONVERTITORE Il servizio di conversione gira in background recuperando i documenti dall AS400 e convertendoli in PDF senza richiedere l intervento dell utente. Lo stato del servizio è visibile nell utilità di configurazione. Inoltre sono presenti un pulsante per il suo avvio ed uno per l arresto. Nel caso in cui si verifichino problemi di conversione è possibile consultare i files di log che vengono generati dai componenti del convertitore. Il percorso dei log è raggiungibile cliccando il pulsante Open logs folder. All interno della cartella (solitamente posizionata in C:\Users\Public\Webgate\Log) si trovano i files: - WSO2PDF.LOG traccia l attività del servizio - OBJ2PDF.LOG traccia l attività dei lavori di conversione - EPDFMAKER.LOG traccia le fasi della conversione Pagina 9 di 12
6 APPENDICE 6.1 File di configurazione Il file di configurazione si chiama WSO2PDF.xml e si trova nella cartella dei dati applicazioni Webgate, sotto la directory Profiles. 6.2 Installazione manuale del servizio di conversione Le procedure di installazione creano automaticamente un servizio Windows denominato WSObject 2 PDF Service. Se l installazione per qualche ragione non lo avesse fatto è possibile installare manualmente il servizio spostandosi con un terminale nella directory di installazione del prodotto (ad esempio C:\Programmi\Webgate) quindi lanciando il comando WSO2PDF.EXE I E possibile in maniera analoga disinstallare il servizio manualmente lanciando WSO2PDF.EXE U 6.3 Integrazione con Office Necessaria per la conversione di files Office (Word, Excel, PowerPoint); richiede la versione a 32 bit. Da Office 2007 in avanti è possibile far eseguire la conversione in PDF dei documenti direttamente da Office senza passare dalla stampa via Virtual Printer. Per farlo nel file di configurazione WSO2PDF.xml cercare il parametro SavePDFFromOffice ed impostarlo a TRUE. Pagina 10 di 12
Nota. Per Office 2007 è richiesto un componente aggiuntivo gratuito offerto da Microsoft che può essere scaricato dal seguente indirizzo: https://www.microsoft.com/it-it/download/details.aspx?id=7 6.4 PSG PS Virtual Printer Verificare dal pannello di controllo di Windows, nell area dedicata alle stampanti, che sia installata PSG PS Virtual Printer. 6.5 Utente locale Verificare che l utente locale sia inserito nella configurazione di convertitore PDF e che, effettuato il login in Windows con l utente configurato, sia possibile eseguire Office ed effettuare stampe su PSG PS Virtual Printer. 6.6 Interagisci col Desktop Verificare all interno del pannello di controllo di Windows che per il servizio WSObject 2 PDF Service sia attiva la spunta Consenti al servizio di interagire col Desktop. Pagina 11 di 12
6.7 Integrazione Adobe Reader XI Adobe Reader XI introduce la modalità protetta avanzata, un sistema Sandbox che impedisce agli applicativi di utilizzare le sue funzioni. Affinchè gli applicativi Webgate possano interagire con Adobe Reader: - Avviare il programma - Dalle impostazioni recarsi in Security (enhanced) o equivalente in lingua - Disattivare i flag di abilitazione (vedi screenshot) 6.8 Prova conversione Provare a convertire un file locale attraverso il pulsante Test conversion presente nell utilità di configurazione. La funzione converte un file presente in locale in un PDF temporaneo che viene aperto immediatamente al momento della creazione ed eliminato automaticamente alla chiusura del programma. La procedura di test non effettua una conversione di un documento in Webgate DBLink. 6.9 Directory per l automazione A partire da Office 2007 e dai sistemi operativi Vista e successivi per utilizzare l automazione da un servizio di Windows è necessario che sul sistema esistano le seguenti directory: C:\Windows\SysWOW64\config\systemprofile\Desktop C:\Windows\System32\config\systemprofile\Desktop Pagina 12 di 12