Document Distributor. Esempi di script. Marzo

Transcript

1 Document Distributor Esempi di script Marzo

2 Edizione: marzo 2003 Le informazioni incluse nel seguente paragrafo non si applicano a tutti i Paesi in cui tali disposizioni non risultino conformi alle leggi locali: LEXMARK INTERNATIONAL, INC., FORNISCE LA PRESENTE PUBBLICAZIONE "COSÌ COM'È" SENZA ALCUN TIPO DI GARANZIA, IMPLICITA O ESPLICITA, INCLUSE, TRA L'ALTRO, EVENTUALI GARANZIE DI COMMERCIABILITÀ O IDONEITÀ AD UNO SCOPO SPECIFICO. In alcuni Paesi non è consentita la rinuncia di responsabilità esplicita o implicita in determinate transazioni; pertanto, la presente dichiarazione potrebbe non essere applicabile. La presente pubblicazione potrebbe includere inesattezze di carattere tecnico o errori tipografici. Periodicamente vengono apportate modifiche alle informazioni ivi riportate e incluse nelle edizioni successive. In qualunque momento, i prodotti o programmi qui descritti possono essere soggetti a modifiche e migliorie. Eventuali commenti possono essere inviati a Lexmark International, Inc., Department F95/032-2, 740 West New Circle Road, Lexington, Kentucky 40550, U.S.A. Per il Regno Unito e l'eire, l'indirizzo è Lexmark International Ltd., Marketing and Services Department, Westhorpe House, Westhorpe, Marlow Bucks SL7 3RQ. Lexmark si riserva il diritto di utilizzare o divulgare le informazioni ricevute nei modi ritenuti adeguati, senza incorrere in alcun obbligo nei confronti del mittente. È possibile acquistare ulteriori copie di pubblicazioni relative a questo prodotto chiamando il numero negli Stati Uniti. Nel Regno Unito e nella Repubblica d'irlanda, chiamare il numero +44 (0) Negli altri Paesi, rivolgersi al proprio rivenditore. I riferimenti a prodotti, programmi o servizi contenuti in questa pubblicazione non implicano che il produttore intenda renderli disponibili in tutti i paesi in cui opera. Qualsiasi riferimento ad un prodotto, programma o servizio non è inteso a dichiarare o sottintendere che sia possibile utilizzare soltanto quel prodotto, programma o servizio. Ogni prodotto, programma o servizio funzionalmente equivalente che non violi diritti di proprietà intellettuale può essere utilizzato al suo posto. La valutazione e la verifica del funzionamento insieme ad altri prodotti, programmi o servizi, tranne quelli espressamente progettati dal produttore, sono di responsabilità dell'utente. Lexmark e Lexmark con il simbolo del diamante sono marchi di Lexmark International, Inc., registrati negli Stati Uniti e/o in altri Paesi. Copyright 2003 Lexmark International, Inc. Tutti i diritti riservati. DIRITTI DEL GOVERNO DEGLI STATI UNITI Il software e tutta la relativa documentazione forniti ai sensi di questo accordo sono di natura commerciale e sono stati sviluppati esclusivamente con fondi privati.

3 Sommario Introduzione...1 Script Document Distributor...2 Esempio 1: Salvataggio in un file... 2 Esempio 2: Stampa di un documento... 3 Esempio 3: Prompt e invio di una Esempio 4: Memorizzazione di dati in un database... 8 Esempio 5: Separazione delle pagine mediante i codici a barre Esempio 6: Prompt avanzati I Esempio 7: Prompt avanzati II Script Document Producer...23 Esempio 8: Unione di dati e stampa di un modulo Esempio 9: Unione di dati e invio di un modulo tramite fax Script Document Portal...27 Esempio 10: Stampa di un modulo vuoto Esempio 11: Prompt e stampa di un modulo vuoto Appendice A: Configurazione ODBC...31 Appendice B: Configurazione di un FormSet...32 iii

4 Introduzione Il presente manuale riporta esempi di costrutti e oggetti che definiscono il linguaggio script utilizzato dalla suite Document Solutions di Lexmark. Questi esempi sono suddivisi in tre capitoli; ciascun capitolo illustra una delle applicazioni della suite. È possibile consultare tutti gli esempi oppure solo quelli relativi all'applicazione di cui si dispone. Tutti gli esempi riportati in questo manuale sono inclusi nel software Workflow Composer. Si consiglia di accedere a Workflow Composer e Server Manager o Document Portal Admin per poter lavorare con gli script man mano che si procede con la consultazione del manuale. Quando si caricano gli script in Document Server, viene richiesto di immettere le informazioni relative all'ambiente necessarie per l'esecuzione degli script. Ad esempio, quando è necessario specificare l'indirizzo IP del server SMTP, lo script indica "local.mailserver". Questa parte dello script verrà sostituita dal valore specificato. 1

5 Script Document Distributor Esempio 1: Salvataggio in un file Panoramica: Salvare in un file il documento acquisito tramite scanner. Dettagli: Un dipendente deve acquisire tramite scanner delle fatture su una stampante MFP e memorizzarle nel file system locale. Script: with SaveToFile.input=original.document.Path="c:\lexmark\invoice.tif".AppendTimestamp=TRUE.CreateDirectory=TRUE Per eseguire questo script: 1 Caricarlo sul server utilizzando Workflow Composer o Server Manager. 2 Utilizzando Server Manager, creare un profilo su una stampante MFP. Nota: Impostando AppendTimestamp su TRUE, il nome di ciascun file salvato sarà univoco. Il nome del file generato sarà: c:\lexmark\invoice_mon_dd_yyyy_hh_mm_ss_ms.tif È importante notare che per l'intero script viene utilizzato lo stesso indicatore di data e ora; quindi, utilizzando più volte SaveToFile durante l'esecuzione dello stesso script, viene applicato lo stesso indicatore di data e ora. Se necessario, l'indicatore di data e ora può essere creato manualmente utilizzando la proprietà usertime dell'oggetto originale e associandovi un valore univoco. Per i dettagli, vedere l'esempio 5: Separazione delle pagine mediante i codici a barre. Impostando la proprietà CreateDirectory su TRUE, verranno create tutte le directory inesistenti nel percorso. Ciò è particolarmente utile nel caso in cui l'indicatore di data e ora faccia parte del nome della directory. 2

