PSG TABLE BUILDER Manuale Utente Paragrafo-Pagina di Pagine 1-1 di 9 Versione 2 del 13/02/2012
SOMMARIO 1 A Chi è destinato... 1-3 2 Pre requisiti... 2-3 3 Obiettivi... 3-3 4 Durata della formazione... 4-3 5 Introduzione concettuale... 5-3 6 Contenuti... 6-4 6.1 Come si usa... 6-4 6.1.1 Attivazione generazione database... 6-4 6.1.2 Configurazione generazione database... 6-5 6.1.3 Struttura database generato... 6-6 6.1.3.1 Struttura database generato sul sistema iseries... 6-6 6.1.3.1.1 Esempio stampa grafica ordine commerciale fornitori... 6-7 6.1.3.2 Struttura file xml compatibile Microsfot Excel... 6-8 7 Prerequisiti... 7-9 7.1 Prerequisiti dei documenti... 7-9 7.2 Prerequisiti di ambiente... 7-9 Paragrafo-Pagina di Pagine 1-2 di 9 Versione 2 del 13/02/2012
1 A CHI È DESTINATO Agli operatori di applicativi gestionali che necessitano di progettare, produrre e visualizzare report, nonché creare database, in completa autonomia. 2 PRE REQUISITI L allievo deve essere in grado di operare con l interfaccia webgate400 e con l applicazione PSG - modulo base, deve possedere una conoscenza minima sulla reportistica di cui è dotata l applicazione gestionale in uso, almeno nell ambito della mansione ricoperta. 3 OBIETTIVI Alla fine del corso sarai in grado di : Argomento Livello Durata 1. Generare un database Base 15 mn 2. Gestire il database Base 15 mn 4 DURATA DELLA FORMAZIONE Per la totalità degli obiettivi indicati, compresa la fase di verifica dell apprendimento, la durata della sessione è di 0,5 ore. 5 INTRODUZIONE CONCETTUALE Webgate Psg Table Builder è un modulo avanzato dell applicazione PSG Processore Stampe Grafiche, il quale consente di creare, per ogni richiesta di stampa e quindi per i documenti prodotti con PSG, un file di database e/o un foglio elettronico editabile con Microsoft Excel. La finalità per la quale è stato realizzato questo modulo è quella di rendere disponibile agli utenti informazioni complesse, come quelle interpretate e calcolate dai programmi di stampa, in un formato elaborabile da strumenti operativi a loro disposizione per analisi proprie, come l SQL, il QUERY, le funzioni di Webgate FASTQuery, TAB SQL ecc, oppure Microsoft Excel. Paragrafo-Pagina di Pagine 5-3 di 9 Versione 2 del 13/02/2012
6 CONTENUTI 6.1 Come si usa 6.1.1 Attivazione generazione database Se installato il modulo, la funzione si attiva, in fase di produzione delle stampe grafiche, attraverso il parametro CREAZIONE FILE sulla finestra di impostazione dei parametri, per il quale viene emessa una ulteriore finestra di immissione dei riferimenti mancanti ed eventualmente assunti dai parametri generali. Figura 1 Video parametri emesso al lancio di un documento Paragrafo-Pagina di Pagine 6-4 di 9 Versione 2 del 13/02/2012
6.1.2 Configurazione generazione database La richiesta di generazione del database e i suoi riferimenti possono essere impostati anche precedentemente a livello di configurazione della stampa grafica. In questo caso i parametri saranno considerati come valori da assumere per difetto in fase di produzione della stampa stessa. Per fare ciò accedere ai parametri generali di stampa grafica con l elaborato K1 o con PSG-Report Editor. Figura 2 K1 Parametri generali stampe Paragrafo-Pagina di Pagine 6-5 di 9 Versione 2 del 13/02/2012
6.1.3 Struttura database generato 6.1.3.1 Struttura database generato sul sistema iseries Il file creato viene confezionato in modo dinamico e compone il tracciato record utilizzando i soli campi individuati dall utente, in sede di personalizzazione della stampa grafica (accessibile con l elaborato K2 o con il PSG Report Editor) e fra quelli disponibili sul documento, contrassegnati attraverso l attributo specifico e creato appositamente. Non possono essere inclusi nel tracciato record campi di tipo testata e di tipo dettaglio. Quindi sono esclusi i campi di tipo costante ( C ) e di tipo costante a livello di dettaglio ( D con sequenza maggiore di 20), di conseguenza anche i campi risultati di formule. Inoltre, attualmente non sono controllate le formule che condizionano l utilizzo dei campi che sono quindi ininfluenti per il PSG Table Builder. Ciccando si seleziona il campo per essere incluso nel tracciato record del file da generare Figura 3 K2 Personalizzazione stampe grafiche La funzione di generazione del file non gestisce più membri, ma un file a membro unico. Inoltre l azione svolta è sempre di sostituzione del file in essere e nel caso in cui il file esista già sul sistema lo sovra scrive. Il file ottenuto ha un unico tracciato record che è la somma di tutti i campi scelti, quelli di testata e quelli di dettaglio. Le informazioni di testata sono ripetute su tutti i record di un singolo documento. Le informazioni di dettaglio, essendo multiple, sono disposte su più record ed in caso di dettagli annidati, i campi dei dettagli superiori sono ripetuti sui vari livelli fino a quello del dettaglio minimo. I nomi dei campi sul tracciato record coincidono con il nome del campo in personalizzazione della stampa grafica seguito da un progressivo numerico (necessario per consentire di gestire casi di omonimia). Paragrafo-Pagina di Pagine 6-6 di 9 Versione 2 del 13/02/2012
6.1.3.1.1 Esempio stampa grafica ordine commerciale fornitori Stampa multipla degli ordini, composti da più articoli, con più righe di commento ognuno. Ordine 52301 del 10/02/2012 Articolo A Commento 1 Commento 2 Qtà 10 pezzi Articolo B Commento A Commento B Commento C Qtà 20 pezzi Ordine 52302 del 11/02/2012 Articolo C Commento X Commento Y Commento Z Qtà 30 pezzi Formato stampa grafica disponibile in personalizzazione della stessa (vedi funzione K2) (XSTAM) Riferimenti PSG Nome Campo Descrizione Campo Natura Campo Testata T10 XNURIF Numero Ordine Numerico di 5 cifre Si XDARIF Data Ordine Numerico di 8 cifre Si Dettaglio D05 XCODAR Codice Articolo Alfanumerico di 13 caratteri Si XNUMER Quantità prodotto Numerico di 2 cifre Si Dettaglio D10 XCOMME Riga di commento Alfanumerico di 30 caratteri Si Opzione inclusione file Tracciato record file generato XNURIF00001 Num.Ordine (Testata) XDARIF00002 Data Ordine (Testata) XCODAR00003 Codice articolo (Dettaglio) XNUMER00004 Quantità (Dettaglio) 52300 10022012 A 10 XXX 52300 10022012 A 10 YYY 52300 10022012 B 20 ZZZ 52300 10022012 B 20 KKK 52300 10022012 B 20 KKK 52301 11022012 C 30 SSS 52301 11022012 C 30 DDD XCOMME00005 Commenti (Dettaglio) Paragrafo-Pagina di Pagine 6-7 di 9 Versione 2 del 13/02/2012
6.1.3.2 Struttura file xml compatibile Microsfot Excel Allo scopo di rendere disponibile un documento in un formato compatibile con Microsoft Excel, la funzione genera, in seguito alla creazione del file, anche un corrispondente oggetto in formato xml. Quest ultimo oggetto è disponibile nella forma di allegato al documento di riferimento, nelle seguenti modalità: 1. Nel caso di inoltro del documento principale attraverso un messaggio di posta elettronica, con attiva l opzione di inclusione allegati. E infatti fra questi ultimi che sarà presente il nuovo oggetto in formato xml. In allegato l oggetto nel formato xml contenente i dati del documento. Figura 4 Messaggio di Posta elettronica 2. Nel caso di inoltro del documento principale alla funzione di PRINT BOX CONTROL (device di tipo WG). E infatti disponibile l accesso diretto all oggetto creato, attraverso un apposita icona di rappresentazione dello stesso nel formato XML, alla colonna XML in corrispondenza del documento di riferimento, che esegue la chiamata all applicazione Microsoft EXCEL (una volta configurata come programma da utilizzare sempre per l apertura di questo tipo di file). In corrispondenza del documento è disponibile l icona per accedere all oggetto in formato xml con Microsoft Excel. Figura 5 Webgate Print Box Control Paragrafo-Pagina di Pagine 6-8 di 9 Versione 2 del 13/02/2012
7 PREREQUISITI 7.1 Prerequisiti dei documenti Per tutte le stampe grafiche personalizzabili dal Psg - Report Editor, è possibile richiedere la creazione del file. In caso di documenti complessi, con dettagli annidati tra loro a diversi livelli, è fondamentale che il programmatore abbia premura di organizzare le informazioni nei dettagli prevedendo la struttura che permette di conoscere i legami fra di essi. Questo prerequisito è fondamentale perché l applicazione riesca a ricondurre informazioni dettagliate a propri riferimenti non di testata ma di dettagli superiori. A questo scopo leggere il manuale PSG per programmatori al paragrafo 6.1.3.1. Facendo riferimento all esempio al punto 6.1.3.1.1 di questo manuale, le informazioni rese disponibili dal programmatore nell archivio XSTAM devono essere organizzate come segue: XSDA01 XSDA02 XSDA03 XSNDOC XSTIRE XSNREC XSIDDT XSIDD2 XSIDD3 XSIDD4 XSIDD5 52300 10/02/12 00001 T 10 0 0 0 0 0 A 10 00001 D 05 00001 00000 00000 00000 00000 Commento1 00001 D 10 00001 00001 00000 00000 00000 Commento2 00001 D 10 00001 00002 00000 00000 00000 B 20 00001 D 05 00002 00000 00000 00000 00000 CommentoA 00001 D 10 00002 00001 00000 00000 00000 CommentoB 00001 D 10 00002 00002 00000 00000 00000 CommentoC 00001 D 10 00002 00003 00000 00000 00000 52301 11/02/12 00002 T 10 0 0 0 0 0 C 30 00002 D 05 00001 00000 00000 00000 00000 Commento1 00002 D 10 00001 00001 00000 00000 00000 Commento2 00002 D 10 00001 00002 00000 00000 00000 CommentoA 00002 D 10 00001 00003 00000 00000 00000 N.B. Per PSG-Table Builder non è importante la sequenza temporale con cui vengono scritti i records nel file di lavoro XSTAM, ma bensì la codifica dei legami tra i dettagli. In documenti semplici senza annidamenti delle informazioni, questi legami non sono indispensabili per ottenere un risultato già soddisfacente. Mentre è prerequisito fondamentale in documenti complessi. 7.2 Prerequisiti di ambiente L applicazione PSG Table Builder è un modulo aggiuntivo che richiede un abilitazione propria. Perché funzioni, è necessario come prerequisito il modulo standard PSG-Report Editor. Le versioni di Microsoft Excel compatibili sono 2003 o superiori. Paragrafo-Pagina di Pagine 7-9 di 9 Versione 2 del 13/02/2012