Home

Documentazione

1. S In questo modo se a colonna 60 dello spool a prescindere da pagina riga viene trovato il testo IMG esso sar omesso e sostituito da un immagine il cui nome si trova alla stessa pagina una riga in meno colonna 10 per una lunghezza di 13 caratteri il codice articolo nell esempio che non verr omesso Le immagini utilizzate dal PC server saranno D Immagini Articoli Img_01010TAVSARDE jpg D Immagini Articoli Img_04550BASE20XL jpg http www pdfcom it Pagina 48 di 150 6 6 Macro Action di Stile Tramite una Macro Action di Stile si ha la possibilit di scegliere Tipo di Font eventualmente grassetto e o corsivo Dimensioni del Font Sottolineatura del testo Come opzioni avanzate possibile scegliere Colore del testo Testo evidenziato con scelta del colore Riquadro intorno al testo con scelta del colore Testo nascosto Spostamento del testo Ogni Macro Action di Stile composta dai seguenti parametri Modifica Tipo Modulo PDF FATTURE x b1K c Le 2 La 100 Times New Roman b std 12 4 72 blank standard 7u 1 999 blank ricerca su tutte 1 99 blank ricerca su tutte 1 220 blank no ricerca Z8 001 050 051 100 101 150 151 200 F12 Precedente F23 Avanzate Numero sequenza Il numero di sequenza determina l ordine con il quale verranno applicate le Macro Action di Stile Si deve tenere presente che per u
2. Per specificare una macro dinamica necessario valorizzare anche i parametri Colonna e Testo dettagliati in seguito e facoltativamente Numero Pagina e Riga dettagliati in seguito Saranno proprio tali parametri a determinare la coppia dei valori di pagina e riga per i quali la Macro Action viene applicata Detto questo i valori di pagina e o riga all interno del parametro Inserimento macro possono essere lasciati a zero ed assumeranno dinamicamente il valore di pagina e o riga per i quali la Macro Action viene applicata Ulteriormente specificando un valore o nel flag di pagina e riga possibile specificare un offset rispettivamente positivo o negativo per determinare il valore di pagina e o riga dello spool dove applicare lo stile Detto in altre parole poich la Macro Action pu essere dinamica ovvero venir applicata in presenza di un determinato testo ad una determinata colonna a prescindere o meno da pagina e riga anche il puntamento alla stringa dello spool alla quale applicare lo stile pu essere astratto e quindi legato alla pagina riga per le quali la Macro Action si applicher Il sottocampi ccc e III indicativi rispettivamente della colonna e della lunghezza cui applicare lo stile sono invece valori sempre assoluti ed obbligatori da specificare Tipo Font Il tipo di carattere da utilizzare per la parte di testo specificata dalla Macro Action Se il valore non viene specificato sar utilizza
3. http www pdfcom it Pagina 46 di 150 pdfCom 7 1 Manuale utente essere condizionata al verificarsi della condizione data dalla presenza o meno di una determinata stringa di testo nello spool In quest ultimo caso il valore Colonna assume due significati contemporaneamente rappresenta sia il punto in cui viene inserita eventualmente l immagine sia il punto in cui iniziare il controllo del testo specificato Numero Pagina Indica il numero di pagina dello spool relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti alla quale viene applicata la Macro Action Se non viene specificato ci sono due possibilit gt Si specifica il valore Testo e la Macro Action diventa condizionale Il numero di pagina sar quello o tutti quelli nel quale la condizione di presenza del testo si verifica gt Si specifica il valore Riga e la Macro Action verr applicata sulla riga specificata di tutte le pagine Riga Indica il numero di riga dello spool alla quale viene applicata la Macro Action Se non viene specificato il valore Testo diventa obbligatorio e di conseguenza la Macro Action diventa condizionale il numero di riga sar quello o tutti quelli nel quale la condizione di presenza del testo si verifica Testo La stringa di testo da ricercare nelle righe dello spool partendo dal valore di Colonna specificato ed eventualmente ristretto al Numer
4. Destinatario Destinatario Destinatario Destinatario Destinatario Destinatario Destinatario Destinatario Destinatario aggiuntivo 1 aggiuntivo 2 aggiuntivo 3 aggiuntivo 4 aggiuntivo 5 aggiuntivo 6 aggiuntivo 7 aggiuntivo 8 aggiuntivo 9 Senza allegato Allegato aggiuntivo 1 Allegato aggiuntivo 2 Allegato aggiuntivo 3 Allegato aggiuntivo 4 Allegato aggiuntivo 5 Allegato aggiuntivo 6 http www pdfcom it Pagina 76 di 150 pdfCom 7 1 MailAttach 7 MailAttach 8 MailAttach 9 User Subject Keywords EncrPwd EncrDisablePrt EncrOpenPwd TiffCompress TiffResolution TiffDithering PrtSync PrtScale PrtFit PrtResolution PrtDuplex 0 O O O O O O O O QD QQ O QQ a a 0 a R Q O O Mo amp pppoffsetX amp amp pppOffsetY amp amp pppLPI amp amp pppCharSize amp amp pppFont amp amp I ppp rr ccc www hhh amp s ppp ere eee 11 1 amp amp B ppp rr ccc www hhh amp amp G PPprrr ece amp amp Gnnn NomeParametro amp amp C amp amp Cnnn NomeField Manuale utente Allegato aggiuntivo 7 Allegato aggiuntivo 8 Allegato aggiuntivo 9 Autore del PDF Oggetto del PDF Parole chiave del PDF Pwd modifica Crittografia PDF Disab stampa Crittografia PDF Pwd apertura Crittografia PDF Compressione Render in TIFF Risoluzione Render in TI FF Dithering Render in TI FF Stampa sincrona Scala Centra
5. con allegato il PDF generato e la riga 3 del corpo della mail viene sostituita con la stringa la fattura n 6 del 12 2 06 Viene impostato inoltre un fincato specifico d finc fatt_rifra pdf per il PDF che verr creato e per la sola pagina 1 viene effettuata una forzatura sul fincato d finc fatt_natale_rifra pdf con relativo aggiustamento del solo Offset Y Ulteriormente a pagina 1 riga 56 colonna 10 viene inserita l immagine d finc albero_natale jpg Ovviamente tutti gli altri parametri saranno quelli specificati sulla Gestione dei Tipi Modulo 7 10 Blocco parametri embedded nel file di spool Un altra interessante possibilit per fornire parametri a pdfCom consiste nello stamparli direttamente all interno del file di spool tramite il proprio applicativo pdfCom utilizzer tali parametri con le stesse regole viste in questo capitolo ed ometter automaticamente dal documento finale l intero blocco dei parametri Il blocco parametri embedded ovviamente facoltativo e deve trovarsi alla fine del file di spool racchiuso da una riga di inizio ed una di fine secondo la seguente struttura PDFCOM START ECEAEE RigaParametrol RigaParametro2 EGEPDFCOM STOPARCE Il blocco parametri verr omesso automaticamente da pdfCom comprese eventuali pagine vuote risultanti dall omissione Detto in altre parole se vengono aggiunte allo spool delle http www pdfcom it Pagina 82 di 150 pdfCom
6. possibile fornire alla API 1 di pdfCom il puntatore ad un array dati utente Se si desidera utilizzare questa funzionalit obbligatoria nel caso di chiamata in modalit Spool Less necessario definire nella procedura che chiamer la API 1 di pdfCom un array di n elementi composti da 220 caratteri alfanumerici in questo modo D SUserDtaA S 220A DIM n n deve essere compreso tra 1 e 32767 E necessario dimensionare il numero di elementi dell array in funzione di quante righe di parametro e di contenuto nel caso di chiamata in modalit Spool Less dovranno effettivamente essere fornite a pdfCom L utilizzo dell array dati utente risulta estremamente efficiente in quanto anche array relativamente grandi non vengono duplicati in memoria bens letti tramite il puntatore fornito direttamente nella zona di memoria che contiene l array istanziato dalla procedura che effettua la chiamata alla API 1 La API 1 di pdfCom dovr essere chiamata includendo la relativa coppia di parametri opzionali UserDtaAN e UserDtaAP da valorizzare come segue Cc Eval SUserDtaAN n C Eval UserDtaAP addr UserDtaA pdfCom durante l elaborazione utilizzer le righe di parametro presenti nell array secondo i criteri di gerarchia dei parametri gi esposti nel paragrafo 7 11 Riepilogo gerarchia dei parametri All interno dell array dati utente necessario inserire un solo parametro per riga terminato sempre dal caratte
7. virtuale determinate proprio da questo parametro analogamente a quanto accade quando viene elaborato un file di spool dove sono pagina riga proprie dello spool a determinare l applicazione di regole di fincato macro etc ExitB ExitAOK SExitAKO ExitWl SExitW2 OPZIONALI Tramite questi parametri possibile specificare ulteriori programmi EXIT di tipo B e di tipo A che verranno richiamati subito dopo gli eventuali programmi EXIT analoghi specificati tramite http www pdfcom it Pagina 107 di 150 pdfCom 7 1 Manuale utente la gerarchia dei parametri fare riferimento al paragrafo 6 10 Parametri di configurazione programmi EXIT ExitB EXIT B SExitAOK EXIT A stato OK SExitAKO EXIT A stato KO SEx1tAWI1 EXIT A stato W lt 07 ExitAW2 EXIT A stato W gt 07 E importante evidenziare che questi parametri sono comunque indipendenti dagli analoghi eventualmente specificati tramite la gerarchia dei parametri e se presenti entrambi saranno richiamati prima i programmi EXIT specificati tramite la gerarchia parametri e poi questi specificati tramite la API 1 Questi parametri opzionali sono da specificare obbligatoriamente in gruppo Possono essere lasciati vuoti oppure valorizzati secondo la seguente struttura LLLLLLLLLLPPPPPPPPPP dove LLLLLLLLLL rappresenta la libreria e PPPPPPPPPP il nome del programma da richiamare Per tutti i parametri valorizzati viene effettuat
8. Grafici 57 6 9 Parametri di elaborazione documenti 60 6 10 Parametri di configurazione programmi EXIT 64 6 11 Gestione override parametri per Utente 66 6 12 Gestione override parametri per Coda modulo opzionale Sorter 69 6 13 Gestione variabili di Path 72 7 Gestione dei parametri sul singolo spool ________________________ 74 7 1 Parametri di input output per programma utente 74 7 2 Sintassi di specifica diretta dei parametri di elaborazione 75 7 3 Dettaglio sintassi parametri Fincato multiplo 78 7 4 Dettaglio sintassi parametri Macro Action per Immagine 79 7 5 Dettaglio sintassi parametri Macro Action per Stile 79 7 6 Dettaglio sintassi parametri Macro Action per Codice a Barre 81 7 7 Dettaglio sintassi parametri Macro Action per Grafico 81 7 8 Dettaglio sintassi parametri Forms 82 7 9 Esempio di utilizzo dei campi USRDFNDTA e USERDATA 82 7 10 Blocco parametri embedded nel file di spool 82 7 11 Riepilogo gerarchia dei parametri 83 8 Gestione avanzata tramite programmi EXIT ____ 84 8 1 Parametri di input output per programma EXIT B 85 8 2 Struttura file DB per programma EXIT B 86 8 3 Parametri di input output per programma EXIT A 90 http www pdfcom it Pagina 2 di 150 pdfCom 7 1 9 Pannello di Controllo su System i 9 1 Dettagli sui file IFS di pdfCom Manuale utente 91 9 2 Come pdfCon gestisce l invio delle e mail 95 10 Log nel Registro degli Eventi di Windows 10 1 Configurazione del Registro degli
9. Scegliere come Tipo di avvio l opzione Automatico e cliccare sulla scheda Connessione Propriet Computer locale pdfCom Generale Connessione Ripristino Relazioni di dipendenza Connessione O Account di sistema locale Account UTENTE Password evecseseseeseso Conferma password eeeeesssssseso possibile attivare o disattivare questo servizio per i seguenti profili hardware Profilo hardware Servizio Profilo 1 Attivato Anzich Account di sistema locale scegliere Account e digitare nella casella a fianco un nome utente con il quale funzioner il servizio sul PC server L account che verr specificato in questa fase pu essere un account locale del PC server nel qual caso si utilizza il prefisso come nell esempio oppure un account di dominio Microsoft nel caso che il PC server faccia parte di un dominio nel qual caso il prefisso da utilizzare sar nomedominio E altres necessario digitare la password e relativa conferma nelle caselle sottostanti Infine premere il pulsante OK Effettuati questi passi il servizio sar correttamente configurato e verr avviato in automatico ad ogni partenza del PC server http www pdfcom it Pagina 18 di 150 pdfCom 7 1 Manuale utente 5 2 Configurazione dei parametri di default per il servizio L installazione sul PC server crea un gruppo di programmi denominato pdfCom nel men
10. nelle propriet del PDF generato viene impostato automaticamente da pdfCom con il nome utente System i che proprietario del file di spool http www pdfcom it Pagina 77 di 150 pdfCom 7 1 Manuale utente Il parametro Subject riportato come Oggetto nelle propriet del PDF generato viene impostato automaticamente da pdfCom con il nome del file di spool su System i Il parametro Keywords riportato come Parole chiave nelle propriet del PDF generato viene impostato automaticamente da pdfCom con i seguenti valori nell ordine tipo modulo nome lavoro System i che ha generato lo spool numero lavoro System i che ha generato lo spool numero del file di spool su System i e numero progressivo di rottura del file di spool A questo elenco di parole chiave verr aggiunto in fase di elaborazione su PC server il nome del file su IFS vedi paragrafo 9 1 Dettagli sui file IFS di pdfCom E possibile valorizzare a piacimento ognuno dei tre parametri tramite la sua specifica diretta 4 Questi parametri sebbene possano essere ereditati dalle impostazioni del tipo modulo vedi paragrafo 6 3 Parametri fincato multiplo e 6 4 Parametri Macro Action se specificati direttamente devono essere assoluti Verr fornita una spiegazione dettagliata nei seguenti paragrafi 7 3 Dettaglio sintassi parametri Fincato multiplo 7 4 Dettaglio sintassi parametri Macro Action per Immagine 7 5 Dettaglio sintassi parametri Mac
11. possibile specificare percorsi locali dal punto di vista del PC server o percorsi di rete con nomi UNC purch raggiungibili dal PC server E altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Se non viene specificato alcun percorso verr utilizzato quello specificato in Cartella di archiviazione copia configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio E da notare che se viene specificato il valore speciale http www pdfcom it Pagina 30 di 150 TEMP in Cartella output documenti non sar possibile specificare alcun valore per questo parametro Come si vedr nei paragrafi 6 11 e 6 12 Gestione override parametri questo parametro potr essere impostato anche per utente o coda di stampa quest ultima solo se risulta installato il modulo opzionale Sorter Premendo il tasto di funzione F23 Avanz si accede alle opzioni avanzate RUS Rm Inserimento Tipo Modulo PDF S 78 50 1200 blank predefinita ETAN blank predefinito N 3 4 L blank predefinita 78 blank random blank nessuna S PARAMETRI DI STAMPA S N blank predefinita S N blank predefinita S N blank predefinita 0 1 2 3 4 blank predefinita 0 D NZ Z H blank predefinito 05 027 Macro automatiche Se devono essere create automaticamente le macr
12. M permette di rendere nuovamente da elaborare un file gi elaborato esclusivamente ai fini dell invio tramite mail se previsto In pratica il documento PDF TXT o TIFF non verr salvato da nessuna parte analogamente a come se fosse specificato TEMP sul parametro Cartella output documenti vedi paragrafo 6 1 Parametri generali di creazione dei PDF non verr archiviato e non verr stampato anche se previsto Questa opzione risulta particolarmente utile in caso si verifichino problemi relativi al solo invio tramite mail come ad esempio in caso di un malfunzionamento del server SMTP L opzione I permette di visualizzare eventuali metadati di indicizzazione associati al file fare riferimento al capitolo 13 Indicizzazione documenti Tramite l opzione 8 possibile accedere alla schermata di dettaglio relativa ad un file Tale schermata offre una descrizione estesa dello stato del file e relativo storico e permette anche la consultazione del log del PC server se presente relativamente al file in esame 9 1 Dettagli sui file I FS di pdfCom pdfCom crea sulla cartella dell IFS specificata nella configurazione dell istanza un file pronto per essere elaborato dal PC server per ogni spool o parte di esso in caso vengano specificate opzioni di rottura che viene indirizzato sulla coda di output controllata dall istanza o processato tramite API Tutti i file creati avranno un nome che rispetta la seguente struttura S
13. Per ogni criterio possibile specificare i seguenti parametri mi Eaj Gestione indicizzazione per tipo modulo TEST_IDX 0000 Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Inserisci 0 _NSegq Meta TAG T Valore DOCUMENTO A A Inserimento Criterio Metadato ERRE TEST_IDX F4 GG MMZAAZAAAA hh mm ss F12 Precedente o y y o 0 4 FO6 Inserisci F12 Precedente Numero sequenza Il numero di sequenza irrilevante ai fini dell elaborazione Risulta per comodo ai fini di leggibilit ed organizzazione della lista dei criteri di valorizzazione dei metadati Meta TAG Specifica il meta tag per il quale il documento sar indicizzato Premendo il tasto di funzione F4 con il cursore posizionato su questo campo possibile scegliere il meta tag da utilizzare E da notare che direttamente nella finestra di ricerca possibile anche inserire nuovi meta tag Valore Il valore del metadato per il quale il documento sar indicizzato E da notare che parte o tutto il contenuto del campo pu essere reperito dinamicamente dal contenuto dello spool tramite l utilizzo di uno o pi PlaceHolder con il seguente formato lt ppp rr ccc 111 0 gt Dove ppp rappresenta la pagina relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti rr la riga e ccc la colonna Ill indica la lunghezza di testo da utilizzare in pratica la lunghez
14. Se specificato un programma utente in questo caso opzionale esso verr richiamato ad ogni rottura E molto importante sottolineare che in caso di suddivisione dello spool in pi documenti ogni documento assumer un ruolo assoluto sulla cartella IFS relativa all istanza saranno presenti tanti documenti frutto della suddivisione come se fossero ognuno relativo ad un singolo spool Ulteriormente tutti i parametri specificati nella gestione Tipi Modulo che fanno riferimento ad un numero pagina diventeranno relativi alla pagina del documento gi suddiviso partendo ogni volta dalla pagina numero 1 Blank Segue Prec Specifica come pdfCom deve comportarsi in presenza di una stringa vuota blank nella posizione referenziata dai parametri Riga Colonna Lunghezza quando la rottura attiva E possibile specificare questo parametro solo se specificato il parametro Rottura I valori possibili sono S e P Specificando la presenza di una stringa vuota causer comunque la rottura a meno che anche nella pagina precedente la stringa non fosse vuota In pratica il blank sar considerato come un valore vero e proprio vedi esempio sotto Specificando S Blank Segue la presenza di una stringa vuota non causer rottura e la pagina far parte del documento precedente vedi esempio sotto Specificando P Blank Precede la presenza di una stringa vuota causer rottura a meno che anche nella pag
15. amp Cnnn NomeField ValoreField E importante non inserire spazi almeno che non facciano parte di una stringa Nome Valore Fincato oppure Immagine e terminare separare sempre con il carattere punto e virgola L ordine dei parametri specificati irrilevante Se i parametri vengono specificati nel campo USRDFNDTA di un file di spool lunghezza massima di 255 caratteri oppure nel campo USERDATA del programma utente lunghezza massima di 2048 caratteri devono essere concatenati l uno all altro senza spazi separati da punto e virgola fare riferimento al paragrafo 7 9 Esempio di utilizzo dei campi USRDFNDTA e USERDATA Se i parametri vengono specificati nel blocco parametri embedded nel file di spool oppure nell array dati utente API 1 necessario specificare rispettivamente un solo parametro per riga oppure un solo parametro per elemento Per maggiori informazioni fare riferimento al paragrafo 7 10 Blocco parametri embedded nel file di spool e 12 3 Dettagli sull utilizzo dell array dati utente http www pdfcom it Pagina 75 di 150 pdfCom 7 1 Manuale utente Di seguito riportata la tabella con tutti i nomi dei parametri che possibile specificare TABELLA NOMI PARAMETRI AQ O O a Q GO GO 0 O a a a ZO N ZO O ZO O TO O GO O EGO O ZO O ZO O ZO NO ZO N ZO O N O UN O TN O TN O TO O TO O GO O GO a O O O O Q GN QQ QQ O GO O QQ Q O O O QQ QQ DD QQ
16. con dati compilati dinamicamente come fincati con il modulo opzionale Forms Indicizzare tutti i documenti prodotti tramite un numero pressoch illimitato di meta TAG con valori dinamici in base al contenuto in modo da poter effettuare ricerche multiple su tutti i documenti prodotti Ulteriormente una volta generati i documenti PDF possibile Effettuare la stampa automatica Effettuare l invio automatico tramite e mail Archiviare i documenti in rete Rasterizzare i documenti in formato TIFF b n multipagina Il prodotto composto essenzialmente da due parti una che risiede su System i ed un altra che risiede su PC o server con piattaforma Microsoft Windows 2000 XP 2003 2003R2 Il funzionamento risulta estremamente semplice sufficiente dirigere una stampa System i su una particolare coda di stampa definibile dall utente ed automaticamente il file di spool verr pre elaborato e preso in carico dalla parte del prodotto che risiede su PC server quest ultima provveder alla produzione del documento PDF TXT o TIFF secondo le specifiche contenute nel file stesso nonch al suo eventuale invio tramite e mail e o archiviazione La parte System i in grado di supportare pi istanze simultanee rendendo possibile avere pi code di stampa ognuna abbinata ad un PC server associato Ulteriormente pdfCom mette a disposizione due potenti API in modo da integrare la produzione dei documenti PDF TXT o T
17. di avvio di Windows tasto Start Programmi Selezionando la voce Configurazione pdfCom verr visualizzata la seguente finestra Configurazione di pdfCom Lingua Strumenti Parametri generali Cartella output documenti DAPDFs Cartella archiviazione copia Documenti con errori in cartella DiNPDFSA_ERRORI Stampante di default MRIFRA SRY155amsung CLP 610 Series Mono Parametri monitoring Indirizzo System i iseries rifranet locale Pota 4000 Cartella istanza PDFCOMX Intervallo monitor 5 r 1 60 secondi Intervallo tentativi monitor 1200 1 3600 secondi Parametri e mail Server SMTP smtp gmail com Porta 25 Autenticazione Usemame stefano picchi rifranet it Utilizzare SSL Password CON N tentativi 1 IS Conferma ncesecese Parametri rasterizzazione TIFF Risoluzione DPI 600 50 1200 DFI Dithering Compressione O Nessuna CCTT3 CCITTA OLZW Controllo servizio Stato attuale Arrestato non attivo gt HO Il Da qui possibile impostare i parametri di default per il servizio pdfCom controllarne lo stato ed effettuare le operazioni di avvio arresto sospensione E da notare che lo stato pu essere controllato anche dalla Gestione Servizi di Windows vedi paragrafo 5 1 Configurazione del servizio pdfCom analogamente alle operazioni di avvio arresto sospensione http www pdfcom it Pagina 19 di 150 pdfCom 7
18. ovvero il fincato sar utilizzato nelle sue dimensioni reali Rotazione Specifica l eventuale rotazione da applicare al fincato E possibile specificare i seguenti valori Nessuna rotazione Rotazione di 90 Rotazione di 180 Rotazione di 270 A WwW N e Se non viene specificato alcun valore la rotazione sar automatica ovvero se il fincato orizzontale ma il PDF da produrre verticale o viceversa sar effettuata una rotazione di 270 I parametri che seguono permettono a pdfCom di determinare se la regola da applicare o meno su una pagina E possibile specificare in alternativa o un numero di pagina assoluto del file di spool o riga colonna relative ad una stringa presente sullo spool che dovr contenere un certo testo affinch la regola sia valida Numero pagina Indica il numero di pagina dello spool relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti per la quale la regola sar applicata Specificando tale parametro la regola riguarder ovviamente solo una determinata pagina e non sar possibile specificare ulteriori parametri Specificando il valore speciale L last ultima possibile fare riferimento all ultima pagina dello spool relativa al singolo documento Specificando il valore speciale O only unica possibile fare riferimento alla prima pagina dello spool se essa l unica pagina relat
19. percorso del file del fincato la soluzione al problema Ulteriormente possibile anche avere variabili di path indipendenti dall istanza da utilizzare per sostituire parti di percorso comuni a tanti percorsi configurati nei tipi modulo con il vantaggio di poter spostare i file puntati modificando la sola variabile senza dover modificare tutti i percorsi che la utilizzano Tramite l opzione 6 5 del menu principale di pdfCom si accede alla Gestione variabili di Path BUSI CI User SPI Gestione variabili di Path Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza OT Variabile Istanza Path _ F FTEST1 PDFCOM S PDFCOMX _ F TEST_2I _ P PTEST F03 Fine FO6 Inserisci Da qui possibile gestire entrambe le tipologie F e P di variabili di path Per ogni variabile di path possibile impostare i seguenti parametri nl RR User SPI Gestione variabili di Path Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 0 T Variabile Istanza Path _ F FTEST1 PDFCOM Inserimento variabile di Path FZP blank tutte F12 Precedente F03 Fine FO6 Inserisci Tipo path Specifica il tipo di variabile di path Specificando F file la variabile sar utilizzabile in sostituzione di tutto o parte del percorso di un file Specificando P printer stampante la variabile sar utilizzabile in sostituzione di tutto o parte del nome di una stampante Nome variabile Il nome della vari
20. simultanei da attivare Per dimensionare correttamente il numero di threads da attivare si consiglia di seguire queste semplici linee guida se si tratta di un server dedicato al prodotto anche se virtuale impostare 2 threads per ogni core del processore per un processore dual core impostare 4 threads per un processore quad core o pi impostare 8 threads s si tratta di un server non dedicato al prodotto ovvero che ospita anche altri servizi impostare in linea di massima 1 thread per ogni core del processore sesitratta di un PC disattivare la modalit MultiThreading Stampa pdfCom permette di effettuare un eventuale stampa automatica dei PDF prodotti Il motore di stampa permette di impostare oltre alla risoluzione di stampa anche l eventuale utilizzo del fronte retro Ulteriormente possibile scegliere di effettuare anche una scalatura e centratura automatica della stampa utile in caso di stampa su fogli di dimensioni differenti da A4 nonch un adattamento automatico all area di stampa Il motore di stampa permette anche di scegliere se la stampa deve essere effettuata in modalit sincrona o asincrona La stampa sincrona viene effettuata dallo stesso processo o dagli stessi processi in caso di MultiThreading che si occupa della produzione del documento il processo rimarr occupato fino a quando la stampa non sar stata completamente accodata sulla stampante e solo a quel punto potr iniziare la produzione del
21. 7 1 Manuale utente pagine in coda per contenere il blocco parametri embedded esse saranno completamente eliminate All interno del blocco parametri necessario inserire un solo parametro per riga terminato sempre dal carattere punto e virgola E possibile lasciare righe vuote e la colonna di inizio irrilevante All interno del blocco parametri possibile specificare tutti i tipi di parametro compresi i metadati relativi all indicizzazione per informazioni relative all indicizzazione documenti fare riferimento al capitolo 13 Indicizzazione documenti 7 11 Riepilogo gerarchia dei parametri Come abbiamo visto fino ad ora esistono vari punti dove poter specificare i parametri di elaborazione che pdfCom dovr utilizzare Ogni volta possibile specificare tutti o parte dei parametri e come risultato finale sar applicata la somma dei vari parametri man mano specificati Poich uno stesso parametro potrebbe essere specificato pi volte e con valori diversi esiste una ben definita gerarchia comune a tutti i parametri per definire quello che sar il valore finale effettivo La gerarchia dei parametri la seguente Blocco parametri embedded nel file di spool P o z 0 Campo USERDATA PGM utente e o API 1 Array dati utente UserDtaA API 1 Campo USRDFNDTA su spool Gestione override parametri per Utente como Gestione override parametri per Coda aoc Gestione Tipi Modu
22. D 14 A 0 3 3 10 F Arial Italic D 12 UND CF 255050050 CB 100100255 T Torta ID 001 FO6 Ins Immag FO7 Ins Stile F08 Ins Barcod F09 Ins Graf F12 Precedente Da qui possibile gestire tutti i parametri che caratterizzano le Macro Action Le Macro Action sono divise in quattro tipologie distinte ovvero Macro Action di Immagine evidenziate in blu Macro Action di Stile evidenziate in rosa fucsia Macro Action di Codice a Barre evidenziate in rosso e Macro Action di Grafico evidenziate in bianco 6 5 Macro Action di Immagine Tramite una Macro Action di Immagine si ha la possibilit di inserire immagini nei PDF o TIFF generati E da notare che il nome completo di path dell immagine o una sua parte pu essere reperito direttamente dal contenuto dello spool tramite un PlaceHolder Questa funzionalit risulta utile ad esempio per la stampa di cataloghi nei quali l immagine varia a seconda dell articolo che deve raffigurare Ogni Macro Action di Immagine composta dai seguenti parametri mi SI CI VICI XI ICI TIT VITE Modifica Tipo Modulo PDF EPE Modifica Macro per Immagine FATTURE d immagini Ima lt 000 M01 010 020 s gt bmp 1 999 blank da immagine 1 999 blank da immagine 1 220 1 999 blank riga o testo 1 99 blank ricerca testo 001 050 051 100 101 150 151 200 F12 Precedente 04 028 Numero sequenza Il numero di sequenza determina l ordine con il quale verranno applicat
23. Eventi 96 11 Manutenzione 11 1 Funzioni di pulizia automatica 99 100 11 2 Funzioni di reportistica automatica 102 12 pdfCom Application Programming I nterface API 12 1 pdfCom API 1 Elaborazioni real time 104 104 12 2 Tabella codici errore di pdfCom API 1 109 12 3 Dettagli sull utilizzo dell array dati utente UserDtaA 110 12 4 pdfCom API 2 Servizi accessori sui file IFS e relativi stati 12 5 Tabella codici errore di pdfCom API 2 111 112 13 Indicizzazione documenti 13 1 Gestione tabella dei Meta TAG 113 113 13 2 Configurazione indicizzazione per Tipo Modulo 115 13 3 Indicizzazione tramite parametri 118 13 4 Ricerca documenti tramite indice da Pannello di Controllo 119 14 Grafici modulo opzionale Grafici 14 1 Struttura dei parametri Graph Set 120 120 14 2 Parametri dei grafici a Curve codice grafico 00 121 123 14 3 Esempio di grafico a Curve 14 4 Parametri dei grafici a Barre codice grafico 01 125 14 5 Esempio di grafico a Barre 127 14 6 Parametri dei grafici a Torta codice grafico 02 129 14 7 Esempio di grafico a Torta 131 15 Moduli PDF modulo opzionale Forms 15 1 Valorizzazione campi Form per Tipo Modulo 133 133 15 2 Struttura dei parametri Form Set 136 16 Smistamento automatico modulo opzionale Sorter 16 1 Gestione Regole di Smistamento
24. Format Larghezza Immagine La larghezza espressa in 72esimi di pollice 1 72 0 3528 mm dell immagine In pratica l immagine verr allargata o compressa per occupare esattamente la larghezza specificata Se questo valore non viene specificato pdfCom utilizzer la risoluzione effettiva dell immagine per calcolare le sue dimensioni se quest ultima nulla non specificata nel file si assumer una risoluzione di 72 dpi in questo modo la larghezza dell immagine in millimetri calcolabile moltiplicando il numero di pixel orizzontali per 0 3528 Se si specifica la Larghezza Immagine anche Altezza Immagine obbligatorio Altezza Immagine L altezza espressa in 72esimi di pollice 1 72 0 3528 mm dell immagine In pratica l immagine verr allungata o compressa per occupare esattamente l altezza specificata Se questo valore non viene specificato pdfCom utilizzer la risoluzione effettiva dell immagine per calcolare le sue dimensioni se quest ultima nulla non specificata nel file si assumer una risoluzione di 72 dpi in questo modo l altezza dell immagine in millimetri calcolabile moltiplicando il numero di pixel verticali per 0 3528 Se si specifica l Altezza Immagine anche Larghezza Immagine obbligatorio Colonna Questo valore specifica la colonna dello spool alla quale viene applicata la Macro Action Tale parametro obbligatorio E da sottolineare che l applicazione di una Macro Action pu anche
25. Nome Percentuale Nome Valore Percentuale Valore Percentuale Nome NESSUNO DISNWNWNEO I valori di percentuale saranno calcolati automaticamente pie pp_label Relativamente alla fetta pp il nome che apparir nella legenda come descrizione della fetta e o nell etichetta se scelto un tipo che prevede la visualizzazione del nome pie pp value Relativamente alla fetta pp il suo valore pie pp_displacement Relativamente alla fetta pp il valore di stacco Utilizzando un valore maggiore di zero la fetta sar rappresentata distaccata dalla torta E consigliabile utilizzare valori relativamente piccoli compresi tra 0 08 e 0 12 pie pp _pieSliceFill Relativamente alla fetta pp il riempimento da utilizzare http www pdfcom it Pagina 130 di 150 pdfCom 7 1 Manuale utente 14 7 Esempio di grafico a Torta Nel precedente paragrafo abbiamo visto tutti i parametri che possibile specificare per un grafico a Barre Per fare un esempio di utilizzo pratico supponiamo di voler realizzare il seguente grafico Prova grafico 02 Torta E 42 31 C 15 98 Supponendo che l ID numerico del grafico sia 003 necessario specificare i seguenti parametri di Graph Set amp amp 003 imgWNidth 300 amp amp 003 imgHeight 300 amp amp 003 imgDPI 200 amp amp 003 gTitle Prova grafico 02 Torta amp amp 003 xTitle Titolo X amp amp 003 yTitle Titolo Y amp amp 003 y2Title Titolo Y2 amp amp 003
26. alfanumerico cartella IFS relativa all istanza Modo INPUT 1 alfanumerico modalit operativa blank R o S FileIFS INPUT 8 alfanumerico nome del file che verr prodotto su IFS Stato IN OUT 3 alfanumerico stato da assegnare al file IFS RTNCD OUTPUT 1 alfanumerico codice di ritorno 4 1 Il campo riferimento array dati utente valorizzato esclusivamente in caso di chiamate tramite API 1 se utilizzato non deve essere utilizzato direttamente sono previste apposite istruzioni di programma gi presenti nel sorgente di esempio che rendono fruibile tale array tramite i campi UserDtaAA e UserDtaAN rispettivamente l array dati utente vero e proprio ed il numero di elementi in esso contenuto indice massimo Fare riferimento al capitolo 12 pdfCom Application Programming Interface per ulteriori dettagli http www pdfcom it Pagina 85 di 150 pdfCom 7 1 Manuale utente 2 Il campo modalit operativa assume i valori R real time o S real time in modalit Spool Less in caso di elaborazione tramite API 1 fare riferimento al capitolo 12 pdfCom Application Programming Interface Diversamente il campo assume il valore blank 3 Tramite questo parametro si ha la possibilit di effettuare una forzatura sullo stato del file che verr prodotto su IFS in attesa di essere elaborato dal PC server Fare riferimento al paragrafo 9 1 Dettagli sui file IFS di pdfCom per una spiegazi
27. applicazione in alternativa della Gestione Servizi di Windows Come si vedr nel capitolo 10 Log nel Registro degli Eventi di Windows pdfCom utilizza il Registro Eventi di Windows per registrare un log delle eventuali anomalie che possono verificarsi durante l elaborazione Nel menu Strumenti scegliendo la voce Visualizzatore eventi possibile accedervi direttamente senza necessit di andare nel Pannello di controllo di Windows http www pdfcom it Pagina 21 di 150 pdfCom 7 1 Manuale utente Dal menu Strumenti scegliendo la voce Opzioni avanzate si accede alla configurazione delle opzioni avanzate di pdfCom Opzioni avanzate MultiT hreading Abilita Threads Stampa C Stampa sincrona Risoluzione Fronte Retro Scala Centra Non impostata Non impostato C Adatta ad area O Bozza O Default driver O Bassa O No fronte retro O Media O Verticale O Alta Orizzontale MultiThreading pdfCom permette la produzione di una grande quantit di documenti in modo estremamente efficiente La quantit di documenti prodotti nell unit di tempo varia ovviamente in base alle prestazioni del PC server Per sfruttare a pieno le caratteristiche dei processori multi core possibile attivare fino ad 8 processi in modo da effettuare in parallelo la produzione di pi documenti Questa funzionalit del prodotto si attiva spuntando la casella di controllo Abilita e scegliendo il numero di Threads processi
28. di smistamento formata da un insieme di criteri di selezione Tramite l opzione 1 del menu Sorter si accede alla gestione delle Regole di Smistamento Gestione Regole di Smistamento oXoxojo Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Inserisci O _NSeg P Set attr Descrizione 0 Nome spool Utente Tipo modulo Dati utente Coda stampa Pgm stampa USEDFNDTA N pagine N colonne Contenuto 1 o Nome spool Utente Tipo modulo Dati utente Coda stampa Pgm stampa USEDFNDTA N pagine N colonne Contenuto 1 F03 Fine FO6 Inserisci 06 013 Da qui possibile gestire tutte le regole che lo smistatore automatico utilizzer per decidere l eventuale modifica degli attributi di un file di spool che entra in una coda monitorata E possibile definire un numero pressoch illimitato di regole Per ogni regola possibile specificare i seguenti parametri LIB OUTO LIBZPGM F12 Precedente F23 Contenuto Numero sequenza Il numero di sequenza irrilevante ai fini dell elaborazione Risulta per comodo ai fini di leggibilit ed organizzazione della lista delle regole di smistamento Priorit Specifica la priorit che deve avere la regola quando viene controllata in fase di elaborazione Pu capitare infatti che due o pi regole siano ugualmente applicabili in tal caso ha la precedenza la regola con priorit maggiore Per meglio comprendere il significat
29. documento Se specificato il parametro Numero pagina la stringa sar omessa solo a quella determinata pagina mentre se specificato il parametro Rottura la stringa sar omessa su tutte le pagine Numero pagina Questo parametro mutuamente esclusivo con il parametro Rottura Specificando tale parametro lo spool non verr in alcun modo suddiviso e la stringa referenziata dai parametri Riga Colonna Lunghezza sar relativa al numero di pagina specificato Diventa quindi obbligatorio specificare un programma utente al quale verr passata la stringa di testo estratta Il programma utente ricevendo tale stringa oltre al Tipo Modulo ed altre informazioni relative allo spool potr effettuare delle elaborazioni specifiche e restituire il campo USERDATA con i parametri da sostituire Volendo fare un semplice esempio se la stringa di testo referenziata relativa al codice cliente presente sullo spool con tipo modulo Fattura il programma utente ricevendo queste informazioni potrebbe andare a reperire l indirizzo e mail del cliente da un anagrafico e restituirlo nel campo USERDATA Il prossimo capitolo 7 Gestione dei parametri sul singolo spool affronta l argomento in modo dettagliato Rottura Specifica se lo spool deve essere suddiviso in pi documenti Valorizzando ad S tale parametro lo spool verr suddiviso al cambio pagina in base alle variazioni della stringa di testo referenziata dai parametri Riga Colonna Lunghezza
30. i quali si vuole filtrare la lista file del Pannello di Controllo Premendo il tasto di funzione F4 con in cursore posizionato sul campo Meta TAG possibile effettuare una ricerca di tutti i meta tag presenti in tabella Nel caso in cui si voglia specificare un valore singolo piuttosto che un range di valori sufficiente valorizzare il campo Valore DA E da notare che eventuali parzializzazioni effettuate nel Pannello di Controllo per range di date e o stato dei file restano comunque attive pdfCom 7 1 Manuale utente 14 Grafici modulo opzionale Grafici Le funzionalit relative ai Grafici sono disponibili solo se risulta installato il modulo opzionale Grafici fare riferimento al paragrafo 2 1 Installazione moduli opzionali Come abbiamo visto nel paragrafo 6 8 Macro Action di Grafico tramite le Macro Action di Grafico si ha la possibilit di inserire grafici dinamici nei PDF o TIFF generati I grafici saranno creati automaticamente da pdfCom con i dati forniti dall utente ed inseriti nei documenti come immagini Questo capitolo affronter l argomento di come fornire a pdfCom tutti i parametri necessari alla creazione dei grafici Graph Set 14 1 Struttura dei parametri Graph Set Come accennato nel paragrafo 6 8 Macro Action di Grafico in una Macro Action di Grafico dobbiamo fornire obbligatoriamente un ID numerico relativo al grafico che vogliamo inserire nel documento Questo ID numerico identifich
31. la regola sia applicabile dovranno essere soddisfatti tutti quelli che vengono specificati Il valore asterisco per i parametri alfanumerici oppure il valore 0 zero per quelli numerici significa tutto ovvero criterio non specificato Nome spool Il nome del file di spool Utente Il nome utente proprietario del file di spool ovvero l utente che ha prodotto la stampa Tipo modulo Il tipo modulo attributo FORMTYPE del file di spool Dati utente Il campo dati utente attributo USRDTA del file di spool Coda stampa libreria coda La coda di stampa che contiene il file di spool E possibile specificare separatamente sia il nome della coda che quello della sua libreria Programma stampa libreria programma Il nome del programma che ha prodotto il file di spool E possibile specificare separatamente sia il nome della programma che quello della sua libreria Campo USRDFNDTA Il campo dati definiti dall utente attributo USRDFNDTA del file di spool Anche se in questo parametro possibile inserire sia caratteri maiuscoli che minuscoli il test sar comunque indipendente dalle maiuscole minuscole ovvero case insensitive N pagine N colonne N righe Il numero di pagine totali colonne e righe del file di spool I criteri di selezione finora descritti si basano esclusivamente su caratteristiche ed attributi del file di spool In aggiunta possibile specificare anche criteri di selezione basati sul contenuto di u
32. mittente e mail Nome mittente e mail Nome che apparir come mittente per eventuali mail spedite da pdfCom in caso non venga specificato un diverso nome mittente pdfCom 7 1 Manuale utente Font base Il tipo di carattere base da utilizzare per il testo E da notare che possibile specificare unicamente Font del tipo MonoSpaced ovvero in cui tutte le lettere occupano la stessa larghezza Il Font base di default il Courier New Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un Font tra quelli disponibili Programma EXIT B E possibile personalizzare il funzionamento di pdfCom in modo avanzato tramite propri programmi esterni Se non in presenza di esigenze specifiche non c la necessit di specificare un Programma EXIT B Fare riferimento al capitolo 8 Gestione avanzata tramite programmi EXIT per ulteriori informazioni Istanza PDFCOMSPL Specifica l istanza predefinita da utilizzare per l utility di invio estemporaneo documenti PDFCOMSPL Fare riferimento al capitolo 17 Invio estemporaneo documenti per ulteriori informazioni Istanza API 1 Specifica l istanza predefinita da utilizzare per l API 1 di pdfCom Fare riferimento al capitolo 12 pdfCom Application Programming Interface per ulteriori informazioni API 1 SpoolLess dft Specifica i valori di default relativi a Colonne LPI e N copie da utilizzare per l API 1 d
33. pagine del documento 1 2 AAA AAA blank 2 1 BBB BBB 3 3 CCC CCC blank blank 4 2 DDD DDD blank 5 1 EEE EEE Con il parametro Blank Segue Prec impostato a P lo spool verr suddiviso in 5 documenti cos strutturati Stringa passata N documento N pagine a PGM utente Contenuto pagine del documento 1 1 AAA AAA 2 2 BBB blank BBB 3 1 CCC CCC 4 3 DDD blank blank DDD 5 2 EEE blank EEE http www pdfcom it Pagina 62 di 150 pdfCom 7 1 Manuale utente Per fare un esempio utile supponiamo di voler creare un tipo modulo denominato MAIL2ME per far si che quando un utente dirige un file di spool con questo tipo modulo su una coda di pdfCom la stampa viene trasformata in PDF ed automaticamente inviata per e mail all indirizzo dell utente proprietario dello spool Da quanto abbiamo visto fin qui possibile creare il tipo modulo PDF MAIL2ME impostare i parametri relativi all invio per e mail di mittente oggetto e corpo mail ma per quanto concerne l indirizzo del destinatario non abbiamo alcuna possibilit se non quella di utilizzare un programma utente in realt come vedremo pi avanti esistono anche altri modi per fornire parametri variabili a pdfCom Insieme al prodotto viene fornito un comodo programma utente denominato PDFU_MAIL nella libreria PDFCOM che in grado di leggere l indirizzo di e mail di un utente del System i dall indirizzario di sistema DI
34. quindi la possibilit di creare metadati per lui strategici in base al contenuto dello spool o forniti direttamente in modo analogo ai parametri ed ottenere cos l indicizzazione di determinati documenti sulla base di quei metadati Questa interessante funzionalit completata da un flessibile motore di ricerca e filtro completamente integrato nel Pannello di Controllo Volendo fare un esempio se definiamo due meta tag uno per numero fattura ed uno per codice cliente sar possibile indicizzare tutte le fatture prodotte da pdfCom per questi due valori Successivamente si avr la possibilit di ricercare le fatture per codice cliente e o per numero fattura pdfCom pu essere sicuramente lo strumento adatto a gestire l intero flusso di documenti in uscita dal System i ed il motore di indicizzazione quello che rende possibile l archiviazione e la successiva ricerca di tutti i documenti prodotti 13 1 Gestione tabella dei Meta TAG I metadati per i quali si desidera indicizzare i documenti devono essere preventivamente dichiarati in un apposita tabella Tramite l opzione 6 4 del menu principale si accede alla Gestione Meta TAG User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r 1 Gestione Meta TAG Opzioni i Inserisci 4 Cancella Meta TAG T Descrizione DESTINATARIO DOCUMENTO FOLDER_ID MITTENTE PRATICA PROVENIENZA RFOUT_KEY TIPO_INVIO UFFICIALE ZDATA Td DD DID DDD DD DI F03 Fine D
35. se installato il modulo opzionale Forms Identificativo numerico del modulo PDF a campi Questo identificativo rappresenta il set di tutti i parametri da utilizzare per la compilazione di un Modulo PDF Form Set Fare riferimento al capitolo 15 Moduli PDF Nome stampante PC su cui stampare E il nome della stampante su cui effettuare eventualmente la stampa Il nome deve essere specificato allo stesso modo di come appare nella gestione Stampanti e fax sul PC server Se non specificato verr utilizzata la Stampante di default configurata al paragrafo 5 2 Configurazione dei parametri di default per il servizio E possibile utilizzare in sostituzione di tutto o parte del nome una viariabile di path di tipo P fare riferimento al paragrafo 6 13 Gestione variabili di Path Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere una stampante tra tutte quelle effettivamente visibili dal PC server E da notare che in caso ci siano pi istanze configurate e quindi pi PC server attivi la lista visualizzata sar complessiva E comunque possibile filtrare le stampanti visibili da un singolo PC server impostando un valore nel campo relativo al filtro per istanza Come si vedr nei paragrafi 6 11 e 6 12 Gestione override parametri questo parametro potr essere impostato anche per utente o coda di stampa quest ultima solo se risulta installat
36. server E da notare che in caso ci siano pi istanze configurate e quindi pi PC server attivi la lista visualizzata sar complessiva E comunque possibile filtrare le stampanti visibili da un singolo PC server impostando un valore nel campo relativo al filtro per istanza pdfCom 7 1 Manuale utente Override n copie Specifica il numero di copie da stampare del documento PDF prodotto Specificando 0 zero non verr effettuata alcuna stampa automatica Se lasciato vuoto il parametro risulter non impostato e verr utilizzato il numero copie specificato nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF Cartella output documenti Il percorso completo della cartella nella quale verranno salvati i documenti prodotti Il percorso specificato deve essere funzionale al PC server che lo utilizzer ed possibile specificare percorsi locali dal punto di vista del PC server o percorsi di rete con nomi UNC purch raggiungibili dal PC server E altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Specificando il valore speciale TEMP il documento prodotto non sar di fatto salvato in nessuna cartella questa impostazione risulta particolarmente utile in caso si desideri generare un documento ai soli fini dell invio tramite e mail oppure ai soli fin
37. smistate Questa opzione risulta particolarmente utile nel caso in cui si voglia sospendere magari temporaneamente le funzioni dello smistatore su una certa coda di stampa 16 3 Gestione attributi di smistamento Come descritto nel paragrafo 16 1 Gestione Regole di Smistamento quando un file di spool soddisfa i criteri di selezione di una regola gli viene applicato un certo set di attributi Un set di attributi da considerarsi come un insieme di nuovi attributi e pu essere utilizzato da una o pi regole di smistamento Tramite l opzione 3 del menu Sorter si accede alla gestione dei set di attributi di smistamento ay Al User SPI Gestione attributi di smistamento Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza Set attr H R Attributi BILANC_RFA REGIVA_RFA TEST1 TEST2 F03 Fine FO6 Inserisci Da qui possibile gestire i set di attributi ognuno identificato da un nome composto al massimo da 10 caratteri alfanumerici da utilizzare all interno di una o pi regole di smistamento Ogni set di attributi composto dai seguenti parametri ag A User SPI renna Gestione attributi di smistamento Inserimento Set attributi FOS5 Rivisual F12 Precedente Set attributi Il nome che identifica il set di attributi E possibile utilizzare fino a 10 caratteri alfanumerici Hold Release Se il file di spool deve essere congelato hold oppure rilasciato release automaticamente S
38. spezzati in pi parti tenendo presente che il valore finale sar il risultato della concatenazione in sequenza compresi eventuali spazi presenti delle stringhe tra il segno uguale ed il punto e virgola di tutti i parametri che si riferiscono allo stesso nome di campo Il NomeField non fa distinzione tra maiuscole e minuscole possibile utilizzare lettere escluso le lettere accentate numeri ed i caratteri _ underscore e segno meno All interno di ValoreField possibile utilizzare tutti i caratteri ad eccezione del carattere punto e virgola in sostituzione disponibile la sequenza di escape P Per specificare il Carriage Return a capo disponibile la sequenza di escape N questa funzionalit risulta utile per i campi che possono andare su pi righe I MPORTANTE Se i parametri di Form Set vengono specificati nei campi USRDFNDTA del file di spool e o nel parametro USERDATA del programma utente non sar possibile inserire valori che eccedono la lunghezza complessiva di 220 caratteri http www pdfcom it Pagina 136 di 150 16 Smistamento automatico modulo opzionale Sorter Le funzionalit relative allo smistamento automatico sono disponibili solo se risulta installato il modulo opzionale Sorter fare riferimento al paragrafo 2 1 Installazione moduli opzionali pdfCom offre delle avanzate funzionalit di smistamento automatico de
39. un timeout definibile Ulteriormente possibile passare direttamente alla API 1 i parametri necessari alla creazione del documento tramite il campo USERDATA argomento trattato nel capitolo 7 e o tramite il puntatore ad una array di dati utente UserDtaA Volendo la API 1 pu operare in modalit Spool Less rendendo indipendente la creazione di documenti PDF TXT o TIFF dalla creazione di file di spool Per il corretto funzionamento necessario che nella lista delle librerie del lavoro che effettua la chiamata alla API 1 siano presenti nell ordine la libreria QTEMP e la libreria PDFCOM diversamente la API 1 produrr un errore in fase di elaborazione errore 96 Ulteriormente al momento della chiamata alla API 1 il sottosistema PDFCOM deve essere attivo fare riferimento al paragrafo 3 3 Avvio del sottosistema PDFCOM diversamente la API 1 produrr un errore in fase di elaborazione errore 95 La API 1 di pdfCom restituisce nel parametro ErrorCod un codice numerico che indica l esito dell elaborazione Questi i parametri di input output D NomeJob S 10A D Utente S 10A D NumJob S 6A D NomeSpool S 10A D NumSpool 5 9B 0 in alternativa 4S 0 D ToFolder S 12A D KeepSpool S 1A D Timeout S 25 0 D CleanUp S 1A D SErrorcod S 25 0 D DocwPath S 256A D UserData S 2048A D OvrTMod S 10A D UserDtaAN S 55 0 http www pdfcom it Pagina 104 di 150 pdfCom 7 1 Manuale utente D U
40. 0 Utente N D Computer PC SPI Descrizione Il fincato specificato c Mtemp PL pdf 53002162 non valido L elaborazione proceder comunque ma non verr aggiunta alcuna fincatura Per ulteriori informazioni consultare la Guida in linea e supporto tecnico all indirizzo http 4 g0 microsoft com fwlink ewents asp Per ogni evento oltre alla descrizione disponibile la data e l ora in cui esso si verificato IMPORTANTE Il registro degli eventi ha una dimensione massima impostabile dall utente Al raggiungimento di tale dimensione in base a come viene impostata la modalit di sovrascrittura degli eventi obsoleti pu risultare impossibile per il servizio pdfCom andare ad aggiungere ulteriori eventi al registro IN TAL CASO IL PRODOTTO SMETTE DI FUNZIONARE Per ovviare a tale eventualit si consiglia vivamente di impostare la configurazione del registro Rifra come descritto nel successivo paragrafo 10 1 Configurazione del Registro degli Eventi http www pdfcom it Pagina 97 di 150 pdfCom 7 1 Manuale utente 10 1 Configurazione del Registro degli Eventi Fare click con il tasto destro sul registro Rifra nella parte sinistra del Visualizzatore eventi vedi paragrafo precedente e scegliere la voce Propriet dal men contestuale Apparir la seguente finestra Propriet Rifra p Generale Filtro Nome visualizzato Rifra Nome registro Dimensione non disp
41. 1 Manuale utente Cartella output documenti Specificare il percorso dove verranno salvati i documenti file PDF TXT o TIFF se non diversamente specificato all interno del file stesso nei parametri di creazione Questo percorso pu essere anche un percorso locale sul PC server In caso si decida di specificare un percorso di rete ricordarsi che poich il servizio gira in background con un determinato utente vedi paragrafo 5 1 non pu disporre di lettere di unit mappate sulle condivisioni i percorsi dovranno pertanto essere specificati in formato UNC Cartella archiviazione copia E possibile specificare una cartella ulteriore dove i documenti verranno copiati Questa cartella non pu coincidere con la Cartella output documenti Anche questo parametro pu essere sostituito da quanto specificato nei parametri di creazione Per quanto concerne i percorsi di rete valgono le stesse regole del parametro precedente Documenti con errori in cartella Spuntando questo controllo tutti i documenti che sono stati generati con errori per maggiori dettagli vedi paragrafo 9 1 Dettagli sui file IFS di pdfCom saranno messi in una sotto cartella denominata _ERRORI all interno della cartella di output dei documenti Tale cartella se non esiste sar creata automaticamente Stampante di default Specificare il nome della stampante sulla quale verranno effettuate le stampe se non diversamente specificato all interno del
42. 137 138 16 2 Gestione Code monitorate 142 16 3 Gestione attributi di smistamento 143 16 4 Log dello smistatore 145 16 5 Impostazione parametri generali del modulo Sorter 146 17 Invio estemporaneo documenti PDFCOMSPL 147 http www pdfcom it Pagina 3 di 150 pdfCom 7 1 Manuale utente 1 Panoramica pdfCom un prodotto che serve per la trasformazione delle stampe di tipo SCS di System i iSeries in documenti PDF nonch per la loro indicizzazione completa Tutti i PDF prodotti da pdfCom sono conformi allo standard PDF A 1b ISO 19005 1 2005 universalmente riconosciuto nonch specificamente approvato dalla legislazione italiana come formato per l archiviazione elettronica documentale sostitutiva Nella fase di trasformazione possibile Aggiungere una fincatura sfondo anche diversa per ogni pagina utilizzando altri documenti PDF come sfondo Suddividere un unico spool in pi documenti specificando i criteri di rottura Inserire immagini in base al contenuto del documento ed in posizioni variabili Utilizzare Font di tipo e stile diversi dimensioni grassetto sottolineato Scegliere il colore del testo ed evidenziarlo con colori variabili Inserire riquadri intorno al testo anche arrotondati con raggio variabile Inserire grafici di vario tipo a contenuto dinamico con il modulo opzionale Grafici Utilizzare Forms PDF moduli PDF contenenti campi
43. A del programma utente non sar possibile inserire valori che eccedono la lunghezza complessiva di 220 caratteri http www pdfcom it Pagina 120 di 150 pdfCom 7 1 14 2 Param Manuale utente etri dei grafici a Curve codice grafico 00 Quella che segue la tabella dei nomi parametri relativi ad un grafico a Curve codice del tipo di grafico 00 Nome parametro Tipo g amp nnn imgWidth NUM g amp nnn imgHeight NUM amp nnn imgDPI NUM g amp nnn gTitle ALFA g amp nnn xTitle ALFA g amp nnn yTitle ALFA g amp nnn y2Title ALFA amp amp nnn isAxisGridVisible BOOL amp amp nnn isLegendVisible BOOL amp amp nnn backgroundFill FILL g amp nnn labels ALFA x amp nnn curve pp label ALFA s amp nnn curve pp_xX NUM x amp nnn curve pp y NUM x amp amp nnn curve pp lineColor COLOR amp amp nnn curve pp pointFill FILL amp amp nnn curve pp onY2Axis BOOL LEGENDA DEI T NUM ALFA BOOL FILL ALFA x NUM x COLOR ENUM IPI Valore numerico come eventuale separatore decimale utilizzare il punto Stringa alfanumerica Booleano SI NO S o Colore di riempimento Pu essere un colore singolo analogo al tipo COLOR oppure una lista di 3 valori i primi due rappresentano i colori di partenza ed arrivo analoghi al tipo COLOR il terzo l angolazione della sfumatura relativa alla transizione tra i due colori di partenza ed arrivo espressa in gradi da 0
44. Adatta ad area Risoluzione Fronte Retro Fincato relativo alla pagina ppp PaginaFincato Scala Rotazione Offset X 1 72 relativo alla pagina ppp Offset Y 1 72 relativo alla pagina ppp LPI relativo alla pagina ppp 4 Dimensioni Font relative alla pagina ppp Tipo Font relativo alla pagina ppp Immagine Font Dimensione U underline sottolineato ColoreFont ColoreEvidenziato ColoreBordo RaggioArrotondamento PercentualeCrescita H hide nascosto OffsetX OffsetY ValoreBarcode TipoBarcode TipoGrafico IdGrafico ValoreParametro Fincato IdForm ValoreField 1 Il parametro Tipo di output non si trova esplicitamente sulla gestione dei Tipo Modulo poich viene valorizzato automaticamente in base al fatto che si tratti di un tipo modulo PDF o TXT ed in base al fatto che il PDF debba essere rasterizzato in TIFF oppure protetto SECURED E possibile specificare i seguenti valori blank PDF E PDF protetto SECURED T TXT I TIFF PDF rasterizzato 2 Il parametro Tipo Font deve essere specificato diversamente da come avviene sulla gestione dei Tipi Modulo direttamente con il nome effettivo del file del font presente nella cartella SystemRoot Fonts del PC server 3 Questi parametri non sono ereditati dalle impostazioni del tipo modulo ma vengono valorizzati in automatico da pdfCom Il parametro User riportato come Autore
45. Copia 4 Cancella 5 Visualizza 6 Inserisci Inserimento criterio di valorizzazione Field ERE FATTURE F12 Precedente Numero sequenza Il numero di sequenza irrilevante ai fini dell elaborazione Risulta per comodo ai fini di leggibilit ed organizzazione della lista dei criteri di valorizzazione ID Form Identificativo numerico del modulo PDF a campi Questo identificativo rappresenta il set di tutti i parametri da utilizzare per la compilazione di un Modulo PDF Form Set E necessario specificare un identificativo numerico che sia gi stato definito per il tipo modulo Fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF ed al paragrafo 6 3 Parametri fincato multiplo Nome Field Specifica il nome di un campo presente sul Modulo PDF per il quale si desidera impostare la valorizzazione E da notare che uno stesso nome campo pu ripetersi pi volte all interno di un Modulo PDF in tal caso tutte le occorrenze del campo saranno riempite con il solito valore Valore Field Il valore da assegnare al campo specificato nel parametro Nome Field E da notare che parte o tutto il contenuto del campo pu essere reperito dinamicamente dal contenuto dello spool tramite l utilizzo di uno o pi PlaceHolder con il seguente formato lt ppp rr ccc l111 0 gt Dove ppp rappresenta la pagina relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione
46. DI CONFIGURAZIONE Tutti i parametri di configurazione del servizio pdfCom sono memorizzati nel Registro di Sistema di Windows e precisamente nella chiave HKEY_LOCAL MACHINE SOFTWARE Rifra pdfCom Parm APPROFONDIMENTO SUL FUNZIONAMENTO DI MASSPRI NTER MassPrinter un processo separato che viene lanciato in automatico alla partenza del servizio pdfCom ed automaticamente terminato quando il servizio viene arrestato Eventuali stampe ancora presenti in coda al momento dell arresto del servizio vengono scartate Dalla Tray Icon di pdfCom dall applicazione Configurazione pdfCom o dalla gestione servizi di Windows possibile sospendere il servizio pdfCom ovvero metterlo in PAUSA in questo modo pdfCom cesser l elaborazione di ulteriori documenti senza per arrestare MassPrinter permettendo cos la stampa di eventuali documenti ancora presenti in coda Alla ripresa del servizio pdfCom continuer la regolare elaborazione dei documenti La funzionalit di sospensione del servizio risulta particolarmente utile in caso si presenti la necessit di dover spengere o riavviare il PC server sar sufficiente sospendere il servizio ed attendere che tutti i documenti in coda siano stampati ma nel frattempo non se ne accoderanno altri A quel punto spengendo o riavviando il PC server non si causer alcun problema poich non ci saranno stampe in coda che diversamente verrebbero scartate http www pdfcom it P
47. Grafico sono disponibili solo se risulta installato il modulo opzionale Grafici fare riferimento al paragrafo 2 1 Installazione moduli opzionali Tramite le Macro Action di Grafico si ha la possibilit di inserire grafici dinamici nei PDF o TIFF generati I grafici saranno creati automaticamente da pdfCom con i dati forniti dall utente ed inseriti nei documenti come immagini In un certo senso le Macro Action di Grafico assomigliano molto alle Macro Action di Immagine con l importante differenza che l immagine ovvero il grafico sar generata dinamicamente da pdfCom secondo le istruzioni e dati forniti dall utente Ogni Macro Action di Grafico composta dai seguenti parametri SUS Eaj Modifica Tipo Modulo PDF Macro Action per tipo modulo FATTURE Modifica Macro per Grafico FATTURE 1 1 999 02 Torta _20 1 220 1 1 999 blank riga o testo 1 99 blank ricerca testo 001 050 051 100 101 150 151 200 F12 Precedente Numero sequenza Il numero di sequenza determina l ordine con il quale verranno applicate le Macro Action di Grafico Si deve tenere presente che per una stessa combinazione di pagina riga colonna pu essere applicata complessivamente tra Immagine Stile Codice a Barre e Grafico una sola Macro Action Quindi in caso di sovrapposizione avr precedenza la Macro Action con numero di sequenza minore tenendo tuttavia presente che verranno applicate per prime le Macro Action
48. IFF all interno di programmi propri con il pieno supporto del real time in questo modo possibile ad esempio creare da System i documenti PDF dinamici per il Web 1 1 Requisiti di sistema Requisiti parte System i i5 O0S 05 400 versione 5 2 o successiva Requisiti parte PC server Sistema operativo Microsoft Windows 2000 Professional o Server Windows XP 32bit Windows 2003 Server 32bit o Windows 2003 R2 Server 32bit con Microsoft NET Framework v2 http www pdfcom it Pagina 4 di 150 pdfCom 7 1 Manuale utente 2 Installazione su System i L installazione del prodotto su System i prevede il ripristino di un programma su licenza LICPGM tramite il comando RSTLICPGM Il prodotto fornito sul file di salvataggio SAVF denominato pdfcom7 bin contenuto nella cartella denominata SAVF all interno del CD di installazione oppure all interno del file ZIP scaricato dal sito Internet di pdfCom Per installare il prodotto trasferire il file denominato pdfcom7 bin su System i tramite FTP collegarsi come QSECOFR ed eseguire il comando RSTLICPGM LICPGM O0ORFPDEC DEV SAVF OPTION BASE RLS V7R1M0 SAVF libreria file lt le stringhe libreria e file sono relative al file di salvataggio pdfcom7 bin trasferito su System i 2 1 Installazione moduli opzionali I moduli opzionali Grafici Forms e Sorter vanno installati separatamente Sono forniti sui
49. Impostazione dei parametri generali Resta inteso che valorizzando i corrispondenti parametri sulla gestione dei tipi modulo o fornendoli direttamente alla API 1 il documento verr prodotto sulla base di quest ultimi poich gerarchicamente superiori a quelli impostati nei parametri generali http www pdfcom it Pagina 110 di 150 pdfCom 7 1 Manuale utente 12 4 pdfCom API 2 Servizi accessori sui file I FS e relativi stati La API 2 di pdfCom denominata PDFCOMAO2R nella libreria PDFCOM e permette l esecuzione di servizi accessori sui file IFS e relativi stati all interno di una propria procedura Tutti i servizi offerti dalla API 2 sono elencati pi avanti nel corso di questo paragrafo Per il corretto funzionamento necessario che nella lista delle librerie del lavoro che effettua la chiamata alla API 2 sia presente la libreria PDFCOM diversamente la API 2 produrr un errore in fase di elaborazione errore 96 La API 2 di pdfCom restituisce nel parametro ErrorCod un codice numerico che indica l esito dell elaborazione Questi i parametri di input output D FileIFS S 8A D Action S 2A D SErrorCod S 25 0 D Output S 2048A FileIFS INPUT 8 alfanumerico Action INPUT 2 alfanumerico ErrorCod OUTPUT 2 numerico UserData OPZIONALE OUTPUT 2048 alfanumerico FileIFS Il nome del file IFS per il quale si richiede il servizio specificato nel parametro Action Il paragrafo 9 1 Dettagli su
50. N possibile avere un report dei file che hanno avuto un qualsiasi problema di elaborazione La lista completa degli stati che possibile specificare la seguente VPD File da elaborare a priorit di default VPL File da elaborare a priorit bassa VPH File da elaborare a priorit alta VPR File da elaborare in real time VPM File da elaborare ai soli fini di invio e mail OK File elaborati correttamente KO File non elaborati con errori bloccanti SEN File in attesa di invio e mail ACT File in corso di elaborazione HLD File congelato Wnn File con specifico errore di Warning nn 2 numeri W Valore speciale tutti gli errori di Warning SET Valore speciale tutti gli stati possibili tutti i file Nella Data ora ultima stampa automatica possibile vedere quando stata effettuata l ultima volta la produzione del report a prescindere dall impostazione del parametro Report anche vuoto La stampa automatica del report fa parte delle funzioni di manutenzione e viene eseguita tramite la schedulazione del programma PDFCOM91R http www pdfcom it Pagina 103 di 150 pdfCom 7 1 Manuale utente 12 pdfCom Application Programming Interface API La filosofia di funzionamento di pdfCom descritta finora basata sulle code di stampa sufficiente indirizzare una stampa di tipo SCS del System i su una coda di stampa relativa ad un istanza di pdfCom ed automaticamente parte tutto il processo automatico di crea
51. N rottura dello spool Se si desidera che la rottura venga effettuata come previsto deve essere lasciato vuoto blank Se viene impostato a N non verr effettuata la rottura e le pagine seguenti verranno accorpate al precedente documento fino al verificarsi nuovamente di una condizione di rottura E da notare che in questo caso il programma utente verr nuovamente chiamato al verificarsi della successiva condizione di rottura e ricever come stringa di testo quella relativa alla nuova rottura Ulteriormente il campo USERDATA non verr pulito permettendo quindi al programma utente di inserire altri parametri in modo incrementale anche in base alla nuova stringa di testo ricevuta 2 Fare riferimento al prossimo paragrafo 7 2 per una spiegazione sulla sintassi dei parametri in questo campo 7 2 Sintassi di specifica diretta dei parametri di elaborazione La sintassi per specificare direttamente i parametri di elaborazione la seguente Parametro Valore amp amp ppp Fincato PaginaFincato Scala Rotazione amp amp pppParametro Valore amp amp I ppp rr ccc www hhh Immagine amp amp S ppp rr ccc lll Font Dimensione U ColoreFont ColoreEvidenziato ColoreBordo RaggioArrotondamento PercentualeCrescita H O0ffsetX OffsetY amp amp B ppp rr ccc www hhh ValoreBarcode TipoBarcode amp amp G ppp rr ccc TipoGrafico IdGrafico amp amp Gnnn NomeParametro ValoreParametro amp amp C Fincato IdForm amp
52. PlaceHolder deve essere omesso nello spool ovvero sostituito con spazi vuoti I valori di pagina e o riga e o colonna all interno del PlaceHolder possono essere lasciati a zero ed in tal caso assumeranno dinamicamente il valore di pagina riga o colonna per i quali la Macro Action viene applicata I valori di pagina e o riga possono essere preceduti dalle lettere P o M che significano rispettivamente o di ppp pagine e o rr righe rispetto al valore di pagina o riga per i quali la Macro Action viene applicata Detto in altre parole poich la Macro Action pu a sua volta essere dinamica ovvero venir applicata in presenza di un determinato testo ad una determinata colonna a prescindere dalla pagina o genericamente per tutte le righe di una pagina anche il PlaceHolder pu essere astratto e quindi legato a pagina riga colonna per le quali la Macro Action si applicher Un dettagliato esempio di utilizzo riportato pi avanti in questo paragrafo E possibile utilizzare nomi UNC ed altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path I formati di immagine supportati sono i seguenti BMP Bitmap Windows EPS Encapsulated PostScript GIF Graphic Interchange Format JPG Joint Photographic Experts Group PNG Portable Network Graphics TIF Tagged Image File Format WMF Windows Metafile
53. QQ QQ QQ QQ a QQ O O O QQ O QQ O O QQ O QQ O O QQ QUI O GQQO O MMMM MMMM MMMM MMMH w jia J QOutType OutName Fincato NumCol NumRig LPI OffsetX OffsetY CharSize Font FOrizzo NumCopie OutFolder ArcFolder MailFrom MailFromN MailTo MailCC Mai1BCC MailBody0 MailBody 1 MailBody2 MailBody3 MailBody4 MailBody5 MailBody6 Body 7 MailBody8 MailBody9 MailTo 1 MailTo 2 MailTo 3 MailTo 4 MailTo 5 MailTo 6 MailTo 7 MailTo 8 MailTo 9 DOP Dpp p PrinterName MailReplyTo MailReplyToN MailPrioril MailReceipt MailSubject MailFormat CY MailUnattach ttach4 ttach4 ttach4 ttach4 ttach4 ttach4 Tipo di output TXT PDF Secured PDF o TIFF Nome del documento Fincato Numero colonne Numero righe LPI Offset X 1 72 Offset Y 1 72 Dimensioni Font Tipo Font Pagina orizzontale Override n copie Nome stampante PC su cui stampare Cartella output documenti Cartella archiviazione copia Mittente Nome mittente Destinatario Copia conoscenza Copia conoscenza nascosta N A N A N A N A Oggetto Formato e mail Corpo e mail riga 1 Corpo e mail riga 2 Corpo e mail Corpo e mail Corpo e mail riga 5 Corpo e mail riga 6 Corpo e mail riga 7 Corpo e mail riga 8 riga 3 riga 4 Corpo e mail riga 9 Corpo e mail riga 10
54. R ed effettuare il seguente comando ADDLICKEY PRDID ORFPDFC LICTRM V7 FEATURE 5004 SERIAL LOCAL PRCGRP ANY LICKEY XXXXXX XXXXXX XXXXXX USGLMT 1 EXPDATE NONE VNDDTA RIFRASRL la stringa xxxxxx xxxxxx xxxxxx dovr essere sostituita con quella fornita nel Certificato di Autenticit rilasciato da Rifra S r l relativo al Modulo FORMS Per inserire la chiave di licenza relativa al modulo opzionale Sorter collegarsi come QSECOFR ed effettuare il seguente comando ADDLICKEY PRDID ORFPDFC LICTRM V7 FEATURE 5005 SERIAL LOCAL PRCGRP ANY LICKEY XXXXXX XXXXXX XXXXXX USGLMT 1 EXPDATE NONE VNDDTA RIFRASRL la stringa xxxxxx xxxxxx xxxxxx dovr essere sostituita con quella fornita nel Certificato di Autenticit rilasciato da Rifra S r l relativo al Modulo SORTER http www pdfcom it Pagina 14 di 150 pdfCom 7 1 Manuale utente 4 Installazione su PC server Come accennato nel paragrafo 3 1 Impostazione istanze di pdfCom ogni istanza di pdfCom necessita di almeno un PC server che la gestisca Per ogni istanza possibile adibire un numero teoricamente illimitato di PC server ma in pratica anche per carichi di lavoro estremi impiegare pi di 3 o 4 server non porta a sensibili aumenti prestazionali In aggiunta alle prestazioni impiegare pi PC server per un istanza porta anche sicuri benefici in termini
55. R ed inserirlo nel campo USERDATA Allo scopo sufficiente impostare i parametri di elaborazione documenti del tipo modulo MAIL2ME come segue MAIL2ME RIGA siii 1 99 Colonna iii 1 220 Lunghezza 1 221 Colonna Omissione S Numero pagina 1 999 Rottura 4pressai S Blank Segue Prec S P Programma utente Libreria Nome LIBL Nome In pratica richiameremo il programma utente PPFCOM PDFU_MAIL passandogli il contenuto del carattere a pagina 1 riga 1 colonna 1 che questo programma utente ignorer ma sempre obbligatorio specificare una stringa da passare Il programma utente andr a leggere dall indirizzario di sistema DIR l indirizzo di e mail associato al proprietario del file di spool e lo aggiunger al campo USERDATA mettendo pdfCom in grado di inviare correttamente la mail con il PDF allegato http www pdfcom it Pagina 63 di 150 6 10 Parametri di configurazione programmi EXIT Ai fini di poter adattare completamente il prodotto alle proprie esigenze esiste la possibilit di implementare programmi EXIT su System i I programmi EXIT sono programmi realizzati dall utente e come unico vincolo devono avere una firma lista parametri INPUT OUTPUT prestabilita Esistono due tipologie distinte di programmi EXIT denominate B Before ed A After Fare riferimento al capitolo 8 Gestione avanzata tramite programmi EXIT per tutte le info
56. RIFRA YV pdfCom 7 1 Manuale utente Data ultima revisione 13 02 2013 12 11 Copyright 2006 2012 Rifra S r l pdfCom 7 1 Indice Manuale utente 1 Panoramica ___ 22 L L22 LL L L LL L L LL LL LL LLL LLL LLL LLL LLL 4 1 1 Requisiti di sistema 4 2 Installazione su System i 222222222222 ____________ 5 2 1 Installazione moduli opzionali 5 2 2 Menu principale di pdfCom 6 3 Configurazione del prodotto lato System i____________ 7 3 1 Impostazione istanze di pdfCom 7 3 2 Impostazione dei parametri generali 10 3 3 Avvio del sottosistema PDFCOM 12 3 4 Inserimento della chiave di licenza prodotto modulo base 13 3 5 Inserimento delle chiavi di licenza prodotto moduli opzionali 14 4 Installazione su PC server 0 amp _ 15 4 1 Parametri opzionali del programma di installazione 16 5 Configurazione del prodotto lato PC server _____________________ 17 5 1 Configurazione del servizio pdfCom 17 5 2 Configurazione dei parametri di default per il servizio 19 5 3 Tray Icon di pdfCom 24 6 Gestione dei Tipi Modulo __ __ v u __________ 26 6 1 Parametri generali di creazione dei PDF 27 6 2 Parametri di invio e mail 35 6 3 Parametri fincato multiplo 40 6 4 Parametri Macro Action 44 6 5 Macro Action di Immagine 45 6 6 Macro Action di Stile 49 6 7 Macro Action di Codice a Barre 54 6 8 Macro Action di Grafico modulo opzionale
57. Subject Invio mail ailFormat T ailBody0 Vi rimettiamo la fattura in oggetto ailBodyl pregandoVi di contattarci per qualsiasi ailBody2 problema ailBody3 ailBody4 Cordiali saluti ailBody5 Rifra S r l ailBody6 ailBody7 ailBody8 ailBody9 ail ail ail ail ail ail ail ail ailTo 9 ailUnattach ailAttach t1 ailAttach 2 ailAttach 3 ailAttach t4 TRE z g Z S a a n aa a a a a a a a 00000000 HW HH O S OO HI lt S ZZZ MailAttach t5 MailAttach t6 MailAttach t7 MailAttach t8 http www pdfcom it Pagina 87 di 150 pdfCom 7 1 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 1000 1001 1002 1003 1004 10000 10001 10002 10003 10004 10005 10006 90000 90001 90002 90003 90004 90005 90006 90007 90008 90009 90010 SOGI 90012 90013 90014 90015 90016 90017 95000 95001 95002 95003 95004 101000 MailAttach 9 User SPI Subject RFFATO1P Manuale utente Keywords FATTURA QPADEV0001 034521 0023 000001 EncrPwd EncrDisablePrt EncrOpenPwd TI ffCOmpress TiffResolution TIiffDithering PrtSync PrtScale S PrtFit S PrtResolution 4 PrtDuplex N MULTI amp amp 001 d fincati fincatol pdf amp a
58. XXXXXXX dove xxxxxxx un progressivo assoluto rappresentato in esadecimale visibile dalla Gestione parametri generali tramite l opzione 6 8 1 del menu principale di pdfCom comune a tutte le istanze in esecuzione a tutte le priorit Ogni file sar contenuto in una sottocartella della cartella abbinata all istanza con un nome che rispetta la seguente struttura Syyyy000 dove yyyy rappresenta i primi 4 caratteri del progressivo documento XXXXXXX http www pdfcom it Pagina 93 di 150 pdfCom 7 1 Manuale utente Ogni file creato avr uno stato iniziale che rispetta la seguente regola VPL file a bassa priorit attributo OUTPTY gt 5 VPD file a priorit di default attributo OUTPTY 5 VPH file ad alta priorit attributo OUTPTY lt 5 VPR file in real time elaborazione tramite API Lo stato VPL VPD VPH VPR indica che il file da elaborare ovvero non stato ancora preso in carico dal PC server che monitorizza quella certa istanza Lo stato VPM assegnabile solo manualmente tramite Pannello di Controllo o forzato da un programma EXIT di tipo B indica che il file da elaborare esclusivamente ai fini dell invio tramite mail i file in questo stato hanno una priorit inferiore ai file in VPH ma superiore ai file in VPD In tutti i casi l elaborazione da parte del PC server determina il cambio di stato che potr assumere i valori OK l elaborazione non ha prodotto errori Wnn l elaborazione ha
59. Z 0 0 20 blank da spool blank automatico RANDnn random blank nessuno blank predefinita blank predefinita TEMP temporanea blank predefinita F12 Pr F13 Mail F14 Finc m F15 Macro F16 El doc F17 Exit F23 Avanz Tipo modulo Il nome del tipo modulo del file di spool Tale parametro ovviamente obbligatorio E possibile specificare il valore speciale STD in modo da gestire anche i file di spool dove non specificato alcun tipo modulo E altres possibile specificare il valore speciale DEFAULT evidenziato in rosa fucsia nella lista in modo da gestire anche tutti i file di spool con un tipo modulo non presente in tabella Numero colonne Il numero di colonne del file di spool Se non specificato tale parametro viene rilevato automaticamente dallo spool stesso E da notare che specificare un numero di colonne diverso da quello reale del file pu essere utile a far s che il PDF venga formattato correttamente Nello specifico pdfCom in grado di centrare il testo sul PDF prodotto nonch determinare automaticamente la dimensione del Font proprio in base al numero di colonne dello spool Pu capitare che uno spool con numero di colonne pari a 132 contenga caratteri solo fino ad una certa colonna diciamo ad esempio fino a colonna 80 Se non si fornisce questa informazione pdfCom centrer il testo sul PDF scegliendo anche la dimensione del Font in modo tale che ci sia effettivament
60. a 360 Lista di x stringhe alfanumeriche separate da virgola Lista di x valori numerici separati da virgola come eventuale separatore decimale utilizzare il punto Colore singolo formato RRRGGGBBB fare riferimento al riquadro FORMATO SPECIFICA COLORE alla fine del paragrafo 6 6 Macro Action di Stile Numero intero positivo compreso lo 0 che rappresenta un tipo nnn rappresenta l ID numerico del grafico pp un progressivo da 01 a 99 relativo alle varie curve linee spezzate da inserire nel grafico Segue la spiegazione del significato di ogni parametro imgWidth Larghezza del g imgHeight Altezza del graf imgDPI rafico espressa in 72esimi di pollice 1 72 0 3528 mm ico espressa in 72esimi di pollice 1 72 0 3528 mm Risoluzione in DPI punti per pollice del grafico E importante precisare che la risoluzione non influir in alcun modo sulle dimensioni del grafico all interno del PDF determinate dai parametri imgWidth e imgHeight bens sulla sua qualit Pi alta sar la qualit maggiori http www pdfcom it Pagina 121 di 150 pdfCom 7 1 Manuale utente saranno le dimensioni in byte del file PDF che conterr il grafico Se si desidera utilizzare il PDF per stampe di alta qualit consigliabile utilizzare una risoluzione di almeno 300 DPI gTitle Titolo del grafico Questo titolo apparir centrato nella parte superiore del grafico xTitle Titolo dell a
61. a al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti alla quale viene applicata la Macro Action Se non viene specificato ci sono due possibilit gt Si specifica il valore Testo e la Macro Action diventa condizionale Il numero di pagina sar quello o tutti quelli nel quale la condizione di presenza del testo si verifica gt Si specifica il valore Riga e la Macro Action verr applicata sulla riga specificata di tutte le pagine Riga Indica il numero di riga dello spool alla quale viene applicata la Macro Action Se non viene specificato il valore Testo diventa obbligatorio e di conseguenza la Macro Action diventa condizionale il numero di riga sar quello o tutti quelli nel quale la condizione di presenza del testo si verifica Testo La stringa di testo da ricercare nelle righe dello spool partendo dal valore di Colonna specificato ed eventualmente ristretto al Numero Pagina specificato La presenza di tale testo determina o meno l applicazione della Macro Action E importante sottolineare che per una Macro Action di Codice a Barre tale stringa di testo sar sempre omessa ovvero sostituita con degli spazi vuoti Questo perch la stringa di testo verrebbe inevitabilmente sovrascritta dall immagine del codice a barre http www pdfcom it Pagina 56 di 150 6 8 Macro Action di Grafico modulo opzionale Grafici Le Macro Action di
62. a il tipo carattere da utilizzare e deve essere specificato esattamente come avviene sulla gestione del Tipo Modulo ovvero con il nome descrittivo compreso di eventuali spazi e maiuscole minuscole Se non viene specificato sar utilizzato il carattere di default fare riferimento al paragrafo 6 6 per ulteriori spiegazioni Dimensione la dimensione del Font da utilizzare Se non viene specificata utilizzata la dimensione di default fare riferimento al paragrafo 6 6 per ulteriori spiegazioni Il carattere U specifica che deve essere effettuata una sottolineatura Se non si desidera specificare i valori avanzati evidenziati in grigio i 3 valori sopraelencati sono tutti opzionali sebbene almeno uno di essi sia comunque obbligatorio altrimenti il parametro di stile non avrebbe alcun senso Se invece si desidera specificare anche uno solo dei valori avanzati allora tutti gli 11 valori complessivi diventano obbligatori ovvero diventa obbligatoria almeno la sola virgola che li separa Ad esempio per creare un parametro di stile che imposti unicamente il colore del testo a rosso ColoreFont il quarto parametro necessario specificare una stringa come segue bkes ppprree 006 L0Us SUONO pre I valori avanzati che possibile specificare sono i seguenti ColoreFont rappresenta il colore del testo Il formato di specifica quello previsto per il corrispondente parametro descritto nel paragrafo 6 6 Macro Action di Sti
63. a nomi parametri del paragrafo 7 2 sono relativi ai Forms Moduli PDF A prescindere dall aver associato un ID numerico di Form ad un fincato tramite la gestione dei Tipi Modulo fare riferimento ai paragrafi 6 1 e 6 3 possibile effettuare questa associazione direttamente specificando uno o pi parametri di form separati Waa terminati sempre con il carattere punto e virgola con la seguente struttura amp amp C Fincato IdForm dove Fincato rappresenta il nome del fincato completo di percorso prescindendo dalle maiuscole minuscole al quale si desidera associare il Form Set IdForm rappresenta l identificativo numerico del set di tutti i parametri da utilizzare per la compilazione del form Form Set Nel capitolo 15 viene esaustivamente trattato l argomento di come fornire a pdfCom i set di dati relativi ai form 7 9 Esempio di utilizzo dei campi USRDFNDTA e USERDATA Di seguito riportato un esempio di stringa che pu essere specificata nel campo USRDFNDTA del file di spool e o nel parametro USERDATA del programma utente OutName Fattura n 6 del 12 2 06 pdf MailTo amministr rifranet it MailBody2 la fattura n 6 del 12 2 06 Fincato d finc fatt_rifra pdf amp amp 001 d finc fatt_ natale_rifra pdf amp amp 0010ffsetY 25 amp amp I 001 56 10 d finc albero_natale jpg Il nome del documento viene impostato a Fattura n 6 del 12 2 06 pdf viene inviata una mail all indirizzo amministr rifranet it
64. a qui possibile inserire i meta tag per i quali sar possibile indicizzare i documenti I meta tag rappresentano i campi di un insieme di metadati in pratica descrivono l informazione che un metadato rappresenta pdfCom 7 1 Manuale utente Detto in altre parole un numero di fattura preso in senso assoluto ed archiviato rappresenterebbe semplicemente un numero allo stesso modo di un numero di pratica L informazione che quel numero proprio un numero di fattura piuttosto che un numero di pratica quello che rende il dato utilizzabile ed esattamente questo lo scopo di un meta tag descrivere il significato dei metadati che ne fanno riferimento I meta tag possono essere di 5 tipi diversi i tipi sono identificati dalla colonna T tipo e sono i seguenti Numerico Alfanumerico Data Ora Timestamp data ora HOOPZ x Tramite l opzione 4 possibile eliminare un meta tag inserito in tabella L eliminazione pu avvenire solo a condizione che non siano presenti metadati nell indice che fanno riferimento al meta tag che si desidera eliminare Occorre precisare che uno stesso documento pu anche essere indicizzato pi volte per il solito meta tag ma solo a condizione che il valore del metadato sia diverso http www pdfcom it Pagina 114 di 150 13 2 Configurazione indicizzazione per Tipo Modulo L indicizzazione di un documento avviene durante la sua fase di elaborazione su System i Analogamente a q
65. a utilizzare per il testo E da notare che possibile specificare unicamente Font del tipo MonoSpaced ovvero in cui tutte le lettere occupano la stessa larghezza Se non specificato viene utilizzato il Font standard specificato nella Gestione parametri generali fare riferimento al paragrafo 3 2 Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un Tipo Font tra quelli disponibili Pagina orizzontale Se la pagina deve essere creata in orizzontale Specificando S la pagina verr creata forzatamente in orizzontale Specificando A la pagina sar creata in orizzontale se contenente un numero di colonne maggiore di 132 diversamente sar creata in verticale Se non specificato la pagina sar creata in verticale Override n copie E possibile specificare il numero di copie da stampare del documento PDF prodotto in sostituzione del numero di copie specificato nel file di spool Specificando 0 zero non verr effettuata alcuna stampa automatica Come si vedr nei paragrafi 6 11 e 6 12 Gestione override parametri questo parametro potr essere impostato anche per utente o coda di stampa quest ultima solo se risulta installato il modulo opzionale Sorter Nome del documento Il nome completo di estensione del file PDF TXT o TIFF che verr prodotto E da notare che parte o tutto il contenuto del campo pu essere reperito
66. abile di path Questo parametro obbligatorio rappresenta la variabile vera e propria che sar utilizzabile nella forma NomevVariabile in sostituzione di tutto o parte del percorso di un file se di tipo F oppure di tutto o parte del nome di una stampante se di tipo P E importante specificare che sebbene il nome variabile possa essere immesso solo con lettere maiuscole l utilizzo della variabile tramite la stringa NomevVariabile non sar sensibile all utilizzo di lettere maiuscole minuscole Istanza Specifica per quale istanza la variabile assumer il valore specificato nel parametro Path E possibile lasciare vuoto questo parametro in modo da specificare una variabile indipendente dall istanza di elaborazione Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un istanza tra quelle configurate Path La stringa di percorso file o nome stampante che sar sostituita a tempo di esecuzione alla stringa NomevVariabile dove questa viene utilizzata pdfCom 7 1 Manuale utente 7 Gestione dei parametri sul singolo spool Come introdotto nel precedente paragrafo 6 9 Parametri di elaborazione documenti pdfCom permette di sostituire gerarchicamente tutti i parametri e regole specificati nella gestione dei tipi modulo E infatti possibile specificare direttamente nel campo Dati definiti dall utente attributo USRDFNDTA de
67. afico pp un progressivo da 01 a 99 relativo alle varie fette di torta da inserire nel grafico Le dimensioni delle fette saranno proporzionali al loro valore ed occuperanno l intera superficie della torta Segue la spiegazione del significato di ogni parametro imgWidth Larghezza del grafico espressa in 72esimi di pollice 1 72 0 3528 mm imgHeight Altezza del grafico espressa in 72esimi di pollice 1 72 0 3528 mm imgDPI Risoluzione in DPI punti per pollice del grafico E importante precisare che la risoluzione non influir in alcun modo sulle dimensioni del grafico all interno del PDF determinate dai parametri imgWidth e imgHeight bens sulla sua qualit Pi alta sar la qualit maggiori saranno le dimensioni in byte del file PDF che conterr il grafico Se si desidera utilizzare il PDF per stampe di alta qualit consigliabile utilizzare una risoluzione di almeno 300 DPI gTitle Titolo del grafico Questo titolo apparir centrato nella parte superiore del grafico http www pdfcom it Pagina 129 di 150 pdfCom 7 1 Manuale utente isLegendVisible Indica se deve essere visibile o meno la legenda delle curve presenti nel grafico La legenda apparir a sinistra nella parte superiore del grafico sotto il titolo backgroundFill Riempimento dello sfondo pieLabelType Tipo dell etichetta da visualizzare in corrispondenza delle fette I tipi possibili sono i seguenti Nome Valore
68. agina 23 di 150 pdfCom 7 1 5 3 Traylcon di pdfCom Manuale utente L installazione sul PC server attiva opzionalmente una Tray Icon nella barra delle icone di Windows con il logo di pdfCom La Tray Icon di pdfCom fornisce una rapida indicazione sullo stato del servizio Cestino Cestino Cestino Cestino Cestino Il servizio di pdfCom in stato Avviato ovvero attivo Il servizio di pdfCom in uno stato di transizione come ad esempio durante il passaggio tra lo stato Avviato e lo stato Arrestato Normalmente questo stato temporaneo e dura al massimo qualche decina di secondi Il servizio di pdfCom in stato Arrestato ovvero non attivo Tutti i processi sono fermi e non viene effettuata nessuna elaborazione Il servizio di pdfCom in stato Sospeso ovvero in pausa In questo stato non vengono elaborati ulteriori documenti ma viene comunque ultimato l invio di eventuali mail in coda nonch la stampa di eventuali documenti in coda Il servizio di pdfCom non risulta correttamente installato Procedere nuovamente all installazione seguendo le istruzioni nel capitolo 4 Installazione su PC server http www pdfcom it Pagina 24 di 150 pdfCom 7 1 Manuale utente Ulteriormente disponibile un menu contestuale accessibile premendo il tasto destro del mouse sulla Tray Icon che offre le seguenti opzioni Configuratore Riprendi servizio Arres
69. ale programma non richiede nessun parametro A puro titolo di esempio riportiamo il comando ADDJOBSCDE Aggiunta voce pianificazione lavoro per inserire una schedulazione automatica delle funzioni di manutenzione di pdfCom alle ore 21 30 di tutti i giorni della settimana dal Luned al Venerd ADDJOBSCDE JOB SCH_PDFCOM CMD CALL PGM PDFCOM PDFCOM91R FRO WEEKLY SCDDATE NONE SCDDAY MON TUE WED THU FRI SCDTIME 21 30 00 JOBD PDFCOM PDFCOMSBM All esecuzione della schedulazione verranno eseguite tutte le funzioni di manutenzione configurate e che risultano attive I MPORTANTE Se come Root IFS di pdfCom vedi paragrafo 3 2 Impostazione dei parametri generali viene specificata la cartella QDLS necessario che l utente con cui viene eseguita la schedulazione delle funzioni di manutenzione sia iscritto nell indirizzario di sistema L utente QPGMR la cui iscrizione nell indirizzario diventa un requisito fondamentale per il corretto funzionamento di pdfCom pu quindi essere utilizzato per la schedulazione Facoltativamente possibile utilizzare la descrizione lavoro denominata PDFCOMSBM nella libreria PDFCOM che imposta la corretta lista delle librerie per il lavoro http www pdfcom it Pagina 99 di 150 11 1 Funzioni di pulizia automatica pdfCom offre una comoda funzione di pulizia automatica dei file su IFS per le varie istanze configurate Come accennato nel paragraf
70. alore nel campo relativo al filtro per istanza Override n copie Specifica il numero di copie da stampare del documento PDF prodotto Specificando 0 zero non verr effettuata alcuna stampa automatica Se lasciato vuoto il parametro risulter non impostato e verr utilizzato il numero copie specificato nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF Cartella output documenti Il percorso completo della cartella nella quale verranno salvati i documenti prodotti Il percorso specificato deve essere funzionale al PC server che lo utilizzer ed possibile specificare percorsi locali dal punto di vista del PC server o percorsi di rete con nomi UNC purch raggiungibili dal PC server E altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Specificando il valore speciale TEMP il documento prodotto non sar di fatto salvato in nessuna cartella questa impostazione risulta particolarmente utile in caso si desideri generare un documento ai soli fini dell invio tramite e mail oppure ai soli fini della stampa Se non viene specificato alcun percorso il parametro risulter non impostato e verr utilizzata la cartella di output specificata nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF Carte
71. altri processi paralleli E altres vero che se tutti i documenti prodotti necessitano sistematicamente di essere stampati http www pdfcom it Pagina 32 di 150 pdfCom 7 1 Manuale utente tutti i processi protrebbero ritrovarsi occupati dalla stampa e quindi la produzione dei documenti essere pi lenta Specificando N la stampa viene effettuata in modalit asincrona La stampa asincrona si avvale di un processo parallelo separato se il PDF prodotto prevede anche la sua stampa questa viene posta in una coda di elaborazione interna permettendo a pdfCom di continuare con l elaborazione dei successivi documenti Il processo parallelo denominato MasspPrinter si occuper di effettuare tutte le stampe in coda in modalit sequenziale Questo approccio diversamente dal precedente non penalizza mai la produzione dei documenti anche senza l utilizzo del MultiThreading Ovviamente saranno penalizzate le eventuali stampe dato che dovranno attendere il loro turno di elaborazione sequenziale Se non viene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Lo stesso paragrafo 5 2 fornice dettagli di approfondimento sul funzionamento del processo MassPrinter Scala Centra Se deve essere effettuata una scalatura e centratura del documento da stampare Specificando S verr effettuata una scalatura con mantenimento delle proporzioni e centratu
72. amite l opzione 6 8 1 del menu principale di pdfCom si accede alla gestione dei parametri generali User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r 1 Gestione parametri generali 1 65535 fhome pdfCom no replu eri franet it Rifra S r l Courier New LIBZPGM PDFCOM F4 PDFCOM F4 220 1 220 26 1 16 Progr documenti 100668698 F03 Fine FOS Rivisual F13 Licenze F22 Sorter Porta TCP Il numero di porta TCP da utilizzare per la connessione tra System i e PC server Se non in presenza di esigenze specifiche si consiglia di lasciare impostato il valore di default porta 4000 Root IFS Il percorso completo della cartella radice dell IFS che dovr contenere tutte le sottocartelle relative alle varie istanze di pdfCom La cartella radice deve esistere mentre le sottocartelle relative ad ogni istanza saranno create automaticamente da pdfCom Il percorso specificato deve iniziare e terminare con il carattere E importante sottolineare che se viene specificata la cartella QDLS come radice sar necessario che tutti gli utenti che faranno accesso al Pannello di Controllo nonch l utente QPGMR profilo con il quale vengono eseguiti i lavori delle istanze ad avvio automatico siano inseriti nell indirizzario di sistema DIR Mittente e mail Indirizzo e mail che sar indicato come mittente per eventuali mail spedite da pdfCom in caso non venga specificato un diverso
73. anno considerati solo a sinistra della stringa Premendo il tasto di funzione F23 Override si accede alle opzioni di override EIUS Rm trani iena dara den Modifica Tipo Modulo PPFRRR AR AREGGPP SS SGAGSASSS NE E POCA ti multipli per tipo nodulo 1_ E Modifica Regola Fincato FATTURE 0020 Modifica Regola Fincato 1 360 blank centra 1 360 blank 20 1 16 blank da spool 4 72 FATTURE b std 4 001 050 051 100 101 150 151 200 F12 Precedente F23 0verride MA 09 007 Da qui possibile specificare l override ovvero la sostituzione per quei parametri che devono assumere un nuovo valore in funzione della fincatura specifica per la pagina Questa possibilit pu risultare particolarmente utile perch cambiando il fincato su una determinata pagina possibile che alcuni parametri impostati sulla Gestione dei Tipi Modulo non siano pi validi Valgono le stesse regole previste per i rispettivi parametri presenti sulla Gestione dei Tipi Modulo Affinch sia possibile specificare il valore per un certo parametro necessario impostare ad S il parametro O Override ad esso relativo I MPORTANTE Come si vedr nel paragrafo 6 9 Gestione parametri di elaborazione documenti e nel capitolo 7 Gestione dei parametri sul singolo spool sar possibile forzare su una determinata pagina un determinato fincato pi eventuali altri parametri di override a prescindere dal verificarsi o meno
74. aragrafo 9 2 Come pdfCom gestisce l invio delle e mail Premendo il tasto Test possibile effettuare l invio di una mail di prova per verificare che tutti i parametri inseriti siano corretti Parametri rasterizzazione TI FF Specificare i parametri relativi all eventuale rasterizzazione in formato TIFF di un PDF prodotto pdfCom offre la possibilit di avere in output il ducumento in formato TIFF multipagina b n ovvero il PDF rasterizzato come immagine fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF E possibile specificare una risoluzione compresa tra 50 e 1200 DPI se effettuare o meno il dithering di eventuali immagini presenti ed infine scegliere la compressione desiderata Controllo servizio pdfCom opera in background sul PC server come Servizio di Windows Analogamente a tutti i servizi pu assumere vari stati Avviato Arrestato etc e pu essere avviato arrestato o sospeso messo in pausa dall utente Da qui possibile effettuare tutte queste operazioni Nel paragrafo 5 1 Configurazione servizio di pdfCom abbiamo visto come impostare il servizio per fare in modo che si avvii automaticamente alla partenza del PC server ma pu risultare pi comodo una volta completata la configurazione e premuto il tasto Applica avviarlo direttamente da qui premendo il tasto di avvio Analogamente per tutte le future operazioni di avvio arresto sospensione possibile utilizzare questa
75. ario del file di spool ovvero l utente che ha prodotto la stampa Tipo modulo Specifica per quale tipo modulo solo per l utente impostato nel parametro Utente si desidera specificare i parametri E possibile lasciare vuoto questo parametro in modo da comprendere tutte le stampe di un utente con un tipo modulo che non sia gi stato specificato Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un Tipo Modulo tra quelli presenti in tabella Nome stampante PC E il nome della stampante su cui effettuare la stampa Il nome deve essere specificato allo stesso modo di come appare nella gestione Stampanti e fax sul PC server Se lasciato vuoto verr utilizzata la Stampante di default configurata al paragrafo 5 2 Configurazione dei parametri di default per il servizio Specificando il valore speciale SAME il parametro risulter non impostato e verr utilizzata la stampante specificata nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF E possibile utilizzare in sostituzione di tutto o parte del nome una viariabile di path di tipo P fare riferimento al paragrafo 6 13 Gestione variabili di Path Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere una stampante tra tutte quelle effettivamente visibili dal PC
76. ato RRRGGGBBB Dove RRR GGG e BBB sono numeri da zero a 255 relativi rispettivamente ai tre colori primari rosso verde e blu nella sintesi additiva Specificando tutti i valori a zero 000000000 si otterr il colore nero Specificando tutti i valori a 255 255255255 si otterr il colore bianco Per comodit riportiamo di seguito i valori relativi ai colori pi comuni Rosso Rosso scuro Fucsia Rosa Marrone Arancione Oro Giallo Verde Verde scuro Verde chiaro Turchese Turchese chiaro Azzurro Blu Blu scuro Blu chiaro Celeste Indaco Viola Prugna Lilla Grigio 80 Grigio 50 Grigio 40 Grigio 25 255000000 128000000 255000255 255153204 153051000 255102000 255204000 255255000 000255000 000128000 204255204 000255255 204255255 051204204 000000255 000000128 051102255 153204255 051051153 128000128 153051102 204153255 051051051 128128128 15353159 TOPNO 24192 http www pdfcom it Pagina 53 di 150 6 7 Macro Action di Codice a Barre Tramite le Macro Action di Codice a Barre si ha la possibilit di inserire codici a barre nei PDF o TIFF generati Un codice a barre normalmente sar rappresentativo di un valore numerico o alfanumerico a seconda del tipo di codice a barre presente sullo spool In un certo senso le Macro Action di Codice a Barre assomigliano molto alle Macro Action di Immagine con un PlaceHolder nel path in quest ultimo caso il nome dell immagine viene reper
77. ato nei paragrafi 6 1 Parametri generali di creazione dei PDF 6 3 Parametri fincato multiplo 6 5 Macro Action di Immagine 6 11 Gestione override parametri per Utente e 6 12 Gestione override parametri per Coda per tutti i parametri dove occorre specificare il percorso di un file oppure il nome di una stampante possibile utilizzare una variabile di path Le variabili di path possono essere di due tipologie F file o P printer stampante Quelle di tipo F sono da utilizzare in sostituzione di tutto o parte del percorso di un file mentre quelle di tipo P sono da utilizzare in sostituzione di tutto o parte del nome di una stampante Quello che rende interessante l utilizzo delle variabili di path la loro dipendenza dall istanza che elaborer un documento Per specificare meglio il concetto supponiamo di avere un tipo modulo che utilizza un fincato ubicato in un certo percorso Come abbiamo visto precedentemente il percorso deve essere funzionale al servizio che gira sul PC server che lo utilizzer per trovare il file ovvero deve essere specificato cos come lo vede quel determinato PC server Se abbiamo configurato pi istanze di pdfCom file di spool che utilizzano il tipo modulo in questione potrebbero essere elaborati da istanze diverse di pdfCom e quindi da PC server diversi che magari raggiungono il file del fincato con un percorso diverso In questo caso l utilizzo di una variabile di path nel
78. bbligatoriamente in coppia Il primo indica il numero di elementi presenti nell array il secondo il puntatore all array stesso Nel paragrafo 12 3 Dettagli sull utilizzo dell array dati utente vengono forniti tutti dettagli sull utilizzo Specificando 0 zero nel numero di elementi e NULL come puntatore l array di dati utente non sar utilizzato utile in caso si renda necessario dover specificare obbligatoriamente questa coppia di parametri solo perch si desidera specificare i successivi opzionali NumRigSs OPZIONALE Questo parametro utilizzato esclusivamente in modalit Spool Less specifica il numero di righe per pagina che andranno a comporre lo spool virtuale il cui contenuto sar fornito tramite array dati utente fare riferimento al paragrafo 12 3 Dettagli sull utilizzo dell array dati utente In modalit Spool Less obbligatorio fornire direttamente alla API 1 tale informazione E importante fare una distinzione tra questo parametro ed il parametro Numero righe gi visto nella Gestione dei Tipi Modulo che ha il solo scopo di modificare la formattazione del contenuto all interno del documento Questo parametro invece determina il numero di righe per pagina e conseguentemente la suddivisione delle pagine dello spool virtuale fornito tramite l array dati utente E da notare che eventuali regole di fincato multiplo macro etc saranno applicate tenendo conto di pagina riga dello spool
79. caratteri lt e gt http www pdfcom it Pagina 36 di 150 Tramite il tasto di funzione F13 Corpo mail possibile accedere alla schermata relativa al corpo della mail 21 51 A Gestione dati e mail FATTURA amministrazione acme com Gestione dati e mail FATTURA Vi rimettiamo in allegato la fattura numero lt 001 08 034 006 N Distinti saluti ACME Ltd E i F04 Elimina F12 Precedente F13 Corpo mail F22 Alleg agg F23 Dest agg F12 Pr F13 Mail F14 Finc m F15 Macro F16 E1 doc F17 Exit F23 Avanz 08 008 E da sottolineare che pdfCom invia i documenti PDF TXT o TIFF come allegati Se stato scelto il formato testo possibile specificare fino a 10 righe per il corpo della mail come presentazione dell allegato Se stato scelto il formato HTML possibile inserire direttamente codice HTML A prescindere dal formato scelto poich 10 righe composte da 70 caratteri ciascuna potrebbero essere limitative possibile referenziare nella prima riga del corpo un file esterno completo di percorso sia esso un file di testo oppure un file HTML E da notare che il percorso deve essere funzionale al servizio che gira sul PC server che lo utilizzer per trovare il file ovvero deve essere specificato cos come lo vede quel determinato PC server possibile utilizzare nomi UNC Nelle successive 9 righe del corpo possibile specificare fino a 9 differenti variabili una per riga con il
80. d non viene specificato oppure viene specificato con il valore speciale SAME la API 1 produrr un errore in fase di elaborazione errore 93 http www pdfcom it Pagina 105 di 150 pdfCom 7 1 Manuale utente Il parametro NumSpool pu essere passato alla API 1 sia come campo binario binary che come campo con zonatura signed con una lunghezza sempre di 4 bytes In caso di campo binary possibile fornire valori fino ad un massimo di 999999 mentre nel caso di campo signed possibile fornire valori fino ad un massimo di 9999 Questo perch con il passaggio dalla V4 alla V5 del sistema operativo del System i cambiata la lunghezza del numero di file di spool passando da 4 cifre max 9999 a 6 cifre max 999999 ToFolder Indica il nome della cartella IFS relativa all istanza che gestir la produzione del documento E necessario specificare il nome di una cartella IFS relativa ad un istanza correttamente configurata fare riferimento al paragrafo 3 1 Impostazione istanze di pdfCom diversamente verr utilizzata l istanza configurata nel parametro Istanza API 1 presente nella configurazione dei parametri generali fare riferimento al paragrafo 3 2 Impostazione dei parametri generali Se neanche quest ultimo valorizzato la API 1 produrr un errore in fase di elaborazione errore 81 KeepSpool Questo parametro che pu essere valorizzato con blank oppure S indica se il file di spool deve esse
81. d un intervallo minimo di 3 minuti l uno dall altro Si parla di intervallo minimo perch in caso di errore la mail viene di nuovo posta in fondo alla coda in virt di quante e mail sono presenti l intervallo potrebbe essere anche superiore a 3 minuti Una volta esauriti tutti i tentativi di invio o se l invio va a buon fine viene assegnato l esito al documento secondo le regole descritte nel precedente paragrafo 9 1 APPROFONDIMENTO SUL FUNZIONAMENTO DI MASSMAI LER MassMailer un processo separato che viene lanciato in automatico alla partenza del servizio pdfCom ed automaticamente terminato quando il servizio viene arrestato Eventuali mail ancora presenti in coda al momento dell arresto del servizio vengono esitate come non inviate e quindi i relativi file su IFS assumeranno lo stato W04 o diverso se presenti eventuali altri errori Dalla Tray Icon di pdfCom dall applicazione Configurazione pdfCom o dalla gestione servizi di Windows possibile sospendere il servizio pdfCom ovvero metterlo in PAUSA in questo modo pdfCom cesser l elaborazione di ulteriori documenti senza per arrestare MassMailer permettendo cos l invio di eventuali e mail ancora presenti in coda Alla ripresa del servizio pdfCom continuer la regolare elaborazione dei documenti La funzionalit di sospensione del servizio risulta particolarmente utile in caso si presenti la necessit di dover spengere o riavviare il PC server sar suf
82. delle regole specificate 6 4 Parametri Macro Action pdfCom offre la possibilit di inserire dinamicamente immagini nei PDF o TIFF generati utilizzare Font di dimensioni stile e colori diversi nonch evidenziare il testo ed inserire riquadri con colori a piacimento In questo modo possibile arricchire graficamente i file di spool di System i anche in maniera dinamica rispetto al loro contenuto Solo per fare un esempio possibile evidenziare in rosso e grassetto magari con un Font diverso una certa stringa di testo nello spool a prescindere dalla sua posizione o magari inserire un immagine in una posizione variabile in base alla presenza di una determinata dicitura E possibile anche inserire codici a barre di varie tipologie che siano rappresentativi di porzioni del testo Ulteriormente se disponibile il modulo opzionale Grafici possibile inserire anche grafici di varie tipologie che rappresentino dati effettivi Con il tasto di funzione F15 Macro dalla gestione visualizzazione di un tipo modulo si accede alla Gestione Macro Action per tipo modulo a Modifica Tipo Modulo PDF Macro Action per tipo modulo FATTURE 0000 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Ins Immagine 7 Ins Stile 8 Ins Barcode 9 Ins Grafico Pa Col Dica alate Bia ei L 150 H 060 I d immagini rifra_logo gif A 1 2 1 100 F Times New Roman D 12 0X 3 50C 0Y 10 25P I d immagini Ima lt 000 M01 010 020 s gt bmp A 0 0 8 20 F Arial
83. determinabile Pwd apertura Relativamente alla crittografia dei PDF specifica un eventuale password di apertura del documento La password di apertura facoltativa Disab stampa Relativamente alla crittografia dei PDF permette di disabilitare la possibilit di stampare il documento Specificando S non sar possibile effettuare la stampa del documento prodotto ferma restando la funzionalit di stampa automatica prevista da pdfCom Descrizione La descrizione di un tipo modulo E possibile specificare una descrizione libera del tipo modulo visualizzabile sulla lista della Gestione dei Tipi Modulo tramite il tasto di funzione F11 Descr Stampa sincrona Specifica se la stampa deve essere effettuata in modalit sincrona o asincrona Specificando S stampa sincrona la stampa viene effettuata dallo stesso processo o dagli stessi processi in caso di MultiThreading che si occupa della produzione del documento il processo rimarr occupato fino a quando la stampa non sar stata completamente accodata sulla stampante e solo a quel punto potr iniziare la produzione del documento successivo Sebbene questo approccio possa sembrare poco produttivo occorre tener presente che tramite il MultiThreading possibile avere pi processi destinati alla produzione e stampa dei documenti e quindi anche se un processo impegnato ad accodare una stampa la produzione dei documenti successivi viene comunque effettuata dagli
84. dfCom 7 1 Manuale utente 4 1 Parametri opzionali del programma di installazione Per rendere possibile l automazione dell installazione di pdfCom su PC server il programma di installazione mette a disposizione i seguenti parametri opzionali specificabili tramite riga di comando SILENT VERYSILENT SUPPRESSMSGBOX CI Cp TASKS name name LOG filename Il wizard di installazione viene richiamato in modalit silenziosa In questa modalit sono soppresse tutte le finestre di dialogo che richiedano un interazione con l utente Viene visualizzata unicamente una finestra che mostra l avanzamento dell installazione nonch eventuali messaggi relativi ad anomalie che possano verificarsi durante il processo di installazione Il wizard di installazione viene richiamato in modalit completamente silenziosa In questa modalit sono soppresse tutte le finestre di dialogo che richiedano un interazione con l utente nonch la finestra che mostra l avanzamento dell installazione Vengono visualizzati unicamente eventuali messaggi relativi ad anomalie che possano verificarsi durante il processo di installazione Da usare in combinazione con SILENT o VERYSILENT Questo parametro sopprime eventuali messaggi relativi ad anomalie che possano verificarsi durante il processo di installazione E da notare che in base al tipo di messaggio verr assunta una risposta di default come seg
85. di fault tolerance L installazione su PC server si avvale di un Wizard estremamente intuitivo Poich pdfCom funziona come servizio di Windows la procedura di installazione provveder anche all installazione del servizio E necessario pertanto che il programma di installazione venga eseguito da un utente con i privilegi di Amministratore Una volta lanciato il programma di installazione si presenter una finestra come segue Installazione di pdfCom Benvenuti nel programma di installazione di pdfCom pdfCom sar installato sul computer Si consiglia di chiudere tutte le applicazioni attive prima di procedere Premere Avanti per continuare o Annulla per uscire Come evidenziato altamente consigliato chiudere tutte le applicazioni attive Si consiglia altres di disattivare temporaneamente eventuali programmi antivirus Per completare il semplice processo di installazione necessario accettare i termini della licenza d uso e seguire le istruzioni che verranno man mano mostrate a video Al termine dell installazione NON E RICHIESTO IL RIAVVIO del PC server IMPORTANTE Il Wizard di installazione controlla la presenza di Microsoft NET Framework versione 2 E quindi assolutamente necessario procedere all installazione di NET Framework disponibile anche come aggiornamento facoltativo tramite il sito di Windows Update prima dell installazione di pdfCom http www pdfcom it Pagina 15 di 150 p
86. di Codice a Barre poi quelle di Immagine successivamente quelle di Stile ed infine quelle di Grafico ID Grafico Identificativo numerico di un grafico Questo identificativo rappresenta il set di tutti i parametri da utilizzare per la creazione del grafico Graph Set Nel capitolo 14 viene esaustivamente trattato l argomento di come fornire a pdfCom i set di dati relativi ai grafici Graph Set e si vedr che saranno tutti identificati tramite un ID numerico Lo stesso ID pu essere utilizzato all interno di pi macro di grafico in modo da utilizzare pi volte lo stesso set di parametri pdfCom 7 1 Tipo Grafico Manuale utente Il tipo di grafico da creare E possibile scegliere tra tre diverse tipologie di grafico Le tipologie di grafico supportate sono le seguenti Prova grafico 00 Curve ES Aha O Beta O Gamma r Titolo Y 0 10 20 30 40 50 60 Titolo X Titolo Y2 Prova grafico 01 Barre Titolo Y Grafico a curve linea spezzata Grafico a barre http www pdfcom it Pagina 58 di 150 pdfCom 7 1 Manuale utente Prova grafico 02 Torta DUTI mooom r E 42 31 Grafico a torta B 15 38 C 15 38 Premendo il tasto di funzione F4 con il cursore posizionato su questo campo possibile scegliere il tipo di grafico da una lista dei tipi supportati Colonna Questo valore specifica la colonna dello spool alla
87. dinamicamente dal contenuto dello spool tramite l utilizzo di uno o pi PlaceHolder con il seguente formato lt ppp rr ccc 111 0 gt Dove ppp rappresenta la pagina relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti rr la riga e ccc la colonna Ill indica la lunghezza di testo da utilizzare in pratica la lunghezza del testo tolti eventuali spazi a sinistra ed a destra che sostituir l intero PlaceHolder o omissione pu assumere i valori S o N ed indica se il testo referenziato dal PlaceHolder deve essere omesso nello spool ovvero sostituito con spazi vuoti A meno di non utilizzare PlaceHolder specificare un nome documento in questa fase pu aver senso solo se tutti gli spool con un determinato tipo modulo devono produrre un file sempre con il solito nome Diversamente il nome documento potr essere specificato direttamente nel file di spool vedi capitolo 7 Gestione dei parametri sul singolo spool o tramite un programma utente vedi paragrafo 6 9 Gestione parametri di elaborazione documenti Se il parametro Nome del documento non viene impostato pdfCom determiner automaticamente il nome del file da creare secondo la seguente convenzione xxxxxxxxxx_ aaaa_bbbbbb_yyyyyyyyyy_cccccc pdf txt tif dove xxxxxxxxxx il nome del file di spool eventualmente tagliato a 10 caratteri massimi aaaa il numero del fi
88. documento successivo Sebbene questo approccio possa sembrare poco produttivo occorre tener presente che tramite il MultiThreading possibile avere pi processi destinati alla produzione e stampa dei documenti e quindi anche se un processo impegnato ad accodare una stampa la produzione dei documenti successivi viene comunque effettuata dagli altri processi paralleli E altres vero che se tutti i documenti prodotti necessitano http www pdfcom it Pagina 22 di 150 pdfCom 7 1 Manuale utente sistematicamente di essere stampati tutti i processi protrebbero ritrovarsi occupati dalla stampa e quindi la produzione dei documenti essere pi lenta In alternativa possibile optare per la stampa in modalit asincrona La stampa asincrona si avvale di un processo parallelo separato se il PDF prodotto prevede anche la sua stampa questa viene posta in una coda di elaborazione interna permettendo a pdfCom di continuare con l elaborazione dei successivi documenti Il processo parallelo denominato MasspPrinter si occuper di effettuare tutte le stampe in coda in modalit sequenziale Questo approccio diversamente dal precedente non penalizza mai la produzione dei documenti anche senza l utilizzo del MultiThreading Ovviamente saranno penalizzate le eventuali stampe dato che dovranno attendere il loro turno di elaborazione sequenziale I MPORTANTE In Windows esiste un importante distinzione tra le stampanti locali gestite c
89. e Visualizzatore eventi E Visualizzatore Eventi Fie Azione Visualizza e mm B e Visualizzatore eventi locale Rifra Eventi 21 Applicazione til Protezione Tipo Data Ora Origine til Sistema D Informazioni 14 10 2008 16 15 35 pdfComService F Internet Explorer D Informazioni 06 10 2008 10 59 17 pdfComService D Informazioni 06 10 2008 10 59 17 pdfComService G Informazioni 06 10 2008 10 45 58 pdfComService D Informazioni 06 10 2008 10 36 54 pdfComService D Informazioni 06 10 2008 10 36 54 pdfComService D Informazioni 06 10 2008 10 34 40 pdfComService D Informazioni 01 10 2008 16 07 15 pdfComService D Informazioni 01 10 2008 16 07 15 pdfComService A Avviso 01 10 2008 16 06 36 pdfComService G Informazioni 01 10 2008 16 06 30 pdfComService D Informazioni 01 10 2008 16 01 32 pdfComService D Informazioni 01 10 2008 16 01 32 pdfComService A Avviso 01 10 2008 16 01 09 pdfComService D Informazioni 01 10 2008 16 01 05 pdfComService D Informazioni 22 05 2008 11 08 45 pdfComService 3 Tnfarmasiani PA2INCI2NN2 11 NA dl ndffamSarvica Nel registro denominato Rifra saranno visibili tutti gli eventi registrati da pdfCom http www pdfcom it Pagina 96 di 150 pdfCom 7 1 Manuale utente Facendo doppio click su una voce dell elenco possibile visualizzarne tutti i dettagli ad esempio Propriet Evento _ Evento Data Origine pdfComService Ora 16 06 36 Categoria Nessuno Tipo Avviso ID evento
90. e obbligatorio Mittente Indirizzo e mail che sar indicato come mittente Il parametro obbligatorio Nome Mittente Nome che apparir come mittente Se non viene specificato alcun valore il nome mittente sar l indirizzo e mail specificato nel parametro Mittente Oggetto L oggetto della mail Istanza L istanza di pdfCom da utilizzare per l elaborazione e l invio del documento E necessario specificare un istanza correttamente configurata fare riferimento al paragrafo 3 1 Impostazione istanze di pdfCom Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un istanza tra quelle configurate Di default verr proposto il valore inserito nel parametro Istanza PDFCOMSPL presente nella configurazione dei parametri generali fare riferimento al paragrafo 3 2 Impostazione dei parametri generali Se quest ultimo non valorizzato verr proposta l istanza configurata con il numero di sequenza pi basso http www pdfcom it Pagina 149 di 150 Tramite il tasto di funzione F13 Dati agg si accede alla videata dei dati aggiuntivi SI A AVILIFARGZIEEE pdfCom Invio spool PDFCOMSPL asi Invio spool COIVG43P TTI Invio spool COIVG43P blank nessuno blank nessuno Copia conoscenza Indirizzo e mail a cui inviare una copia Tale indirizzo sar visibile nella mail al destinatario Copia conoscenza nascosta Indirizzo e mai
91. e al numero di serie magari a seguito di aggiornamenti hardware al System i comportano il blocco del prodotto Se si prevede di effettuare aggiornamenti hardware che comportano il cambio del numero di serie accertarsi di avere a disposizione le nuove chiavi di licenza Per inserire la chiave di licenza relativa al modulo base collegarsi come QSECOFR ed effettuare il seguente comando ADDLICKEY PRDID ORFPDEC LICTRM V7 FEATURE 5001 SERIAL LOCAL PRCGRP ANY LICKEY XXXXXX XXXXXX XXXXXKX USGLMT 1 EXPDATE NONE VNDDTA RIFRASRL la stringa xxxxxx xxxxxx xxxxxx dovr essere sostituita con quella fornita nel Certificato di Autenticit rilasciato da Rifra S r l relativo al Modulo BASE http www pdfcom it Pagina 13 di 150 pdfCom 7 1 Manuale utente 3 5 Inserimento delle chiavi di licenza prodotto moduli opzionali Per inserire la chiave di licenza relativa al modulo opzionale Grafici collegarsi come QSECORR ed effettuare il seguente comando ADDLICKEY PRDID ORFPDEC LICTRM V7 FEATURE 5003 SERIAL LOCAL PRCGRP ANY LICKEY Xxxxxx XXXXXX XXXXXX USGLMT 1 EXPDATE NONE VNDDTA RIFRASRL la stringa xxxxxx xxxxxx xxxxxx dovr essere sostituita con quella fornita nel Certificato di Autenticit rilasciato da Rifra S r l relativo al Modulo GRAFICI Per inserire la chiave di licenza relativa al modulo opzionale Forms collegarsi come QSECOF
92. e che esprimono la dimensione dell immagine in 72esimi di pollice fare riferimento al paragrafo 6 5 per ulteriori spiegazioni Immagine il nome del file immagine completo di percorso Pu contenere il PlaceHolder che specifica dove reperire tutto o parte del nome immagine fare riferimento al paragrafo 6 5 per ulteriori spiegazioni 7 5 Dettaglio sintassi parametri Macro Action per Stile I parametri evidenziati in rosa fucsia nella tabella nomi parametri del paragrafo 7 2 sono relativi alle Macro Action di Stile A prescindere dalle regole specificate per un Tipo modulo vedi paragrafo 6 6 Macro Action di Stile possibile forzare per un testo ad una determinata pagina riga colonna per una determinata lunghezza di caratteri lo stile A tale scopo sufficiente specificare uno o pi parametri di stile separati terminati sempre AA con il carattere punto e virgola con la seguente struttura amp amp S ppp rr ccc lll Font Dimensione UpReotoreHont ColorceEviaenzilato ColoreBordo RaggioArrotondamento PercentualeCrescita H OffsetX OffsetY dove ppp rr ccc e Ill rappresentano rispettivamente il numero di pagina riga colonna e lunghezza numero di caratteri da specificare obbligatoriamente e composti rispettivamente di 3 2 3 e 3 cifre http www pdfcom it Pagina 79 di 150 pdfCom 7 1 Manuale utente A destra dell uguale possibile specificare i seguenti valori di base Font rappresent
93. e le Macro Action di Immagine Si deve tenere presente che per una stessa combinazione di pagina riga colonna pu essere applicata complessivamente tra Immagine Stile Codice a Barre e Grafico una sola Macro Action Quindi in caso di sovrapposizione avr precedenza la Macro Action con numero di sequenza minore tenendo tuttavia presente che verranno applicate per prime le Macro Action di Codice a Barre poi quelle di Immagine successivamente quelle di Stile ed infine quelle di Grafico Path Immagine Il nome completo di percorso dell immagine da inserire nel documento generato L immagine sar inserita nel documento facendo corrispondere il suo angolo inferiore sinistro con riga colonna specificate nella Macro Action pdfCom 7 1 Manuale utente E da notare come avviene nell esempio che parte o tutto del nome percorso pu essere reperito dinamicamente dal contenuto dello spool tramite l utilizzo di un PlaceHolder con il seguente formato lt P M ppp P M rr ccc 111 0 gt ppp rappresenta la pagina relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti rr la riga e ccc la colonna IIl indica la lunghezza di testo da utilizzare in pratica la lunghezza del testo tolti eventuali spazi a sinistra ed a destra che sostituir l intero PlaceHolder o omissione pu assumere i valori S o N ed indica se il testo referenziato dal
94. e mail da parte di pdfCom in maniera sincrona rispetto al suo funzionamento Immaginiamo di aver lanciato l elaborazione di 50 documenti la met dei quali devono anche essere spediti via e mail ma in quel momento il server SMTP esterno risulta particolarmente lento per cause a noi estranee l ipotesi di attendere che una mail sia stata inviata prima di procedere all elaborazione di eventuali successivi documenti non praticabile In virt del fatto che i timeout del TCP IP sono nell ordine dei 30 60 secondi l elaborazione dell ultimo documento dell esempio e quindi la produzione del relativo PDF TXT o TIFF avverrebbe in tempi decisamente non accettabili Come soluzione a questa problematica pdfCom prevede l invio delle e mail in maniera asincrona tramite un processo separato denominato MassMailer Se il documento PDF TXT o TIFF prodotto prevede anche l invio tramite e mail questa viene posta in una coda di invio permettendo a pdfCom di continuare con l elaborazione dei successivi documenti Come accennato nel precedente paragrafo 9 1 il relativo file IFS assumer lo stato temporaneo SEN mail accodata da inviare Il processo parallelo MassMailer si occuper di inviare tutte le e mail in coda In caso di errore di invio ed esempio se il server SMTP non risponde viene eseguito il numero massimo di tentativi specificati nei parametri di configurazione vedi paragrafo 5 2 Configurazione dei parametri di default per il servizio a
95. e spazio per 132 colonne lasciando quindi spazio vuoto alla destra del testo Numero righe Il numero di righe del file di spool Se non specificato tale parametro viene rilevato automaticamente dallo spool stesso Sebbene questo parametro possa sembrare simile al precedente importante precisare che l applicazione di eventuali regole di fincato macro etc descritte pi avanti nel corso di questo manuale terr conto esclusivamente della posizione di pagina riga proprie dello spool pdfCom 7 1 Manuale utente LPI Il numero di righe per pollice del file di spool Se non specificato tale parametro viene rilevato automaticamente dallo spool stesso E da notare che specificare un numero di righe per pollice diverso da quello reale del file pu essere utile a far s che il PDF venga formattato correttamente Per ulteriori dettagli si veda l esempio nel parametro Numero colonne Offset X 1 72 Lo spazio espresso in 72esimi di pollice 1 72 0 3528 mm da lasciare come margine sinistro Se il parametro non viene espresso viene effettuata una centratura automatica del testo in base alle dimensioni del Font ed al numero di colonne Offset Y 1 72 Lo spazio espresso in 72esimi di pollice 1 72 0 3528 mm da lasciare come margine superiore Se il parametro non viene espresso viene lasciato uno spazio di 20 unit equivalenti a circa 7 mm Dimensioni Font Le dimensioni del Font da utilizzare per il testo espresse in
96. eCycle Designer ad esempio permette un posizionamento estremamente preciso dei campi in un PDF senza contare la possibilit di scegliere lo stile tipo di carattere colore etc di come apparir il testo nel campo compilato In considerazione del fatto che un Modulo PDF pu anche essere composto da pi pagine ed i campi possono ripetersi sulle varie pagine semplicemente utilizzando il solito nome possibile preparare un modulo PDF che sia omnicomprensivo di tutte le possibili pagine dalle quali un contratto pu essere composto Infine tramite le regole di fincato multiplo fare riferimento al paragrafo 6 3 Parametri fincato multiplo non rester che determinare la sequenza delle pagine per lo specifico contratto da produrre semplicemente scegliendo le pagine da utilizzare sempre del solito fincato ovvero il modulo PDF compilato 15 1 Valorizzazione campi Form per Tipo Modulo Come accennato nei paragrafi 6 1 Parametri generali di creazione dei PDF e 6 3 Parametri fincato multiplo possibile specificare in corrispondenza di un fincato anche un eventuale ID numerico relativo al form Questo ID che deve essere univoco per fincato considerando tutto il path ignorando maiuscole minuscole identificher un set di parametri Form Set relativi ai nomi dei campi del modulo con i rispettivi valori di riempimento Analogamente a quanto avviene per i parametri di elaborazione fare riferimento al capitolo 7 Gestione dei param
97. econdi Il valore di default di 5 secondi Intervallo tentativi monitor Specifica il numero di secondi che il servizio attende se la comunicazione con il System i non disponibile Tipicamente il caso in cui il System i spento ma il PC server attivo E possibile specificare un intervallo compreso tra 1 e 3600 secondi Il valore di default di 1200 secondi 20 minuti http www pdfcom it Pagina 20 di 150 pdfCom 7 1 Manuale utente Tramite il tasto Test possibile effettuare una prova di connettivit con il System i Verr verificata la connessione ed un messaggio informer sull esito della prova Affinch il test vada a buon fine necessario che il sottosistema PDFCOM sul System i sia attivo Parametri e mail Specificare i parametri di configurazione relativi al server SMTP che si occuper dell eventuale invio automatico di e mail Oltre al nome del server e la relativa porta TCP il default del protocollo SMTP la porta 25 possibile specificare se il server necessita di una connessione protetta SSL e o dell autenticazione di base Basic Authentication In quest ultimo caso possibile specificare il nome utente con la relativa password Ulteriormente possibile specificare il numero di tentativi compreso tra 1 e 5 che pdfCom dovr effettuare in caso di errore durante l invio di una mail I tentativi saranno effettuati ad un intervallo minimo di 3 minuti l uno dall altro vedi p
98. egola di fincato multiplo composta dai seguenti parametri mi RI Modifica Tipo Modulo PDF Modifica Regola Fincato FATTURE 0020 blank nessuno 2 d fincati ultima_pag_fatture PDF 1 999 blank 1 1 900 blank 100 __ E 49 1 2 3 4 blank auto 1 999 xL ultima Q unica OPPURE 1 99 1 220 78S AR SEROREN MENE SERPII ASES SESO EN SEN PEA E Totale fattura 001 050 051 100 101 150 151 200 F12 Precedente F23 0verride Numero sequenza Determina l ordine con il quale la regola verr applicata potrebbe capitare infatti che due o pi regole siano ugualmente valide La regola valida con numero di sequenza pi alto sar quella effettivamente applicata Fincato Il nome del fincato completo di percorso da applicare alle pagine che soddisfano la regola Il fincato deve essere un file PDF e deve essere specificato completo del suo percorso E da notare che il percorso deve essere funzionale al servizio che gira sul PC server che lo utilizzer per trovare il file ovvero deve essere specificato cos come lo vede quel determinato PC server E possibile utilizzare nomi UNC ed altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Il parametro opzionale se non specificato sulle pagine che soddisfano la regola non verr applicata alcuna fincatura E impor
99. endere tutte le stampe di una coda con un tipo modulo che non sia gi stato specificato Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un Tipo Modulo tra quelli presenti in tabella Nome stampante PC E il nome della stampante su cui effettuare la stampa Il nome deve essere specificato allo stesso modo di come appare nella gestione Stampanti e fax sul PC server Se lasciato vuoto verr utilizzata la Stampante di default configurata al paragrafo 5 2 Configurazione dei parametri di default per il servizio Specificando il valore speciale SAME il parametro risulter non impostato e verr utilizzata la stampante specificata nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF E possibile utilizzare in sostituzione di tutto o parte del nome una viariabile di path di tipo P fare riferimento al paragrafo 6 13 Gestione variabili di Path pdfCom 7 1 Manuale utente Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere una stampante tra tutte quelle effettivamente visibili dal PC server E da notare che in caso ci siano pi istanze configurate e quindi pi PC server attivi la lista visualizzata sar complessiva E comunque possibile filtrare le stampanti visibili da un singolo PC server impostando un v
100. entemente a destra o sinistra Nel caso in cui la stringa Valore sia relativa ad un metadato di tipo data ora o timestamp necessario specificare obbligatoriamente la stringa con la seguente sintassi AAAAMMGGhhmmss eventualmente specificando il default per eventuali valori non significativi ai fini del metadato http www pdfcom it Pagina 118 di 150 Se ad esempio vogliamo specificare un metadato di tipo ora con il valore 13 54 la stringa Valore sar la seguente 00010101135400 Poich uno stesso documento pu anche essere indicizzato pi volte per il solito meta tag con valori diversi le regole di gerarchia parametri non hanno alcun effetto 13 4 Ricerca documenti tramite indice da Pannello di Controllo Indicizzare un documento pone le basi affinch sia possibile effettuare ricerche tramite il Pannello di Controllo di pdfCom Come accennato nel capitolo 9 Pannello di Controllo su System i premendo il tasto di funzione F2 dal Pannello di Controllo si accede al Filtro documenti da Indice SUS RR Gestione documenti istanza PDFCOM 13 04 2012 _0 00 00 20 04 2012 24 00 00 nea blank tutti Opzioni 2 Modifica 3 Congela 4 Cancella 5 Visualizza 8 Dettagli D Elabora H El pr Alta L El pr Bassa M El solo Mail I Ind Filtro documenti da Indice F02 No filtro FOS Rivisual F12 Precedente 09 028 Da qui possibile specificare fino ad un massimo di 3 meta tag e relativo range di valori dei metadati per
101. ento valori positivi produrranno uno spostamento verso destra valori negativi verso sinistra I valori per questo parametro vanno specificati secondo il seguente formato valore espresso in punti nnn nnP valore espresso in colonne nnn nC OffsetY relativo specifica lo spostamento sull asse Y del testo E possibile inserire valori secondo due diverse unit esclusive tra loro numero di righe oppure punti espressi in 72esimi di pollice 1 72 0 3528 mm Nel primo caso possibile utilizzare valori con una cifra decimale es 1 5 righe mentre nel secondo caso possibile utilizzare fino a due cifre decimali arrivando alla precisione di 1 7200 3 528 um Il segno obbligatorio specifica la direzione di spostamento valori positivi produrranno uno spostamento verso il basso valori negativi verso l alto I valori per questo parametro vanno specificati secondo il seguente formato http www pdfcom it Pagina 80 di 150 pdfCom 7 1 Manuale utente valore espresso in punti nnn nnP valore espresso in righe nnn nR Come gi evidenziato se si desidera specificare anche uno solo dei valori avanzati allora tutti gli 11 valori complessivi diventano obbligatori ovvero diventa obbligatoria almeno la sola virgola che li separa Resta fermo il fatto che almeno un valore tra gli 11 complessivi sia comunque obbligatorio altrimenti il parametro di stile non avrebbe alcun senso 7 6 Dettaglio sintassi parametri Macro Actio
102. er un set di parametri necessari alla creazione del grafico Graph Set I parametri di Graph Set diversamente dagli altri parametri non possono essere definiti sulla base del tipo modulo ma vanno forniti a pdfCom direttamente I parametri di Graph Set hanno cadauno una lunghezza massima di 220 caratteri totali e sono strutturati in questo modo amp amp Gnnn NomeParametrol ValoreParametrol amp amp Gnnn NomeParametro2 ValoreParametro2 amp amp Gnnn NomeParametro2 ContinuazioneValoreParametro2 dove nnn rappresenta l ID numerico del grafico da specificare obbligatoriamente composto di 3 cifre NomeParametro il nome di un parametro di grafico e ValoreParametro il corrispondente valore Valori che eccedono la lunghezza complessiva di 220 caratteri vanno spezzati su pi righe tenendo presente che il valore finale sar il risultato della concatenazione in sequenza compresi eventuali spazi presenti delle stringhe tra il segno ed il di tutte le righe che si riferiscono allo stesso nome di parametro All interno di ValoreField possibile utilizzare tutti i caratteri ad eccezione del carattere punto e virgola in sostituzione disponibile la sequenza di escape P Per specificare il Carriage Return a capo disponibile la sequenza di escape N IMPORTANTE Se i parametri di Graph Set vengono specificati nei campi USRDFNDTA del file di spool e o nel parametro USERDAT
103. er pollice del grafico E importante precisare che la risoluzione non influir in alcun modo sulle dimensioni del grafico all interno del PDF determinate dai parametri imgWidth e imgHeight bens sulla sua qualit Pi alta sar la qualit maggiori http www pdfcom it Pagina 125 di 150 pdfCom 7 1 Manuale utente saranno le dimensioni in byte del file PDF che conterr il grafico Se si desidera utilizzare il PDF per stampe di alta qualit consigliabile utilizzare una risoluzione di almeno 300 DPI gTitle Titolo del grafico Questo titolo apparir centrato nella parte superiore del grafico xTitle Titolo dell asse X Questo titolo apparir centrato nella parte inferiore del grafico come didascalia dell asse X yTitle Titolo dell asse Y di sinistra Questo titolo apparir scritto verticalmente nella parte sinistra del grafico come didascalia dell asse Y sinistro y2Title Titolo dell asse Y di destra Questo titolo apparir scritto verticalmente nella parte destra del grafico come didascalia dell asse Y destro isAxisGridVisible Indica se deve essere visibile o meno la griglia di riferimento degli assi isLegendVisible Indica se deve essere visibile o meno la legenda delle barre presenti nel grafico La legenda apparir a sinistra nella parte superiore del grafico sotto il titolo backgroundFill Riempimento dello sfondo labels Lista di etichette da utilizzare in sostituzione dei nume
104. ere trasformata in codice a barre TipoBarcode rappresenta il codice del tipo di barcode da creare fare riferimento al paragrafo 6 7 per ulteriori spiegazioni 7 7 Dettaglio sintassi parametri Macro Action per Grafico I parametri evidenziati in arancione nella tabella nomi parametri del paragrafo 7 2 sono relativi alle Macro Action di Grafico A prescindere dalle regole specificate per un Tipo modulo vedi paragrafo 6 8 Macro Action di Grafico possibile inserire un grafico ad una determinata pagina riga colonna A tale scopo sufficiente specificare uno o pi parametri di grafico separati terminati sempre n con il carattere punto e virgola con la seguente struttura amp amp G ppp rr ccc TipoGrafico IdGrafico dove ppp rr e ccc rappresentano rispettivamente il numero di pagina riga e colonna da specificare obbligatoriamente e composti rispettivamente di 3 2 e 3 cifre TipoGrafico rappresenta il codice del tipo di grafico da creare fare riferimento al paragrafo 6 8 per ulteriori spiegazioni IdGrafico rappresenta l identificativo numerico del set di tutti i parametri da utilizzare per la creazione del grafico Graph Set Nel capitolo 14 viene esaustivamente trattato l argomento di come fornire a pdfCom i set di dati relativi ai grafici http www pdfcom it Pagina 81 di 150 pdfCom 7 1 Manuale utente 7 8 Dettaglio sintassi parametri Forms I parametri evidenziati in celeste nella tabell
105. ersione 7 1 2378 1031 C 2006 2012 Rifra S r 1 Gestione Istanze pdfCom oJoxojo Modifica opzioni Report automatico PDFCOM S 1485 PDFCOM PDFCOM_RP Wxx SEN KO ACT 25 09 2008 16 19 42 F03 Fin F08 Elimina F12 Precedente Report attivo Permette di abilitare o disabilitare il report senza la necessit di eliminare la configurazione delle opzioni Coda di stampa La coda di emissione System i sulla quale il report verr prodotto Ovviamente possibile inserire anche una coda relativa ad un istanza di pdfCom in questo modo il report una volta prodotto potr essere elaborato da pdfCom stesso Tipo modulo L attributo Tipo Modulo che verr assegnato al file di spool del report Questo parametro risulta particolarmente utile specie in combinazione con il parametro Coda di stampa per far elaborare a pdfCom stesso il report prodotto Report anche vuoto Specifica se il report deve essere fisicamente prodotto anche se non dovesse contenere nessuna riga stampata ovvero contenere solo l intestazione Questa opzione pu risultare utile se si desidera comunque avere la certezza che la schedulazione della reportistica automatica abbia avuto luogo pdfCom 7 1 Manuale utente Stati da includere E possibile specificare una lista di stati vedi paragrafo 9 1 Dettagli sui file IFS di pdfCom da includere nel report per una data istanza Specificando ad esempio gli stati W KO e SE
106. estione dei tipi modulo Il paragrafo 7 11 Riepilogo gerarchia dei parametri fornisce una spiegazione completa sulla gerarchia dei parametri Per ogni override possibile impostare i seguenti parametri nl D User SPI Gestione override parametri per Coda 777 Inserimento override parametri per Coda F4 blank tutti blank predefinita xSAME non impostata 0 20 blank non impostato blank non impostata TEMP temporanea blank non impostata blank non impostato blank non impostato F12 Precedente Coda La coda di stampa di provenienza in base alla quale si desidera specificare i parametri Questo parametro ovviamente obbligatorio Occorre precisare che questo parametro fa riferimento alla coda di stampa dove si trovava il file di spool prima che il modulo di smistamento automatico lo smistasse in una coda gestita da un istanza di pdfCom Pertanto possibile specificare solo code di stampa monitorate dallo smistatore automatico fare riferimento al paragrafo 16 2 Gestione Code monitorate Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere una coda di stampa effettivamente monitorata dallo smistatore automatico Tipo modulo Specifica per quale tipo modulo solo per la coda di stampa impostata nel parametro Coda si desidera specificare i parametri E possibile lasciare vuoto questo parametro in modo da compr
107. estituito il codice 0 zero Fare riferimento al successivo paragrafo 12 5 Tabella codici errore di pdfCom API 2 per una spiegazione dei possibili codici di risposta http www pdfcom it Pagina 111 di 150 pdfCom 7 1 Output OPZIONALE Tramite questo parametro opzionale possibile ricevere in output l informazione Manuale utente eventualmente richiesta alla API 2 tramite il parametro Action Tutti i codici azione che iniziano con il carattere G prevedono un output 12 5 Tabella codici errore di pdfCom API 2 La API 1 di pdfCom restituisce nel parametro ErrorCod un codice numerico che indica l esito dell elaborazione Quella che segue la tabella con tutti i possibili codici di risposta 00 OK 01 File IFS gi nello stato richiesto 02 File IFS gi eliminato precedentemente 71 File IFS non valido 72 Errore cancellazione file semilavorato su cartella IFS 81 N A 96 Libreria PDFCOM non presente in lista delle librerie 99 Codice azione in input non valido Un codice di errore minore di 70 considerato non bloccante e significa che la API 2 ha comunque svolto la sua funzione o che questa non era necessaria http www pdfcom it Pagina 112 di 150 13 Indicizzazione documenti pdfCom mette a disposizione un potente motore di indicizzazione che tramite l utilizzo di metadati dinamici permette di catalogare un qualsiasi documento prodotto L utente ha
108. etri sul singolo spool anche i parametri di Form Set si possono fornire a pdfCom tramite l utilizzo del campo USRDFNDTA del file di spool tramite il parametro denominato USERDATA del programma utente e o della API 1 tramite l array dati utente della API 1 e tramite il blocco parametri embedded nel file di spool Il paragrafo 15 2 Struttura dei parametri Form Set affronta l argomanto su come fornire a pdfCom direttamente i parametri relativi ai Form Set http www pdfcom it Pagina 133 di 150 Dalla Gestione dei Tipi Modulo opzione 1 del menu principale di pdfCom inserendo l opzione F Field Form si accede alla Gestione Field Form per Tipo Modulo H05 A Gestione Field Form per tipo modulo FATTURE olo LoLo Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Inserisci O _NSeq ID Nome Field Valore Field Me 0010 fComunicazioneLP fTiDo FO6 Inserisci F12 Precedente 06 007 Da qui possibile gestire i criteri di valorizzazione dei parametri relativi ai Form Set pdfCom utilizzer tali criteri al momento dell elaborazione di un file di spool sulla base del suo Tipo Modulo Per ogni Form Set gi definito identificato dal suo ID numerico possibile specificare il nome del campo da riempire con il relativo valore Per ogni criterio di valorizzazione possibile specificare i seguenti parametri SUS f Gestione Field Form per tipo modulo FATTURE ofo Kofo Opzioni 2 Modifica 3
109. etro alla API 1 non deve prevedere rotture vedi paragrafo 6 9 Parametri di elaborazione documenti diversamente la API 1 di pdfCom produrr un errore in fase di elaborazione errore 82 http www pdfcom it Pagina 108 di 150 pdfCom 7 1 Manuale utente 12 2 Tabella codici errore di pdfCom API 1 La API 1 di pdfCom restituisce nel parametro ErrorCod un codice numerico che indica l esito dell elaborazione Quella che segue la tabella con tutti i possibili codici di risposta 00 0K 01 Fincato default non trovato 02 Errore su fincato multiplo 03 Fincato default non trovato Errore su fincato multiplo 04 Fallito inserimento Macro 05 Fincato default non trovato Fallito inserimento Macro 06 Errore su fincato multiplo Fallito inserimento Macro 07 Fincato default non trovato Errore su fincato multiplo Fallito inserimento Macro 71 Errore copia del file di spool riferimenti passati errati o mancanza autorizzazione 72 Errore reperimento attributi del file di spool 73 Errore scrittura file semilavorato Sxxxxxxx su cartella IFS istanza 81 Cartella IFS istanza non valida 82 Tipo modulo prevede delle rotture 85 Programma EXIT di tipo B da API 1 non trovato 86 Programma EXIT di tipo A per stato OK da API 1 non trovato 87 Programma EXIT di tipo A per stato KO da API 1 non trovato 88 Programma EXIT di tipo A per stato W lt 07 da API 1 non trovato 89 Program
110. ettua in pochi semplici passi Configurazione del servizio pdfCom Configurazione dei parametri di default per il servizio Configurazione del Registro degli Eventi di Windows per questo punto fare riferimento al capitolo 10 ed in particolare al paragrafo 10 1 5 1 Configurazione del servizio pdfCom Il Wizard di installazione aggiunge un servizio gestibile tramite la Gestione Servizi di Windows Dal Pannello di controllo scegliere l opzione Strumenti di amministrazione e successivamente l opzione Servizi verr visualizzata la lista di tutti i servizi installati nel PC server Scorrere la lista fino a trovare la voce pdfCom fare click sopra con il tasto destro e scegliere la voce Propriet dal men contestuale Apparir la seguente finestra Propriet Computer locale pdfCom Generale Connessione Ripristino Relazioni di dipendenza Nome del servizio pdfCom Nome visualizzato PdfCom Descrizione System i Enhanced Output Percorso file eseguibile CProgrammi Rifra pdfCom Service pdfCom exe Tipo di avvio Automatico Stato del servizio Arrestato Avvia possibile specificare i parametri iniziali da applicare quando il servizio viene avviato da qui Parametri di avvio nella casella Percorso file eseguibile potrebbe esserci un altra stringa a seconda del percorso scelto durante l installazione http www pdfcom it Pagina 17 di 150 pdfCom 7 1 Manuale utente
111. fcom it Pagina 88 di 150 pdfCom 7 1 Manuale utente 102000 riga 2 pagina 1 del file di spool 103000 riga 3 pagina 1 del file di spool 201000 riga 1 pagina 2 del file di spool 408000 riga 8 pagina 4 del file di spool IMPORTANTE La struttura dei parametri deve obbligatoriamente iniziare e terminare con le stringhe evidenziate in giallo senza il carattere e deve essere obbligatoriamente all inizio del file L ordine dei parametri in un blocco irrilevante La riga di testo immediatamente successiva alla stringa END PARM la prima riga che verr effettivamente stampata sul PDF ovvero la prima riga del file di spool Tutti i parametri che iniziano con i caratteri sono obbligatori notare che le stringhe MULTI MACRO GRAPH e FORMS evidenziate in grigio non sono un parametro vero e proprio bens rappresentano l inizio di un blocco di parametri e pertanto sono opzionali Il blocco di parametri in colore verde opzionale ed relativo alla gestione del fincato multiplo La stringa MULTI inizio blocco parametri fincato multiplo deve trovarsi dopo l ultimo parametro che inizia con i caratteri e precedere i vari parametri amp amp nnn Il blocco di parametri in colore blu rosa fucsia rosso opzionale ed relativo alla gestione delle Macro Action di Immagine Stile e Barcode La stringa MACRO inizio blocco parametri Macro Action di Immagine Stile e Barcode deve trovars
112. ficiente sospendere il servizio ed attendere che tutti i documenti in stato SEN mail accodata da inviare siano processati ma nel frattempo non se ne accoderanno altri A quel punto spengendo o riavviando il PC server non si causer alcun problema poich non ci saranno mail in coda che diversamente verrebbero esitate tutte come non inviate http www pdfcom it Pagina 95 di 150 pdfCom 7 1 Manuale utente 10 Log nel Registro degli Eventi di Windows pdfCom effettua un log nel Registro degli Eventi di Windows utile per controllare lo stato del prodotto nonch eventuali anomalie che possono verificarsi durante l elaborazione Tale log replicato quasi integralmente su System i e quindi visibile direttamente dal Pannello di Controllo Si parla di replica quasi integrale perch eventuali errori relativi alla mancanza di collegamento tra PC server e System i non potranno ovviamente essere replicati su quest ultimo Il Visualizzatore eventi di Windows accessibile nei seguenti modi dalla Tray Icon di pdfCom premendo il tasto destro del mouse sull icona e scegliendo l opzione Registro eventi dal menu contestuale dall applicazione Configurazione pdfCom accessibile dal tasto Start Programmi pdfCom scegliendo la voce Visualizzatore eventi presente nel menu Strumenti dal Pannello di controllo di Windows scegliendo l opzione Strumenti di amministrazione e successivamente l opzion
113. file di salvataggio SAVF denominati rispettivamente pdfcom7_02 bin pdfcom7_03 bin e pdfcom7_04 bin contenuti nella cartella denominata SAVF all interno del CD di installazione oppure all interno del file ZIP scaricato dal sito Internet di pdfCom Per installare il modulo opzionale Grafici trasferire il file denominato pdfcom7_02 bin su System i tramite FTP collegarsi come QSECORR ed eseguire il comando RSTLICPGM LICPGM ORFPDEC DEV SAVF OPTION 2 RLS V7R1M0 SAVF libreria file le stringhe libreria e file sono relative al file di salvataggio pdfcom7_02 bin trasferito su System i Per installare il modulo opzionale Forms trasferire il file denominato pdfcom7_03 bin su System i tramite FTP collegarsi come QSECOFR ed eseguire il comando RSTLICPGM LICPGM O0ORFPDEC DEV SAVF OPTION 3 RLS V7R1M0 SAVF libreria file le stringhe libreria e file sono relative al file di salvataggio pdfcom7_03 bin trasferito su System i http www pdfcom it Pagina 5 di 150 Per installare il modulo opzionale Sorter trasferire il file denominato pdfcom7_04 bin su System i tramite FTP collegarsi come QSECORR ed eseguire il comando RSTLICPGM LICPGM ORFPDEC DEV SAVF OPTION 4 RLS V7RI1MO SAVF libreria file le stringhe libreria e file sono relative al file di salvataggio pdfcom7_04 bin tra
114. file stesso nei parametri di creazione E importante leggere attentamente le note nel riquadro in fondo a questo paragrafo Selezionando la voce Stampa automatica dei PDF disabilitata non sar effettuata alcuna stampa dei documenti PDF prodotti Indirizzo System i Specificare il nome DNS o direttamente l indirizzo IP del System i Porta Specificare il numero di porta TCP da utilizzare per la connessione con il System i Analogamente su System i vedi paragrafo 3 2 Impostazione dei parametri generali possibile specificare il numero di porta TCP da utilizzare E assolutamente necessario che i due valori siano uguali Se non in presenza di esigenze specifiche si consiglia di lasciare impostato il valore di default porta 4000 Cartella istanza Specificare il nome della cartella IFS cos come specificato nella configurazione dell istanza su System i vedi paragrafo 3 1 Questo parametro in pratica serve a specificare quale istanza dovr gestire il PC server Intervallo monitor Specifica il numero di secondi che il servizio attende tra un controllo della presenza di file da elaborare ed il successivo I file da elaborare hanno uno stato diverso a seconda della priorit del file di spool attributo OUTPTY da cui sono stati generati Fare riferimento al capitolo 9 Pannello di Controllo su System i per tutte le informazioni riguardanti i file IFS di pdfCom E possibile specificare un intervallo compreso tra 1 e 60 s
115. g nel Registro degli Eventi di Windows Tramite le opzioni 1 2 3 4 e 5 possibile accedere alla gestione dei file presenti su una cartella IFS associata ad una determinata istanza gestione documenti nu Gestione documenti istanza PDFCOM3 1 01 2010 _0 00 00 16 11 2010 24 00 00 blank tutti Opzioni 2 Modifica 3 Congela 4 Cancella 5 Visualizza 8 Dettagli D Elabora H El pr Alta L El pr Bassa M El solo Mail lI Ind O_ File STS BERT Ora Dettagli 60005C9 W16 60005C8 W48 S60005C4 S60005C1 KO F02 Filtro F05 Agg F09 Log F10 0rdin F11 Vista F12 Prec F21 Report Il range di date impostato di default prevede la visualizzazione degli ultimi 7 giorni di attivit ma possibile impostare qualsiasi periodo si desideri Il tasto di funzione F10 Ordin permette di scegliere l ordinamento della lista dal file pi recente al pi vecchio default o vice versa E da notare che l ordinamento di default permette di avere in cima alla lista i file pi recenti e quindi molto probabilmente quelli di maggior interesse Il tasto di funzione F2 Filtro permette di effettuare una ricerca parzializzazione della lista dei file tramite l indicizzazione documenti per ulteriori informazioni fare riferimento al paragrafo 13 4 Ricerca documenti tramite indice da Pannello di Controllo Premendo ripetutamente il tasto di funzione F11 Vista possibile scegliere tra le varie viste disponibili della lista Il tasto di f
116. gliere l utente del quale visualizzare i file di spool ovviamente a condizione di avere i privilegi di sistema necessari Per ogni file di spool vengono visualizzate le principali caratteristiche e tramite il tasto di funzione F11 possibile visualizzare ulteriori caratteristiche I valori relativi al Tipo Modulo sono evidenziati con diversi colori in modo da fornire un indicazione precisa di come il documento in relazione al tipo modulo sar elaborato La tabella che segue descrive per ogni colore la situazione relativa al Tipo Modulo nella tabella di pdfCom BIANCO VERDE FUCSIA ROSSO Il tipo modulo del file presente nella tabella dei tipi modulo di pdfCom come tipo modulo PDF o TIFF L elaborazione terr conto di tutti i parametri specificati nel Tipo Modulo ad eccezione di quelli relativi alla scrittura archiviazione ed invio automatico del documento Il tipo modulo del file presente nella tabella dei tipi modulo di pdfCom come tipo modulo TXT L elaborazione terr conto di tutti i parametri specificati nel Tipo Modulo ad eccezione di quelli relativi alla scrittura archiviazione ed invio automatico del documento Il tipo modulo del file non presente nella tabella dei tipi modulo di pdfCom tuttavia presente la voce DEFAULT l elaborazione terr conto di tutti i parametri specificati per tale voce ad eccezione di quelli relativi alla scrittura archiviazione ed invio automatico del document
117. i della stampa Se non viene specificato alcun percorso il parametro risulter non impostato e verr utilizzata la cartella di output specificata nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF Cartella archiviazione copia Il percorso completo della cartella nella quale verranno ulteriormente copiati i documenti prodotti Il percorso specificato deve essere funzionale al PC server che lo utilizzer ed possibile specificare percorsi locali dal punto di vista del PC server o percorsi di rete con nomi UNC purch raggiungibili dal PC server E altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Se non viene specificato alcun percorso il parametro risulter non impostato e verr utilizzata la cartella di archiviazione specificata nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF E da notare che se viene specificato il valore speciale TEMP in Cartella output documenti non sar possibile specificare alcun valore per questo parametro Mittente e mail Indirizzo e mail che sar indicato come mittente E da notare che questo parametro sar utilizzato solo nel caso in cui sia effettivamente previsto l invio tramite e mail del documento prodotto Nome mittente e mail Nome che appa
118. i dopo l ultimo parametro che inizia con i caratteri o dopo l ultimo parametro di fincato multiplo e precedere le varie stringhe amp amp I amp amp S e amp amp B Il blocco di parametri in colore arancione opzionale ed relativo ai Grafici La stringa GRAPH inizio blocco parametri di grafico deve trovarsi dopo l ultimo parametro che inizia con i caratteri o dopo l ultimo parametro di fincato multiplo e precedere le varie stringhe amp amp G e amp amp nnn Il blocco di parametri in colore celeste opzionale ed relativo ai Forms La stringa FORMS inizio blocco parametri forms deve trovarsi dopo l ultimo parametro che inizia con i caratteri o dopo l ultimo parametro di fincato multiplo e precedere le varie stringhe amp amp C e amp amp nnn Alla fine del file deve obbligatoriamente essere presente la stringa END TEXT evidenziata in azzurro Il numero di riga non importante per quanto concerne il suo valore ma solo ai fini dell ordine delle righe stesse nel file che sar creato sulla cartella dell IFS su System i semilavorato per essere elaborato dal PC server I numeri di riga presenti in tabella e relativi ai parametri che iniziano con i caratteri alle stringhe di inizio blocchi opzionali evidenziate in grigio alle due stringhe di apertura e chiusura dell intera struttura evidenziate in giallo ed alla stringa di fine testo evidenziata in az
119. i file IFS di pdfCom fornisce una descrizione dettagliata dei file IFS semilavorati e dei relativi stati E necessario fornire il nome di un file IFS esistente ovvero prodotto da pdfCom diversamente verr generato un errore in fase di elaborazione errore 71 Action Indica il codice dell azione da eseguire La tabella seguente illustra tutti i codici che possibile fornire alla API 2 ed il relativo significato SH Imposta lo stato di un file a VPH il file sar elaborato rielaborato a priorit alta SD Imposta lo stato di un file a VPD il file sar elaborato rielaborato a priorit di default SL Imposta lo stato di un file a VPL il file sar elaborato rielaborato a priorit bassa SM Imposta lo stato di un file a VPM il file sar elaborato rielaborato ai soli fini di invio mail DD Eliminazione completa di un file compreso l eventuale indice DI Eliminazione di un file conservando integralmente l indice GI Reperisce il percorso completo di un file su IFS completo del nome del file stesso GN Reperisce il nome del documento PDF TXT o TIFF generato se presente GS Reperisce lo stato corrente di un file GO Reperisce la cartella di output del documento PDF TXT o TIFF se presente GA Reperisce la cartella di archiviazione del documento PDF TXT o TIFF se presente SErrorCod La API 2 di pdfCom restituisce un codice numerico che indica l esito dell elaborazione In caso di elaborazione corretta sar r
120. i file di spool che possono tranquillamente prescindere dall elaborazione vera e propria finalizzata alla produzione di documenti Tramite le funzionalit di smistamento automatico infatti possibile monitorare alcune o anche tutte le code di stampa del System i e in base a regole basate sugli attributi e o sul contenuto dei file di spool che finiscono nelle code monitorate effettuare modifiche automatiche prestabilite a qualsiasi attributo del file di spool come ad esempio indirizzare la stampa su una certa stampante o coda modificare il tipo modulo congelare la stampa etc Queste funzionalit risultano particolarmente utili in tutte quelle realt dove non possibile o comunque oneroso effettuare modifiche ai programmi di stampa delle procedure gestionali per adattarli alle proprie esigenze Tramite l opzione 8 del menu principale di pdfCom si accede al sotto menu relativo al modulo di smistamento automatico SUE A User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r l http www pdfcom it System i Enhanced Output Menu principale _____ F03 Fine F12 Precedente 21 020 Nel corso di questo capitolo verr fornita una spiegazione dettagliata delle funzionalit offerte da ogni singola opzione 16 1 Gestione Regole di Smistamento Come accennato all inizio di questo capitolo le funzioni di smistamento automatico si basano su regole che vengono definite dall utente Una regola
121. i grafici a Torta codice grafico 02 Quella che segue la tabella dei nomi parametri relativi ad un grafico a Torta codice del tipo di grafico 02 Nome parametro Tipo g amp nnn imgWidth NUM g amp nnn imgHeight NUM amp nnn imgDPI NUM g amp nnn gTitle ALFA amp amp nnn isLegendVisible BOOL amp nnn backgroundFill FILL amp nnn pieLabelTyp ENUM amp nnn pie pp label ALFA amp nnn pie pp valu NUM amp amp nnn pie pp_displacement NUM amp nnn pie pp pieSliceFill FILL LEGENDA DEI TIPI NUM Valore numerico come eventuale separatore decimale utilizzare il punto ALFA Stringa alfanumerica BOOL Booleano SI NO S o FILL Colore di riempimento Pu essere un colore singolo analogo al tipo COLOR oppure una lista di 3 valori i primi due rappresentano i colori di partenza ed arrivo analoghi al tipo COLOR il terzo l angolazione della sfumatura relativa alla transizione tra i due colori di partenza ed arrivo espressa in gradi da 0 a 360 ALFA x Lista di x stringhe alfanumeriche separate da virgola NUM x Lista di x valori numerici separati da virgola come eventuale separatore decimale utilizzare il punto Colore singolo formato RRRGGGBBB fare riferimento al riquadro FORMATO SPECIFICA COLOR g q COLORE alla fine del paragrafo 6 6 Macro Action di Stile ENUM Numero intero positivo compreso lo 0 che rappresenta un tipo nnn rappresenta l ID numerico del gr
122. i parametri per un tipo modulo presente una sezione inerente la configurazione dei parametri specifici per un eventuale invio del documento creato sia esso un PDF un file TXT o un TIFF tramite e mail Con il tasto di funzione F13 Mail dalla gestione visualizzazione di un tipo modulo si accede alla Gestione dati e mail RI R Gestione dati e mail FATTURA amministrazione acme com Reparto Amministrazione Acme Ltd blank no mail automatica lt 001 10 052 040 N gt blank nessuno lt 001 02 001 040 S gt acme com blank nessuno Fattura n lt 001 08 034 006 N gt del lt 001 08 042 008 N gt I Txt Htm S lt FO4 Elimina F12 Precedente F13 Corpo mail F22 Alleg agg F23 Dest agg F12 Pr F13 Mail F14 Finc m F15 Macro F16 E1 doc F17 Exit F23 Avanz Mittente Indirizzo e mail che sar indicato come mittente Il parametro se si decide di specificare i dati e mail per un tipo modulo obbligatorio Come si vedr nei paragrafi 6 11 e 6 12 Gestione override parametri questo parametro potr essere impostato anche per utente o coda di stampa quest ultima solo se risulta installato il modulo opzionale Sorter Nome mittente Nome che apparir come mittente Il parametro se si decide di specificare i dati e mail per un tipo modulo obbligatorio Come si vedr nei paragrafi 6 11 e 6 12 Gestione override parametri questo parametro potr essere impostato anche per utente o coda di sta
123. i pdfCom Fare riferimento al capitolo 12 pdfCom Application Programming Interface per ulteriori informazioni Premendo il tasto di funzione F22 Sorter disponibile solo se il modulo opzionale Sorter risulta installato si accede alla gestione dei parametri generali specifici per il modulo Sorter Fare riferimento al capitolo 16 Smistamento automatico per ulteriori informazioni http www pdfcom it Pagina 11 di 150 Premendo il tasto di funzione F13 Licenze viene visualizzata una finestra dalla quale possibile verificare lo stato delle licenze inserite User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r l Gestione parametri generali 1 65535 Gestione parametri generali Modulo pdfCom Stato lic Modulo BASE fhome pdfCom no reply ri franet it Modulo Postel l Modulo Grafici Rifra S r l Modulo Forms PDF Modulo Sorter 3 INVIO PDFCOM 220 1 220 26 1 18 Progr documenti 100668698 F03 Fine FOS Rivisual F13 Licenze F22 Sorter 10 031 Fare riferimento ai paragrafi 3 4 e 3 5 Inserimento delle chiavi di licenza prodotto per tutte le informazioni relative alle licenze di pdfCom 3 3 Avvio del sottosistema PDFCOM Il sottosistema PDFCOM contenuto nella libreria PDFCOM deve essere attivo affinch il prodotto sia operativo Tramite l opzione 6 8 4 del menu principale di pdfCom possibile effettuare l avvio manuale del sottosistema Per evitare di dover effettuare l av
124. iene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio http www pdfcom it Pagina 33 di 150 pdfCom 7 1 Manuale utente I MPORTANTE E da notare che i parametri Nome stampante PC su cui stampare Cartella output documenti Cartella archiviazione copia i parametri di rasterizzazione in TIFF Risoluzione Dithering e Compressione ed i parametri di stampa Stampa sincrona Scala Centra Adatta ad area Risoluzione e Fronte retro sono gerarchici rispetto a quelli specificati al paragrafo 5 2 Configurazione dei parametri di default per il servizio Il paragrafo 7 11 Riepilogo gerarchia dei parametri fornisce una spiegazione completa sulla gerarchia dei parametri Come si vedr nel paragrafo 6 9 Gestione parametri di elaborazione documenti e nel capitolo 7 Gestione dei parametri sul singolo spool tutti i parametri qui specificati potranno a loro volta essere sostituiti Ulteriormente per i parametri Nome stampante PC su cui stampare Override n copie Cartella output documenti e Cartella archiviazione copia possibile effettuare una sostituzione per utente o coda di stampa quest ultima solo se risulta installato il modulo opzionale Sorter fare riferimento ai paragrafi 6 11 e 6 12 Gestione override parametri http www pdfcom it Pagina 34 di 150 6 2 Parametri di invio e mail Nell ambito della configurazione de
125. ile specificare i parametri di elaborazione dei file di spool sulla base del loro tipo modulo Sebbene pdfCom produca normalmente documenti PDF eventualmente rasterizzati in TIFF possibile ottenere anche la produzione di semplici file di testo TXT I parametri di creazione di file TXT sono un piccolo sottoinsieme di quelli di creazione dei PDF e la spiegazione del loro significato la stessa che si trova nel paragrafo 6 1 Parametri generali di creazione dei PDF Tramite il tasto di funzione F6 possibile inserire un tipo modulo per la creazione di documenti PDF TIFF evidenziati in bianco nella lista mentre con il tasto di funzione F7 possibile inserire un tipo modulo per la creazione di documenti TXT evidenziati in verde nella lista Inserendo l opzione I Indicizzazione si accede alla Gestione Indicizzazione per Tipo Modulo il capitolo 13 Indicizzazione documenti affronta l argomento relativo all indicizzazione dei documenti in modo completo ed esaustivo Inserendo l opzione F Field Form si accede alla Gestione Field Form per Tipo Modulo tale argomento trattato nel capitolo 15 Moduli PDF 6 1 Parametri generali di creazione dei PDF I parametri che possibile specificare per un tipo modulo PDF o TIFF sono i seguenti T Inserimento Tipo Modulo PDF 1 220 blank da spool 2 99 blank da spool 1 16 blank da spool 1 360 blank centra 1 360 blank 20 4 72 blank automatico b std DZ A A
126. ina precedente la stringa non fosse vuota e la pagina far parte del documento successivo vedi esempio sotto http www pdfcom it Pagina 61 di 150 pdfCom 7 1 Programma utente Manuale utente Specifica il nome e la libreria del programma utente che pdfCom richiamer nel corso dell elaborazione Il prossimo capitolo 7 in particolare il paragrafo 7 1 Parametri di input output per programma utente fornisce una spiegazione dei parametri di input output previsti Poich viene effettuato un controllo di esistenza dell oggetto il programma deve esistere quando tale parametro viene impostato Supponiamo di avere un file di spool composto da 9 pagine con la stringa referenziata dai parametri Riga Colonna Lunghezza valorizzata nelle varie pagine come segue Pag 1 Stringa 2 3 blank BBB 4 5 CCC blank 6 7 8 9 blank DDD blank EEE Con il parametro Blank Segue Prec lasciato a blank lo spool verr suddiviso in 8 documenti cos strutturati Stringa passata N documento N pagine a PGM utente Contenuto pagine del documento 1 1 AAA AAA 2 1 blank blank 3 1 BBB BBB 4 1 CCC CCC 5 2 blank blank blank 6 1 DDD DDD 7 1 blank blank 8 1 EEE EEE Con il parametro Blank Segue Prec impostato a S lo spool verr suddiviso in 5 documenti cos strutturati Stringa passata N documento N pagine a PGM utente Contenuto
127. ina riga colonna per le quali la Macro Action si applicher Questo un concetto molto simile a quello spiegato nelle Macro Action di Immagine con un PlaceHolder nel path immagine La lunghezza della stringa da trasformare in codice a barre tolti eventuali spazi a sinistra ed a destra invece un valore sempre assoluto ed obbligatorio da specificare L immagine del codice a barre sar inserita nel PDF facendo corrispondere il suo angolo inferiore sinistro con riga colonna specificate nella Macro Action Omissione Specifica se la stringa di testo specificata tramite il parametro Barcode da spool deve essere omessa dallo spool ovvero sostituita con degli spazi vuoti Tipo Barcode Esistono numerosi tipi di codici a barre utilizzabili ognuno con le proprie caratteristiche Alcuni sono a lunghezza fissa altri a lunghezza variabile alcuni permettono di rappresentare unicamente valori numerici altri anche valori alfanumerici La tabella che segue oltre ad elencare i tipi di Barcode supportati fornisce anche una sommaria indicazione delle caratteristiche Tipo Barcode Cod Tipo Num Alfa Lunghezza CheckDigit EAN 13 00 Num 13 si EAN 8 01 Num 8 si UPC A 02 Num 12 si UPC E 03 Num 6 si Code128 04 Alfanum variabile opzionale Code39 05 Alfanum variabile no Interleaved20f5 06 Num variabile x2 opzionale Codabar 07 Num variabile no E da sottolineare che eventuali caratteri di contro
128. installato il modulo opzionale Forms fare riferimento al paragrafo 2 1 Installazione moduli opzionali I Moduli PDF sono documenti PDF che contengono campi field Esistono vari programmi per creare documenti PDF con campi Adobe ad esempio fornisce Adobe LiveCycle Designer normalmente fornito con Adobe Acrobat Professional pdfCom in grado di riempire i campi di tali moduli ed utilizzare Moduli PDF compilati al pari di altri fincati Per fare un esempio applicativo si pensi alla stampa di un contratto ricco di tante parti da compilare Un primo approccio potrebbe essere quello di utilizzare il PDF del contratto vuoto come fincato e creare uno spool ad hoc che vada a stampare nei corretti spazi del contratto Questo richiede quanto meno che le parti da compilare del fincato rispettino tra loro una distanza di riga conforme ad un valore stabilito di LPI linee per pollice e la stessa cosa sarebbe necessaria anche se meno critica per le distanze di colonna Ulteriormente il programma di stampa del contratto dovrebbe prevedere la possibilit di stampare le pagine complete dei dati con una sequenza variabile in base alla struttura dello specifico contratto da produrre es omissione di pagine per servizi non sottoscritti pagine aggiuntive per sottoscrizioni accessorie etc Un altro approccio decisamente pi produttivo potrebbe essere quello di rendere il PDF del contratto vuoto un Modulo PDF a campi Adobe Liv
129. io direttamente dal computer e le stampanti di rete gestite cio da un server remoto Il fatto che una stampante sia fisicamente collegata in rete non indicativo di come essa venga gestita Per sapere se una stampante locale o di rete si deve fare riferimento alla sua icona nella gestione stampanti se presente il contrassegno del link di rete significa che la stampante gestita da un server remoto diversamente gestita localmente Questa precisazione necessaria perch mentre le stampanti locali sono visibili a tutti gli account utenti del computer le stampanti di rete sono SPECIFICHE per account Poich il servizio di pdfCom gira con le credenziali dell account utente che viene configurato come specificato nel paragrafo 5 1 si deve tener conto di quanto detto relativamente alla visibilit delle stampanti Potrebbe infatti verificarsi il caso che l account con il quale si collegati interattivamente sul PC server e dal quale si sta effettuando la configurazione dei parametri di pdfCom non sia lo stesso configurato nel servizio e quindi non veda le medesime stampanti dell utente con il quale il servizio girer A tale proposito il servizio di pdfCom effettua un periodico controllo sulla lista delle stampanti ad esso visibili e la invia al System i in modo che dove possibile specificare il nome di una stampante vi sia a disposizione una comoda funzione di ricerca MEMORIZZAZI ONE PARAMETRI
130. irettamente da una lista dei colori pi comuni Per informazioni sul formato di specifica colore consultare il riquadro relativo alla fine del paragrafo pdfCom 7 1 Manuale utente Colore evidenziato Specifica il colore da utilizzare per evidenziare la parte di testo specificata dalla Macro Action Lasciando il parametro vuoto il testo non verr evidenziato Premendo il tasto di funzione F4 con il cursore posizionato su questo campo possibile scegliere il colore direttamente da una lista dei colori pi comuni Per informazioni sul formato di specifica colore consultare il riquadro alla fine del paragrafo Colore bordo Specifica il colore da utilizzare per disegnare un riquadro intorno alla parte di testo specificata dalla Macro Action Lasciando il parametro vuoto non verr disegnato alcun riquadro Premendo il tasto di funzione F4 con il cursore posizionato su questo campo possibile scegliere il colore direttamente da una lista dei colori pi comuni Per informazioni sul formato di specifica colore consultare il riquadro alla fine del paragrafo Raggio arrotondamento Il valore del raggio per lo smussamento degli angoli relativamente al riquadro intorno al testo e o all evidenziato Specificando un valore compreso tra 1 e 9 gli angoli dei due eventuali elementi grafici saranno smussati proporzionalmente Non specificando questo parametro non verr effettuata alcuna smussatura e gli angoli saranno netti Da notare che po
131. isAxisGridVisible S amp amp 003 isLegendVisible S http www pdfcom it Pagina 131 di 150 pdfCom 7 1 amp amp 003 backgroundFil1 255255255 128128128 45 amp amp 003 labels amp amp 003 pieLabelType 1 amp amp 003 pie 01 label A amp amp 003 pie 01 value 10 amp amp 003 pie 01 displacement 0 amp amp 003 pie 01 pieSliceFil 255255255 255000000 45 amp amp 003 pie 02 label B amp amp 003 pie 02 value 20 amp amp 003 pie 02 displacement 0 amp amp 003 pie 02 pieSliceFil l 255255255 000000255 45 amp amp 003 pie 03 label C amp amp 003 pie 03 value 20 amp amp 003 pie 03 displacement 0 amp amp 003 pie 03 pieSliceFill 000255000 amp amp 003 pie 04 label D amp amp 003 pie 04 value 25 amp amp 003 pie 04 displacement 0 1 amp amp 003 pie 04 pieSliceFill 255255255 120120120 45 amp amp 003 pie 05 1label E amp amp 003 pie 05 value 55 amp amp 003 pie 05 displacement 0 12 amp amp 003 pie 05 pieSliceFil l 255255255 000000000 45 Manuale utente Il grafico sar creato di dimensioni pari a circa 10 6 x 10 6 cm 300 72 pollici con una risoluzione di 200 dpi http www pdfcom it Pagina 132 di 150 pdfCom 7 1 Manuale utente 15 Moduli PDF modulo opzionale Forms Le funzionalit relative ai Moduli PDF PDF Forms sono disponibili solo se risulta
132. ito dinamicamente dal contenuto dello spool Nelle Macro Action di Codice a Barre invece quello che viene reperito dallo spool il valore da trasformare in codice a barre Ogni Macro Action di Codice a Barre composta dai seguenti parametri 2151 Da Modifica Macro per Codice a Barre FATTURE x b1Kk n iQ 12 S Code128 5 300 blank default 80 500 blank default 1 220 1 999 blank riga o testo 1 99 blank ricerca testo i SPIRI TOTI a Ae STA pria beai kca aTi bawa i e Barcode 001 050 051 100 101 150 151 200 F12 Precedente 037 028 Numero sequenza Il numero di sequenza determina l ordine con il quale verranno applicate le Macro Action di Codice a Barre Si deve tenere presente che per una stessa combinazione di pagina riga colonna pu essere applicata complessivamente tra Immagine Stile Codice a Barre e Grafico una sola Macro Action Quindi in caso di sovrapposizione avr precedenza la Macro Action con numero di sequenza minore tenendo tuttavia presente che verranno applicate per prime le Macro Action di Codice a Barre poi quelle di Immagine successivamente quelle di Stile ed infine quelle di Grafico Barcode da spool Il riferimento al contenuto dello spool da trasformare in codice a barre Questo parametro diviso in 4 sottocampi ppp rr ccc e Ill che rappresentano rispettivamente pagina riga colonna e lunghezza della stringa dello spool da trasformare in codice a barre Relativa
133. iva al singolo documento E da notare che se si desidera specificare una regola di fincato diversa per pagina 1 quando la prima non l unica quella con il valore speciale O andr inserita a numero di sequenza pi alto rispetto a quella per pagina 1 Questo perch diversamente per la prima pagina sarebbe sempre valida la regola per pagina 1 Riga Colonna Specificare rispettivamente a che riga e colonna estrapolare una stringa da ogni pagina dello spool da confrontare con quella specificata nel parametro Testo la corrispondenza determiner la validit della regola E quindi evidente che pi pagine possono essere interessate da una regola specificata in questo modo Omissione Specifica se al verificarsi della validit della regola di confronto la stringa dello spool specificata tramite i parametri riga colonna per la lunghezza del testo specificato deve essere sostituita con degli spazi vuoti Questo parametro risulta particolarmente utile se si decide di stampare sullo spool ad una determinata posizione una stringa appositamente aggiunta per soddisfare una regola di fincato multiplo http www pdfcom it Pagina 42 di 150 Testo La stringa di testo tramite la quale effettuare il confronto con la stringa dello spool specificata tramite i parametri Riga e Colonna La lunghezza del testo specificato indicher la lunghezza per la quale effettuare il confronto nonch l eventuale omissione Gli spazi vuoti sar
134. l Se si prevede di far elaborare a pdfCom file di spool di grandi dimensioni o massicce quantit di stampe in modo consecutivo sulla solita istanza consigliabile impostare questo parametro ad S in modo da rendere possibile l elaborazione di eventuali altri documenti urgenti Avvio manuale Indica se l istanza prevede un avvio manuale Specificando S l istanza non sar avviata automaticamente alla partenza del sottosistema PDFCOM e risulter evidenziata in rosso nella lista della Gestione istanze Le istanze ad avvio manuale sono utilizzabili esclusivamente tramite il comando PDFCOMII Istanza interattiva I MPORTANTE Effettuando il comando WRKACTJOB Visualizzazione dei lavori attivi le istanze saranno visibili come lavori all interno del sottosistema PDFCOM Nel caso in cui non sia attiva la gestione priorit presente un lavoro per ogni istanza il cui nome corrisponde al nome della coda di stampa monitorata Diversamente se attiva la gestione priorit sono presenti tre lavori per ogni istanza con i seguenti nomi PDFC_nnnnH PDFC_nnnnD PDFC_nnnnL dove nnnn il numero di sequenza dell istanza In ogni caso sono presenti anche due lavori denominati PDFCOM_A e PDFCOM_M Ulteriormente possono essere presenti altri lavori denominati PDFCOM_S_L e PDFCOM_S_I che sono funzionali al prodotto http www pdfcom it Pagina 9 di 150 3 2 Impostazione dei parametri generali Tr
135. l Gestione Istanze pdfCom 0000 Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Inserisci R 0pzioni report P 0pzioni pulizia O_NSe Cartella IFS Coda MSp Pta R P 0010 MEDICA 0020 PDFCOM 0030 PDFCOM3 0040 PDFCOMSP 0050 PDFCOMPT 0060 0070 PDFCOMX F03 Fine FO6 Inserisci Ogni voce che verr inserita rappresenta un istanza di pdfCom e necessita di almeno un PC server che la gestisca Per il corretto funzionamento del prodotto indispensabile inserire almeno un istanza Tramite le opzioni R Opzioni report automatico e P Opzioni pulizia automatica si accede alla configurazione delle funzioni di manutenzione per una specifica istanza Fare riferimento al capitolo 11 Manutenzione per una spiegazione dettagliata di tali funzioni Per ogni voce possibile specificare i seguenti parametri User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r 1 Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Inserisci R 0Opzioni report P 0pzioni pulizia 0 NSe Cartella IFS Coda MSp Pta R P 0010 MEDICA Inserimento Istanza 9999 xNONE F12 Precedente Numero sequenza Il numero di sequenza un semplice indice che determina l ordine con il quale le istanze verranno immesse in batch nel sottosistema PDFCOM Cartella IFS La cartella dell IFS che conterr i file di spool convertiti semilavorati pronti per essere presi in carico dal PC server che gestisce l ista
136. l 200200200 amp amp 001 curve 01 onY2Axis amp amp 001 curve 02 label Beta amp amp 001 curve 02 x 5 5 10 15 20 25 amp amp 001 curve 02 x 30 35 40 45 50 c G 01 01 01 01 amp amp 001 curve 02 y 5 3 3 5 2 2 1 4 4 5 amp amp 001 curve 02 lineColor 000000255 amp amp 001 curve 02 pointFill 200200200 amp amp 001 curve 02 onY2Axis amp amp 001 curve 03 label Gamma amp amp 001 curve 03 x 5 10 15 20 25 30 35 40 45 50 amp amp 001 curve 03 y 10 20 30 40 50 60 50 40 30 20 amp amp 001 curve 03 lineColor 000255000 amp amp 001 curve 03 pointFill 200200200 amp amp 001 curve 03 onY2Axis S Il grafico sar creato di dimensioni pari a circa 10 6 x 10 6 cm 300 72 pollici con una risoluzione di 200 dpi http www pdfcom it Pagina 124 di 150 pdfCom 7 1 Manuale utente 14 4 Parametri dei grafici a Barre codice grafico 01 Quella che segue la tabella dei nomi parametri relativi ad un grafico a Barre codice del tipo di grafico 01 Nome parametro Tipo g amp nnn imgWidth NUM g amp nnn imgHeight NUM amp nnn imgDPI NUM g amp nnn gTitle ALFA g amp nnn xTitle ALFA g amp nnn yTitle ALFA g amp nnn y2Title ALFA amp amp nnn isAxisGridVisible BOOL amp amp nnn isLegendVisible BOOL amp amp nnn backgroundFill FILL g amp nnn labels ALFA x amp nnn barStack BOOL amp n
137. l a cui inviare una copia Tale indirizzo non sar visibile nella mail al destinatario ed al destinatario in copia Corpo e mail Il corpo della mail E da sottolineare che pdfCom invia i documenti PDF TXT o TIFF come allegati E possibile specificare fino a 10 righe per il corpo della mail come presentazione dell allegato
138. l che vengono prodotti o indirizzati su tali code Tramite l opzione 2 del menu Sorter si accede alla gestione delle Code monitorate 21 51 RI User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r l Gestione Code monitorate Opzioni i Inserisci 4 Cancella 8 Dissocia 9 Associa 0 Coda Libreria Descrizione QPRINT QGPL SPIOUTQ SPI MAI a MU 127 009 Da qui possibile specificare quali code di stampa dovranno essere monitorate dallo smistatore di pdfCom E da notare che possibile specificare solo code gi esistenti e non possibile specificare code di istanza di pdfCom fare riferimento al paragrafo 3 1 Impostazione istanze di pdfCom Quando si aggiunge una coda di stampa al monitor pdfCom provveder automaticamente a modificare tale coda associandogli una coda dati Affinch l operazione vada a buon fine necessario che l utente che esegue tale operazione sia autorizzato ad effettuare la modifica sull oggetto coda di stampa di tipo OUTQ Nel caso in cui la coda dati non venga correttamente associata la coda di stampa sar evidenziata in rosso nella lista Tramite l opzione 9 Associa possibile tentare nuovamente l associazione della coda dati alla coda di stampa L opzione 8 Dissocia permette invece di dissociare volutamente la coda dati dalla coda di stampa in tal modo tutte le stampe che verranno prodotte o indirizzate su tale coda non saranno pi analizzate e quindi
139. l file di spool una stringa contenente i nomi dei parametri che si desidera variare o impostare ed il loro nuovo valore Ulteriormente o in alternativa possibile preparare un programma utente su System i che avr a disposizione oltre ad una stringa di testo estratta dallo spool come visto nel precedente paragrafo 6 9 anche tutta una serie di informazioni sullo spool stesso compreso il suo Tipo Modulo ed avr la possibilit di impostare nel parametro USERDATA una stringa di parametri con lo stesso formato del campo Dati definiti dall utente dello spool Altra interessante possibilit per fornire parametri a pdfCom consiste nello stamparli direttamente all interno del file di spool tramite il proprio applicativo pdfCom utilizzer tali parametri e li ometter automaticamente dal documento finale fare riferimento al paragrafo 7 10 Blocco parametri embedded nel file di spool Infine se si utilizzano le API di pdfCom descritte al capitolo 12 pdfCom Application Programming Interface possibile utilizzare anche l array dati utente per fornire direttamente i parametri di elaborazione fare riferimento al paragrafo 12 3 Dettagli sull utilizzo dell array dati utente Il paragrafo 7 11 Riepilogo gerarchia dei parametri fornisce una spiegazione completa sulla gerarchia dei parametri 7 1 Parametri di input output per programma utente Nella libreria PDFCOM nel file QRPGLESRC presente un sorgente ILE RPG denominat
140. la gestione dei tipi modulo pdfCom offre due possibilit il campo Dati definiti dall utente USRDFNDTA del file di spool e o l utilizzo di un programma utente Il prossimo capitolo 7 affronta l argomento in modo dettagliato comunque nel corso di questo paragrafo verr introdotto meglio il concetto di programma utente Con il tasto di funzione F16 El doc dalla gestione visualizzazione di un tipo modulo si accede alla Gestione elaborazione documenti per tipo modulo T Gi Modifica Tipo Modulo PDF E mail FATTURA Finc mult Gestione elaborazione documenti FATTURA 1 99 1 220 1 221 Colonna 78 o S 1 999 blan 785 ZS7P blank nessuno Nome LIBL FOQ4 Elimina F12 Precedente pdfCom 7 1 Manuale utente Riga Colonna Lunghezza Indicano rispettivamente la riga la colonna e la lunghezza di una stringa di testo dello spool che pdfCom utilizzer per effettuare un eventuale rottura dello stesso in pi documenti parametro Rottura valorizzato ad S vedi pi avanti nel corso di questo paragrafo e o da passare ad un programma utente Omissione Specifica se la stringa di testo referenziata dai parametri Riga Colonna Lunghezza deve essere omessa dallo spool ovvero deve essere sostituita con degli spazi vuoti Questo parametro risulta particolarmente utile se si decide di stampare sullo spool ad una determinata posizione una stringa appositamente aggiunta ai soli fini della elaborazione del
141. la produzione del documento PDF TXT o TIFF da parte del PC server abbia prodotto errori non bloccanti con codice errore minore o uguale a 7 vedi paragrafo 9 1 Dettagli sui file IFS pdfCom 7 1 Manuale utente di pdfCom Poich viene effettuato un controllo di esistenza dell oggetto il programma deve esistere quando tale parametro viene impostato EXIT A stato W gt 07 Specifica la libreria ed il nome del programma EXIT di tipo A che pdfCom richiamer nel caso in cui la produzione del documento PDF TXT o TIFF da parte del PC server abbia prodotto errori non bloccanti con codice errore maggiore di 7 vedi paragrafo 9 1 Dettagli sui file IFS di pdfCom Poich viene effettuato un controllo di esistenza dell oggetto il programma deve esistere quando tale parametro viene impostato EXIT A stato KO Specifica la libreria ed il nome del programma EXIT di tipo A che pdfCom richiamer nel caso in cui la produzione del documento PDF TXT o TIFF da parte del PC server abbia prodotto errori bloccanti vedi paragrafo 9 1 Dettagli sui file IFS di pdfCom Poich viene effettuato un controllo di esistenza dell oggetto il programma deve esistere quando tale parametro viene impostato http www pdfcom it Pagina 65 di 150 6 11 Gestione override parametri per Utente Come gi accennato nel paragrafo 6 1 Parametri generali di creazione dei PDF per alcuni parametri specifici possibile effettuare una sostituzione per utente T
142. le ColoreEvidenziato rappresenta il colore da utilizzare per evidenziare il testo Il formato di specifica quello previsto per il corrispondente parametro descritto nel paragrafo 6 6 Macro Action di Stile ColoreBordo rappresenta il colore da utilizzare per disegnare un riquadro intorno al testo Il formato di specifica quello previsto per il corrispondente parametro descritto nel paragrafo 6 6 Macro Action di Stile RaggioArrotondamento specifica il valore del raggio per lo smussamento degli angoli relativamente al riquadro intorno al testo e o all evidenziato fare riferimento al paragrafo 6 6 per ulteriori spiegazioni PercentualeCrescita specifica la percentuale di cui deve essere ingrandito il riquadro intorno al testo e o l evidenziato fare riferimento al paragrafo 6 6 per ulteriori spiegazioni Il carattere H specifica che il testo deve essere nascosto fare riferimento al paragrafo 6 6 per ulteriori spiegazioni OffsetX relativo specifica lo spostamento sull asse X del testo E possibile inserire valori secondo due diverse unit esclusive tra loro numero di caratteri colonne oppure punti espressi in 72esimi di pollice 1 72 0 3528 mm Nel primo caso possibile utilizzare valori con una cifra decimale es 12 5 colonne mentre nel secondo caso possibile utilizzare fino a due cifre decimali arrivando alla precisione di 1 7200 3 528 um Il segno obbligatorio specifica la direzione di spostam
143. le di spool La sintassi per specificare direttamente i metadati per l indicizzazione la seguente MetaTag Valore E importante non inserire spazi almeno che non facciano parte di una stringa MetaTag oppure Valore e terminare separare sempre con il carattere punto e virgola L ordine dei metadati specificati irrilevante e possono tranquillamente essere mischiati con altri parametri eventualmente presenti in questi campi fare riferimento al paragrafo 7 2 Sintassi di specifica diretta dei parametri di elaborazione Se i metadati vengono specificati nel campo USRDFNDTA di un file di spool lunghezza massima di 255 caratteri oppure nel campo USERDATA del programma utente lunghezza massima di 2048 caratteri devono essere concatenati l uno all altro senza spazi separati da punto e virgola Se i metadati vengono specificati nel blocco parametri embedded nel file di spool oppure nell array dati utente API 1 necessario specificare rispettivamente un solo metadato per riga oppure un solo metadato per elemento Per maggiori informazioni fare riferimento al paragrafo 7 10 Blocco parametri embedded nel file di spool e 12 3 Dettagli sull utilizzo dell array dati utente Nel caso in cui la stringa Valore sia relativa ad un metadato di tipo numerico possibile utilizzare indifferentemente il carattere virgola o punto come separatore dei decimali ed il segno pu essere specificato indiffer
144. le di spool 4 caratteri fissi bbbbbb il numero progressivo di rottura del file di spool 6 caratteri fissi yyyyyyyyyy il nome utente System i 10 caratteri massimi e cccccc il numero del lavoro System i 6 caratteri fissi E da notare che tale convenzione fa si che uno stesso file di spool elaborato da pdfCom produca un file sempre con il solito nome Specificando il valore speciale RANDnn dove nn un numero compreso tra 10 e 99 il nome del file sar determinato da pdfCom utilizzando una stringa completamente casuale composta da lettere maiuscole minuscole e numeri della lunghezza nn specificata http www pdfcom it Pagina 29 di 150 pdfCom 7 1 Manuale utente Fincato L eventuale nome del fincato completo di percorso Il fincato deve essere un file PDF possibilmente composto da una sola pagina diversamente sar utilizzata comunque la prima e deve essere specificato completo del suo percorso E da notare che il percorso deve essere funzionale al servizio che gira sul PC server che lo utilizzer per trovare il file ovvero deve essere specificato cos come lo vede quel determinato PC server E possibile utilizzare nomi UNC ed altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Il parametro opzionale se non specificato non verr effettuata alcuna fincatura ID Form solo
145. lla archiviazione copia Il percorso completo della cartella nella quale verranno ulteriormente copiati i documenti prodotti Il percorso specificato deve essere funzionale al PC server che lo utilizzer ed possibile specificare percorsi locali dal punto di vista del PC server o percorsi di rete con nomi UNC purch raggiungibili dal PC server E altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Se non viene specificato alcun percorso il parametro risulter non impostato e verr utilizzata la cartella di archiviazione specificata nella gestione dei tipi modulo fare riferimento al paragrafo 6 1 Parametri generali di creazione dei PDF E da notare che se viene specificato il valore speciale TEMP in Cartella output documenti non sar possibile specificare alcun valore per questo parametro Mittente e mail Indirizzo e mail che sar indicato come mittente E da notare che questo parametro sar utilizzato solo nel caso in cui sia effettivamente previsto l invio tramite e mail del documento prodotto Nome mittente e mail Nome che apparir come mittente E da notare che questo parametro sar utilizzato solo nel caso in cui sia effettivamente previsto l invio tramite e mail del documento prodotto http www pdfcom it Pagina 71 di 150 6 13 Gestione variabili di Path Come gi accenn
146. llo CheckDigit se previsti devono essere gi presenti nella stringa origine referenziata dal parametro Barcode da spool e non saranno n controllati n ricalcolati Premendo il tasto di funzione F4 con il cursore posizionato su questo campo possibile scegliere il tipo di codice a barre da una lista dei tipi supportati Altezza Barcode L altezza espressa in 72esimi di pollice 1 72 0 3528 mm del codice a barre Questo parametro facoltativo se non viene specificato verr utilizzata l altezza di default http www pdfcom it Pagina 55 di 150 pdfCom 7 1 Manuale utente Larghezza m barra La larghezza della barra pi piccola espressa in centesimi di 72esimi di pollice 1 72 0 3528 mm Questo parametro facoltativo se non viene specificato verr utilizzato il valore di default pari a 80 centesimi Colonna Questo valore specifica la colonna dello spool alla quale viene applicata la Macro Action Tale parametro obbligatorio E da sottolineare che l applicazione di una Macro Action pu anche essere condizionata al verificarsi della condizione data dalla presenza o meno di una determinata stringa di testo nello spool In quest ultimo caso il valore Colonna assume due significati contemporaneamente rappresenta sia il punto in cui viene inserita eventualmente l immagine sia il punto in cui iniziare il controllo del testo specificato Numero Pagina Indica il numero di pagina dello spool relativ
147. lo Seguendo le regole di gerarchia se un tipo modulo avr specificato un programma EXIT di tipo B differente quest ultimo avr la precedenza e sar quello effettivamente richiamato Tramite l opzione 6 8 1 del menu principale di pdfCom si accede alla Gestione parametri generali User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r l Gestione parametri generali 1 65535 fhome pdfCom no reply eri franet it Rifra S r l Courier New LIB PGM PDECOM F4 PDECOM F4 220 1 220 2 1 16 Progr documenti 100668758 F03 Fine FOS Rivisual F13 Licenze F22 Sorter Impostando il parametro Programma EXIT B con libreria e nome del proprio programma questo sar richiamato automaticamente per tutti i tipi modulo a meno che su un dato tipo modulo non sia specificato un programma EXIT di tipo B differente pdfCom 7 1 Manuale utente 8 1 Parametri di input output per programma EXI T B I programmi EXIT di tipo B saranno richiamati da pdfCom dopo aver creato il file contenente lo spool oppure parte di esso in caso di rottura con tutti i parametri in testa prima che questo venga trasferito sulla cartella dell IFS ed elaborato successivamente dal PC server per la creazione vera e propria del documento PDF TXT o TIFF Avranno a disposizione Parametri in ingresso File di database contenente il documento completo con in testa tutti i parametri di elaborazione Nella libreria PDFCOM
148. lo sco Configurazione pdfCom PC server e Parametri generali System i Meno significativo In questo schema non compaiono volutamente i programmi EXIT B Come si vedr nel prossimo capitolo 8 tramite i programmi EXIT B possibile intervenire a basso livello magari direttamente sul file che pdfCom andr ad elaborare prescindendo quindi completamente da quello che il concetto di gerarchia dei parametri http www pdfcom it Pagina 83 di 150 8 Gestione avanzata tramite programmi EXIT Come ulteriore risorsa per adattare pdfCom alle proprie esigenze esiste la possibilit di implementare programmi EXIT su System i Esistono due tipologie distinte di programmi EXIT denominate B Before ed A After Eventuali programmi EXIT di tipo B saranno richiamati da pdfCom dopo aver creato il file contenente lo spool oppure parte di esso in caso di rottura con tutti i parametri in testa prima che questo venga trasferito sulla cartella dell IFS ed elaborato successivamente dal PC server per la creazione vera e propria del documento PDF TXT o TIFF Eventuali programmi EXIT di tipo A saranno richiamati da pdfCom dopo che il PC server avr creato fisicamente il documento Come gi visto nel paragrafo 6 10 Parametri di configurazione programmi EXIT possibile specificare per tipo modulo i vari programmi EXIT da richiamare Unicamente per il tipo B possibile specificare un programma EXIT da richiamare per tutti i tipi modu
149. ma EXIT di tipo A per stato W gt 07 da API 1 non trovato 91 Programma EXIT di tipo B ha restituito il parametro RTNCD lt gt blank 92 Errore reperimento ultimo spool del job 93 Modalit Spool Less senza array dati utente o senza Override Tipo Modulo o senza Numero Righe 94 Identificativo dello spool da elaborare incompleto 95 Sottosistema PDFCOM non attivo 96 Librerie QTEMP PDFCOM non presenti in lista o in ordine non corretto 97 Errore di elaborazione interna 98 Timeout elaborazione 99 Errore servizio file KO Un codice di errore minore di 70 considerato non bloccante e significa che il documento stato comunque prodotto eventualmente in un path diverso se impostato il parametro Documenti con errori in cartella fare riferimento al paragrafo 5 2 Configurazione dei parametri di default per il servizio CODI FICA ERRORI NON BLOCCANTI I codici di errore non bloccanti minore di 70 hanno una codifica binaria in modo da essere facilmente interpretabili da un programma che effettua la chiamata alla API 1 di pdfCom oike al aL Fincato default non trovato bit 2 2 Errore su fincato multiplo bit 3 4 Fallito inserimento Macro bit 4 8 N A bit 5 16 N A bit 6 32 N A http www pdfcom it Pagina 109 di 150 pdfCom 7 1 Manuale utente 12 3 Dettagli sull utilizzo dell array dati utente UserDtaA Come accennato nel precedente paragrafo 12 1
150. mente ai parametri ppp ed rr previsto anche un flag indicato con che pu assumere il valore il valore o restare vuoto pdfCom 7 1 Manuale utente Per capire in dettaglio la logica di funzionamento necessario focalizzare bene il concetto che una Macro Action di Codice a Barre pu essere applicata o meno al verificarsi di una condizione oppure essere applicata sempre comunque in base ai parametri specificati di Colonna Numero Pagina Riga e Testo dettagliati in seguito Saranno proprio tali parametri a determinare un insieme di valori di pagina riga e colonna per i quali la Macro Action viene applicata Detto questo i valori di pagina e o riga e o colonna all interno del parametro Barcode da spool possono essere lasciati a zero ed assumeranno dinamicamente il valore di pagina riga o colonna per i quali la Macro Action viene applicata Ulteriormente specificando un valore o nel flag di pagina e riga possibile specificare un offset rispettivamente positivo o negativo per determinare il valore di pagina e o riga della stringa da trasformare in Barcode Detto in altre parole poich la Macro Action pu essere dinamica ovvero venir applicata in presenza di un determinato testo ad una determinata colonna a prescindere dalla pagina o genericamente per tutte le righe di una pagina anche il puntamento alla stringa dello spool da trasformare in barcode pu essere astratto e quindi legato a pag
151. mente alla curva pp i colore della curva sul grafico curve pp pointFill Relativamente alla curva pp il riempimento dei punti che rappresentano il valore X Y curve pp onY2Axis Relativamente alla curva pp indica se i suoi valori devono essere rappresentati sull asse Y2 quello di destra http www pdfcom it Pagina 122 di 150 pdfCom 7 1 Manuale utente 14 3 Esempio di grafico a Curve Nel precedente paragrafo abbiamo visto tutti i parametri che possibile specificare per un grafico a Curve Per fare un esempio di utilizzo pratico supponiamo di voler realizzare il seguente grafico Prova grafico 00 Curve Alpha Gamma N gt 2 o H 30 Titolo X Supponendo che l ID numerico del grafico sia 001 necessario specificare i seguenti parametri di Graph Set amp amp 001 imgWidth 300 amp amp 001 imgHeight 300 amp amp 001 imgDPI 200 amp amp 001 gTitle Prova grafico 00 Curve amp amp 001 xTitle Titolo X amp amp 001 yTitle Titolo Y amp amp 001 y2Title Titolo Y2 amp amp 001 isAxisGridVisible S amp amp 001 isLegendVisible S http www pdfcom it Pagina 123 di 150 pdfCom 7 1 Manuale utente amp amp 001 backgroundFil1 255255255 128128128 45 amp amp 001 labels amp amp 001 curv amp amp 001 curv label Alpha L1 x 5 10 15 20 25 30 35 40 45 50 amp amp 001 curv l y 1 2 3 4 5 4 3 2 1 2 amp amp 001 curv lineColor 255000000 amp amp 001 curve 01 pointFil
152. milavorato e prescinde dall utilizzo o meno della API 1 che rende il processo di produzione del PDF sincrono fare riferimento al paragrafo 12 1 pdfCom API 1 Elaborazione real time Il nome del file IFS parametro FileIFS presente nei parametri di entrambe le tipologie di EXIT l unico legame tra la pre produzione EXIT di tipo B e la post produzione EXIT di tipo A del documento http www pdfcom it Pagina 90 di 150 9 Pannello di Controllo su System i pdfCom comprende un utile strumento di monitoraggio adatto a tenere sotto controllo lo stato dei documenti file IFS elaborati o in fase di elaborazione nonch lo stato dei server per ciascuna istanza Tramite l opzione 2 del menu principale si accede al Pannello di Controllo pdfCom 2851 R Pannello di Controllo pdfCom User SPI Opzioni 1 Gest ToDo 2 Gest Hold 3 Gest Warn 4 Gest Err 5 Gest xALL 6 Gest coda 8 Monitor 9 Log PC server O Cartella IFS ToDo Send OK Hold NEIM Err Coda stampa 130 44 3 F03 Fine FO5 Aggiorna 08 007 Per ogni istanza di pdfCom vedi paragrafo 3 1 Impostazione istanze di pdfCom viene visualizzato un riepilogo dello stato dei documenti in termini di file ToDo da elaborare ovvero in attesa di essere processati dal PC server Send Mail accodata da inviare o in fase di invio OK elaborati correttamente Hold congelati dall utente Warn elaborati ma con errori non bloccanti ed Err elaborati ma con e
153. mp 005 d fincati fincato2 pdf 1 amp amp 0050ffsetY 25 amp amp 006 d fincati fincato2 pdf 2 1 3 MACRO amp amp I 001 25 015 050 080 d immagini immaginel jpg amp amp S 001 32 001 080 ARIALBI TTF 12 U amp amp B 001 45 010 080 000 8010421000543 01 amp amp I 002 02 119 d immagini immagine2 bmp amp amp S 003 D1 060 010 COURBD TTF 255255000 5 amp amp B 004 02 10 ARTO1 06 GRAPH amp amp G 002 34 011 00 001 amp amp G 004 50 005 02 002 amp amp 001 imgWidth 288 amp amp 001 imgHeight 288 amp amp 001 imgDPI 200 amp amp 001 gTitle Prova grafico 00 Curve amp amp 001 xTitle Titolo X amp amp 001 yTitle Titolo Y amp amp 001 y2Title Titolo Y2 amp amp 001 isAxisGridVisible S amp amp 001 isLegendVisib le S amp amp 001 backgroundFill 255255255 128128128 45 amp amp 001 labels amp amp 001 curve 01 labe l Alpha amp amp 001 curve 01 x 5 LO 15 20 25 30 39 40 45 50 amp amp 001 gt ceurve 01 v 1 2 3 4 5 4 3 5251 47 amp amp 001 curve 01 lineColor 255000000 amp amp 002 imgWidth 180 FORMS amp amp C d fincati fincatol pdf 001 amp amp C d fincati fincato3 pdf 002 amp amp 001 fRagSoc Ente Livornese Cassa amp amp 001 fIndiri Via G March 14 b amp amp 002 fImporto EUR 47 500 riga 1 pagina 1 del file di spool http www pd
154. mpa quest ultima solo se risulta installato il modulo opzionale Sorter Destinatario Indirizzo e mail del destinatario A meno di non utilizzare PlaceHolder vedi pi avanti nel corso di questo paragrafo specificare un indirizzo e mail in questa fase pu aver senso solo se tutti gli spool con un determinato tipo modulo devono essere inviati sempre allo stesso destinatario Diversamente il destinatario potr essere specificato direttamente nel file di spool pdfCom 7 1 Manuale utente vedi capitolo 7 Gestione dei parametri sul singolo spool o tramite un programma utente vedi paragrafo 6 9 Gestione parametri di elaborazione documenti Premendo il tasto di funzione F23 Dest agg si accede ad una videata dove possibile specificare fino a 9 destinatari aggiuntivi Copia conoscenza Indirizzo e mail a cui inviare una copia Tale indirizzo sar visibile nella mail al destinatario Copia conoscenza nascosta Indirizzo e mail a cui inviare una copia Tale indirizzo non sar visibile nella mail al destinatario ed al destinatario in copia Oggetto L oggetto della mail Formato e mail Il formato da utilizzare per il corpo dell e mail Specificare T per inviare e mail con il corpo in formato testo oppure H per il formato HTML Senza allegato Se la mail da inviare non dovr avere allegato il documento PDF TXT o TIFF generato Specificando S la mail sar inviata senza nessun allegato Utile per invia
155. mpo sar il risultato della modifica ad essere utilizzato ai fini dell elaborazione Per la sintassi di specifica dei parametri in questo campo fare riferimento al paragrafo 7 2 Sintassi di specifica diretta dei parametri di elaborazione OvrTMod OPZIONALE Tramite questo parametro possibile specificare un override del tipo modulo Quando viene richiamata la API 1 per elaborare un file di spool analogamente a quanto accade quando una stampa viene indirizzata su una coda di pdfCom il suo tipo modulo determiner tutti i parametri e regole per la creazione del documento PDF TXT o TIFF compreso il nome nonch la cartella di output E possibile passare direttamente alla API 1 il Tipo Modulo da utilizzare in sostituzione di quello del file di spool E possibile specificare il valore speciale SAME per utilizzare il Tipo Modulo del file di spool utile in caso si renda necessario dover specificare obbligatoriamente questo parametro solo perch si desidera specificare i successivi opzionali E altres possibile specificare il valore speciale NONE per fare in modo che non venga utilizzato nessun tipo modulo specificato in tabella utile in caso sia presente la voce DEFAULT nella tabella dei Tipi Modulo ma non si desideri utilizzarla UserDtaAN SUserDtaAP OPZIONALI Tramite questi parametri possibile specificare un array di dati utente UserDtaA Questi parametri opzionali sono da specificare o
156. n file di spool http www pdfcom it Pagina 140 di 150 Premendo il tasto di funzione F23 Contenuto si accede alla videata che permette di specificare fino a tre criteri di selezione basati sul contenuto Inserimento Regola di Smistamento ___ 1 999 1 99 ___ 1 220 ___ 1 200 Mana ne 001 050 051 100 101 150 151 200 1 200 001 050 051 100 101 150 151 200 1 200 IG 001 050 051 100 101 150 151 200 05 014 Pag Riga Col Lun Specificano rispettivamente la pagina la riga la colonna e la lunghezza di una stringa di testo che verr estratta dallo spool e confrontata con la stringa specificata nel parametro Testo Testo Specifica una stringa di testo che verr utilizzata per il confronto con la stringa di testo estratta dallo spool E da notare che la lunghezza della stringa deve essere minore o uguale a quella specificata nel parametro Lun nel caso in cui la lunghezza della stringa sia minore saranno utilizzati spazi vuoti fino al raggiungimento della lunghezza specificata nel parametro e quindi nello spool dovranno esserci effettivamente spazi vuoti Il test sar dipendente dalle maiuscole minuscole ovvero case sensitive 16 2 Gestione Code monitorate Le funzionalit di smistamento automatico si basano sul monitoraggio di una o pi code di stampa del System i ed analizzano sulla base delle regole di smistamento descritte tutti i file di spoo
157. n per Codice a Barre I parametri evidenziati in rosso nella tabella nomi parametri del paragrafo 7 2 sono relativi alle Macro Action di Codice a Barre A prescindere dalle regole specificate per un Tipo modulo vedi paragrafo 6 7 Macro Action di Codice a Barre possibile inserire un codice a barre ad una determinata pagina riga colonna specificandone opzionalmente l altezza A tale scopo sufficiente specificare uno o pi parametri di codice a barre separati terminati AZZ sempre con il carattere punto e virgola con la seguente struttura amp amp B ppp rr cccrwww hhh ValoreBarcode TipoBarcode dove ppp rr e ccc rappresentano rispettivamente il numero di pagina riga e colonna da specificare obbligatoriamente e composti rispettivamente di 3 2 e 3 cifre www e hhh rappresentano rispettivamente la larghezza minima barra ed l altezza del codice a barre e sono opzionali evidenziati in grigio Se vengono specificati devono essere entrambi presenti e composti obbligatoriamente di 3 cifre che esprimono rispettivamente la larghezza minima delle barre del codice in centesimi di 72esimi di pollice e l altezza del codice a barre in 72esimi di pollice comunque possibile specificare il valore zero che equivale a non specificare alcun valore in tal caso sar assunto quello di default fare riferimento al paragrafo 6 7 per ulteriori spiegazioni ValoreBarcode la stringa numerica o alfanumerica che deve ess
158. n unico metadato relativo al timestamp di approvazione Riga Espates E E sie catena adire eterna 05 Data approvazione 12 05 2009 06 Ora approvazione 13 54 http www pdfcom it Pagina 117 di 150 pdfCom 7 1 Manuale utente Il campo Valore sar valorizzato con due PlaceHolder in questo modo lt 001 05 020 010 N gt lt 001 06 020 005 N gt lunghezza 15 Il campo Maschera D O T sar valorizzato in questo modo GG MM AAAAhh mm lunghezza 15 E da notare che i caratteri e possono essere scritti sulla maschera solo ai fini di una maggiore leggibilit ma sono assolutamente irrilevanti poich solo la posizione di GG MM AAAA hh e mm che viene presa in considerazione Come risultato il valore del metadato ai fini dell indice sar un timestamp con il seguente valore 2009 05 12 13 54 00 000000 Come si pu notare i secondi non presenti nella maschera saranno assunti a 00 ovvero al valore di default 13 3 Indicizzazione tramite parametri Analogamente a quanto avviene per i parametri di elaborazione fare riferimento al capitolo 7 Gestione dei parametri sul singolo spool anche i metadati per l indicizzazione si possono fornire a pdfCom tramite l utilizzo del campo USRDFNDTA del file di spool tramite il parametro denominato USERDATA del programma utente e o della API 1 tramite l array dati utente della API 1 e tramite il blocco parametri embedded nel fi
159. na stessa combinazione di pagina riga colonna pu essere applicata complessivamente tra Immagine Stile Codice a Barre e Grafico una sola Macro Action Quindi in caso di sovrapposizione avr precedenza la Macro Action con numero di sequenza minore tenendo tuttavia presente che verranno applicate per prime le Macro Action di Codice a Barre poi quelle di Immagine successivamente quelle di Stile ed infine quelle di Grafico pdfCom 7 1 Manuale utente Inserimento macro Il riferimento al contenuto dello spool al quale applicare la macro di stile Questo parametro diviso in 4 sottocampi ppp rr ccc e Ill che rappresentano rispettivamente pagina riga colonna e lunghezza della stringa dello spool al quale applicare lo stile Relativamente ai parametri ppp ed rr previsto anche un flag indicato con che pu assumere il valore il valore o restare vuoto Per capire in dettaglio la logica di funzionamento necessario focalizzare bene il concetto che una Macro Action di Stile pu essere applicata o meno al verificarsi di una condizione oppure essere applicata sempre nel primo caso si parla di una macro condizionale nel secondo caso di una macro statica Per specificare una macro statica sufficiente riempire i sottocampi di questo parametro con la possibilit di omettere il solo sottocampo ppp per far si che la macro sia applicata alla riga rr di tutte le pagine Non possibile specificare alcun valore per i flag
160. nel file QRPGLESRC presente un sorgente ILE RPG denominato EXIT_B di un programma EXIT di tipo B vuoto da usare come base di partenza per crearne uno proprio Questi i parametri disponibili in input output da un programma EXIT di tipo B ENTRY PLIST amp PARM NomeJob Nome lavoro E PARM Utente Utente C PARM NumJob Numero lavoro G PARM NomeSpool Nome spool PARM NumSpool Numero spool C PARM ProgSpool Progr rottura spool PARM STipoMod Tipo modulo Gi PARM SUserDefD Campo USRDENDTA PARM UserData Campo da PGM utente C PARM S UserDtaA PARM FLRIstanza Cartella istanza G PARM Modo Modalit operativa C PARM FileIFS File IFS E PARM Stato Stato file E PARM S RTNCD Codice ritorno SNomeJob INPUT 10 alfanumerico nome del lavoro che ha prodotto lo spool Utente INPUT 10 alfanumerico nome utente proprietario dello spool SNumJob INPUT 6 alfanumerico numero del lavoro cha ha prodotto lo spool NomeSpool INPUT 10 alfanumerico nome del file di spool NumSpool INPUT 4 numerico numero del file di spool ProgSpool INPUT 6 numerico numero progressivo di rottura del file di spool TipoMod INPUT 10 alfanumerico nome del tipo modulo UserDefD INPUT 255 alfanumerico campo USRDFNDTA del file di spool UserData INPUT 2048 alfanumerico campo USERDATA da PGM utente e o API UserDtaA INPUT 18 alfanumerico riferimento array dati utente da API 1 FLRIstanza INPUT 12
161. nn bar pp label ALFA amp nnn bar pp x NUM x amp nnn bar pp y NUM x amp amp nnn bar pp barFill FILL amp amp nnn bar pp barBorderVisible BOOL LEGENDA DEI TIPI NUM Valore numerico come eventuale separatore decimale utilizzare il punto ALFA Stringa alfanumerica BOOL Booleano SI NO S o FILL Colore di riempimento Pu essere un colore singolo analogo al tipo COLOR oppure una lista di 3 valori i primi due rappresentano i colori di partenza ed arrivo analoghi al tipo COLOR il terzo l angolazione della sfumatura relativa alla transizione tra i due colori di partenza ed arrivo espressa in gradi da 0 a 360 ALFA x Lista di x stringhe alfanumeriche separate da virgola NUM x Lista di x valori numerici separati da virgola come eventuale separatore decimale utilizzare il punto Colore singolo formato RRRGGGBBB fare riferimento al riquadro FORMATO SPECIFICA COLOR g q COLORE alla fine del paragrafo 6 6 Macro Action di Stile ENUM Numero intero positivo compreso lo 0 che rappresenta un tipo nnn rappresenta l ID numerico del grafico pp un progressivo da 01 a 99 relativo alle varie barre verticali da inserire nel grafico Segue la spiegazione del significato di ogni parametro imgWidth Larghezza del grafico espressa in 72esimi di pollice 1 72 0 3528 mm imgHeight Altezza del grafico espressa in 72esimi di pollice 1 72 0 3528 mm imgDPI Risoluzione in DPI punti p
162. nza La cartella sar creata automaticamente da pdfCom come sottocartella della cartella radice specificata nella gestione dei parametri generali fare riferimento al prossimo paragrafo 3 2 Impostazione dei parametri generali Nel corso di questo manuale quando faremo riferimento al nome di un istanza di pdfCom ci riferiremo al valore impostato in questo parametro Coda OUTQ Il nome della coda di stampa che sar controllata dall istanza Occorre specificare un nome di coda di stampa che non sia gi presente su System i La coda sar creata automaticamente da pdfCom nella libreria QGPL ed avr un funzionamento simile a qualsiasi altra coda presente sul sistema Quando una stampa di tipo SCS verr indirizzata su tale coda essa sar automaticamente presa in carico da pdfCom ed elaborata Non possibile utilizzare un nome di coda che viene monitorata dalle funzioni di smistamento automatico fare riferimento al capitolo 16 Smistamento automatico Mantiene spool Indica se il file di spool deve comunque essere conservato al termine dell elaborazione Lasciando vuoto questo parametro il file di spool a meno che non abbia impostato l attributo SAVE a YES sar eliminato automaticamente al termine dell elaborazione pdfCom 7 1 Manuale utente Gestione priorit pdfCom in grado di effettuare una gestione avanzata della priorit di elaborazione dei file di spool Lasciando vuoto questo parametro sar presente un sol
163. o Il tipo modulo del file non presente nella tabella dei tipi modulo di pdfCom Ai fini dell invio verr prodotto un documento PDF standard Tramite l opzione 5 possibile visualizzare il contenuto del file di spool mentre tramite l opzione 1 si accede alla maschera relativa all invio del documento ml c 20 04 12 15 49 55 pdfCom Invio spool PDFCOMSPL Opz Invio spool COIVG43P COIVG43P ololololok i 434036 RP0 C0IVG43C READY 71 04 11 12 44 RIEP IVA j COIVG43R DEFAULT blank nessuno PDFCOM s F03 Fine F12 Precedente F13 Dati agg Override T Mod Specifica il tipo modulo da utilizzare ai fini dell elaborazione A prescindere dal tipo modulo del file di spool possibile specificare un tipo modulo in sostituzione presente nella tabella di pdfCom da utilizzare ai fini dell elaborazione In automatico viene proposto il valore del tipo modulo del file di spool solo se questo presente nella tabella di pdfCom se il tipo modulo del pdfCom 7 1 Manuale utente file di spool non presente nella tabella di pdfCom sar proposto il valore DEFAULT se quest ultimo presente in tabella diversamente non sar proposto alcun valore Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un Tipo Modulo tra quelli presenti in tabella Destinatario Indirizzo e mail del destinatario Il parametro ovviament
164. o USERPGM di un programma utente vuoto da usare come base di partenza per crearne uno proprio Questi i parametri disponibili in input output dal programma utente E ENTRY PLIST 5 PARM NomeJob Nome lavoro g PARM Utente Utente PARM NumJob Numero lavoro PARM NomeSpool Nome spool C PARM NumSpool Numero spool C PARM ProgSpool Progr rottura spool E PARM TipoMod Tipo modulo G PARM Testo Testo estratto Cc PARM Lunghezza Lunghezza testo es Cc PARM Rottura Effettuare rottura E PARM UserData Parametri elabor NomeJob INPUT 10 alfanumerico nome del lavoro che ha prodotto lo spool Utente INPUT 10 alfanumerico nome utente proprietario dello spool NumJob INPUT 6 alfanumerico numero del lavoro cha ha prodotto lo spool NomeSpool INPUT 10 alfanumerico nome del file di spool NumSpool INPUT 6 numerico numero del file di spool ProgSpool INPUT 6 numerico numero progressivo rottura del file di spool TipoMod INPUT 10 alfanumerico nome del tipo modulo Testo INPUT 220 alfanumerico stringa di testo estratta dallo spool Lunghezza INPUT 3 numerico lunghezza della stringa di testo estratta Rottura OUTPUT 1 alfanumerico flag per non effettuare la rottura UserData OUTPUT 2048 alfanumerico parametri elaborazione http www pdfcom it Pagina 74 di 150 pdfCom 7 1 Manuale utente 1 In caso di rottura tramite questo flag il programma utente ha la possibilit di forzare una NO
165. o 3 1 Impostazione istanze di pdfCom inserendo l opzione P Opzioni pulizia automatica sulla Gestione Istanze si accede alla configurazione delle funzioni di pulizia per una specifica istanza ag User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r l Modifica opzioni Pulizia automatica PDFCOM3 S 48 Stato Dopo giorni 180 OK 10 S 1 999 blank nessuna 30 10 2008 15 31 15 FO8 Elimina F12 Precedente Pulizia attiva Permette di abilitare o disabilitare la pulizia automatica senza la necessit di eliminare la configurazione delle opzioni Eliminare E possibile specificare una lista di stati vedi paragrafo 9 1 Dettagli sui file IFS di pdfCom con il relativo numero di giorni da 1 a 999 trascorsi i quali i file sono considerati da eliminare Per ogni stato quindi possibile definire un numero di giorni diverso pdfCom 7 1 Manuale utente La lista completa degli stati che possibile specificare la seguente P j TU gt W Ep g nNOS T WW g ACT HLD Wnn WX kkk Elimin solo IFS File da elaborare a priorit di default File da elaborare a priorit bassa File da elaborare a priorit alta File da elaborare in real time File da elaborare ai soli fini di invio e mail File elaborati correttamente File non elaborati con errori bloccanti File in attesa di invio e mail File in corso di elaborazione File congelato File con specific
166. o Pagina specificato La presenza di tale testo determina o meno l applicazione della Macro Action Omissione Specifica se al verificarsi della presenza della stringa di testo specificata nel parametro Testo essa deve essere omessa dallo spool ovvero deve essere sostituita con degli spazi vuoti Questo parametro risulta particolarmente utile se si decide di stampare sullo spool ad una determinata posizione una stringa appositamente aggiunta ai soli fini di una Macro Action http www pdfcom it Pagina 47 di 150 pdfCom 7 1 Manuale utente Per fare un esempio supponiamo di avere la stampa di una lista articoli che vogliamo trasformare in PDF con l aggiunta di immagini relativamente ad ogni articolo Riga Cradle dada naaa tanar eaa Tam ra rana ian 05 Lista articoli aggiornata al 12 05 2009 06 07 08 Tavolo da giardino verde mod Sardegna 09 Ns Cod QOLOLOTAVSARDE 10 IMG i 12 Base appoggio ombrellone Light Transport 13 Ns Cod 04550BASE20XL 14 SIMGS Allo scopo sar sufficiente inserire una sola Macro Action di Immagine cos composta LISTA ART Numero sequenza 9999 Path Immagine Larghezza Immagine 1 999 blank da immagine Altezza Immagine 1 999 blank da immagine Colonna II 1 220 Numero Pagina 1 999 blank riga o testo Riga scarica 1 99 blank ricerca testo Testo E cutter ata derit briaata sad sIMG 001 050 051 100 101 150 151 200 Omissione
167. o di fincato e sono tutti opzionali I parametri di override che possibile specificare sono gli stessi descritti nel paragrafo 6 3 Parametri fincato multiplo fare riferimento alla tabella dei nomi parametri presente nel paragrafo 7 2 Sintassi di specifica diretta dei parametri di elaborazione Ad esempio per impostare l offset Y di pagina 1 al valore 25 necessario specificare una stringa come segue amp amp 0010ffsetY 25 7 4 Dettaglio sintassi parametri Macro Action per Immagine I parametri evidenziati in blu nella tabella nomi parametri del paragrafo 7 2 sono relativi alle Macro Action di Immagine A prescindere dalle regole specificate per un Tipo modulo vedi paragrafo 6 5 Macro Action di Immagine possibile inserire un immagine ad una determinata pagina riga colonna specificandone opzionalmente le dimensioni A tale scopo sufficiente specificare uno o pi parametri di immagine separati terminati AA sempre con il carattere punto e virgola con la seguente struttura amp amp I ppp rr ccc www hhh Immagine dove ppp rr e ccc rappresentano rispettivamente il numero di pagina riga e colonna da specificare obbligatoriamente e composti rispettivamente di 3 2 e 3 cifre www e hhh rappresentano rispettivamente larghezza ed altezza dell immagine e sono opzionali evidenziati in grigio Se vengono specificati devono essere entrambi presenti e composti obbligatoriamente di 3 cifr
168. o di questo parametro facciamo l esempio di aver inserito due regole una richiede unicamente che il nome del file di spool sia QSYSPRT ed un altra richiede unicamente che il tipo modulo sia FATTURE Se in una coda di stampa monitorata entra un file di spool denominato QSYSPRT che ha il tipo modulo FATTURE entrambe le regole sarebbero applicabili Specificando valori diversi per la Priorit potremo decidere a priori quale regola utilizzare in caso entrambe siano applicabili E da notare che nel caso di due o pi regole ugualmente applicabili e con stessa priorit i risultati non saranno prevedibili Descrizione E possibile inserire una descrizione libera per la regola La descrizione irrilevante ai fini dell elaborazione Risulta per comoda similmente al Numero sequenza ai fini di leggibilit della lista delle regole di smistamento Set attributi Specifica il set di attributi da applicare al file di spool nel caso in cui la regola sia applicabile Il set di attributi deve esistere al momento della creazione di una regola di smistamento Fare riferimento al paragrafo 16 3 Gestione attributi di smistamento per informazioni riguardo la creazione dei set di attributi pdfCom 7 1 Manuale utente I parametri che seguono permettono di specificare i criteri di selezione veri e propri che determineranno se la regola applicabile Tutti i criteri di selezione sono da considerarsi in AND ovvero affinch
169. o errore di Warning nn 2 numeri Valore speciale tutti gli errori di Warning Valore speciale tutti gli stati possibili tutti i file La funzione di pulizia automatica prevede oltre all eliminazione dei file IFS anche l eliminazione dell indice dei documenti fare riferimento al capitolo 13 Indicizzazione documenti Nel caso si desideri effettuare la pulizia dei soli file IFS conservando integralmente l indice sufficiente specificare S in questo parametro Pulizia LOG gg Specifica il numero di giorni da 1 a 999 trascorsi i quali le voci presenti nel log su System i sono considerate da eliminare Lasciando vuoto questo parametro non sar effettuata alcuna pulizia del log Nella Data ora ultima pulizia automatica possibile vedere quando stata effettuata l ultima volta la pulizia automatica dei file IFS La pulizia automatica dei file su IFS fa parte delle funzioni di manutenzione e viene eseguita tramite la schedulazione del programma PDFCOM91R http www pdfcom it Pagina 101 di 150 11 2 Funzioni di reportistica automatica pdfCom offre una comoda funzione di reportistica automatica sullo stato dei file su IFS per le varie istanze configurate Come accennato nel paragrafo 3 1 Impostazione istanze di pdfCom inserendo l opzione R Opzioni report automatico sulla Gestione Istanze si accede alla configurazione delle funzioni di reportistica per una specifica istanza ay R User SPI V
170. o il modulo opzionale Sorter Cartella output documenti Il percorso completo della cartella nella quale verranno salvati i documenti prodotti Il percorso specificato deve essere funzionale al PC server che lo utilizzer ed possibile specificare percorsi locali dal punto di vista del PC server o percorsi di rete con nomi UNC purch raggiungibili dal PC server E altres possibile utilizzare in sostituzione di tutto o parte del percorso una viariabile di path di tipo F fare riferimento al paragrafo 6 13 Gestione variabili di Path Se non viene specificato alcun percorso verr utilizzato quello specificato in Cartella output documenti configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Specificando il valore speciale TEMP il documento prodotto non sar di fatto salvato in nessuna cartella questa impostazione risulta particolarmente utile in caso si desideri generare un documento ai soli fini dell invio tramite e mail oppure ai soli fini della stampa Come si vedr nei paragrafi 6 11 e 6 12 Gestione override parametri questo parametro potr essere impostato anche per utente o coda di stampa quest ultima solo se risulta installato il modulo opzionale Sorter Cartella archiviazione copia Il percorso completo della cartella nella quale verranno ulteriormente copiati i documenti prodotti Il percorso specificato deve essere funzionale al PC server che lo utilizzer ed
171. o lavoro all interno del sottosistema PDFCOM per ogni istanza configurata in questo modo i file di spool saranno elaborati in modo sequenziale seguendo l ordine con cui sono stati diretti nella coda di stampa gestita dall istanza parametro Coda a prescindere dalla loro priorit attributo spool OUTPTY L elaborazione da parte del PC server avverr comunque tenendo conto della priorit che andr a determinare lo stato del file IFS sulla cartella relativa all istanza fare riferimento al paragrafo 9 1 Dettagli sui file IFS di pdfCom Diversamente impostando ad S questo parametro saranno presenti tre lavori all interno del sottosistema PDFCOM per ogni istanza configurata Ogni lavoro si occuper dell elaborazione dei file di spool diretti sulla coda di stampa gestita dall istanza divisi per priorit In pratica ci sar un lavoro per gestire i file ad alta priorit attributo spool OUTPTY lt 5 uno per i file a priorit di default attributo spool OUTPTY 5 ed infine uno per i file a bassa priorit attributo spool OUTPTY gt 5 In questo scenario l elaborazione sequenziale seguendo l ordine con cui i file di spool sono stati diretti nella coda di stampa gestita dall istanza sar comunque ristretta ai soli file della stessa priorit Poich l elaborazione da parte del PC server a sua volta avverr tenendo conto della priorit si otterr un controllo totale dell ordine di elaborazione dei file di spoo
172. o relative al sottolineato ed al grassetto eventualmente presenti sul file di spool Specificando S se nel file di spool sono presenti caratteri in grassetto o sottolineati saranno create automaticamente macro di stile per far si che nel documento PDF o TIFF siano riportati entrambi E da notare che le macro automatiche saranno create solo per le prime 999 pagine dello spool Render in TIFF Se deve essere rasterizzato in formato TIFF il documento PDF prodotto Specificando S l output non sar in formato PDF bens in formato TIFF multipagina b n Risoluzione Relativamente alla rasterizzazione in TIFF specifica la risoluzione in DPI dot per inch del file TIFF da produrre Se non viene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Dithering Relativamente alla rasterizzazione in TIFF specifica la modalit di rasterizzazione di eventuali immagini presenti nel documento Specificando S le immagini saranno rasterizzate utilizzando il dithering mentre specificando N le immagini saranno rasterizzate in bitmap pdfCom 7 1 Manuale utente b n Se non viene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Compressione Relativamente alla rasterizzazione in TIFF specifica l eventuale compressione del file TIFF da produrre E possibile s
173. o un controllo sull esistenza del programma nel caso in cui il programma specificato non venga trovato sar prodotto un errore in fase di elaborazione errori da 85 a 89 fare riferimento al successivo paragrafo 12 2 Tabella codici errore di pdfCom API 1 FileIFS OPZIONALE In caso di corretta elaborazione la API 1 di pdfCom restituisce il nome del file IFS prodotto ed elaborato dal PC server E da notare che il nome sar restituito anche in caso di elaborazione con errori non bloccanti codice di errore minore di 70 o in caso di timeout dell elaborazione codice di errore 98 Il nome del file IFS presente anche nei parametri di entrambe le tipologie di EXIT fare riferimento al capitolo 8 Gestione avanzata tramite programmi EXIT e rappresenta un informazione molto utile poich lega in modo univoco la chiamata alla API 1 l eventuale chiamata ad un programma EXIT di tipo B sincrona e l eventuale chiamata ad un programma EXIT di tipo A asincrona ovvero tutte le fasi di elaborazione di un documento Ulteriormente eventuali successive chiamate alla API 2 fare riferimento al paragrafo 12 4 pdfCom API 2 Servizi accessori sui file IFS e relativi stati potranno essere effettuate proprio sulla base del nome del file IFS I MPORTANTE Il tipo modulo che sar utilizzato per l elaborazione tramite la API 1 di pdfCom a prescindere che sia quello del file di spool o quello in override passato tramite l apposito param
174. ol o di utilizzare il valore speciale NONE tutti questi parametri sono obbligatori Se specificati in modo incompleto verr prodotto un errore in fase di elaborazione errore 94 Se il parametro NomeSpool non viene valorizzato la API 1 di pdfCom provveder automaticamente a reperire l ultimo file di spool prodotto nel lavoro che ha effettuato la chiamata alla API 1 stessa In questo caso se nel lavoro non stata generata alcuna stampa verr prodotto un errore in fase di elaborazione errore 92 Se nel parametro NomeSpool viene specificato il valore speciale NONE la API 1 di pdfCom operer in modalit Spool Less In questa modalit il contenuto del documento non sar preso da un file di spool bens direttamente dall array dati utente fare riferimento al paragrafo 12 3 Dettagli sull utilizzo dell array dati utente che diventa pertanto un parametro obbligatorio diversamente sar restituito il codice di errore 93 Affinch la API 1 possa funzionare correttamente in modalit Spool Less necessario specificare obbligatoriamente anche i parametri OvrTMod e NumRig dato che non esiste uno spool dal quale ricavare l informazione E da notare che il parametro OvrTMod potr essere valorizzato anche con il valore speciale NONE in modo da svincolarsi completamente dalla Gestione dei Tipi Modulo e fornire direttamente alla API 1 tutti i parametri di elaborazione desiderati Se il parametro OvrTMo
175. ol in caso di utilizzo di PlaceHolder Questo parametro deve essere specificato solo in caso di metadati di tipo data ora o timestamp La maschera pu contenere qualsiasi carattere ma solo i seguenti caratteri saranno ritenuti significativi GG Giorno MM Mese AA Anno di 2 cifre sar assunto 20AA mutuamente esclusivo con AAAA AAAA Anno di 4 cifre mutuamente esclusivo con AA hh Ore mm Minuti SS Secondi La lunghezza complessiva della maschera dovr essere minore o uguale a quella della stringa specificata nel campo Valore tenendo conto della sua lunghezza complessiva determinata dall utilizzo di eventuali PlaceHolder La tabella che segue illustra a seconda del tipo di metadato quali valori all interno della maschera saranno presi in considerazione D GG MM AAAA oppure AA O hh mm ss T GG MM AAAA oppure AA hh mm ss Occorre precisare che i valori sopraelencati non sono obbligatori Se un valore non viene specificato all interno della maschera ma funzionale per il tipo di metadato in fase di elaborazione pdfCom assumer il suo valore di default I valori di default previsti sono i seguenti 01 per giorno e mese 0001 per anno 00 per ore minuti e secondi Per capire meglio il significato nonch l utilizzo di questo parametro facciamo un esempio supponendo di avere la stampa di un documento che contiene al suo interno una data ed un ora di approvazione e che vogliamo indicizzare il documento con u
176. one dettagliata sugli stati dei file IFS I valori che il programma EXIT pu forzare sono i seguenti VPL VPD VPH VPR VPM e HLD 4 Il codice di ritorno deve essere restituito con valore blank Restituendo un qualsiasi valore diverso da blank il documento non verr elaborato 8 2 Struttura file DB per programma EXI T B Un programma EXIT di tipo B ha a disposizione il seguente file di database x File PDFCOMSETE FPDECOMSETFUFE A E K DISK Il file PDFCOMSETF contenuto nella libreria QTEMP in fase di esecuzione ha la seguente struttura A UNIQUE A R PDEFSER TEXT TEMP SPOOL ELABORAZIONE A PSE_RIGA 105 Q COLHDG Numero riga A PSE DTA 220A COLHDG TEXT A K PSE_RIGA Il campo PSE_RIGA un progressivo che determina l ordine delle righe nel file che verr trasferito sulla cartella dellIFS su System i ed elaborato successivamente dal PC server E altres da sottolineare che la numerazione del campo PSE_RIGA intelligente e segue la seguente regola ppppprr000 Le prime 5 cifre indicano il numero di pagina La cifre 6 e 7 indicano il numero di riga Le ultime tre cifre sono impostate a zero Ad esempio la riga 1 di pagina 1 sar 0000101000 la riga 12 di pagina 8 sar 0000812000 In questo modo i programmi EXIT di tipo B hanno la possibilit di analizzare lo spool conoscendo la reale pagina riga ed ovviamente la colonna di ogni singolo carattere Ap
177. onibile Data creazione non disponibile Ultima modifica non disponibile Ultimo accesso non disponibile Dimensione registro Dimensione massima registro 1024 KB Al raggiungimento delle dimensioni massime del registro Sovrascrivi eventi se necessario ji O Sovrascrivi eventi anteriori a 7 giomi O Non sovrascrivere eventi pulizia manuale del registro Ripristina C Utilizza una connessione a bassa velocit Cancella registro Impostare la Dimensione massima registro a 1024 KB il default 512 KB e scegliere l opzione Sovrascrivi eventi se necessario Infine premere il pulsante OK Questo far si che al raggiungimento delle dimensioni massime del registro gli eventi pi vecchi siano se necessario sovrascritti http www pdfcom it Pagina 98 di 150 pdfCom 7 1 Manuale utente 11 Manutenzione pdfCom offre delle comode funzioni di manutenzione che prevedono Funzioni di pulizia automatica dei file su IFS descritte in dettaglio nel paragrafo 11 1 Funzioni di reportistica automatica sullo stato dei file su IFS descritte in dettaglio nel paragrafo 11 2 Funzioni di pulizia automatica del Log dello smistatore fare riferimento al capitolo 16 Smistamento automatico Le funzioni di manutenzione devono essere schedulate a cura dell utente Il programma che esegue tutte le funzioni di manutenzione previste ed attive PDFCOM91R nella libreria PDFCOM La chiamata a t
178. ossibilit di effettuare invii estemporanei di file di spool del System i tramite e mail In pratica abbiamo a disposizione una comoda utility che ci permette di convertire al volo un file di spool del System i in PDF TXT o TIFF ed inviarlo tramite posta elettronica L invio estemporaneo diversamente da un elaborazione vera e propria pur tenendo conto dell eventuale tipo modulo si limita ad effettuare il solo invio del documento tramite e mail escludendo tutte le funzionalit di scrittura archiviazione ed invio automatico del documento stesso restano attive eventuali funzioni di indicizzazione se previste nel tipo modulo L utility per l invio estemporaneo accessibile tramite l opzione 4 del menu principale di pdfCom oppure tramite il comando PDFCOMSPL contenuto nella libreria PDFCOM richiamabile da linea di comando digitando PDFCOM PDFCOMSPL seguito dal tasto Enter mig RI 20 04 12 15 49 55 pdfCom Invio spool PDFCOMSPL Opzioni 1 INVIO B5 Visualizza O File Utente Stato Coda Pagine T Modulo Lavoro IMELA N file Libr Dati ut xSTD xSTD RIEP xSTD xSTD RIEP RIEP RIEP xSTD STD STD STD STD STD STD STD F03 Fine FO5 Aggiorna F11 Altri dati MAI a MW 07 002 Viene visualizzata una lista di tutti i file di spool dell utente che ha eseguito il comando E da notare che digitando PDFCOM PDFCOMSPL seguito dal tasto di funzione F4 anzich dal tasto Enter possibile sce
179. p amp 002 gTitle Prova grafico 01 Barre amp amp 002 xTitle Titolo X amp amp 002 yTitle Titolo Y amp amp 002 y2Title Titolo Y2 amp amp 002 isAxisGridVisible S amp amp 002 isLegendVisible http www pdfcom it Pagina 127 di 150 pdfCom 7 1 Manuale utente amp amp 002 backgroundFil1 255255255 128128128 45 amp amp 002 labels A B C D E F G H 1 L amp amp 002 barStack S amp amp 002 bar 01 label A pha amp amp 002 bar 01 x 5 1 0 15 20 25 30 35 40 45 50 amp amp 002 bar 01 y 1 2 3 4 5 4 3 2 1 2 amp amp 002 bar 01 barFill l 255255255 255000000 45 amp amp 002 bar 01 barBorderVisible S amp amp 002 bar 02 label B amp amp 002 bar 02 x 5 5 1 ta 015 205 253 amp amp 002 bar 02 x 30 35 40 45 50 amp amp 002 bar 02 y 5 3 3 5 2 2 1 4 4 5 amp amp 002 bar 02 barFill 255255255 000000255 45 amp amp 002 bar 02 barBorderVisible amp amp 002 bar 03 label l G amp amp 002 bar 03 x 5 1 LO amma 1520725730 35 40 45 50 amp amp 002 bar 03 y 10 20 30 40 50 60 50 40 30 20 amp amp 002 bar 03 barFill 0002550005 amp amp 002 bar 03 barBorderVisible S Il grafico sar creato di dimensioni pari a circa 10 6 x 10 6 cm 300 72 pollici con una risoluzione di 200 dpi http www pdfcom it Pagina 128 di 150 pdfCom 7 1 Manuale utente 14 6 Parametri de
180. parametri di elaborazione documenti rr la riga e ccc la colonna Ill indica la lunghezza di testo da utilizzare in pratica la lunghezza del testo tolti eventuali spazi a sinistra ed a destra che sostituir l intero PlaceHolder o omissione pu pdfCom 7 1 Manuale utente assumere i valori S o N ed indica se il testo referenziato dal PlaceHolder deve essere omesso nello spool ovvero sostituito con spazi vuoti 15 2 Struttura dei parametri Form Set Analogamente a quanto avviene per i parametri di elaborazione fare riferimento al capitolo 7 Gestione dei parametri sul singolo spool anche i parametri di Form Set si possono fornire a pdfCom tramite l utilizzo del campo USRDFNDTA del file di spool tramite il parametro denominato USERDATA del programma utente e o della API 1 tramite l array dati utente della API 1 e tramite il blocco parametri embedded nel file di spool I parametri di Form Set hanno cadauno una lunghezza massima di 220 caratteri totali e sono strutturati in questo modo amp amp Cnnn NomeFieldl ValoreFieldl amp amp Cnnn NomeField2 ValoreField2 amp amp Cnnn NomeField2 ContinuazioneValoreField2 dove nnn rappresenta l ID numerico del form da specificare obbligatoriamente composto di 3 cifre Nomefield il nome di un campo presente nel Modulo PDF e ValoreField il valore con cui riempire tale campo Valori che eccedono la lunghezza complessiva di 220 caratteri vanno
181. pare evidente che oltre a modificare i parametri di elaborazione tramite un programma EXIT di tipo B risulta possibile andare ad effettuare addirittura modifiche allo spool prima che questo venga convertito oppure effettuare modifiche ai parametri in base al contenuto del file stesso http www pdfcom it Pagina 86 di 150 pdfCom 7 1 Manuale utente Questo esempio riporta la struttura dei parametri nel file di database con il loro esatto numero di riga al momento della chiamata ad un programma EXIT di tipo B PSE_RIGA G w w W W W W W WwWwWNNNNNNNNNEEPEEEEPEHH 0 da dis WNE O ov da di WNE vo Ja ds wne o IL LIDI0LWN PO D UT db do ab a a a O 00 u O O e w u H U U U U J Ww u e PSE_DTA Q 2 Q Q QQ Q QQ QQ QQ QQ QQ QQ MMMM QQ QQ QQ QQ QQ QQ QQ MMMM QQ QQ QQ QQ QQ QQ QQ Q QQ QQ QQ QQ QQ QQ QQ a QQ Q QQ QQ I QQ Q QQ O O Q OutType OutName ft 160_06 ENTE LIVORNESE CASSA PDF Fincato d fincati carta srl pdf NumCol 096 NumRig 72 LPI 06 COffsetX 1 OffsetY 20 CharSize 09 Font COUR TTF FOrizzo NumCopie 1 PrinterName rifra srvl Samsung CLP 610 Series OutFolder Rifra srvl documenti Contab fatturepdf ArcFolder Rifra srvl documenti Contab fatture storico MailFrom rifra rifranet it MailFromN Rifra S r l MailTo stefano picchi rifranet it MailCC MailBCC MailReplyTo MailReplyToN ailPriority ailReceipt ail
182. pecificando H il file di spool al quale sar applicato il set di attributi verr congelato Diversamente specificando R il file sar rilasciato E da notare che l eventuale operazione di congelamento avviene prima di effettuare il cambio degli attributi secondo quanto previsto dal parametro Stringa attributi mentre l eventuale rilascio viene effettuato solo dopo il cambio attributi Se il file di spool da congelare o rilasciare risulta gi nello stato desiderato non verr effettuata alcuna operazione Stringa attributi Specifica la stringa contenente tutti gli attributi del file di spool che si desidera modificare La sintassi per specificare gli attributi la stessa prevista dal comando CHGSPLFA Modifica attr file in spool Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di editazione degli attributi il cui comportamento del tutto analogo a quello del comando CHGSPLFA con il tasto di funziona F10 Altri parametri possibile visualizzare tutti gli attributi modificabili Il valore di default SAME inizialmente previsto per tutti gli attributi significa che tale attributo non sar modificato E quindi necessario specificare solo gli attributi che si desidera modificare 16 4 Log dello smistatore Ogni volta che un file di spool viene processato dallo smistatore e soddisfa i criteri di selezione di una regola viene scritto un record nel log dello smistatore T
183. pecificare i seguenti valori Nessuna compressione Compressione CCITT ITU T Gruppo 3 fax Compressione CCITT ITU T Gruppo 4 fax Compressione LZW Lempel Ziv Welch H eUZ Se non viene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Crittografia PDF Se deve essere crittografato il documento PDF prodotto Specificando S il documento prodotto sar critografato protetto pdfCom offre la possibilit di produrre documenti PDF protetti SECURED in modo che questi non possano essere in alcun modo manipolati La crittografia documenti utilizzata da pdfCom si basa su quanto previsto dallo standard PDF e prevede una password di modifica pi un eventuale password di apertura tutte le funzionalit previste dallo standard di protezione sono inibite copia incolla estrazioni di pagina etc ad eccezione del supporto per la lettura dei documenti per persone diversamente abili Per quanto concerne la funzionalit di stampa disponibile l apposito parametro Disab stampa che permette di sceglierne l eventuale disabilitazione Pwd modifica Relativamente alla crittografia dei PDF specifica la password di modifica del documento Lo standard PDF relativo alla crittografia dei documenti prevede obbligatoriamente una password di modifica Se non viene specificata alcuna password verr scelta una password casuale di 35 caratteri alfanumerici non
184. prodotto errori non bloccanti PDF TXT generato comunque KO si sono verificati errori bloccanti durante l elaborazione Lo stato SEN mail accodata da inviare temporaneo al termine dell invio il file assumer comunque lo stato OK oppure Wnn Lo stato HLD file congelato assegnato tramite un apposita opzione dal Pannello di Controllo o forzato dal programma EXIT il PC server ignora i file in questo stato In caso di errori non bloccanti la struttura dello stato composta dal carattere W warning e due numeri che rappresentano il codice dell errore o degli errori che si sono verificati la cui descrizione visibile dal Pannello di Controllo E importante sottolineare che se il codice di errore maggiore di 7 l eventuale stampa archiviazione o invio mail se previste non vengono eseguite Ulteriormente se impostato il parametro Documenti con errori in cartella sul configuratore vedi paragrafo 5 2 tutti i documenti con codice errore maggiore di 7 verranno creati nella sotto cartella _ ERRORI Questo perch un codice errore maggiore di 7 pu essere relativo alla mancanza del fincato ad un errore sul fincato multiplo ad un errore su una macro oppure ad una combinazione di questi possibili errori Pertanto il documento PDF o TIFF generato in tal caso potrebbe risultare effettivamente errato nel suo contenuto Il dettaglio di tutti gli eventuali errori bloccanti e non sar registrato dal PC
185. punti Per avere un riferimento tutte le applicazioni Windows permettono di specificare la dimensione del Font in questo modo Se non specificato tale parametro viene determinato automaticamente sulla base del numero di colonne e precisamente Modulo VERTI CALE Modulo ORIZZONTALE Numero Colonne Punti Font Numero Colonne Punti Font lt 80 11 lt 132 9 81 96 9 133 160 8 97 120 8 161 190 7 121 132 7 gt 190 6 gt 132 6 La scelta automatica delle dimensioni funziona correttamente con la maggior parte dei Font Tuttavia in caso di utilizzo di Font molto particolari potrebbe rendersi necessario specificare manualmente le dimensioni Sono riportate a titolo di esempio alcune dimensioni del Font Courier New The quick brown fox jumps over the lazy dog 6 punti The quick brown fox jumps over the lazy dog 7 punti The quick brown fox jumps over the lazy dog 8 punti The quick brown fox jumps over the lazy dog 9 punti The quick brown fox jumps over the lazy dog 10 punti The quick brown fox jumps over the lazy dog 11 punti The quick brown fox jumps over the lazy dog 12 punti The quick brown fox jumps over the lazy dog 14 punti The quick brown fox jumps over the lazy dog 16 punti The quick brown fox jumps over the 20 punti The quick brown fox Jumps ove 4 punti http www pdfcom it Pagina 28 di 150 pdfCom 7 1 Manuale utente Tipo Font Il tipo di carattere d
186. quale viene applicata la Macro Action Tale parametro obbligatorio E da sottolineare che l applicazione di una Macro Action pu anche essere condizionata al verificarsi della condizione data dalla presenza o meno di una determinata stringa di testo nello spool In quest ultimo caso il valore Colonna assume due significati contemporaneamente rappresenta sia il punto in cui viene inserita eventualmente l immagine sia il punto in cui iniziare il controllo del testo specificato Numero Pagina Indica il numero di pagina dello spool relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti alla quale viene applicata la Macro Action Se non viene specificato ci sono due possibilit gt Si specifica il valore Testo e la Macro Action diventa condizionale Il numero di pagina sar quello o tutti quelli nel quale la condizione di presenza del testo si verifica gt Si specifica il valore Riga e la Macro Action verr applicata sulla riga specificata di tutte le pagine Riga Indica il numero di riga dello spool alla quale viene applicata la Macro Action Se non viene specificato il valore Testo diventa obbligatorio e di conseguenza la Macro Action diventa condizionale il numero di riga sar quello o tutti quelli nel quale la condizione di presenza del testo si verifica Testo La stringa di testo da ricercare nelle righe dello spool partendo dal
187. r quella pagina completo di percorso Ulteriormente possibile specificare i seguenti valori opzionali PaginaFincato rappresenta la pagina del PDF da utilizzare per la fincatura Se non viene espressa sar utilizzata la prima pagina Scala rappresenta il fattore di riduzione o ingrandimento da applicare al fincato Diversamente dal formato di specifica descritto nel paragrafo 6 3 Parametri fincato multiplo anzich specificare il valore in percentuale necessario specificare il valore come numero Ad esempio 150 dovr essere specificato con il valore 1 5 Per impostare l adattamento automatico necessario specificare il valore 1 Se la scala non viene espressa sar assunto il valore 1 100 Rotazione rappresenta l eventuale rotazione da applicare al fincato I valori possibili sono gli stessi previsti per il corrispondente parametro descritto nel paragrafo 6 3 Parametri fincato multiplo Se non viene espressa la rotazione sar automatica http www pdfcom it Pagina 78 di 150 pdfCom 7 1 Manuale utente Tutti i valori sopraelencati sono opzionali ma essendo importante il loro ordine potrebbe essere necessario specificare la sola virgola che li separa Ad esempio per impostare unicamente l adattamento automatico necessario specificare una stringa come segue amp amp 001 d fincati fincato2 pdf 1 Eventuali parametri di override se specificati non possono essere orfani del parametr
188. ra del documento questa funzionalit risulta particolarmente utile in caso di stampa su fogli di dimensioni differenti dall A4 Specificando N la stampa sar invece ancorata all angolo superiore sinistro Se non viene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Adatta ad area Se deve essere effettuato un adattamento all area di stampa Specificando S la stampa sar scalata e centrata in modo da occupare l intera area effettiva disponibile per la stampa mantenendo comunque le proporzioni Specificando N eventuali porzioni del documento al di fuori dell area stampabile saranno tagliate Se non viene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Risoluzione Specifica la risoluzione di stampa del documento E possibile specificare i seguenti valori Non impostata Bozza Bassa Media Alta 5b WIN H O Se non viene specificato alcun valore verr utilizzato quello configurato al paragrafo 5 2 Configurazione dei parametri di default per il servizio Fronte Retro Specifica la modalit fronte retro da utilizzare per la stampa del documento E possibile specificare i seguenti valori Non impostato Default del driver della stampante No fronte retro Verticale lato lungo Orizzontale lato corto T lt sqzoo Se non v
189. ramite l opzione 5 del menu Sorter si accede alla visualizzazione del log dello smistatore SUC R User SPI Visualizzazione LOG smistatore 0 00 0000 _0 00 00 Opzioni 1 Dettagli 5 Visualizza 6 Regola 7 Attributi 0 BERT Ora Nome file Utente Nome job Coda Set attr 107004 Per ogni file di spool elaborato dallo smistatore viene visualizzata la data ora di elaborazione nonch il set di attributi che stato applicato al file Tramite l opzione 1 possibile visualizzare tutti i dettagli disponibili timestamp esatto di elaborazione lavoro che ha prodotto lo spool etc Tramite l opzione 5 possibile visualizzare il file di spool a condizione di avere le necessarie autorizzazioni ed a condizione che il file sia sempre presente nel sistema Tramite l opzione 6 possibile visualizzare la regola di smistamento i cui criteri di selezione sono stati soddisfatti ovvero per la quale il file stato elaborato Infine tramite l opzione 8 possibile visualizzare il set di attributi che stato applicato al file 16 5 Impostazione parametri generali del modulo Sorter Il modulo opzionale Sorter prevede alcuni semplici parametri generali di configurazione Tramite l opzione 6 8 1 del menu principale di pdfCom si accede alla Gestione parametri generali premendo il tasto di funzione F22 Sorter si accede alla gestione dei parametri generali specifici per il modulo Sorter 2118 R User SPI Ve
190. ramite l opzione 6 1 del menu principale di pdfCom si accede alla Gestione override parametri per Utente US 5 User SPI Gestione override parametri per Utente Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 0 Utente TipoModulo Nome stampante nc OAMN _ SPI STD S CERT770 _ UTENTE2 F03 Fine F06 Inserisci 08 006 Da qui possibile impostare per utente eventualmente solo per determinati tipi modulo alcuni parametri specifici in sostituzione di quelli impostati nella gestione dei tipi modulo come visto nel precedente paragrafo 6 1 Parametri generali di creazione dei PDF I parametri specificati tramite questa gestione saranno gerarchici rispetto a quelli impostati nella gestione dei tipi modulo Il paragrafo 7 11 Riepilogo gerarchia dei parametri fornisce una spiegazione completa sulla gerarchia dei parametri Per ogni override possibile impostare i seguenti parametri ag A User SPI Gestione override parametri per Utente 7777 Inserimento override parametri per Utente blank tutti blank predefinita xSAME non impostata 0 20 blank non impostato blank non impostata TEMP temporanea blank non impostata blank non impostato blank non impostato F12 Precedente Utente Il nome utente su System i per il quale si desidera specificare i parametri Questo parametro ovviamente obbligatorio Occorre precisare che questo parametro fa riferimento all utente propriet
191. re punto e virgola ed possibile specificare tutti i tipi di parametro compresi i metadati relativi all indicizzazione per informazioni relative all indicizzazione documenti fare riferimento al capitolo 13 Indicizzazione documenti In caso di chiamata alla API 1 in modalit Spool Less l array dati utente dovr contenere oltre alle eventuali righe relative ai parametri di elaborazione ed ai metadati anche il contenuto del documento da produrre Tutte le righe che iniziano con i caratteri amp amp e sono considerate righe di parametro o metadato tutte le altre comprese eventuali righe vuote sono considerate righe di contenuto e saranno quindi impaginate al pari di un file di spool sul ducumento PDF TXT o TIFF che sar creato Appare quindi evidente che in modalit Spool Less dovr essere presente almeno una riga di contenuto che sar la riga 1 di pagina 1 diversamente verr prodotto un documento vuoto In modalit Spool Less il parametri relativi al numero colonne LPI e numero copie del documento non sono comunque obbligatori Se non specificati verranno assunti i seguenti valori Numero colonne 220 LPI 6 Numero copie O zero E possibile specificare valori di default differenti da assumere a livello globale valorizzando i parametri API 1 SpoolLess dft Col LPI e N copie presenti nella configurazione dei parametri generali fare riferimento al paragrafo 3 2
192. re conservato al termine dell elaborazione Impostando a blank tale parametro il file di spool a meno che non abbia impostato l attributo SAVE a YES sar eliminato dopo l elaborazione STimeout Indica il numero massimo di secondi che la API 1 pu attendere per la produzione del documento da parte del PC server Essendo sincrono il funzionamento la API restituir il controllo al programma chiamante non appena il documento sar stato prodotto oppure trascorsi i secondi di timeout specificati in questo caso sar restituito il codice di errore 98 E da notare che anche se viene restituito l errore di timeout il processo di creazione del documento proceder comunque sino alla fine Specificando un valore negativo l attesa sar infinita ovvero il controllo al chiamante sar restituito solo una volta prodotto il documento Specificando zero il controllo sar restituito immediatamente al programma chiamante e non si verificher mai l errore di timeout codice di errore 98 CleanUp Questo parametro che pu essere valorizzato con blank oppure S indica se al termine dell elaborazione la API 1 dovr effettuare una pulizia dei file di appoggio creati nella libreria QTEMP Impostando a blank tale parametro saranno lasciati sulla QTEMP i file di appoggio rendendo pi performanti eventuali successive chiamate alla API 1 SErrorCod La API 1 di pdfCom restituisce un codice numerico che indica l esito dell elabora
193. re mail di sola notifica Se non specificato la mail sar inviata con il documento allegato E importante capire come si vede nell esempio che parte o tutto il contenuto di ogni parametro e mail compreso il corpo pu essere reperito dinamicamente dal contenuto dello spool tramite l utilizzo di PlaceHolder con il seguente formato lt ppp rr ccc l111 0 gt Dove ppp rappresenta la pagina relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti rr la riga e ccc la colonna Ill indica la lunghezza di testo da utilizzare in pratica la lunghezza del testo tolti eventuali spazi a sinistra ed a destra che sostituir l intero PlaceHolder o omissione pu assumere i valori S o N ed indica se il testo referenziato dal PlaceHolder deve essere omesso nello spool ovvero sostituito con spazi vuoti Poich i caratteri lt e gt sono riservati all utilizzo di eventuali PlaceHolder risulta impossibile utilizzarli come parte integrante del testo Limitatamente all oggetto ed al corpo della mail potrebbe presentarsi effettivamente la necessit di utilizzare tali caratteri come parte del testo tra l altro in modo imprescindibile nel caso di utilizzo di codice HTML nel corpo Per questo scopo sono a disposizione i caratteri 8 simbolo di paragrafo e c con cediglia che saranno sostituiti rispettivamente con i
194. relativo valore da sostituire nel file esterno Il formato di specifica il seguente File D Public HTML mail_fattura html Riga 1 NumeroFattura Numero lt 001 08 034 006 N gt Riga 2 DataFattura lt 001 08 042 008 N gt Riga 3 eventuale altra variabile Riga 4 eventuale altra variabile i eventuale altra variabile Riga 10 In questo caso sono state definite due variabili NumeroFattura riga 2 e DataFattura riga 3 gli apici non fanno parte della stringa e sono obbligatori pdfCom andr a sostituire tutte le occorrenze di tali stringhe di testo nel file D Public HTML mail_fattura html con le rispettive stringhe alla destra del segno uguale tolti ovviamente gli apici che sono obbligatori E possibile utilizzare PlaceHolder sia per il nome del file esterno sia per i nomi delle variabili sia per i valori delle variabili come nell esempio Tramite il tasto di funzione F23 Dest agg possibile accedere alla schermata relativa ai destinatari aggiuntivi 2151 A Modifica Tipo Modulo PDF E mail FATTURA Finc mult Gestione dati e mail FATTURA amministrazione acme com Gestione dati e mail FATTURA blank nessuno 1 protocollo uscita acme com 2 3 4 5 6 7 8 9 25 F04 Elimina F12 Precedente F13 Corpo mail F22 Alleg agg F23 Dest agg 11 008 Da qui possibile specificare fino ad un massimo di 9 indirizzi e mail relativi ad altrettanti de
195. ri che rappresentano i valori dell asse X E necessario fornire un numero di etichette pari a quanti valori sono forniti per l asse x parametro bar pp x barStack Indica se le barre presenti nel grafico devono essere impilate una sull altra anzich affiancate bar pp_label Relativamente alla barra pp il nome che apparir nella legenda come descrizione della barra bar pp x Relativamente alla barra pp i valori da rappresentare sull asse X Deve essere fornito un numero di valori equivalente a quelli forniti nel parametro bar pp y bar pp y Relativamente alla barra pp i valori da rappresentare sull asse Y Deve essere fornito un numero di valori equivalente a quelli forniti nel parametro bar pp x bar pp_barFill Relativamente alla barra pp il riempimento della barra bar pp _barBorderVisible Relativamente alla barra pp indica se deve essere presente un piccolo bordo nero http www pdfcom it Pagina 126 di 150 pdfCom 7 1 Manuale utente 14 5 Esempio di grafico a Barre Nel precedente paragrafo abbiamo visto tutti i parametri che possibile specificare per un grafico a Barre Per fare un esempio di utilizzo pratico supponiamo di voler realizzare il seguente grafico Prova grafico 01 Barre Titolo X Supponendo che l ID numerico del grafico sia 002 necessario specificare i seguenti parametri di Graph Set amp amp 002 imgNWidth 300 amp amp 002 imgHeight 300 amp amp 002 imgDPI 200 am
196. rir come mittente E da notare che questo parametro sar utilizzato solo nel caso in cui sia effettivamente previsto l invio tramite e mail del documento prodotto http www pdfcom it Pagina 68 di 150 6 12 Gestione override parametri per Coda modulo opzionale Sorter Come gi accennato nel paragrafo 6 1 Parametri generali di creazione dei PDF per alcuni parametri specifici possibile effettuare una sostituzione per coda di stampa E importante sottolineare che questa funzionalit risulta utilizzabile solo nel caso in cui lo spool sia stato smistato dallo smistatore automatico su una coda gestita da un istanza di pdfCom fare riferimento al capitolo 16 Smistamento automatico Tramite l opzione 6 2 del menu principale di pdfCom si accede alla Gestione override parametri per Coda 2151 5 User SPI Gestione override parametri per Coda Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 0 Coda TipoModulo Nome stampante n _ QPRINT SPIO1 SPIOUTQ F03 Fine FO6 Inserisci 08 006 Da qui possibile impostare in base alla coda di stampa di provenienza ed eventualmente solo per determinati tipi modulo alcuni parametri specifici in sostituzione di quelli impostati nella gestione dei tipi modulo come visto nel precedente paragrafo 6 1 Parametri generali di creazione dei PDF I parametri specificati tramite questa gestione saranno gerarchici rispetto a quelli impostati nella g
197. rmazioni relative ai programmi EXIT nonch al loro utilizzo Con il tasto di funzione F17 Exit dalla gestione visualizzazione di un tipo modulo si accede alla Gestione programmi EXIT per tipo modulo 21 51 mR Tipo Modulo PDF E mail FATTURE Finc mult 1 220 blank da spool Macro Act 2 99 blank da spool 1 16 blank da spool 1 360 blank centra 1 360 blank 20 4 72 blank automatico b std Gestione programmi EXIT FATTURE LIB PGM Fattura lt 001 bl LIB PGM D FINCATI f i LIB PGM LIB PGM LIB PGM FO4 Elimina F12 Precedente F12 Pr F13 Mail F14 Finc m Fi15 Macro F16 El doc F17 Exit F23 Avanz 13 044 EXIT B Specifica la libreria ed il nome del programma EXIT di tipo B che pdfCom richiamer sempre nel corso dell elaborazione di un documento Poich viene effettuato un controllo di esistenza dell oggetto il programma deve esistere quando tale parametro viene impostato EXIT A stato OK Specifica la libreria ed il nome del programma EXIT di tipo A che pdfCom richiamer nel caso in cui la produzione del documento PDF TXT o TIFF da parte del PC server non abbia prodotto errori vedi paragrafo 9 1 Dettagli sui file IFS di pdfCom Poich viene effettuato un controllo di esistenza dell oggetto il programma deve esistere quando tale parametro viene impostato EXIT A stato W lt 07 Specifica la libreria ed il nome del programma EXIT di tipo A che pdfCom richiamer nel caso in cui
198. ro Action per Stile 7 6 Dettaglio sintassi parametri Macro Action per Codice a Barre 7 7 Dettaglio sintassi parametri Macro Action per Grafico 7 8 Dettaglio sintassi parametri Forms e 15 2 Struttura dei parametri Form Set 5 Questi parametri non sono ereditati dalle impostazioni del tipo modulo e possono essere valorizzati unicamente tramite la loro specifca diretta Fare riferimento al paragrafo 14 1 Struttura dei parametri Graph Set Per una spiegazione dettagliata dei singoli parametri consultare i paragrafi 6 1 Parametri generali di creazione dei PDF e 6 2 Parametri di invio e mail 7 3 Dettaglio sintassi parametri Fincato multiplo I parametri evidenziati in verde nella tabella nomi parametri del paragrafo 7 2 sono relativi alla fincatura multipla A prescindere dalle regole specificate per un Tipo modulo vedi paragrafo 6 3 Parametri fincato multiplo possibile forzare un determinato fincato per una determinata pagina ed eventualmente altri parametri di override A tale scopo sufficiente specificare uno o pi parametri di fincatura multipla NN separati terminati sempre con il carattere punto e virgola con la seguente struttura amp ppp Fincato PaginaFincato Scala Rotazione parametro di fincato amp amp pppParametro Valore parametro di override dove ppp rappresenta il numero di pagina da specificare obbligatoriamente composto di 3 cifre e Fincato il nome del fincato pe
199. rrori bloccanti Tramite l opzione 6 possibile accedere alla gestione della coda di stampa analogamente al comando WRKOUTQ nomecoda La colonna Cartella IFS istanza fornisce una rapida indicazione dello stato del o dei PC server che la gestiscono Se la colonna non risulta evidenziata tutti i server oppure l unico server che la gestiscono sono attivi Se la colonna risulta evidenziata in verde siamo in presenza di una condizione di attenzione dovuta al fatto che almeno uno dei server risulti inattivo da pi di 65 secondi Se l istanza gestita da un unico server esso risulta inattivo per un intervallo di tempo compreso tra 65 e 130 secondi Se la colonna risulta evidenziata in rosso siamo in presenza di una condizione di errore dovuta al fatto che nessun server sia stato attivo durante gli ultimi 130 secondi Se la colonna risulta evidenziata in rosa fucsia siamo altres in presenza di una condizione di errore dovuta al fatto che nessun server sia mai risultato attivo dall ultimo avvio del sottosistema PDFCOM Tramite l opzione 8 possibile avere il dettaglio di tutti i server che gestiscono l istanza con il nome del server ed il relativo delay dall ultimo contatto Tramite l opzione 9 possibile accedere al log degli eventi del PC server che gestisce l istanza in modo praticamente analogo alla consultazione del Registro degli Eventi di Windows per ulteriori informazioni fare riferimento al capitolo 10 Lo
200. rsione 7 1 2378 1031 C 2006 2012 Rifra S r l Gestione parametri generali A 4000 1 65535 Gestione parametri generali 2 1 9 5 1 999 blank nessuna INVIO Rifra S r l Courier New LIB PGM PDFCOM F4 PDFCOM F4 220 1 220 _6 1 16 Progr documenti 100668758 F03 Fine FOS Rivisual F13 Licenze F22 Sorter Istanze smistamento Il numero di istanze da 1 a 9 ovvero lavori nel System i che devono effettuare le operazioni di smistamento automatico Il valore di default che prevede una sola istanza di smistamento attiva va bene nella stragrande maggioranza dei casi Tuttavia se il numero delle stampe che lo smistatore deve analizzare risulta particolarmente elevato possibile incrementare il numero di istanze dedicate al lavoro di smistamento Se ci sono ritardi nelle operazioni di smistamento automatico incrementare il numero delle istanze di smistamento in modo da ripartire il carico su pi lavori paralleli Pulizia LOG gg Specifica il numero di giorni da 1 a 999 trascorsi i quali le voci presenti nel Log dello smistatore sono considerate da eliminare Lasciando vuoto questo parametro non sar effettuata alcuna pulizia del log La pulizia automatica del Log dello smistatore parte delle funzioni di manutenzione e viene eseguita tramite la schedulazione del programma PDFCOM91R fare riferimento al capitolo 11 Manutenzione 17 Invio estemporaneo documenti PDFCOMSPL pdfCom offre la p
201. rver StatoA INPUT 3 alfanumerico stato assegnato al file IFS StatoDa INPUT 3 alfanumerico stato precedente del file IFS TipoMod INPUT 10 alfanumerico nome del tipo modulo Utente INPUT 10 alfanumerico nome utente proprietario dello spool NomeDoc INPUT 200 alfanumerico nome del documento prodotto l outputDoc INPUT 200 alfanumerico cartella di output del documento sAarchivDoc INPUT 200 alfanumerico cartella di archiviazione del documento 1 Questi parametri sono presenti solo nel caso in cui l elaborazione da parte del PC server non abbia prodotto errori oppure abbia prodotto errori non bloccanti Fare riferimento al paragrafo 9 1 Dettagli sui file IFS di pdfCom per una spiegazione dettagliata sugli stati dei file IFS 2 La cartella di archiviazione documento sar presente solo nel caso in sui sia prevista un archiviazione copia aggiuntiva per il documento elaborato I MPORTANTE Poich la produzione effettiva del documento da parte del PC server avviene in un lasso di tempo variabile e non determinabile a priori ovvero avviene in maniera asincrona anche la chiamata ai programmi EXIT di tipo A sar asincrona essi saranno richiamati dopo un lasso di tempo non determinabile e saranno eseguiti in un lavoro job a se stante Questo concettualmente molto diverso dalla chiamata ai programmi EXIT di tipo B che avviene nell ambito dello stesso lavoro di produzione del file IFS se
202. serDtaAP S D NumRigsS Ss 25 0 D ExitB S 20A D ExitAOK S 20A D ExitAKO S 20A D ExitAW1 S 20A D ExitAW2 S 20A D FileIFS S 8A NomeJob INPUT 10 alfanumerico Utente INPUT 10 alfanumerico NumJob INPUT 6 alfanumerico NomeSpool INPUT 10 alfanumerico NumSpool INPUT 4 bytes numerico binary 9B0 o signed 4S0 ToFolder INPUT 12 alfanumerico KeepSpool INPUT 1 alfanumerico Timeout INPUT 2 numerico CcleanUp INPUT 1 alfanumerico ErrorCod OUTPUT 2 numerico DocwPath OUTPUT 256 alfanumerico UserData OPZIONALE INPUT 2048 alfanumerico OvrTMod OPZIONALE INPUT 10 alfanumerico UserDtaAN OPZIONALE INPUT 5 numerico UserDtaAP OPZIONALE INPUT puntatore NumRigS OPZIONALE INPUT 2 numerico ExitB OPZIONALE INPUT 20 alfanumerico SExitAOK OPZIONALE INPUT 20 alfanumerico SExitAKO OPZIONALE INPUT 20 alfanumerico SEx1tAWI1 OPZIONALE INPUT 20 alfanumerico SEx1tAW2 OPZIONALE INPUT 20 alfanumerico SFileIFS OPZIONALE OUTPUT 8 alfanumerico NomeJob Utente NumJob NomeSpool NumSpool Questi parametri identificano in maniera univoca un file di spool su System i Sono relativi rispettivamente al nome del lavoro che ha prodotto lo spool utente del lavoro che ha prodotto lo spool e proprietario dello spool numero del lavoro cha ha prodotto lo spool nome del file di spool e numero del file di spool A meno di non valorizzare il parametro NomeSpo
203. server che ha prodotto il documento e visibile sul Registro degli Eventi di Windows vedi capitolo 10 Log nel Registro degli Eventi di Windows o direttamente dal Pannello di Controllo su System i I MPORTANTE A seguito di una elaborazione pdfCom non effettua alcuna cancellazione automatica dei file su IFS a prescindere dall esito La cancellazione pu essere a cura dell utente che potrebbe decidere di salvare i file semilavorati a scopo di ulteriore archiviazione oppure eseguita massivamente tramite le funzioni di pulizia automatica dei file su IFS Fare riferimento al capitolo 11 Manutenzione per una spiegazione dettagliata Si consiglia vivamente di consultare il Pannello di Controllo al termine dell elaborazione di documenti per i quali previsto magari esclusivamente l invio per e mail eventuali errori potrebbero averne impedito il corretto invio ed il Pannello di Controllo lo strumento adatto per averne un riscontro In aggiunta sono disponibili funzioni di reportistica automatica dello stato dei file su IFS vedi capitolo 11 Manutenzione http www pdfcom it Pagina 94 di 150 pdfCom 7 1 Manuale utente 9 2 Come pdfCom gestisce l invio delle e mail L invio di posta elettronica in particolare se effettuato tramite un server SMTP esterno alla intranet comporta spesso tempi relativamente lunghi specie in presenza di PDF o TIFF allegati di grandi dimensioni Questo renderebbe incompatibile l invio di
204. sferito su System i 2 2 Menu principale di pdfCom Una volta eseguita l installazione su System i sar presente una libreria denominata PDFCOM L intero prodotto contenuto all interno di questa libreria Tramite il comando PDFCOM contenuto anch esso nella libreria PDFCOM richiamabile da linea di comando digitando PDFCOM PDFCOM seguito dal tasto Enter si accede al menu principale del prodotto che offre le seguenti opzioni I A User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r l http www pdfcom it System i Enhanced Output Menu principale F03 Fine 20 006 E da notare che le voci del menu possono variare in base ai moduli opzionali installati Pi avanti nel corso di questo manuale verr fornita una spiegazione dettagliata delle funzionalit offerte da ogni singola opzione 3 Configurazione del prodotto lato System i Una volta effettuata l installazione su System i necessario procedere a pochi semplicissimi passi per configurare il prodotto Impostazione di una o pi istanze Impostazione dei parametri generali Eventuale aggiunta del sottosistema PDFCOM nella libreria PDFCOM tra i sottosistemi ad avvio automatico Inserimento delle chiavi di licenza 3 1 Impostazione istanze di pdfCom Tramite l opzione 6 8 2 del menu principale di pdfCom si accede alla gestione delle istanze ag A User SPI Versione 7 1 2378 1031 C 2006 2012 Rifra S r
205. spool dove verificare la presenza del testo Specificare un valore per questo parametro significa rendere la macro condizionale si rende quindi obbligatoria la valorizzazione del parametro Testo Omissione Specifica se al verificarsi della presenza della stringa di testo specificata nel parametro Testo essa deve essere omessa dallo spool ovvero deve essere sostituita con degli spazi vuoti Questo parametro risulta particolarmente utile se si decide di stampare sullo spool ad una determinata posizione una stringa appositamente aggiunta ai soli fini di una Macro Action Testo La stringa di testo da ricercare nello spool partendo dal valore di Colonna specificato ed eventualmente ristretta al Numero Pagina e o Riga specificati La presenza di tale testo determina o meno l applicazione della Macro Action dinamica Premendo il tasto di funzione F23 Avanzate si accede alle opzioni avanzate USI Al Modifica Tipo Modulo PDF FATTURE RRRGGGBBB blank standard 2 RRRGGGBBB blank nessuno F4 RRRGGGBBB blank nessuno F4 1 9 blank nessuno 1 500 blank nessuna ZH 4 101 150 151 200 F12 Precedente F23 Avanzate E Colore Font Il colore del Font da utilizzare per la parte di testo specificata dalla Macro Action Lasciando il parametro vuoto verr utilizzato il colore standard nero Premendo il tasto di funzione F4 con il cursore posizionato su questo campo possibile scegliere il colore d
206. sse X Questo titolo apparir centrato nella parte inferiore del grafico come didascalia dell asse X yTitle Titolo dell asse Y di sinistra Questo titolo apparir scritto verticalmente nella parte sinistra del grafico come didascalia dell asse Y sinistro y2Title Titolo dell asse Y di destra Questo titolo apparir scritto verticalmente nella parte destra del grafico come didascalia dell asse Y destro isAxisGridVisible Indica se deve essere visibile o meno la griglia di riferimento degli assi isLegendVisible Indica se deve essere visibile o meno la legenda delle curve presenti nel grafico La legenda apparir a sinistra nella parte superiore del grafico sotto il titolo backgroundFill Riempimento dello sfondo labels Lista di etichette da utilizzare in sostituzione dei numeri che rappresentano i valori dell asse X E necessario fornire un numero di etichette pari a quanti valori sono forniti per l asse x parametro curve pp x curve pp label Relativamente alla curva pp il nome che apparir nella legenda come descrizione della curva curve pp xX Relativamente alla curva pp i valori da rappresentare sull asse X Deve essere fornito un numero di valori equivalente a quelli forniti nel parametro curve pp y curve pp y Relativamente alla curva pp i valori da rappresentare sull asse Y Deve essere fornito un numero di valori equivalente a quelli forniti nel parametro curve pp x curve pp lineColor Relativa
207. ssibile specificare un valore solo se vengono specificati i parametri Colore evidenziato e o Colore bordo Percentuale crescita La percentuale di cui deve essere ingrandito il riquadro intorno al testo e o l evidenziato L ingrandimento viene calcolato tramite la percentuale specificata sull altezza del testo e poi applicato in modo distribuito sui 4 lati E possibile specificare un valore compreso tra 1 e 500 Non specificando questo parametro non verr effettuato alcun ingrandimento ed il riquadro e o evidenziato sar a filo del testo Da notare che possibile specificare un valore solo se vengono specificati i parametri Colore evidenziato e o Colore bordo Testo nascosto Specifica se la parte di testo specificata dalla Macro Action deve essere nascosta Se l output scelto in formato TIFF si otterr un omissione a tutti gli effetti ma occorre precisare che se l output in formato PDF non si tratter di una vera e propria omissione in quanto il testo sar comunque presente sul documento PDF anche se non visibile Offset X relativo Specifica lo spostamento sull asse X della parte di testo specificata dalla Macro Action E possibile inserire valori secondo due diverse unit esclusive tra loro numero di caratteri colonne oppure punti espressi in 72esimi di pollice 1 72 0 3528 mm Nel primo caso possibile utilizzare valori con una cifra decimale es 12 5 colonne mentre nel secondo caso possibile
208. stinatari aggiuntivi Ovviamente possibile utilizzare PlaceHolder Tramite il tasto di funzione F22 Alleg agg possibile accedere alla schermata relativa agli allegati aggiuntivi LI Modifica Tipo Modulo PDF E mail FATTURA Finc mult Gestione dati e mail IU FATTURA amministrazione acme com Gestione dati e mail FATTURA j blank nessuno 1 D AllegatiMai 1 FATTURA Disclaimer txt 2 D AllegatiMai FATTURA AcmeLogo01 jpg 3 4 5 6 7 8 9 45 l F04 Elimina F12 Precedente F13 Corpo mail F22 Alleg agg F23 Dest agg Da qui possibile specificare fino ad un massimo di 9 file che risulteranno allegati aggiuntivi alla mail che sar inviata I file da allegare devono essere specificati completi del suo percorso E da notare che il percorso deve essere funzionale al servizio che gira sul PC server che lo utilizzer per trovare il file ovvero deve essere specificato cos come lo vede quel determinato PC server E possibile utilizzare nomi UNC ed possibile utilizzare PlaceHolder I MPORTANTE Tutti i parametri qui specificati potranno a loro volta essere sostituiti come si vedr nel paragrafo 6 9 Gestione parametri di elaborazione documenti e nel capitolo 7 Gestione dei parametri sul singolo spool Il paragrafo 7 11 Riepilogo gerarchia dei parametri fornisce una spiegazione completa sulla gerarchia dei parametri Da notare che il corpo della mail composto da 10 righe in effet
209. ta servizio Sospendi servizio Registro eventi Informazioni su Esci Configuratore opzione predefinita accessibile anche con un doppio click sull icona Apre la Configurazione pdfCom vedi paragrafo 5 2 Avvia Arresta Sospendi servizio E possibile procedere all avvio arresto sospensione del servizio direttamente dal menu contestuale senza necessit di aprire la Configurazione pdfCom o accedere alle Gestione Servizi di Windows Registro eventi Fornisce un rapido accesso al Visualizzatore Eventi senza necessit di andare nel Pannello di controllo di Windows Esci Permette la disattivazione temporanea della Tray Icon di pdfCom fino al prossimo riavvio del PC server oppure al successivo collegamento dell utente http www pdfcom it Pagina 25 di 150 6 Gestione dei Tipi Modulo Tramite l opzione 1 del menu principale di pdfCom si accede alla Gestione dei Tipi Modulo 251 E Gestione Tipi Modulo User SPI Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza I Indicizzazione F Field Form Flr 0 TipoModulo I Col Ri LPI OfX OfY Font 0 nC Nom P Fin 0 A e M MAC EDo Ext _ DEFAULT _ STD _ ALL_FT _ ALL_FT2 _ CAECO1 _ CARTASRL _ CATAL_IMG _ CERTAUTE _ CERT 770 _ COCOPF _ COCOPP _ COMFORN2 _ CONETR_FAX F03 Fine FO6 Ins PDF FO Ins TXT F11 Descr 08 004 pdfCom decide come elaborare un file di spool tramite il suo attributo Tipo Modulo FORMTYPE Tramite questa gestione possib
210. tante evidenziare che diversamente da quanto avviene sulla Gestione dei Tipi Modulo dove il PDF da utilizzare come fincato deve essere composto possibilmente da una sola pagina diversamente sar utilizzata la comunque prima in una regola di fincato multiplo possibile utilizzare anche PDF composti da pi pagine il parametro Pagina fincato permette di specificare quale pagina utilizzare ID Form solo se installato il modulo opzionale Forms Identificativo numerico del modulo PDF a campi Questo identificativo rappresenta il set di tutti i parametri da utilizzare per la compilazione di un Modulo PDF Form Set Fare riferimento al capitolo 15 Moduli PDF pdfCom 7 1 Manuale utente Pagina fincato La pagina del PDF specificato nel parametro Fincato da utilizzare per la fincatura Se questo parametro non viene espresso sar utilizzata la prima pagina Scala La percentuale di scala da applicare al fincato Questo parametro risulta particolarmente utile quando si desidera utilizzare fincati in formati diversi da A4 possibile specificare il fattore di riduzione o ingrandimento oppure richiedere l adattamento automatico specificando S su Auto Valori inferiori al 100 determineranno una riduzione delle dimensioni valori superiori determineranno un ingrandimento E possibile specificare valori compresi tra 1 e 900 percento con una cifra decimale Se questo parametro non viene espresso verr assunto il valore 100
211. ti composto da 10 singoli parametri che potranno quindi essere sostituiti singolarmente a prescindere dall utilizzo o meno di un file esterno Ulteriormente per i parametri Mittente e mail e Nome mittente e mail possibile effettuare una sostituzione per utente o coda di stampa quest ultima solo se risulta installato il modulo opzionale Sorter fare riferimento ai paragrafi 6 11 e 6 12 Gestione override parametri 6 3 Parametri fincato multiplo Come interessante funzionalit pdfCom permette la creazione di documenti PDF con fincature diverse per ogni singola pagina Con il tasto F14 Multi dalla gestione visualizzazione di un tipo modulo si accede alla Gestione fincati multipli per tipo modulo SUS R Modifica Tipo Modulo PDF Fincati multipli per tipo modulo olo 1of0 Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Inserisci tro ca bravate FATTURE FO6 Inserisci F12 Precedente 08 013 Da qui possibile gestire le regole tramite le quali verr deciso il fincato da applicare su una o pi pagine in alternativa a quello specificato sulla Gestione dei Tipi Modulo Sostanzialmente il fincato specificato sulla Gestione dei Tipi Modulo sar quello di default e quelli specificati nelle regole dei fincati multipli andranno a sostituire quello di default E da sottolineare che il fincato potr anche essere volutamente non specificato ottenendo come risultato pagine senza fincatura Ogni r
212. to il Font specificato sulla gestione del Tipo Modulo In questa fase possibile specificare sia Font di tipo MonoSpaced che proporzionali Premendo il tasto di funzione F4 con il cursore posizionato su questo campo si apre la maschera di ricerca che permette di scegliere un Tipo Font tra quelli disponibili Dimensione Font Le dimensioni del Font espresse in punti da utilizzare per la parte di testo specificata dalla Macro Action Il Font utilizzato quello specificato nel parametro Tipo Font altrimenti quello specificato sulla gestione del Tipo Modulo Per avere un riferimento tutte le applicazioni Windows permettono di specificare la dimensione del Font in questo modo Sottolineato Specifica se la parte di testo specificata dalla Macro Action deve essere sottolineata Numero Pagina Indica il numero di pagina dello spool relativa al singolo documento in caso di suddivisione di uno spool vedi paragrafo 6 9 Gestione parametri di elaborazione documenti dove verificare la presenza del testo Questo parametro facoltativo funzionale alle sole macro dinamiche e serve a restringere la ricerca del testo nella pagina specificata Riga Indica il numero di riga dello spool dove verificare la presenza del testo Questo parametro facoltativo funzionale alle sole macro dinamiche e serve a restringere la ricerca del testo alla riga specificata http www pdfcom it Pagina 50 di 150 Colonna Indica il numero di colonna dello
213. uanto avviene per i parametri di elaborazione fare riferimento al capitolo 7 Gestione dei parametri sul singolo spool anche i metadati per l indicizzazione si possono fornire a pdfCom tramite l utilizzo del campo USRDFNDTA del file di spool tramite il parametro denominato USERDATA del programma utente e o della API 1 tramite l array dati utente della API 1 e tramite il blocco parametri embedded nel file di spool Il paragrafo 13 3 Indicizzazione tramite parametri affronta l argomento su come fornire a pdfCom direttamente i metadati per l indicizzazione Dalla Gestione dei Tipi Modulo opzione 1 del menu principale di pdfCom inserendo l opzione I Indicizzazione si accede alla Gestione Indicizzazione per Tipo Modulo SUS Eaj Gestione indicizzazione per tipo modulo TEST_IDX oko LoLo Opzioni 2 Modifica 3 Copia 4 Cancella 5 Visualizza 6 Inserisci O _ NSeg_ Meta TAG T Valore z DOCUMENTO A Tipo Documento Co 0020 ZA L A Tipo Invio Comuni 0030 a S i Folder Id _ O O 4 ORA la a TEST Data FO6 Inserisci F12 Precedente 06 009 Da qui possibile gestire i criteri di valorizzazione dei metadati pdfCom utilizzer tali criteri al momento dell elaborazione di un file di spool sulla base del suo Tipo Modulo E possibile assegnare ad un documento tutti i metadati che si desidera Ogni criterio di valorizzazione presente in questa tabella relativo alla valorizzazione di un singolo metadato
214. ue SI in caso si debba mantenere un file pi nuovo NO in caso di sovrascrittura di un file esistente ANNULLA in caso di ANNULLA RIPROVA CANCELLA in caso di RIPROVA CANCELLA SI continua in caso di messaggi di attenzione es disco quasi pieno directory gi esistente etc E da notare che eventuali messaggi di errore bloccanti che impediscono la partenza del programma di installazione come la mancanza di Microsoft NET Framework versione 2 non possono essere soppressi Permette di impostare le seguenti opzioni addizionali di installazione Icona sul Desktop desktopicon Installazione Tray Icon di pdfCom trayicon Ad esempio se si desidera installare la sola icona sul Desktop occorre specificare TASKS desktopicon Se si desidera installare sia l icona sul Desktop che la Tray Icon di pdfcom occorre specificare TASKS desktopicon trayicon Se questo parametro non viene specificato l installazione avverr con le opzioni di default che prevedono l installazione della sola Tray Icon Permette la creazione di un file di LOG relativo al processo di installazione Il file sar creato nel percorso nome specificati in filename Utile quando il wizard di installazione viene richiemato in modalit silenziosa http www pdfcom it Pagina 16 di 150 pdfCom 7 1 Manuale utente 5 Configurazione del prodotto lato PC server La configurazione di pdfCom lato PC server si eff
215. unzione F9 Log permette di accedere alla visualizzazione del log del PC server in modo praticamente analogo alla consultazione del Registro degli Eventi di Windows per ulteriori informazioni fare riferimento al capitolo 10 Log nel Registro degli Eventi di Windows pdfCom 7 1 Manuale utente Infine il tasto di funzione F21 Report permette di effettuare una stampa della lista visualizzata verr preso in considerazione il filtro per estensione nonch l eventuale range di date impostato a video ma non l eventuale filtro relativo all indicizzazione documenti Tramite l opzione 2 e l opzione 5 possibile rispettivamente modificare e visualizzare il contenuto di un documento Apportare direttamente modifiche ad un documento pu essere utile ai fini della risoluzione di un errore senza essere costretti a rigenerare la stampa cosa peraltro non sempre possibile L opzione 3 permette di congelare un file che sar quindi ignorato dal PC server Le opzioni H D e L permettono di rendere nuovamente da elaborare un file gi elaborato In questo modo se si sono verificati errori ma anche per qualsiasi altro tipo di necessit possibile far processare nuovamente un file senza dover produrre di nuovo lo spool Altres possibile cambiare la priorit di elaborazione di un file in attesa di elaborazione a prescindere da quella che aveva lo spool da cui stato generato attributo OUTPTY L opzione
216. utilizzare fino a due cifre decimali arrivando alla precisione di 1 7200 3 528 um Il segno obbligatorio specifica la direzione di spostamento valori positivi produrranno uno spostamento verso destra valori negativi verso sinistra Non specificando questo parametro non verr effettuato alcuno spostamento del testo Offset Y relativo Specifica lo spostamento sull asse Y della parte di testo specificata dalla Macro Action E possibile inserire valori secondo due diverse unit esclusive tra loro numero di righe oppure punti espressi in 72esimi di pollice 1 72 0 3528 mm Nel primo caso possibile utilizzare valori con una cifra decimale es 1 5 righe mentre nel secondo caso possibile utilizzare fino a due cifre decimali arrivando alla precisione di 1 7200 3 528 um Il segno obbligatorio specifica la direzione di spostamento valori positivi produrranno uno spostamento verso il basso valori negativi verso l alto Non specificando questo parametro non verr effettuato alcuno spostamento del testo http www pdfcom it Pagina 52 di 150 pdfCom 7 1 Manuale utente E da notare che almeno uno dei parametri Tipo Font Dimensione Font Sottolineato Colore Font Colore evidenziato Colore bordo Testo nascosto Offset X relativo o Offset Y relativo obbligatorio diversamente la Macro Action non avrebbe ragione di esistere FORMATO SPECI FI CA COLORE Il colore viene specificato nel seguente form
217. valore di Colonna specificato ed eventualmente ristretto al Numero Pagina specificato La presenza di tale testo determina o meno l applicazione della Macro Action http www pdfcom it Pagina 59 di 150 Omissione Specifica se al verificarsi della presenza della stringa di testo specificata nel parametro Testo essa deve essere omessa dallo spool ovvero deve essere sostituita con degli spazi vuoti Questo parametro risulta particolarmente utile se si decide di stampare sullo spool ad una determinata posizione una stringa appositamente aggiunta ai soli fini di una Macro Action 6 9 Parametri di elaborazione documenti Come abbiamo visto fino ad ora tutti i parametri e regole che possibile specificare nella gestione dei tipi modulo vengono applicati a tutti i file di spool elaborati da pdfCom che hanno quel certo tipo modulo Pu esserci per l esigenza di variare alcuni parametri per un singolo file di spool e pu essere preferibile non creare allo scopo tanti tipi modulo senza contare il fatto che alcuni parametri come l indirizzo e mail del destinatario potrebbero essere impossibili da predeterminare Allo stesso tempo potrebbe esserci l esigenza di suddividere un unico file di spool in tanti documenti come avviene ad esempio per una stampa di fatturazione dove in un unico spool sono presenti numerose fatture relative a clienti diversi Per variare i parametri su un singolo spool gerarchicamente a quanto specificato nel
218. vio manuale tutte le volte che viene acceso il System i consigliato effettuare una modifica al programma di sistema QSTRUP nella libreria QSYS in modo da includere il sottosistema PDFCOM tra quelli ad avvio automatico Il prodotto gestisce correttamente la richiesta di chiusura da parte del sistema operativo per cui non necessario effettuare una chiusura forzata del sottosistema PDFCOM in fase di termine o spegnimento della macchina Tramite l opzione 6 8 5 del menu principale di pdfCom possibile effettuare l arresto manuale del sottosistema E da notare che le opzioni di menu relative all avvio ed all arresto sono disponibili in funzione dell effettivo stato del sottosistema pdfCom 7 1 Manuale utente 3 4 Inserimento della chiave di licenza prodotto modulo base Per il corretto funzionamento sia il modulo base di pdfCom nonch eventuali moduli opzionali necessitano di una chiave di licenza specifica per il System i sul quale vengono installati In mancanza di tali chiavi tutti i moduli compreso il modulo base funzioneranno senza alcuna limitazione per 30 giorni al termine dei quali non sar pi possibile utilizzarli senza l inserimento della relativa chiave di licenza Le chiavi vengono fornite da Rifra S r l e sono specifiche per un determinato System i identificato dal suo numero di serie E possibile verificare il numero di serie del proprio System i tramite il seguente comando DSPSYSVAL QOSRLNBR Modifich
219. za del testo tolti eventuali spazi a sinistra ed a destra che sostituir l intero PlaceHolder o omissione pu assumere i valori S o N ed indica se il testo referenziato dal PlaceHolder deve essere omesso nello spool ovvero sostituito con spazi vuoti A meno di non utilizzare PlaceHolder specificare un valore assoluto ha senso solo se tutti i documenti con un determinato tipo modulo devono avere il valore del metadato abbinato al suo meta tag che sia sempre lo stesso Se ad esempio definiamo un meta tag che per noi pdfCom 7 1 Manuale utente rappresenta il tipo del documento possiamo valorizzarlo direttamente sapendo che tutti i file di spool prodotti con un determinato tipo modulo sono per noi documenti dello stesso tipo Nel caso di metadati di tipo numerico il valore specificato o estratto dallo spool in caso di utilizzo di PlaceHolder pu avere indifferentemente il carattere virgola o punto come separatore dei decimali ed il segno indifferentemente a destra o sinistra Nel caso di metadati di tipo data ora o timestamp il parametro Maschera D O T descriver la posizione dei valori di giorno mese anno ore minuti e secondi all interno del valore sia esso specificato direttamente che estratto dallo spool Maschera D O T Descrive la posizione dei valori di giorno mese anno ore minuti e secondi all interno della stringa specificata nel campo Valore oppure estratta dallo spo
220. zione In caso di elaborazione corretta sar restituito il codice 0 zero Fare riferimento al successivo paragrafo 12 2 Tabella codici errore di pdfCom API 1 per una spiegazione dei possibili codici di risposta SDocwPath In caso di corretta elaborazione la API 1 di pdfCom restituisce il nome del documento generato completo del suo path assoluto E da notare che il nome sar restituito anche in caso di elaborazione con errori non bloccanti codice di errore minore di 70 Specificando un valore di timeout pari a zero il nome non sar mai restituito perch l elaborazione non sincrona http www pdfcom it Pagina 106 di 150 pdfCom 7 1 Manuale utente I parametri che seguono sono tutti opzionali E possibile passare alla API 1 solo il primo parametro opzionale i primi due i primi quattro i primi cinque i primi dieci o tutti SUserData OPZIONALE E possibile fornire direttamente alla API 1 il campo USERDATA Valgono i criteri di gerarchia dei parametri gi esposti nel paragrafo 7 11 Riepilogo gerarchia dei parametri Se nella gestione dei tipi modulo specificato un programma utente quest ultimo ricever eventualmente il campo USERDATA gi valorizzato L elaborazione terr conto dei parametri specificati nel campo USERDATA passato alla API 1 a prescindere dalla presenza o meno di un eventuale programma utente ma importante sottolineare che se il programma utente presente e modifica tale ca
221. zione del documento PDF TXT o TIFF Questa modalit di funzionamento risulta poco compatibile con l eventuale integrazione di pdfCom in un processo che richieda la produzione di documenti in real time tempo reale poich viene a mancare il feedback relativo all ultimazione del processo di creazione del documento Al tempo stesso se all interno di un processo c la necessit di produrre un documento a prescindere o meno dall esigenza del real time necessario un metodo pi dinamico per fornire direttamente i vari parametri per la creazione del documento stesso Ulteriormente ai fini dell integrazione con applicativi esistenti potrebbe esserci l esigenza di manipolare gli stati dei file IFS e rendere ad esempio nuovamente da elaborare file che hanno prodotto errori senza l intervento manuale dal Pannello di Controllo o effettuare cancellazioni di file A tale scopo pdfCom mette a disposizione due API una per la creazione dei documenti in real time ed un altra per la gestione di servizi accessori sui file IFS e relativi stati 12 1 pdfCom API 1 Elaborazioni real time La API 1 di pdfCom denominata PDFCOMAO1R nella libreria PDFCOM e permette l integrazione della creazione di documenti PDF TXT o TIFF all interno di una propria procedura Volendo l esecuzione della API 1 sincrona ovvero la API 1 restituisce il controllo al chiamante solo una volta ultimato il processo di creazione del documento oppure trascorso
222. zurro sono quelli effettivamente presenti sul file al momento della chiamata ad un programma EXIT di tipo B possono essere modificati da quest ultimo purch siano rispettate le regole evidenziate Se ad esempio il programma EXIT B ha bisogno di modificare il valore del parametro MailTo lo trover alla riga 18 se vuole modificare la riga 4 di pagina 6 del testo dello spool la trover alla riga 604000 http www pdfcom it Pagina 89 di 150 pdfCom 7 1 Manuale utente 8 3 Parametri di input output per programma EXI T A I programmi EXIT di tipo A saranno richiamati da pdfCom dopo che il PC server avr creato fisicamente il documento PDF TXT o TIFF ed avranno a disposizione una lista di parametri d ingresso Nella libreria PDFCOM nel file QRPGLESRC presente un sorgente ILE RPG denominato EXIT_A di un programma EXIT di tipo A vuoto da usare come base di partenza per crearne uno proprio Questi i parametri disponibili in input output da un programma EXIT di tipo A C ENTRY PLIST E PARM FLRIstanza Cartella istanza Cc PARM FileIFS File IFS c PARM StatoA Stato A a PARM StatoDa Stato DA Q PARM TipoMod Tipo modulo G PARM Utente Utente e PARM NomeDoc Nome documento Cc PARM OutputDoc Cartella output E PARM ArchivDoc Cartella archiv FLRIstanza INPUT 12 alfanumerico cartella IFS relativa all istanza FileIFS INPUT 8 alfanumerico nome del file IFS elaborato dal PC se

Documentazione

Contents

Download Pdf Manuals

Related Search

Related Contents