6 Esempio 2: Stampa di un documento Panoramica: Stampare un documento acquisito tramite scanner su un'altra stampante. Dettagli: Un dipendente deve inviare un fax interno, vale a dire da una sede a un'altra dell'azienda. Dato che esiste una rete LAN aziendale e che in tutte le sedi sono presenti delle stampanti, utilizzando questo script è possibile stampare direttamente su una delle stampanti invece di inviare un fax. In questo modo, si ottiene un output dalla qualità elevata e si riducono i costi telefonici. Inoltre, alla stampa viene aggiunto un indicatore di data e ora in modo analogo a un fax. Script: 1 Usare il metodo separato per dividere il valore usertime in parti singole. Quindi, creare la stringa di informazioni da includere in ciascuna pagina della stampa. Il formato della stringa è "Inviato da IP address il giorno date alle ore time". stringarray time = original.usertime.separate("_") string stamp = "Inviato da " + original.userip stamp.concatenate(" il giorno " + time[2] + " " + time[3] + " " + time[4]) stamp.concatenate(" alle ore " + time[5] + ":" + time[6]) 2 Usare l'azione ImageText per aggiungere le informazioni relative a data e ora nell'angolo inferiore destro di tutte le pagine inviate. with ImageText.input=original.document.Orientation=LDD_ORIENTATION_PORTRAIT.Text=stamp.Direction=LDD_IMGTEXTDIR_HORIZONTAL.Font=LDD_IMGTEXTFONT_ARIAL.Color=LDD_IMGTEXTCOLOR_BLACK.Position=LDD_IMGTEXTPOS_BOTTOMRIGHT.AllPages=TRUE.Size=10.Bold=TRUE.Italic=TRUE.Underline=FALSE 3 Usare l'azione ConvertToDocument per convertire l'immagine TIFF in PostScript per poterla stampare. Notare che l'output dell'azione ImageText viene utilizzato per aggiungere le informazioni relative a data e ora all'immagine TIFF. with ConvertToDocument.input=ImageText.output.Format=LDD_DOCFORMAT_PS.AllPages=TRUE.PaperSize=LDD_PAPERSIZE_LETTER.Orientation=LDD_ORIENTATION_AUTO 3

7 4 Usare l'azione PrintJob per inviare il file PostScript alla stampante specificata. Se la stampante dispone di una scheda SIMM ImageQuick, è possibile inviare il file TIFF direttamente alla stampante senza convertirlo in PostScript. with PrintJob.input=ConvertToDocument.output.IPAddress=local.printerip.Copies=1.SetWaitTimeout(FALSE).PaperSource=LDD_PRINTER_DEFAULT.PaperSize=LDD_PRINTER_DEFAULT.OutputBin=LDD_PRINTER_DEFAULT.Duplex=LDD_DUPLEX_OFF.Orientation=LDD_PRINTER_DEFAULT.Nup=LDD_NUP_OFF.Collate=FALSE.Staple=FALSE.HolePunch=FALSE.TonerSaver=FALSE.SetConfidentialPrint(FALSE) Per eseguire questo script: 1 Caricarlo sul server utilizzando Server Manager. 2 Configurare l'indirizzo IP della stampante mediante le impostazioni locali. 3 Creare un profilo su una stampante MFP. 4

8 Esempio 3: Prompt e invio di una Panoramica: Acquisire otticamente un documento ed inviarlo all'utente tramite . Dettagli: Un'azienda desidera semplificare l'attività di acquisizione ottica dei documenti cartacei senza dover installare il software OCR sui computer aziendali. Questo script consente di richiedere all'utente l'indirizzo e se desidera il documento in formato RTF (utilizzato dalla maggior parte degli elaboratori di testo) o PDF. Lo script converte il documento e lo invia all'utente tramite . Script: 1 Questo script consente di richiedere all'utente finale alcune informazioni; è necessario impostare alcuni prompt. Il primo prompt richiede di specificare un indirizzo , mentre il secondo è costituito da un elenco a selezione singola in cui deve essere indicato il formato del file. stringprompt .setprompttext("immettere l'indirizzo ") stringprompt format with format.setprompttext("selezionare il formato del file").addpromptoption("rtf").addpromptoption("pdf") 2 Una volta configurato il blocco dei prompt, questi vengono utilizzati per richiedere informazioni. Quando viene selezionato questo script, questa parte viene eseguita prima dell'acquisizione tramite scanner. Dato che le informazioni fornite non vengono verificate e che non influiscono sui prompt successivi, è possibile richiedere le informazioni in un unico passo. prompt step "prompt" ask( ) ask(format) laststep endprompt 3 Una volta specificate le informazioni, il documento viene acquisito tramite scanner e inviato come tutti gli altri processi non contenenti prompt. A questo punto, quando il processo viene riavviato, riprende l'esecuzione dello script. 5

9 4 Osservare il formato specificato e convertire il documento originale nel formato PDF o RTF. L'output viene memorizzato nella variabile ocr in modo che possa essere utilizzato per inviare l' . doc ocr if (format == "PDF") with ImageToPDF.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.Format=LDD_PDFFORMAT_IMAGEONTEXT.PictureResolution=300.PictureQuality=75.AllPages=TRUE ocr =.output else with ImageToRTF.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.PaperSize=LDD_PAPERSIZE_LETTER.KeepColor=TRUE.KeepPictures=TRUE.AllPages=TRUE ocr =.output endif 5 A questo punto, viene utilizzata l'azione SMTP per inviare l' a cui è allegato il documento acquisito otticamente. L'indirizzo utilizzato è quello specificato dall'utente finale quando è stato inviato il processo. L'indirizzo IP del server SMTP è stato definito come impostazione locale; quando lo script viene caricato sul server, Server Manager richiede il valore da utilizzare per questa proprietà. with SMTP.Server=local. server.To= .From= .Subject="Documento acquisito".message="è stato allegato il documento acquisito nel formato specificato.".characterset=ldd_smtpcharset_us.attachments=ocr 6

10 Per eseguire questo script: 1 Caricarlo sul server utilizzando Server Manager. 2 Configurare l'indirizzo del server SMTP mediante le impostazioni locali. 3 Per utilizzare questo script su una stampante MFP, è necessario un touch screen. In caso contrario, utilizzare Select'N'Send oppure Print'N'Send. Se si dispone di un touch screen, creare un profilo utilizzando un file TIFF con risoluzione 300 dpi e tonalità 4. In questo modo, l'acquisizione ottica garantirà risultati ottimali. Nota: È possibile sostituire l'azione SMTP con oggetti specifici supportati da GroupWare, ad esempio Lotus Notes ( Notes), Microsoft Exchange ( Exchange) e Novell GroupWise (GWMail). Il maggiore vantaggio derivante dall'impiego di questi oggetti è che lo script può utilizzare la rubrica e le funzioni specifiche di GroupWare; tuttavia, per utilizzare questi oggetti è necessario soddisfare ulteriori requisiti di configurazione. Nella maggior parte dei casi, è possibile configurare i server GroupWare in modo da accettare messaggi di posta SMTP. Se per lo script non sono necessarie funzioni specifiche, dovrebbe essere sufficiente l'azione più generica, ovvero SMTP. 7

