PSG TABLE BUILDER – Manuale Utente

PSG Table Builder – Manuale Utente
PSG TABLE BUILDER – Manuale Utente
Paragrafo-Pagina di Pagine 1-1 di 9
Versione 2 del 13/02/2012
PSG Table Builder – Manuale Utente
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
6.1.3.2
7
Esempio stampa grafica ordine commerciale fornitori.................................................................... 6-7
Struttura file xml compatibile Microsfot Excel .................................................................................... 6-8
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
PSG Table Builder – Manuale Utente
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
15 mn
15 mn
1.
Generare un database
Base
2.
Gestire il database
Base
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
PSG Table Builder – Manuale Utente
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
PSG Table Builder – Manuale Utente
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
PSG Table Builder – Manuale Utente
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
PSG Table Builder – Manuale Utente
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
Articolo B
Commento A
Commento B
Commento C
Qtà 10 pezzi
Qtà 20 pezzi
Commento Y
Commento Z
Qtà 30 pezzi
Ordine 52302 del 11/02/2012
Articolo C
Commento X
Formato stampa grafica disponibile in personalizzazione della stessa (vedi funzione K2) (XSTAM)
Riferimenti PSG
Testata T10
Dettaglio D05
Dettaglio D10
Nome Campo
Descrizione Campo
Natura Campo
Opzione
inclusione
file
XNURIF
Numero Ordine
Numerico di 5 cifre
Si
XDARIF
Data Ordine
Numerico di 8 cifre
Si
XCODAR
Codice Articolo
Alfanumerico di 13 caratteri
Si
XNUMER
Quantità prodotto
Numerico di 2 cifre
Si
XCOMME
Riga di commento
Alfanumerico di 30 caratteri
Si
Tracciato record file generato
XNURIF00001
XDARIF00002
XCODAR00003
XNUMER00004
Num.Ordine (Testata) Data Ordine (Testata) Codice articolo (Dettaglio) Quantità (Dettaglio)
XCOMME00005
Commenti (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
Paragrafo-Pagina di Pagine 6-7 di 9
Versione 2 del 13/02/2012
PSG Table Builder – Manuale Utente
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
PSG Table Builder – Manuale Utente
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
52300
10/02/12
A
10
XSDA03…
Commento1
Commento2
B
20
XSNDOC XSTIRE
XSNREC XSIDDT XSIDD2 XSIDD3
XSIDD4
XSIDD5
00001
10
0
0
T
0
0
0
00001
D
05
00001
00000
00000
00000
00000
00001
D
10
00001
00001
00000
00000
00000
00001
D
10
00001
00002
00000
00000
00000
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