11 Esempio 4: Memorizzazione di dati in un database Panoramica: Memorizzare in un database il documento acquisito tramite scanner. Dettagli: La divisione Risorse umane di un'azienda è responsabile della gestione di tutti i curriculum. Questo script consente di memorizzare i curriculum in un database. Inoltre, i curriculum vengono convertiti in documenti di testo che verranno memorizzati nel database. In tal modo, è possibile effettuare ricerche nei documenti di testo memorizzati nel database utilizzando determinate parole chiave e ottenere un elenco di tutti i curriculum individuati. Dato che nel database è presente anche il curriculum, è possibile visualizzarlo, stamparlo o inviarlo a un'altra divisione. Lo script 4A è destinato ai database che utilizzano oggetti binari di grandi dimensioni (BLOB). I BLOB vengono utilizzati dai database che consentono la memorizzazione di file, ad esempio Oracle, Microsoft SQL Server e IBM DB2. Lo script 4B è destinato ai database che, come Microsoft Access, non supportano i BLOB. Per eseguire la stessa funzione, è necessario salvare il documento nel file system locale. L'ubicazione del file viene quindi salvata nel database in modo da poter essere recuperata in seguito. Script 4A: 1 Convertire il documento in testo; questo testo verrà memorizzato nel database e associato al curriculum corrispondente per potervi effettuare delle ricerche. with ImageToText.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.OneLine=TRUE.SeparateParagraphs=TRUE.PageBreaks=FALSE.AppendEOF=FALSE.AllPages=TRUE 2 Utilizzando l'oggetto textfile, leggere il testo generato dall'azione ImageToText e memorizzarlo in una stringa. textfile tf string ocrtext tf.open(imagetotext.output) ocrtext = tf.read(tf.size()) tf.close() 8

12 3 Inserire il curriculum e il testo corrispondente nel database per poterli recuperare in seguito. Le proprietà relative ai dati del database vengono configurate mediante le impostazioni locali quando lo script viene caricato sul server. with ODBCWrite.DataSource=local.DataSource.TableName=local.TableName.LogonName=local.LogonName.LogonPassword=local.LogonPassword.AssignValue("ScanDate","").AssignValue("OCRText",ocrText).AssignValue("Resume",original.document) Per eseguire questo script: 1 Sul server, configurare il database che si desidera utilizzare. I file LDDOracleTable.sql e LDDSQLServerTable.sql consentono di creare le tabelle di esempio in Oracle e Microsoft SQL Server. Questi file si trovano nella directory degli esempi di script installata con Workflow Composer. Dopo aver configurato il database, configurare la connessione ODBC. Per ulteriori informazioni, vedere l'appendice A: Configurazione ODBC. 2 Caricare lo script sul server utilizzando Server Manager. 3 Configurare i dati di connessione ODBC mediante le impostazioni locali. 4 Creare un profilo su una stampante MFP. 9

13 Script 4B: 1 Convertire il documento in testo; questo testo verrà memorizzato nel database e associato al curriculum corrispondente per potervi effettuare delle ricerche. with ImageToText.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.OneLine=TRUE.SeparateParagraphs=TRUE.PageBreaks=FALSE.AppendEOF=FALSE.AllPages=TRUE 2 Utilizzando l'oggetto textfile, leggere il testo generato dall'azione ImageToText e salvarlo in una stringa. textfile tf string ocrtext tf.open(imagetotext.output) ocrtext = tf.read(tf.size()) tf.close() 3 Impostare il percorso in cui salvare il file. Il file verrà salvato nel file system locale in una directory denominata c:\lexmark. Il nome del file è resume_timestamp.tif. string filepath = "c:\lexmark\resume" + original.usertime + ".tif" 4 Dato che il documento non può essere inserito nel database, salvarlo nel file system locale. AppendTimestamp è impostato su FALSE perché nel passo precedente è stato aggiunto manualmente l'indicatore di data e ora. CreateDirectory è impostato su TRUE; quindi, se il percorso c:\lexmark non esiste, verrà creato. with SaveToFile.input=original.document.AppendTimestamp=FALSE.Overwrite=FALSE.Path=filepath.CreateDirectory=TRUE 10

14 5 Inserire il nome del file e il testo corrispondente nel database per poterli recuperare in seguito. Le proprietà relative ai dati del database vengono configurate mediante le impostazioni locali quando lo script viene caricato sul server. with ODBCWrite.DataSource=local.DataSource.TableName=local.TableName.LogonName=local.LogonName.LogonPassword=local.LogonPassword.AssignValue("ScanDate","").AssignValue("OCRText",ocrText).AssignValue("ResumeFile",filepath) Per eseguire questo script: 1 Sul server, configurare il database che si desidera utilizzare. In questo esempio, verrà utilizzato il database Microsoft Access fornito, resumes.mdb. Questo file si trova nella directory degli esempi di script installata con Workflow Composer. Dopo aver configurato il database o dopo aver selezionato quello fornito, configurare la connessione ODBC. Per ulteriori informazioni, vedere l'appendice A. 2 Caricare lo script sul server utilizzando Server Manager. 3 Configurare i dati di connessione ODBC mediante le impostazioni locali. 4 Creare un profilo su una stampante MFP. 11

15 Esempio 5: Separazione delle pagine mediante i codici a barre Panoramica: Utilizzare una pagina separatrice con codice a barre per dividere i processi di grandi dimensioni in file separati. Dettagli: Un dipendente deve acquisire tramite scanner ed elaborare diversi gruppi di documenti. Ciascun gruppo può essere acquisito separatamente, ma è più semplice (e auspicabile) acquisirli tutti in un'unica operazione. A tal fine, è possibile utilizzare una pagina separatrice con codice a barre per indicare l'inizio di un nuovo gruppo. Utilizzando la pagina separatrice, ciascun gruppo potrà contenere qualunque numero di pagine. Questo script ricerca i codici a barre in tutte le pagine del documento acquisito contrassegnando la fine del gruppo precedente, e salvandolo in un file, e l'inizio di un nuovo gruppo ogni volta che rileva un codice a barre. Script: 1 Dichiarare tutte le variabili utilizzate in questo script. doc separated int i, startpage, lastpage bool found string fullpath, bcode 2 Separare il documento acquisito tramite scanner in modo che ciascuna pagina si trovi nel file corrispondente. In questo modo, ogni serie di pagine appartenente a un gruppo potrà essere combinata in un unico file. with ImageSeparate.input=original.document.AllPages=TRUE.separated =.output 3 Utilizzare la variabile startpage per indicare la prima pagina del gruppo corrente. Impostare la prima pagina del gruppo acquisito. startpage = 1 4 Ripetere l'operazione per tutte le pagine inviate. loop i from 1 to separated.getnumberfiles() 5 La variabile found indica che un nuovo gruppo di pagine è pronto per il salvataggio. Reimpostarla prima di elaborare ogni pagina. found = false 12

16 6 Utilizzare l'azione BarcodeRead per determinare la presenza di un codice a barre sulla pagina corrente. with BarcodeRead.Reset().Input=separated.GetFile(i).Type=LDD_BARCODE_CODE128.Direction=LDD_BCDIR_HORIZ.Quality=LDD_BCQUALITY_GOOD.Fixed=FALSE.Validate=TRUE.Length=0.PageNumber=1.WholePage=TRUE bcode =.Results 7 In questo esempio (e nel file di esempio fornito), il codice a barre è la parola "BREAK". Controllare se questo codice a barre è stato individuato nella pagina corrente. if (bcode.contains("break")) then 8 È stato rilevato un codice a barre. Se la prima pagina corrisponde a quella corrente (ad esempio, startpage è uguale a 1 e la prima pagina del documento acquisito è una pagina separatrice), non è necessario salvare alcuna pagina. In questo caso, la prima pagina impostata per il gruppo successivo è la pagina successiva. In altre parole, l'ultima pagina impostata per il gruppo corrente è la pagina precedente (non impostare questa pagina, altrimenti verrà salvata anche la pagina separatrice). Impostare il flag found in modo che indichi la presenza di un gruppo di pagine da salvare. if (startpage == i) startpage = i + 1 else lastpage = i - 1 found = true endif 9 Non è stato rilevato alcun codice a barre. Controllare se questa è l'ultima pagina del documento. In caso affermativo, deve essere l'ultima pagina del gruppo corrente. Impostare lastpage sulla pagina corrente e il flag found in modo che indichi la presenza di un gruppo di pagine da salvare. else if (i == separated.getnumberfiles()) then lastpage = i found = true endif endif 10 Se è stato rilevato un nuovo gruppo di pagine, è necessario salvarle. if (found == true) then 13

17 11 Utilizzare l'azione ImageCombine per combinare il gruppo di pagine in un unico documento. with ImageCombine.input=separated.GetFileRange(startpage, lastpage).format=ldd_imgformat_tifg4.colordepth=ldd_imgdepth_bw 12 Determinare il nome del file da utilizzare per salvare il nuovo documento. I gruppi di pagine vengono salvati nella directory c:\lexmark. Il nome del file è set_timestamp_page.tif. Dato che tutti i file salvati in un processo riportano lo stesso indicatore di data e ora, viene aggiunto il numero dell'ultima pagina del gruppo per ottenere un nome univoco per il file. fullpath = "c:\lexmark\set" + original.usertime + "_" + lastpage.asstring() + ".tif" 13 Salvare il nuovo documento su disco. AppendTimestamp è impostato su FALSE poiché nel passo precedente è stato aggiunto manualmente l'indicatore di data e ora. CreateDirectory è impostato su TRUE; quindi, se la directory c:\lexmark non esiste, verrà creata. with SaveToFile.input = ImageCombine.output.Path=fullpath.AppendTimestamp=FALSE.Overwrite=FALSE 14 Il gruppo corrente è stato salvato. Impostare la prima pagina del gruppo successivo in modo che corrisponda alla pagina successiva del documento. Non impostarla sulla pagina corrente; in caso contrario, il gruppo successivo includerà la pagina separatrice nel documento salvato. startpage = i + 1; endif endloop Per eseguire questo script: 1 Caricarlo sul server utilizzando Server Manager. 2 Creare un profilo su una stampante MFP utilizzando un file TIFF con risoluzione 300 dpi e tonalità 3 o 4. 3 Il file, fullset.tif, si trova nella directory degli esempi di script installata con Workflow Composer. Questo file può essere stampato e acquisito oppure inviato mediante Select'N'Send. Quando lo si utilizza insieme a questo script, genera tre file separati rispettivamente di 3, 2 e 4 pagine. 14

18 Esempio 6: Prompt avanzati I Panoramica: Utilizzare le informazioni ottenute mediante i prompt per determinare il prompt successivo. Dettagli: Questo script consente di acquisire un documento tramite scanner e di inviarne l'originale o una versione modificabile tramite . Si tratta di un'estensione dello script riportato nell'esempio 3: Prompt e invio di una . Verrà richiesto di specificare l'indirizzo a cui inviare il documento, quindi se si desidera acquisirlo otticamente. A seconda dell'informazione fornita, il prompt successivo riguarderà il formato appropriato. Sebbene si tratti di uno script semplice, mostra l'importanza dei prompt e delle informazioni fornite nella definizione dei prompt successivi. Script: 1 Questo script consente di richiedere all'utente finale alcune informazioni; a tal fine, è necessario configurare alcuni prompt. Il primo prompt richiede di specificare un indirizzo , mentre il secondo richiede un valore booleano utilizzato per acquisire otticamente il documento; in caso contrario, il documento verrà inviato come immagine. stringprompt .setprompttext("indirizzo a cui inviare il documento") boolprompt ocr ocr.setprompttext("fare clic per acquisire otticamente il documento.") 2 Se si seleziona l'acquisizione ottica, viene utilizzato questo prompt. Si tratta di un elenco a selezione singola che consente di scegliere il formato del documento da acquisire otticamente. stringprompt ocrformat with ocrformat.setprompttext("selezionare il formato OCR").AddPromptOption("RTF").AddPromptOption("PDF (con possibilità di effettuare ricerche)") 3 Se non si seleziona l'acquisizione ottica, viene utilizzato questo prompt. Si tratta di un elenco a selezione singola che consente di scegliere il formato del documento immagine. stringprompt imgformat with imgformat.setprompttext("selezionare il formato immagine").addpromptoption("tiff").addpromptoption("pdf (senza possibilità di effettuare ricerche)") 4 Una volta configurato il blocco dei prompt, questi vengono utilizzati per richiedere informazioni. Quando viene selezionato questo script, la parte relativa ai prompt viene eseguita prima dell'acquisizione tramite scanner. Dato che le informazioni fornite vengono utilizzate per formulare i prompt successivi, l'operazione prevede più passi. prompt 15

19 5 Questo passo comprende due prompt: il primo richiede l'indirizzo , il secondo se si desidera acquisire otticamente il documento. Entrambi i prompt vengono inviati in un solo passo perché non interferiscono fra loro. Una volta inviato il prompt relativo all'acquisizione ottica, viene verificato il valore di ritorno. Se viene selezionata l'acquisizione ottica, il prompt successivo è oformat; in caso contrario, il passo successivo è iformat. Ogni passo deve includere la directive nextstep o laststep. step " " ask( ) ask(ocr) if (ocr == TRUE) nextstep "oformat" else nextstep "iformat" endif 6 Questo passo viene utilizzato quando si seleziona l'acquisizione ottica. Viene richiesto di selezionare il formato del documento da acquisire otticamente. Questa è l'ultimo prompt di questa procedura, quindi viene utilizzata la directive laststep. step "oformat" ask(ocrformat) laststep 7 Questo passo viene utilizzato quando non si seleziona l'acquisizione ottica. Viene richiesto di selezionare il formato del documento immagine. Questa è l'ultimo prompt di questa procedura, quindi viene utilizzata la directive laststep. step "iformat" ask(imgformat) laststep endprompt 8 Una volta specificate le informazioni, il documento viene acquisito tramite scanner e inviato come tutti gli altri processi non contenenti prompt. A questo punto, quando il processo viene riavviato, riprende l'esecuzione dello script. Verificare il prompt ocr per controllare se l'utente desidera acquisire otticamente il documento. doc attach if (ocr == TRUE) 16

20 9 L'utente desidera acquisire otticamente il documento; verificare il formato desiderato ed eseguire la conversione. Memorizzare l'output della conversione nella variabile attach. if (ocrformat == "RTF") with ImageToRTF.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.PaperSize=LDD_PAPERSIZE_LETTER.KeepColor=TRUE.KeepPictures=TRUE.AllPages=TRUE attach =.output else with ImageToPDF.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.Format=LDD_PDFFORMAT_IMAGEONTEXT.PictureResolution=72.PictureQuality=50.AllPages=TRUE attach =.output endif 10 L'utente non desidera acquisire otticamente il documento; verificare il formato immagine desiderato ed eseguire la conversione, se necessario. Dato che il documento è stato acquisito come TIFF, non è necessaria alcuna conversione se si sceglie tale formato. Memorizzare l'output della conversione nella variabile attach. else if (imgformat == "TIFF") attach = original.document else with ConvertToDocument.input=original.document.Format=LDD_DOCFORMAT_PDF.AllPages=TRUE.PaperSize=LDD_PAPERSIZE_LETTER.Orientation=LDD_ORIENTATION_AUTO attach =.output endif endif 17

21 11 A questo punto, viene utilizzata l'azione SMTP per inviare l' a cui è allegato l'output selezionato. L'indirizzo utilizzato è quello specificato dall'utente finale quando è stato inviato il processo. L'indirizzo IP del server SMTP è stato definito come impostazione locale; quando lo script viene caricato sul server, Server Manager richiede il valore da utilizzare per questa proprietà. with SMTP.Server=local. server.To= .cc="".bcc="".From= .ReplyTo="".Sender="".Subject="Documento acquisito".message="i documenti acquisiti sono pronti per l'uso".characterset=ldd_smtpcharset_us.attachments=attach Per eseguire questo script: 1 Caricarlo sul server utilizzando Server Manager. 2 Configurare l'indirizzo del server SMTP mediante le impostazioni locali. 3 Per utilizzare questo script su una stampante MFP, è necessario un touch screen. In caso contrario, utilizzare Select'N'Send oppure Print'N'Send. Se si dispone di un touch screen, creare un profilo utilizzando un file TIFF con risoluzione 300 dpi e tonalità 4. In questo modo, l'acquisizione ottica garantirà risultati ottimali. 18

22 Esempio 7: Prompt avanzati II Panoramica: Eseguire la convalida dei dati man mano che l'utente risponde ai prompt dinamici. Dettagli: Un dipendente deve acquisire dei documenti tramite scanner ma desidera separarli in base al negozio di destinazione e al reparto che ne ha fatto richiesta. Questo script richiede di specificare il numero del negozio. Se il numero del negozio è valido, viene visualizzato l'elenco dei reparti di tale negozio. In caso contrario, viene visualizzato un messaggio di errore e viene richiesto di specificare nuovamente il numero del negozio. Una volta raccolte tutte le informazioni necessarie, il documento viene acquisito tramite scanner e salvato nell'ubicazione appropriata del file system locale. Script: 1 Questo script consente di richiedere all'utente finale alcune informazioni; a tal fine, è necessario configurare alcuni prompt. Il primo prompt è un numero intero corrispondente al numero del negozio. Il secondo è un messaggio di errore che viene visualizzato nel caso in cui il numero di divisione specificato non sia valido. In questo esempio viene illustrato anche un terzo prompt che viene configurato dopo aver fornito l'informazione richiesta; tutti i prompt e le variabili utilizzati nel blocco dei prompt devono essere dichiarati prima di inserire il blocco dei prompt. intprompt store store.setprompttext("immettere il numero del negozio:") messageprompt errmsg errmsg.setprompttext("numero di negozio non valido; immettere nuovamente il numero.") stringprompt dept string storename, item 2 Alcuni prompt sono stati configurati ed altri dichiarati. A questo punto, viene utilizzato il blocco dei prompt per richiedere informazioni. Quando viene selezionato questo script, questa parte viene eseguita prima dell'acquisizione tramite scanner. Dato che le informazioni vengono convalidate e utilizzate per formulare altri prompt, l'operazione prevede più passi. prompt 19

23 3 Questo passo richiede di indicare il numero del negozio. Dopo averlo specificato, il numero di divisione viene ricercato all'interno del database per verificarne la validità. Se il numero è valido, il nome del negozio viene recuperato dal database e nextstep viene impostato su dept. In caso contrario, nextstep viene impostato su error. step "storenum" ask(store) with ODBCRead.Reset().DataSource=local.DataSource.TableName="negozi".LogonName=local.LogonName.LogonPassword=local.LogonPassword.DataColumns="NomeNegozio".WhereClause="NumeroNegozio=" + store.asstring() if (.GetNextRow()) then storename =.GetString("NomeNegozio") nextstep "oformat" else nextstep "error" endif.finished() 4 Questo passo viene utilizzato nel caso in cui venga specificato un numero di negozio non valido. Viene visualizzato un messaggio di errore in cui viene richiesto di specificare nuovamente il numero del negozio. Una volta accettato il messaggio, nextstep viene impostato su storenum; in altre parole, il primo prompt viene nuovamente inviato all'utente. step "error" ask(errmsg) nextstep "storenum" 5 Questo passo viene utilizzato nel caso in cui sia stato specificato un numero di divisione valido. Il testo del prompt viene impostato in modo da comprendere il nome della divisione selezionata. Quindi vengono recuperati dal database i reparti validi per la divisione. step "dept" dept.setprompttext("selezionare il reparto della divisione " + storename) with ODBCRead.Reset().DataSource=local.DataSource.TableName="Reparti".LogonName=local.LogonName.LogonPassword=local.LogonPassword.DataColumns="Reparto".WhereClause="NumeroNegozio=" + store.asstring() 20

24 6 Ciascun reparto viene aggiunto come opzione all'elenco a selezione singola. repeat until (.GetNextRow() == FALSE) item =.GetString("Reparto") dept.addpromptoption(item) endrepeat.finished() 7 A questo punto, il prompt è configurato. L'utente potrà selezionare il reparto di destinazione del documento acquisito tramite scanner. Poiché si tratta dell'ultima informazione richiesta, viene utilizzata la directive laststep. ask(dept) laststep endprompt 21

25 8 Una volta specificate le informazioni, il documento viene acquisito tramite scanner e inviato come tutti gli altri processi non contenenti prompt. A questo punto, quando il processo viene riavviato, riprende l'esecuzione dello script. Creare l'intero percorso e il nome da utilizzare per salvare il file. Il file viene salvato nella sottodirectory relativa al reparto, all'interno della directory corrispondente al numero di divisione che si trova in c:\lexmark. Il nome finale avrà il seguente formato: c:\lexmark\storenum\department name\scan_timestamp.tif. string filepath = "c:\lexmark\" + store.asstring() + "\" + dept + "\scan.tif" 9 Il file viene salvato nel percorso specificato nel passo precedente utilizzando l'azione SaveToFile. AppendTimestamp è impostato su TRUE; pertanto, viene utilizzato un nome univoco. CreateDirectory è impostato su TRUE; pertanto, vengono create le directory che non esistono. with SaveToFile.input=original.document.Path=filepath.AppendTimestamp=TRUE.CreateDirectory=TRUE Per eseguire questo script: 1 Sul server, installare il database che si desidera utilizzare. In questo esempio, verrà utilizzato il database Microsoft Access fornito, stores.mdb. Questo file si trova nella directory degli esempi di script installata con Workflow Composer. Configurare la connessione ODBC. Per ulteriori informazioni, vedere l'appendice A. 2 Caricare lo script sul server utilizzando Server Manager. 3 Configurare i dati di connessione ODBC mediante le impostazioni locali. 4 Per utilizzare questo script su una stampante MFP, è necessario un touch screen. In caso contrario, utilizzare Select'N'Send oppure Print'N'Send. Se si dispone di un touch screen, creare un profilo. 5 Nel database sono presenti tre numeri di divisione: 10, 20 e 30. Se si immette un numero non valido, viene visualizzato un messaggio di errore. Questo script evidenzia l'importanza dei prompt per la convalida dei dati immessi e dell'utilizzo delle informazioni per poter disporre di diverse selezioni in modo dinamico. Questo esempio consente di salvare il file su disco; può essere utilizzato come complemento dell'esempio 2: Stampa di un documento. In questo caso, l'indirizzo IP della stampante corrispondente alla divisione e al reparto selezionati viene recuperato dal database e utilizzato per inviare la stampa. 22

26 Script Document Producer Esempio 8: Unione di dati e stampa di un modulo Panoramica: Unire i dati in un modulo e stamparlo. Dettagli: Utilizzando Document Producer, un'azienda deve reindirizzare il flusso di stampa ASCII da una stampante caricata con moduli prestampati a Document Server. Questo script consente di unire i dati in ricezione utilizzando un FormSet, creato con Forms Composer, e di stamparlo su un foglio bianco. Script: 1 Utilizzare i dati in ricezione, original.dataset, con l'azione MergeForm per generare un PDF del modulo compilato. with MergeForm.input=original.dataset 2 Le opzioni di stampa, ad esempio fronte/retro, origine carta e dimensioni carta, vengono configurate quando viene creato il FormSet e impostate mediante la proprietà printoptions. Le opzioni di finitura, ad esempio la cucitura e la perforazione, non possono essere impostate nel FormSet. Per aggiungere altre impostazioni o sostituire quelle del FormSet, creare un oggetto printoptions e specificare le impostazioni desiderate. In questo caso, viene attivata la funzione di perforazione. printoptions po = MergeForm.printoptions po.setjoboption(ldd_printoption_holepunch, LDD_HOLEPUNCH_ON) 3 Utilizzare l'azione PrintForm per stampare il modulo PDF. L'indirizzo IP e il tipo di stampante vengono configurati mediante le impostazioni locali. Se la stampante utilizzata è dotata di una scheda SIMM ImageQuick, il modulo PDF viene inviato direttamente alla stampante. In caso contrario, il modulo PDF viene prima convertito in PostScript. with PrintForm.input=MergeForm.output.IPAddress=local.PrinterAddress.PrinterType=local.PrinterType.PrintOptions=po.WaitForCompletion=FALSE 23

27 Per eseguire questo script: 1 Caricarlo sul server utilizzando Server Manager. 2 Configurare le informazioni relative alla stampante mediante le impostazioni locali. 3 Caricare l'esempio di nota di addebito incluso in Forms Composer. Creare una named pipe denominata "test". Per ulteriori informazioni, vedere l'appendice B. 4 Aprire una finestra del prompt dei comandi sul computer su cui è installato Document Server. Utilizzando il file di dati di esempio incluso in Forms Composer, emulare un flusso di stampa digitando quanto segue: copy /b debittext.txt \\.\pipe\test L'opzione /b consente di effettuare una copia binaria. Il file debittext.txt contiene un file di dati campione formattato come se fosse stato inviato a una stampante. \\.\pipe\test consente di copiare il file nella named pipe creata nell'appendice B. Se lo si esegue da un computer diverso da quello su cui è installato Document Server, sostituire il punto (".") con l'indirizzo IP del computer su cui è installato il server. Nota: Per ulteriori informazioni sulla configurazione delle code di stampa in Windows, consultare la Guida in linea di Forms Composer e Server Manager. 24

28 Esempio 9: Unione di dati e invio di un modulo tramite fax Panoramica: Unire i dati in un modulo e inviarlo tramite fax. Dettagli: Utilizzando Document Producer, un'azienda deve reindirizzare il flusso di stampa ASCII da una stampante caricata con moduli prestampati a Document Server. Questo script consente di unire i dati in ricezione utilizzando un FormSet creato con Forms Composer e di inviare il documento risultante tramite fax. Script: 1 Utilizzare i dati in ricezione, original.dataset, con l'azione MergeForm per generare un PDF del modulo compilato. with MergeForm.input=original.dataset 2 L'output dell'azione MergeForm è un PDF. È necessario convertirlo in un'immagine TIFF per poterlo convertire in un file PostScript. with ConvertImageFormat.input=MergeForm.output.Format=LDD_IMGFORMAT_TIFG4.ColorDepth=LDD_IMGDEPTH_BW.AllPages=TRUE 3 Convertire l'immagine TIFF in un file PostScript per poterlo inviare tramite fax. with ConvertToDocument.input=ConvertImageFormat.output.Format=LDD_DOCFORMAT_PS.AllPages=TRUE.PaperSize=LDD_PAPERSIZE_LETTER.Orientation=LDD_ORIENTATION_AUTO 4 Ricavare il numero di fax dall'insieme di dati inviato. È possibile recuperare qualsiasi valore di qualunque variabile presente in un FormSet e utilizzarlo in uno script. string faxnumber = original.dataset.getdataitem("fax_number") 25

29 5 Utilizzare l'azione FaxByPrinter per inviare il fax. Il fax viene inviato mediante una stampante MFP con funzionalità fax. L'indirizzo IP della stampante MFP viene configurato mediante le impostazioni locali. with FaxByPrinter.input=ConvertToDocument.output.IPAddress=local.IpAddress.StationID="ID stazione fax".faxnumber=faxnumber.waitforcompletion=false.redialminutes=5.redialtimes=3 Per eseguire questo script: 1 Caricarlo sul server utilizzando Server Manager. 2 Configurare le informazioni relative alla stampante mediante le impostazioni locali. 3 Caricare l'esempio di copertina fax incluso in Forms Composer. Creare una named pipe denominata "test". Per ulteriori informazioni, vedere l'appendice B. 4 Aprire una finestra del prompt dei comandi sul computer su cui è installato Document Server. Utilizzando il file di dati di esempio incluso in Forms Composer, emulare un flusso di stampa digitando quanto segue: copy /b faxcover.txt \\.\pipe\test L'opzione /b consente di effettuare una copia binaria. Il file faxcover.txt contiene un file di dati campione formattato come se fosse stato inviato a una stampante. \\.\pipe\test consente di copiare il file nella named pipe creata nell'appendice B. Se lo si esegue da un computer diverso da quello su cui è installato Document Server, sostituire il punto (".") con l'indirizzo IP del computer su cui è installato il server. Nota: Mentre lo script consente di recuperare solo il numero di fax, in un FormSet è anche possibile ottenere l'indirizzo , il numero cliente o qualunque altra variabile. Sarà quindi possibile utilizzare questi valori nello script. Questo script consente di inviare il fax mediante una stampante MFP; è possibile modificare lo script in modo che invii il fax mediante un server fax che supporti la posta elettronica SMTP. È anche possibile archiviare il modulo per usarlo in seguito utilizzando una delle altre azioni supportate dal server. 26

30 Script Document Portal Esempio 10: Stampa di un modulo vuoto Panoramica: Stampare un modulo vuoto. Dettagli: Si tratta di uno script di base utilizzato da Document Portal per stampare moduli vuoti mediante una stampante PostScript. Script: 1 Creare un dataset per passare all'azione MergeForm. Dato che si desidera un modulo vuoto, questo dataset conterrà solo il nome del FormSet da utilizzare. Il FormSet viene specificato mediante la proprietà formsetname dell'oggetto originale. dataset merge_input merge_input.setformset(original.formsetname) 2 Utilizzare l'azione MergeForm per generare il modulo PDF vuoto. with MergeForm.input=merge_input 3 Utilizzare l'azione PrintForm per stampare il PDF generato dall'azione MergeForm. L'indirizzo IP della stampante e le opzioni di stampa vengono specificati mediante le proprietà printerip e printoptions dell'oggetto originale. Queste impostazioni vengono configurate in Document Portal Admin. In questo caso, il tipo di stampante è impostato su PostScript; se la stampante utilizzata dispone dell'opzione ImageQuick, impostare il tipo LDD_PRINTERTYPE_LEXIQ. with PrintForm.input=MergeForm.output.IPAddress=original.printerip.PrinterType=LDD_PRINTERTYPE_LEXPS.PrintOptions=original.printoptions.WaitForCompletion=FALSE 27

31 Per eseguire questo script: 1 Caricarlo sul server utilizzando Document Portal Admin. 2 Nel caso in cui sul server non sia stato caricato alcun PDF o FormSet, caricarne uno. Associare lo script a un FormSet caricato. 3 Utilizzando una stampante MFP con touch screen, selezionare l'icona relativa ai moduli, quindi il modulo associato a questo script. 28

32 Esempio 11: Prompt e stampa di un modulo vuoto Panoramica: Utilizzare i prompt e stampare il modulo selezionato. Dettagli: Questo script è utile per le stampanti a colori. Richiede all'utente di specificare se il modulo deve essere stampato a colori o in bianco e nero. In questo modo è possibile utilizzare un solo script per entrambi i tipi di output. Script: 1 Questo script consente di richiedere all'utente finale alcune informazioni; a tal fine, è necessario configurare un prompt. Si tratta di un elenco a selezione singola che consente di selezionare Bianco e nero o Colore. Come nel caso di tutti gli script che richiedono informazioni, tutti i prompt e le variabili utilizzati nel blocco dei prompt devono essere dichiarati prima di immettere il blocco dei prompt. stringprompt color with color.setprompttext("selezionare l'output desiderato:").addpromptoption("bianco e nero").addpromptoption("colore") 2 Una volta configurata la domanda, viene utilizzato il blocco dei prompt per richiedere l'informazione. Quando viene selezionato questo script, questa parte viene eseguita prima di inviare il processo al server. Dato che viene richiesta una sola informazione, è necessario un unico passo. prompt step "prompts" ask(color) laststep endprompt 3 Una volta specificata l'informazione, il processo viene inviato come tutti gli altri processi non contenenti prompt. A questo punto, quando il processo viene riavviato, riprende l'esecuzione dello script. 4 Creare un dataset per passare all'azione MergeForm. Dato che si desidera un modulo vuoto, questo dataset conterrà solo il nome del FormSet da utilizzare. Il FormSet viene specificato mediante la proprietà formsetname dell'oggetto originale. dataset merge_input merge_input.setformset(original.formsetname) 5 Utilizzare l'azione MergeForm per generare il modulo PDF vuoto. with MergeForm.input=merge_input 29

33 6 Lo script modifica le opzioni di stampa associate al processo. A seconda della selezione, la stampante verrà impostata in modo da eseguire la stampa utilizzando le cartucce a colori o solo la cartuccia di inchiostro nero. printoptions opts = original.printoptions if (color == "Colore") opts.setjoboption(ldd_printoption_colormodel, LDD_COLORMODEL_CMYK) else opts.setjoboption(ldd_printoption_colormodel, LDD_COLORMODEL_BLACK) endif 7 Utilizzare l'azione PrintForm per stampare il PDF generato dall'azione MergeForm. L'indirizzo IP della stampante viene specificato mediante la proprietà printerip dell'oggetto originale. Le opzioni di stampa sono quelle modificate nel passo precedente. Le impostazioni di stampa originali vengono configurate in Document Portal Admin. In questo caso, il tipo di stampante è impostato su PostScript; se la stampante utilizzata dispone di una scheda SIMM ImageQuick, impostare il tipo LDD_PRINTERTYPE_LEXIQ. with PrintForm.input=MergeForm.output.IPAddress=original.printerip.PrinterType=LDD_PRINTERTYPE_LEXPS.PrintOptions=opts.WaitForCompletion=FALSE Per eseguire questo script: 1 Caricarlo sul server utilizzando Document Portal Admin. 2 Nel caso in cui sul server non sia stato caricato alcun PDF o FormSet, caricarne uno. Associare lo script a un FormSet caricato. 3 Utilizzando una stampante MFP con touch screen collegata a una stampante a colori, selezionare l'icona relativa ai moduli, quindi il modulo associato a questo script. 30

34 Appendice A: Configurazione ODBC Attenersi alla seguente procedura per creare le connessioni DSN ODBC utilizzate per l'esempio 4 e 7. I DSN vengono creati utilizzando lo stesso computer su cui è installato Document Server. 1 In Windows NT: Selezionare Impostazioni Pannello di controllo. In Windows 2000/XP: Selezionare Impostazioni Pannello di controllo Strumenti di amministrazione. 2 Selezionare Origini dati ODBC. 3 Selezionare la scheda relativa ai DSN di sistema. Fare clic su Aggiungi. Viene visualizzato l'elenco dei driver ODBC installati sul computer. Selezionare "Microsoft Access Driver (*.mdb)" dall'elenco e fare clic su Fine. 4 Viene visualizzata la finestra di dialogo relativa all'installazione di ODBC Microsoft Access. Per l'esempio 4, immettere il nome origine dati "LDD1"; per l'esempio 7, immettere "LDD2". Fare clic sul pulsante Seleziona per selezionare il database da utilizzare per la connessione. Per l'esempio 4, selezionare il database "resumes.mdb"; per l'esempio 7, selezionare "stores.mdb". Fare clic su OK. 5 Una volta aggiunti, entrambi i DSN compariranno nell'elenco dei DSN di sistema. 6 Fare clic su OK per chiudere la finestra di dialogo. A questo punto, le connessioni sono configurate ed è possibile utilizzarle all'interno di uno script. Quando si caricano gli script, sono disponibili le impostazioni locali relative all'esempio 4 e 7 che consentono di configurare le impostazioni ODBC. In genere, i dati necessari per tutte le connessioni ODBC sono due; gli altri due sono facoltativi. È necessario specificare il DSN. Il nome origine dati è quello specificato nel passo 5. È necessario specificare il nome della tabella. Si tratta del nome della tabella contenente i dati utilizzati nello script. Se si utilizzano i database inclusi negli esempi, è possibile utilizzare i nomi predefiniti delle tabelle presenti nelle impostazioni locali. Il nome utente è facoltativo. Se non si richiede di effettuare l'accesso, è possibile lasciare vuoto questo campo. Per impostazione predefinita, per il database Microsoft Access non è necessario effettuare l'accesso. La password è facoltativa. Se non si richiede di effettuare l'accesso, è possibile lasciare vuoto questo campo. 31

35 Appendice B: Configurazione di un FormSet Questa appendice illustra la procedura necessaria per caricare un FormSet e configurare la named pipe per poterlo utilizzare. Queste informazioni servono per eseguire l'esempio 8 e 9. In Server Manager: 1 Se non lo si è già fatto, caricare lo script da utilizzare per questo FormSet. Per questi esempi, caricare "example08.xdd" o "example09.xdd". 2 Fare clic su Aggiungi formset nella pagina iniziale. Viene avviata la procedura Aggiunta guidata formset. Per prima cosa, selezionare il FormSet da caricare. Per l'esempio 8, selezionare "debitmemo.fdd"; per l'esempio 9, selezionare "faxcover.fdd". Entrambi i FormSet sono inclusi nelle directory di esempio installate con Forms Composer. Fare clic su Avanti. La pagina successiva della procedura guidata consente di selezionare l'azione da eseguire quando si ricevono i dati per questo FormSet. Le opzioni disponibili sono tre: l'azione viene specificata dalla pipe o nel flusso di dati, è necessario utilizzare una delle azioni predefinite oppure è necessario utilizzare uno script personalizzato. Negli esempi, si utilizzerà uno script personalizzato. Selezionare lo script appropriato (example08 o example09) dall'elenco. 3 Fare clic su Avanti. Nell'ultima pagina della procedura guidata viene visualizzato un riepilogo delle selezioni effettuate. Se non si è creata la named pipe da utilizzare per questi esempi, selezionare la casella che consente di avviare la procedura Creazione guidata named pipe. 4 Fare clic su Fine. Se è necessario creare la named pipe, viene avviata la procedura Creazione guidata named pipe; in caso contrario, la procedura è terminata ed è possibile procedere con l'esecuzione dello script. 5 Per prima cosa, all'interno di Creazione guidata named pipe, denominare la pipe. In questi esempi, si creerà una sola pipe. Selezionare lo script appropriato (example08 o example09) dall'elenco. Fare clic su Avanti. 6 La pagina successiva della procedura guidata consente di configurare la pipe in modo da accettare dati per uno o più FormSet. Dato che la pipe creata può essere utilizzata in entrambi gli esempi, selezionare "La pipe verrà utilizzata da più formset". Fare clic su Avanti. 7 La pagina successiva della procedura guidata consente di configurare l'azione da eseguire quando si ricevono dati nella pipe. Questa pagina è simile a quella della procedura Aggiunta guidata formset che consente di configurare l'azione da eseguire quando si ricevono i dati per il FormSet. Dato che l'azione relativa al FormSet è stata già configurata (viene eseguito uno script personalizzato), selezionare "L'azione verrà specificata nel flusso di stampa". Fare clic su Avanti. 32