Document Distributor Scripteksempler Marts 2003 www.lexmark.com
Udgave: Marts 2003 Det følgende afsnit gælder ikke for lande, hvor sådanne bestemmelser ikke er i overensstemmelse med det pågældende lands lovgivning: LEXMARK INTERNATIONAL, INC. UDSENDER DETTE DOKUMENT "SOM DET ER OG FOREFINDES" UDEN GARANTI AF NOGEN ART, ENTEN UDTRYKKELIG ELLER STILTIENDE, HERUNDER, MEN IKKE BEGRÆNSET TIL, DE STILTIENDE GARANTIER FOR SALGBARHED ELLER EGNETHED TIL SÆRLIGE FORMÅL. Nogle stater tillader ikke ansvarsfraskrivelse for udtrykkeligt eller stiltiende ansvar ved bestemte transaktioner, og derfor er denne erklæring måske ikke gældende for dig. Dokumentet kan indeholde tekniske unøjagtigheder eller trykfejl. Der foretages regelmæssige ændringer af oplysningerne heri. Ændringerne vil blive medtaget i senere udgaver. Forbedringer og ændringer af det beskrevne produkt eller program kan foretages på et hvilket som helst tidspunkt. Kommentarer til denne udgivelse kan sendes til Lexmark International, Inc., Department F95/032-2, 740 West New Circle Road, Lexington, Kentucky 40550, USA. I Storbritannien og Irland skal de sendes til Lexmark International Ltd., Marketing and Services Department, Westhorpe House, Westhorpe, Marlow Bucks SL7 3RQ. Lexmark kan frit bruge eller distribuere alle de indsendte oplysninger, som Lexmark finder det passende, uden at forpligte sig over for dig. Du kan købe yderligere kopier af publikationer, som er beslægtet med dette produkt, ved at ringe på 1-800-553-9727. I Storbritannien og Irland skal du ringe på +44 (0)8704 440 044. I andre lande, skal du kontakte det sted, hvor du har købt produktet. Henvisninger i dette dokument til produkter, programmer eller tjenester indebærer ikke, at producenten har til hensigt at markedsføre disse i alle de lande, hvor producenten opererer. Henvisninger til et produkt, et program eller en tjeneste har ikke til hensigt at fastslå eller antyde, at kun dette produkt, dette program eller denne tjeneste kan bruges. Produkter, programmer eller tjenester med lignende funktionalitet, som ikke krænker eksisterende ejendomsrettigheder, kan bruges i stedet. Evaluering og verifikation af produktets evne til at fungere sammen med andre produkter, programmer eller tjenester, undtagen dem der er udpeget af producenten, er brugerens eget ansvar. Lexmark og Lexmark med diamantformen er varemærker tilhørende Lexmark International, Inc. og er registreret i USA og/eller andre lande. Copyright 2003 Lexmark International, Inc. Alle rettigheder forbeholdes. RETTIGHEDER I FORBINDELSE MED DEN AMERIKANSKE REGERING Denne software og den medfølgende dokumentation, som leveres under denne aftale, er kommerciel software og dokumentation, som udelukkende er udviklet for egen regning.
Indholdsfortegnelse Introduktion...1 Document Distributor-scripts...2 Eksempel 1: Lagring i en fil... 2 Eksempel 2: Udskrivning af et dokument... 3 Eksempel 3: Prompt og afsendelse af en e-mail... 5 Eksempel 4: Lagring af data i en database... 8 Eksempel 5: Adskillelse af sider ved hjælp af stregkoder... 12 Eksempel 6: Avancerede prompter I... 15 Eksempel 7: Avancerede prompter II... 19 Document Producer-scripts...23 Eksempel 8: Sammenfletning af data og udskrivning af en formular... 23 Eksempel 9: Sammenfletning af data og faxning af en formular... 25 Document Portal-scripts...27 Eksempel 10: Udskrivning af en tom formular... 27 Eksempel 11: Prompt til brugeren og udskrivning af en tom formular... 29 Appendiks A: ODBC-opsætning...31 Appendiks B: FormSet-opsætning...32 iii
Introduktion Denne bog indeholder eksempler på konstruktioner og objekter, der udgør det scriptsprog, som bruges i Lexmark Document Solutions-programpakken. Eksemplerne er inddelt i tre kapitler. I hvert kapitel beskrives et medlem af programpakken. Du kan vælge at gennemse dem alle eller kun dem, der gælder for dit program. Alle eksemplerne i denne bog leveres sammen med Workflow Composer-softwaren. Det anbefales, at du har adgang til Workflow Composer og Server Manager eller Document Portal Admin, så du kan arbejde med de pågældende scripts, efterhånden som du arbejder dig igennem bogen. Når du overfører de pågældende scripts til Document Server, bliver du bedt om at angive miljøspecifikke oplysninger, der er nødvendige for at udføre disse scripts. Når du f.eks. skal angive IP-adressen til SMTP-serveren, vises "local.mailserver" i scriptet. Det erstattes af den værdi, du angiver. 1
Document Distributor-scripts Eksempel 1: Lagring i en fil Oversigt: Lagring af det scannede dokument i en fil. Detaljer: En medarbejder skal scanne fakturaer på MFP'en og gemme dem på det lokale filsystem. Script: with SaveToFile.input=original.document.Path="c:\lexmark\invoice.tif".AppendTimestamp=TRUE.CreateDirectory=TRUE Sådan køres dette script: 1 Overfør det til serveren ved hjælp af Workflow Composer eller Server Manager. 2 Opret en profil på en MFP ved hjælp af Server Manager. Bemærk! Hvis du angiver AppendTimestamp til TRUE, tildeles alle gemte filer automatisk hvert sit filnavn. Det filnavn, der genereres, er: c:\lexmark\invoice_mon_dd_yyyy_hh_mm_ss_ms.tif Det er vigtigt at bemærke, at det samme tidsstempel bruges til hele scriptet. Hvis du f.eks. aktiverer SaveToFile flere gange under kørsel af det samme script, anvendes det samme tidsstempel. Hvis det er nødvendigt, kan tidsstemplet angives manuelt ved at angive en entydig værdi for egenskaben usertime til det oprindelige objekt. Det kan du se et eksempel på i Eksempel 5: Adskillelse af sider ved hjælp af stregkoder. Hvis du angiver egenskaben CreateDirectory til TRUE, opretter handlingen biblioteker i stien, der ikke findes. Dette er især nyttigt, hvis selve tidsstemplet bruges som en del af biblioteksnavnet. 2
Eksempel 2: Udskrivning af et dokument Oversigt: Udskrivning af et scannet dokument på en anden printer. Detaljer: En medarbejder skal sende en intern fax, dvs. en fax til andre medarbejdere i samme virksomhed. Da man har et LAN-netværk, der dækker hele virksomheden, og printere er tilgængelige i alle lokationer, udskrives dette script direkte på printerne, og det er ikke nødvendigt at sende en fax. Dette medfører en udskrift i høj kvalitet og en besparelse af telefonudgifter. Derudover føjes tidsstemplet til udskriften, så den ligner en fax. Script: 1 Brug adskillelsesmetoden til at opdele værdien for usertime i flere dele. Opret derefter oplysningsstrengen, der er påstemplet de enkelte sider af udskriften. Strengens syntaks er "Sent by IP address on date at time". stringarray time = original.usertime.separate("_") string stamp = "Sent by " + original.userip stamp.concatenate(" on " + time[2] + " " + time[3] + " " + time[4]) stamp.concatenate(" at " + time[5] + ":" + time[6]) 2 Brug handlingen ImageText til at tilføje tidsstemplet nederst til højre på alle sider, der sendes. 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 Brug handlingen ConvertToDocument til at konvertere TIFF-billedet til PostScript, så det kan udskrives. Bemærk, at vi bruger udskriften fra handlingen ImageText, så vi får et TIFF-billede med tidsstempel. with ConvertToDocument.input=ImageText.output.Format=LDD_DOCFORMAT_PS.AllPages=TRUE.PaperSize=LDD_PAPERSIZE_LETTER.Orientation=LDD_ORIENTATION_AUTO 3
4 Brug handlingen PrintJob til at sende PostScript-filen til den angivne printer. Hvis printeren er installeret med et ImageQuick SIMM-kort, kan du sende TIFF-filen direkte til printeren uden at konvertere den til PostScript først. 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) Sådan køres dette script: 1 Overfør det til serveren ved hjælp af Server Manager. 2 Konfigurer printerens IP-adresse, så den kan angives via lokale indstillinger. 3 Opret en profil på en MFP. 4
Eksempel 3: Prompt og afsendelse af en e-mail Oversigt: Udførelse af OCR på et dokument og afsendelse af dokumentet til brugeren via e-mail. Detaljer: En virksomhed vil gøre det lettere for medarbejderne at udføre OCR på trykte dokumenter, uden at de skal installere OCR-softwaren på virksomhedens computere. Dette script bruges til at anmode brugeren om at angive e-mail-adressen og derefter spørge, om dokumentet skal være i RTF-format (anvendes af de fleste tekstbehandlingsprogrammer) eller i PDF-format. Scriptet konverterer dokumentet og sender det derefter til brugeren via e-mail. Script: 1 Dette script stiller slutbrugeren spørgsmål, så disse spørgsmål skal opstilles. Det første spørgsmål er en streng, der anmoder om en e-mail-adresse. Det andet spørgsmål er en enkeltvalgsliste, der spørger om filens format. stringprompt email email.setprompttext("enter your email address") stringprompt format with format.setprompttext("select the file format").addpromptoption("rtf").addpromptoption("pdf") 2 Spørgsmålene er udarbejdet. Nu bruges promptblokken til at stille spørgsmålene. Når brugeren vælger dette script, er det den del af scriptet, der udføres, før der foretages scanning. Da svarene på spørgsmålene ikke påvirker efterfølgende spørgsmål, og da svarene ikke skal bekræftes, kan spørgsmålene stilles på én gang. prompt step "prompts" ask(email) ask(format) laststep endprompt 3 Når spørgsmålene er stillet, scannes dokumentet og sendes på samme måde som alle andre job uden en prompt. Udførelsen af scriptet genoptages nu, når jobbet genstartes. 5
4 Bemærk det valgte format, og konverter inputdokumentet til PDF eller RTF. Outputdokumentet gemmes med variablen ocr, så det kan bruges sammen med e-mail-handlingen. 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 Handlingen EmailSMTP bruges nu til at sende e-mailen med OCR-dokumentet som en vedhæftet fil. Den anvendte e-mail-adresse blev hentet fra slutbrugeren, da jobbet blev sendt. IP-adressen til SMTP-serveren blev defineret som en lokal indstilling. Når scriptet overføres til serveren, anmoder Server Manager om den værdi, der skal bruges til denne egenskab. with EmailSMTP.Server=local.emailserver.To=email.From=email.Subject="Your scanned document".message="attached is your scanned document in the format you requested.".characterset=ldd_smtpcharset_us.attachments=ocr 6
Sådan køres dette script: 1 Overfør det til serveren ved hjælp af Server Manager. 2 Konfigurer SMTP-serveradressen ved hjælp af lokale indstillinger. 3 Hvis du vil køre dette script på en MFP, skal du have en berøringsskærm. Hvis du ikke har én, kan du bruge Select'N'Send eller Print'N'Send i stedet. Hvis du har én, skal du oprette en profil med TIFF, en opløsning på 300 dpi og en sværtningsgrad på 4. Det giver det bedste OCR-resultat. Bemærk! Handlingen EmailSMTP kan erstattes med visse GroupWare-understøttede objekter, f.eks. Lotus Notes (EmailNotes), Microsoft Exchange (EmailExchange) og Novell GroupWise (GWMail). Den største fordel ved at bruge disse objekter er, at scriptet kan gøre brug af adressekartoteket og GroupWare-specifikke funktioner. Der er dog visse installationskrav i forbindelse med disse objekter. I de fleste tilfælde kan GroupWare-servere konfigureres til at acceptere SMTP-e-mail. Hvis scriptet ikke skal bruge de specielle funktioner, er den mere overordnede handling EmailSMTP tilstrækkelig. 7
Eksempel 4: Lagring af data i en database Oversigt: Lagring af det scannede dokument i en database. Detaljer: Afdelingen for Human Resources er ansvarlig for at holde styr på alle cv'er. Dette script bruges til at gemme cv'et i en database. Derudover konverteres cv'et til tekst, som også gemmes i databasen. Når teksten gemmes, kan der i databasen søges efter visse nøgleord, og der kan derefter returneres en liste over alle cv'er, der opfylder søgekriterierne. Da cv'et også findes der, kan det gennemses, udskrives eller sendes til en anden lokation. Script 4A skal bruges af databaser, der bruger BLOB'er (Binary Large Objects). BLOB'er bruges af databaser, der kan gemmes filer i. Eksempler på sådanne databaser er Oracle, Microsoft SQL Server og IBM DB2. Script 4B skal bruges af databaser, f.eks. Microsoft Access, der ikke understøtter BLOB'er. Hvis du vil udføre samme opgave, skal dokumentet gemmes i det lokale filsystem. Filens placering gemmes derefter i databasen, så den kan hentes senere. Script 4A: 1 Konverter det sendte dokument til tekst. Denne tekst gemmes i databasen og kædes sammen med cv'et, så den kan søges i. with ImageToText.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.OneLine=TRUE.SeparateParagraphs=TRUE.PageBreaks=FALSE.AppendEOF=FALSE.AllPages=TRUE 2 Brug tekstfilobjektet til at læse den tekst, der fremkommer ved handlingen ImageToText, og til at gemme den i en streng. textfile tf string ocrtext tf.open(imagetotext.output) ocrtext = tf.read(tf.size()) tf.close() 3 Indsæt cv'et sammen med teksten i databasen, så den kan hentes senere. Egenskaberne for databasen konfigureres via lokale indstillinger, når scriptet overføres til serveren. with ODBCWrite.DataSource=local.DataSource.TableName=local.TableName.LogonName=local.LogonName.LogonPassword=local.LogonPassword.AssignValue("ScanDate","").AssignValue("OCRText",ocrText).AssignValue("Resume",original.document) 8
Sådan køres dette script: 1 Angiv indstillinger for den database, der skal bruges, på serveren. Filerne LDDOracleTable.sql og LDDSQLServerTable.sql kan bruges til at oprette eksempeltabellerne i Oracle og Microsoft SQL Server. Disse filer findes i scriptets eksempelbibliotek, der installeres sammen med Workflow Composer. Når du har angivet indstillinger for databasen, skal du konfigurere ODBC-forbindelsen. Yderligere oplysninger om dette finder du i Appendiks A: Konfiguration af ODBC-DSN (Data Source Names). 2 Overfør scriptet til serveren ved hjælp af Server Manager. 3 Konfigurer ODBC-forbindelsen ved hjælp af lokale indstillinger. 4 Opret en profil på en MFP. 9
Script 4B: 1 Konverter det sendte dokument til tekst. Denne tekst gemmes i databasen og kædes sammen med cv'et, så den kan søges i. with ImageToText.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.OneLine=TRUE.SeparateParagraphs=TRUE.PageBreaks=FALSE.AppendEOF=FALSE.AllPages=TRUE 2 Brug tekstfilobjektet til at læse den tekst, der fremkommer ved handlingen ImageToText, og til at gemme den i en streng. textfile tf string ocrtext tf.open(imagetotext.output) ocrtext = tf.read(tf.size()) tf.close() 3 Angiv den sti, hvor filen skal gemmes. Filen gemmes i det lokale filsystem i et bibliotek kaldet c:\lexmark. Filnavnet er resume_timestamp.tif. string filepath = "c:\lexmark\resume" + original.usertime + ".tif" 4 Da selve dokumentet ikke kan indsættes i databasen, skal du gemme dokumentet i det lokale filsystem. AppendTimestamp angives til FALSE, da vi manuelt har tilføjet tidsstemplet i forrige trin. CreateDirectory angives til TRUE, så c:\lexmark oprettes, hvis stien ikke allerede findes. with SaveToFile.input=original.document.AppendTimestamp=FALSE.Overwrite=FALSE.Path=filepath.CreateDirectory=TRUE 10
5 Indsæt filnavnet sammen med teksten i databasen, så den kan hentes senere. Egenskaberne for databasens oplysninger konfigureres via lokale indstillinger, når scriptet overføres til serveren. with ODBCWrite.DataSource=local.DataSource.TableName=local.TableName.LogonName=local.LogonName.LogonPassword=local.LogonPassword.AssignValue("ScanDate","").AssignValue("OCRText",ocrText).AssignValue("ResumeFile",filepath) Sådan køres dette script: 1 Angiv indstillinger for den database, der skal bruges, på serveren. Microsoft Access-databasen, resumes.mdb, bruges til dette eksempel. Denne fil findes i scriptets eksempelbibliotek, der installeres sammen med Workflow Composer. Når du har angivet indstillinger for databasen eller har valgt den leverede, skal du konfigurere ODBC-forbindelsen. Yderligere oplysninger om dette finder du i Appendiks A. 2 Overfør scriptet til serveren ved hjælp af Server Manager. 3 Konfigurer ODBC-forbindelsen ved hjælp af lokale indstillinger. 4 Opret en profil på en MFP. 11
Eksempel 5: Adskillelse af sider ved hjælp af stregkoder Oversigt: Brug af en side med stregkodeseparator til at opdele job af forskellig sidelængde i separate filer. Detaljer: En medarbejder skal scanne og behandle flere dokumenter. De enkelte dokumenter skal scannes separat, men det er nemmere (og mere fordelagtigt) at scanne dem alle på én gang. Det kan gøres ved hjælp af en side med en stregkodeseparator, der kan angive starten af et nyt dokument. Når du bruger separatorsiden, kan alle dokumenter indeholde et hvilket som helst antal sider. Dette script søger efter en stregkode på de enkelte sider i det scannede dokument. Når stregkoden bliver fundet, mærkes slutningen af det forrige dokument, som gemmes i en fil, og derefter mærkes starten af det nye dokument. Script: 1 Erklær alle de variabler, der bruges i dette script. doc separated int i, startpage, lastpage bool found string fullpath, bcode 2 Opdel det scannede dokument, så de enkelte sider er i hver sin fil. Det er nødvendigt, så de enkelte grupper af sider, der udgør et dokument, senere kan samles i en enkelt fil. with ImageSeparate.input=original.document.AllPages=TRUE.separated =.output 3 Brug variablen startpage til at angive den første side i det aktuelle dokument. Angiv den på den første side i det scannede dokument. startpage = 1 4 Angiv en løkke for alle de sider, der er sendt. loop i from 1 to separated.getnumberfiles() 5 Den fundne variabel angiver, at en ny gruppe sider er klar til at blive gemt. Nulstil, før du behandler de enkelte sider. found = false 12
6 Brug handlingen BarcodeRead til at afgøre, om der findes en stregkode på denne side. 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 I dette eksempel (og den leverede eksempelfil) er stregkoden ordet "BREAK". Se, om stregkoden blev fundet på denne side. if (bcode.contains("break")) then 8 Der blev fundet en stregkode. Hvis startpage er den aktuelle side (f.eks. startpage er 1, og den første side i det scannede dokument er en separatorside), skal ingen sider gemmes. I dette tilfælde er startpage i det næste dokument angivet til at være næste side. Ellers er lastpage i det aktuelle dokument angivet til den forrige side. (Angives ikke til denne side, da selve separatorsiden så også gemmes). Angiv found flag til at angive, at der er flere sider, der skal gemmes. if (startpage == i) startpage = i + 1 else lastpage = i - 1 found = true endif 9 Der blev ikke fundet en stregkode. Kontroller, om dette er den sidste side i det sendte dokument. Hvis det er tilfældet, vil det være sidste side i det aktuelle dokument. Angiv lastpage til den aktuelle side, og indstil found flag til at angive, at der er sider, der skal gemmes. else if (i == separated.getnumberfiles()) then lastpage = i found = true endif endif 10 Hvis der blev fundet nye sider, skal de gemmes. if (found == true) then 13
11 Brug handlingen ImageCombine til at samle siderne i ét dokument. with ImageCombine.input=separated.GetFileRange(startpage, lastpage).format=ldd_imgformat_tifg4.colordepth=ldd_imgdepth_bw 12 Angiv et navn til den fil, det nye dokument skal gemmes som. Dokumentet gemmes i biblioteket c:\lexmark. Filnavnet er set_timestamp_page.tif. Da alle filer, der gemmes på én gang, har det samme tidsstempel, tilføjes det sidste sidetal i dokumentet for at få et entydigt filnavn. fullpath = "c:\lexmark\set" + original.usertime + "_" + lastpage.asstring() + ".tif" 13 Gem det nye dokument på harddisken. AppendTimestamp angives til FALSE, da vi manuelt har tilføjet tidsstemplet i forrige trin. CreateDirectory angives til TRUE, så biblioteket c:\lexmark oprettes, hvis det ikke allerede findes. with SaveToFile.input = ImageCombine.output.Path=fullpath.AppendTimestamp=FALSE.Overwrite=FALSE 14 Det aktuelle dokument er nu gemt. Angiv startpage i næste dokument til at være næste side i dokumentet. Angives ikke til den aktuelle side, da næste dokument så også vil medtage separatorsiden som en del af det gemte dokument. startpage = i + 1; endif endloop Sådan køres dette script: 1 Overfør scriptet til serveren ved hjælp af Server Manager. 2 Opret en profil på en MFP med TIFF, en opløsning på 300 dpi og en sværtningsgrad på 3 eller 4. 3 Filen fullset.tif findes i scriptets eksempelbibliotek, der installeres sammen med Worfkflow Composer. Denne fil udskrives og scannes eller sendes via Select'N'Send. Når den bruges sammen med dette script, oprettes der tre separate filer på henholdsvis 3, 2 og 4 sider. 14
Eksempel 6: Avancerede prompter I Oversigt: Brug af svarene fra promptspørgsmålene til at afgøre det næste spørgsmål, der skal stilles. Detaljer: Dette script giver en bruger mulighed for at scanne et dokument og sende originalen eller en redigerbar version af dokumentet via e-mail. Det er en udvidelse til scripts i Eksempel 3: Prompt og afsendelse af en e-mail. Brugeren bliver bedt om at angive en e-mail-adresse for at sende dokumentet og bliver derefter spurgt, om der skal udføres OCR på dokumentet. På grundlag af dette svar stilles det næste spørgsmål, der omhandler format. Selvom det er et simpelt script, viser det, hvor effektive prompter er, og hvordan svaret på ét spørgsmål direkte kan føre til næste spørgsmål. Script: 1 Dette script stiller slutbrugeren spørgsmål, så disse spørgsmål skal opstilles her. Det første spørgsmål er en streng, der anmoder om en e-mail-adresse. Det andet er en boolesk prompt. Brugeren skal kontrollere det for at udføre OCR på dokumentet. Ellers sendes det som et billede. stringprompt email email.setprompttext("email address to send document") boolprompt ocr ocr.setprompttext("click to OCR the document.") 2 Hvis brugeren vælger OCR, anvendes dette spørgsmål. Det er en enkeltvalgsliste, hvor brugeren kan vælge formatet for OCR-dokumentet. stringprompt ocrformat with ocrformat.setprompttext("select the OCR format").addpromptoption("rtf").addpromptoption("pdf (Searchable)") 3 Hvis brugeren ikke vælger OCR, anvendes dette spørgsmål. Det er en enkeltvalgsliste, hvor brugeren kan vælge formatet for billeddokumentet. stringprompt imgformat with imgformat.setprompttext("select the Image format").addpromptoption("tiff").addpromptoption("pdf (Not Searchable)") 4 Spørgsmålene er udarbejdet. Nu bruges promptblokken til at stille spørgsmålene. Når brugeren vælger dette script, udføres promptdelen af scriptet, før der foretages scanning. Da svarene på spørgsmålene bruges til at vælge det næste spørgsmål, bruges flere trin. prompt 15
5 Dette trin indeholder to spørgsmål: Hvad er e-mail-adressen, og skal der udføres OCR på dokumentet. Disse spørgsmål stilles samtidig, da de ikke påvirker hinanden. Når OCR-spørgsmålet er stillet, kontrolleres returværdien. Hvis der er valgt OCR, er det næste trin, der skal udføres, oformat. Ellers er det næste trin iformat. De enkelte trin skal have en nextstep- eller laststep-directive. step "email" ask(email) ask(ocr) if (ocr == TRUE) nextstep "oformat" else nextstep "iformat" endif 6 Dette trin vælges, når brugeren har valgt OCR. Brugeren bliver bedt om at vælge formatet for OCR-dokumentet. Det er det sidste spørgsmål i denne sti, dvs. laststep-directive bruges. step "oformat" ask(ocrformat) laststep 7 Dette trin vælges, når brugeren ikke har valgt OCR. Brugeren bliver bedt om at vælge formatet for billedet. Det er det sidste spørgsmål i denne sti, dvs. laststep-directive bruges. step "iformat" ask(imgformat) laststep endprompt 8 Når spørgsmålene er stillet, scannes dokumentet og sendes på samme måde som alle andre job uden en prompt. Udførelsen af scriptet genoptages nu, når jobbet genstartes. Kontroller prompten ocr for at se, om brugeren vil udføre OCR på dokumentet. doc attach if (ocr == TRUE) 16
9 Brugeren vil udføre OCR. Kontroller det ønskede format, og udfør konverteringen. Gem resultatet af konverteringen i variblen 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 Brugeren vil ikke udføre OCR på dokumentet. Kontroller det ønskede billedformat, og udfør evt. konverteringen. Eftersom dokumentet blev scannet som TIFF, er konvertering ikke nødvendig, hvis det pågældende format er valgt. Gem resultatet af konverteringen i variblen 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
11 Handlingen EmailSMTP bruges nu til at sende e-mailen med det valgte dokument som en vedhæftet fil. Den anvendte e-mail-adresse blev hentet fra slutbrugeren, da jobbet blev sendt. IP-adressen til SMTP-serveren blev defineret som en lokal indstilling. Når scriptet overføres til serveren, anmoder Server Manager om den værdi, der skal bruges til denne egenskab. with EmailSMTP.Server=local.emailserver.To=email.cc="".bcc="".From=email.ReplyTo="".Sender="".Subject="Scanned Document".Message="Here's your scanned document(s)".characterset=ldd_smtpcharset_us.attachments=attach Sådan køres dette script: 1 Overfør det til serveren ved hjælp af Server Manager. 2 Konfigurer SMTP-serveradressen ved hjælp af lokale indstillinger. 3 Hvis du vil køre dette script på en MFP, skal du have en berøringsskærm. Hvis du ikke har én, kan du bruge Select'N'Send eller Print'N'Send i stedet. Hvis du har én, skal du oprette en profil med TIFF, en opløsning på 300 dpi og en sværtningsgrad på 4. Det giver det bedste OCR-resultat. 18
Eksempel 7: Avancerede prompter II Oversigt: Udførelse af datavalidering, efterhånden som slutbrugeren besvarer dynamiske prompter. Detaljer: En medarbejder skal scanne dokumenter, men vil opdele dem i forhold til den forretning, der skal bruge dokumenterne, og derefter i forhold til afdelingen i forretningen. Dette script anmoder om forretningsnummer. Hvis forretningsnummeret er gyldigt, vises der en liste over afdelingerne i den pågældende forretning. Ellers vises der en fejlmeddelelse, og brugeren bliver bedt om at angive forretningsnummeret igen. Når alle de nødvendige oplysninger er indhentet, scannes dokumentet, som derefter gemmes på den rette placering i det lokale filsystem. Script: 1 Dette script stiller slutbrugeren spørgsmål, så disse spørgsmål skal opstilles først. Den første prompt er et heltal, der anmoder om forretningsnummeret. Den anden er en fejlmeddelelse, der vises, hvis det indtastede forretningsnummer er ugyldigt. Den tredje prompt erklæres her, men oprettes først, når spørgsmålet er besvaret. Alle prompter og variabler, der bruges i promptblokken, skal erklæres, før promptblokken indtastes. intprompt store store.setprompttext("enter the store number:") messageprompt errmsg errmsg.setprompttext("invalid store number; please reenter.") stringprompt dept string storename, item 2 Nogle spørgsmål er udarbejdet, og andre er erklæret. Nu bruges promptblokken til at stille spørgsmålene. Når brugeren vælger dette script, er det den del af scriptet, der udføres, før der foretages scanning. Da svarene valideres og bruges til at udforme andre spørgsmål, skal der udføres flere trin. prompt 19
3 Dette trin indeholder ét spørgsmål: Hvad er forretningsnummeret. Når forretningsnummeret er angivet, slås den op i databasen for at sikre, at det er gyldigt. Hvis forretningsnummeret er gyldigt, hentes det fra databasen, og nextstep angives til dept. Hvis det ikke er gyldigt, angives nextstep til error. step "storenum" ask(store) with ODBCRead.Reset().DataSource=local.DataSource.TableName="stores".LogonName=local.LogonName.LogonPassword=local.LogonPassword.DataColumns="StoreName".WhereClause="StoreNumber=" + store.asstring() if (.GetNextRow()) then storename =.GetString("StoreName") nextstep "dept" else nextstep "error" endif.finished() 4 Dette trin bruges, hvis der er angivet et ugyldigt forretningsnummer. Der vises en fejlmeddelelse, og brugeren bliver bedt om at angive forretningsnummeret igen. Brugeren bekræfter meddelelsen, og derefter angives nextstep til storenum. Med andre ord stilles det første spørgsmål igen. step "error" ask(errmsg) nextstep "storenum" 5 Dette trin anvendes, når der er angivet et gyldigt forretningsnummer. Promptteksten angives her, så den kan indeholde navnet på den forretning, der blev valgt. De gyldige afdelinger i den pågældende forretning hentes derefter fra databasen. step "dept" dept.setprompttext("select the Department at " + storename) with ODBCRead.Reset().DataSource=local.DataSource.TableName="departments".LogonName=local.LogonName.LogonPassword=local.LogonPassword.DataColumns="Department".WhereClause="StoreNumber=" + store.asstring() 20
6 De enkelte afdelinger føjes til enkeltvalgslisten som en indstilling. repeat until (.GetNextRow() == FALSE) item =.GetString("Department") dept.addpromptoption(item) endrepeat.finished() 7 Spørgsmålet er nu færdigudarbejdet. Brugeren kan vælge, hvilken afdeling det scannede dokument skal sendes til. Det er det sidste spørgsmål, dvs. laststep-directive bruges. ask(dept) laststep endprompt 21
8 Når spørgsmålene er stillet, scannes dokumentet og sendes på samme måde som alle andre job uden en prompt. Udførelsen af scriptet genoptages nu, når jobbet genstartes. Angiv hele stien og filnavnet, hvor filen skal gemmes. Filen gemmes i biblioteket c:\lexmark i et bibliotek, hvor forretningsnummeret anvendes, og derefter i et underbibliotek for den pågældende afdeling. Det endelige navn se sådan ud: c:\lexmark\storenum\department name\scan_timestamp.tif. string filepath = "c:\lexmark\" + store.asstring() + "\" + dept + "\scan.tif" 9 Filen gemmes på harddisken ved hjælp af handlingen SaveToFile og den filsti, der er angivet i det forrige trin. AppendTimestamp angives til TRUE, så der automatisk tildeles et entydigt filnavn. CreateDirectory angives til TRUE, så biblioteker, der ikke findes, oprettes. with SaveToFile.input=original.document.Path=filepath.AppendTimestamp=TRUE.CreateDirectory=TRUE Sådan køres dette script: 1 Angiv indstillinger for den database, der skal bruges, på serveren. Microsoft Access-databasen, stores.mdb, bruges til dette eksempel. Denne fil findes i scriptets eksempelbibliotek, der installeres sammen med Workflow Composer. Konfigurer ODBC-forbindelsen. Yderligere oplysninger om dette finder du i Appendiks A. 2 Overfør scriptet til serveren ved hjælp af Server Manager. 3 Konfigurer ODBC-forbindelsen ved hjælp af lokale indstillinger. 4 Hvis du vil køre dette script på en MFP, skal du have en berøringsskærm. Hvis du ikke har én, kan du bruge Select'N'Send eller Print'N'Send i stedet. Hvis du har én, skal du oprette en profil. 5 Databasen har tre forretningsnumre: 10, 20 og 30. Hvis du angiver et ugyldigt nummer, vises der en fejlmeddelelse. I dette script vises, hvor effektive prompter er til at validere data, efterhånden som brugeren indtaster dem, og til dynamisk at bruge svarene til at give brugeren forskellige valgmuligheder. Selvom filen i dette eksempel gemmes på harddisken, kan eksemplet bruges som en udvidelse til Eksempel 2: Udskrivning af et dokument. I så fald hentes den printer-ip-adresse, der svarer til den valgte forretning og afdeling, fra databasen og bruges til at sende udskriftsjobbet. 22
Document Producer-scripts Eksempel 8: Sammenfletning af data og udskrivning af en formular Oversigt: Sammenfletning af data i en formular og udskrivning af dem. Detaljer: Ved hjælp af Document Producer vil en virksomhed omdirigere ASCII-udskriftsstreamen fra en printer, hvor der er ilagt fortrykte formularer, til Document Server. Dette script bruges til at sammenflette indgående data med et FormSet, der er oprettet i Forms Composer, og udskrive dem på tomt papir. Script: 1 Brug de indgående data, original.dataset, sammen med handlingen MergeForm til at oprette en PDF med den udfyldte formular. with MergeForm.input=original.dataset 2 Udskriftsindstillingerne, som f.eks. dupleks, papirkilde og papirstørrelse, konfigureres, når FormSet oprettes og overføres via egenskaben printoptions. Finishing-indstillinger, som f.eks. hæftning og hulning, kan ikke angives i FormSet. Hvis du vil angive flere indstillinger eller overskrive indstillinger i FormSet'et, skal du oprette et printoptions-objekt og angive de ønskede indstillinger. I følgende tilfælde aktiveres hulning. printoptions po = MergeForm.printoptions po.setjoboption(ldd_printoption_holepunch, LDD_HOLEPUNCH_ON) 3 Brug handlingen PrintForm til at udskrive PDF-formularen. Printerens IP-adresse og printertypen konfigureres via lokale indstillinger. Hvis den anvendte printer understøtter ImageQuick-funktionen, sendes PDF-formularen direkte til printeren. Ellers konverteres PDF-formularen til PostScript og sendes derefter til printeren. with PrintForm.input=MergeForm.output.IPAddress=local.PrinterAddress.PrinterType=local.PrinterType.PrintOptions=po.WaitForCompletion=FALSE 23
Sådan køres dette script: 1 Overfør scriptet til serveren ved hjælp af Server Manager. 2 Konfigurer printeren ved hjælp af lokale indstillinger. 3 Overfør eksemplet med debitnotaen, der findes i Forms Composer. Opret en navngivet pipe, der kaldes "test". Yderligere oplysninger om dette finder du i Appendiks B. 4 Åbn et kommandopromptvindue på den computer, Document Server er installeret på. Brug eksempeldatafilen, der findes i Forms Composer, til at emulere en udskriftsstream ved at skrive følgende: copy /b debittext.txt \\.\pipe\test Indstillingen /b opretter en binær kopi. Filen debittext.txt indeholder en eksempeldatafil, der er formateret til at blive sendt til en printer. \\.\pipe\test kopierer filen til den angivne pipe, der er oprettet i Appendiks B. Hvis du bruger en anden computer end den, Document Server er installeret på, skal du udskifte "." (punktum) med IP-adressen til den computer, serveren er installeret på. Bemærk! Oplysninger om konfiguration af Windows-printerkøer finder du i online Hjælp til Forms Composer og Server Manager. 24
Eksempel 9: Sammenfletning af data og faxning af en formular Oversigt: Sammenfletning af data i en formular og faxning af dem. Detaljer: Ved hjælp af Document Producer vil en virksomhed omdirigere ASCII-udskriftsstreamen fra en printer, hvor der er ilagt fortrykte formularer, til Document Server. Dette script bruges til at sammenflette indgående data med et FormSet, der er oprettet i Forms Composer, og faxe dokumentet. Script: 1 Brug de indgående data, original.dataset, sammen med handlingen MergeForm til at oprette en PDF med den udfyldte formular. with MergeForm.input=original.dataset 2 Outputdokumentet efter handlingen MergeForm er en PDF-fil. Det skal konverteres til et TIFF-billede, så det kan konverteres til PostScript. with ConvertImageFormat.input=MergeForm.output.Format=LDD_IMGFORMAT_TIFG4.ColorDepth=LDD_IMGDEPTH_BW.AllPages=TRUE 3 Konverter TIFF-billedet til PostScript, så det kan faxes. with ConvertToDocument.input=ConvertImageFormat.output.Format=LDD_DOCFORMAT_PS.AllPages=TRUE.PaperSize=LDD_PAPERSIZE_LETTER.Orientation=LDD_ORIENTATION_AUTO 4 Hent faxnummeret fra det sendte dataset. Alle værdier af en hvilken som helst variabel i et FormSet kan hentes og bruges i et script. string faxnumber = original.dataset.getdataitem("fax_number") 25
5 Brug handlingen FaxByPrinter til at sende faxen. Faxen sendes via en MFP med faxfunktioner. IP-adressen til MFP'en konfigureres via en lokal indstilling. with FaxByPrinter.input=ConvertToDocument.output.IPAddress=local.IpAddress.StationID="Fax Station ID".FaxNumber=faxnumber.WaitForCompletion=FALSE.RedialMinutes=5.RedialTimes=3 Sådan køres dette script: 1 Overfør scriptet til serveren ved hjælp af Server Manager. 2 Konfigurer printeren ved hjælp af lokale indstillinger. 3 Overfør eksemplet med faxens forside, der findes i Forms Composer. Opret en navngivet pipe, der kaldes "test". Yderligere oplysninger om dette finder du i Appendiks B. 4 Åbn et kommandopromptvindue på den computer, Document Server er installeret på. Brug eksempeldatafilen, der findes i Forms Composer, til at emulere en udskriftsstream ved at skrive følgende: copy /b faxcover.txt \\.\pipe\test Indstillingen /b opretter en binær kopi. Filen faxcover.txt indeholder en eksempeldatafil, der er formateret til at blive sendt til en printer. \\.\pipe\test kopierer filen til den angivne pipe, der er oprettet i Appendiks B. Hvis du bruger en anden computer end den, Document Server er installeret på, skal du udskifte "." (punktum) med IP-adressen til den computer, serveren er installeret på. Bemærk! Mens scriptet kun henter faxnummeret, kan du også hente e-mail-adresse, kundenummer eller andre variabler i et FormSet. Disse værdier kan derefter bruges i scriptet. Dette script vælger at faxe via en MFP. Du kan også skrive scriptet, så der faxes via en faxserver, der understøtter SMTP-e-mail. Denne formular kan også hentes til senere brug ved andre handlinger, der understøttes af serveren. 26
Document Portal-scripts Eksempel 10: Udskrivning af en tom formular Oversigt: Udskrivning af en tom formular. Detaljer: Det er et grundlæggende script, der bruges i Document Portal til at udskrive tomme formularer ved hjælp af en PostScript-printer. Script: 1 Opret et dataset for at aktivere handlingen MergeForm. Dette dataset indeholder kun navnet på det FormSet, der skal bruges. Der indsættes ingen data, da der skal oprettes en tom formular. Det FormSet, der skal bruges, angives via egenskaben formsetname til det oprindelige objekt. dataset merge_input merge_input.setformset(original.formsetname) 2 Brug handlingen MergeForm til at oprette den tomme PDF-formular. with MergeForm.input=merge_input 3 Brug handlingen PrintForm til at udskrive den PDF, der oprettes af handlingen MergeForm. Printerens IP-adresse og de udskriftsindstillinger, der skal bruges, indsættes via egenskaberne printerip og printoptions til det oprindelige objekt. Disse indstillinger konfigureres i Document Portal Admin. I dette tilfælde angives printertypen til PostScript. Hvis den printer, der bruges, understøtter ImageQuick-funktionen, skal du ændre printertypen til LDD_PRINTERTYPE_LEXIQ. with PrintForm.input=MergeForm.output.IPAddress=original.printerip.PrinterType=LDD_PRINTERTYPE_LEXPS.PrintOptions=original.printoptions.WaitForCompletion=FALSE 27
Sådan køres dette script: 1 Overfør scriptet til serveren ved hjælp af Document Portal Admin. 2 Hvis der ikke er overført en PDF eller FormSet til serveren, skal du overføre én nu. Tilknyt scriptet med et overført FormSet. 3 Brug en MFP med berøringsskærm til at vælge ikonet Formularer, og vælg derefter den formular, der er tilknyttet dette script. 28
Eksempel 11: Prompt til brugeren og udskrivning af en tom formular Oversigt: Prompt til brugeren og udskrivning af den valgte formular. Detaljer: Dette script kan med fordel anvendes af farveprintere. Det beder brugeren angive, om formularen skal udskrives i farver eller i sort og hvid. Derved kan ét script bruges til begge typer output. Script: 1 Dette script stiller slutbrugeren et spørgsmål, så dette spørgsmål skal opstilles her. Spørgsmålet er en enkeltvalgsliste, hvor brugeren kan vælge output i Sort og hvid eller Farve. Som med alle scripts, der stiller spørgsmål, skal alle prompter og variabler, der bruges i prompten, erklæres, før promptblokken indtastes. stringprompt color with color.setprompttext("select the desired color output:").addpromptoption("black & White").AddPromptOption("Color") 2 Spørgsmålet er udarbejdet. Nu bruges promptblokken til at stille spørgsmålet. Når brugeren vælger dette script, er det den del af scriptet, der udføres, før jobbet sendes til serveren. Eftersom der kun er ét spørgsmål, skal der kun udføres ét trin. prompt step "prompts" ask(color) laststep endprompt 3 Når spørgsmålet er stillet, sendes jobbet på samme måde som alle andre job uden en prompt. Udførelsen af scriptet genoptages nu, når jobbet genstartes. 4 Opret et dataset for at aktivere handlingen MergeForm. Dette dataset indeholder kun navnet på det FormSet, der skal bruges. Der indsættes ingen data, da der skal oprettes en tom formular. Det FormSet, der skal bruges, angives via egenskaben formsetname til det oprindelige objekt. dataset merge_input merge_input.setformset(original.formsetname) 5 Brug handlingen MergeForm til at oprette den tomme PDF-formular. with MergeForm.input=merge_input 29
6 Scriptet redigerer de udskriftsindstillinger, der er sendt sammen med jobbet. På baggrund af brugerens valg angives printeren til at udskrive ved hjælp af farvede tonerkassetter eller kun den sorte tonerkassette. printoptions opts = original.printoptions if (color == "Color") opts.setjoboption(ldd_printoption_colormodel, LDD_COLORMODEL_CMYK) else opts.setjoboption(ldd_printoption_colormodel, LDD_COLORMODEL_BLACK) endif 7 Brug handlingen PrintForm til at udskrive den PDF, der oprettes af handlingen MergeForm. Printerens IP-adresse angives via egenskaben printerip til det oprindelige objekt. Udskriftsindstillingerne er den redigerede version, der er oprettet i forrige trin. De oprindelige udskriftsindstillinger konfigureres i Document Portal Admin. I dette tilfælde angives printertypen til PostScript. Hvis den printer, der bruges, understøtter ImageQuick-funktionen, skal du ændre printertypen til LDD_PRINTERTYPE_LEXIQ. with PrintForm.input=MergeForm.output.IPAddress=original.printerip.PrinterType=LDD_PRINTERTYPE_LEXPS.PrintOptions=opts.WaitForCompletion=FALSE Sådan køres dette script: 1 Overfør scriptet til serveren ved hjælp af Document Portal Admin. 2 Hvis der ikke er overført en PDF eller FormSet til serveren, skal du overføre én nu. Tilknyt scriptet med et overført FormSet. 3 Brug en MFP med berøringsskærm, der er tilsluttet en farveprinter, til at vælge ikonet Formularer, og vælg derefter den formular, der er tilknyttet dette script. 30
Appendiks A: ODBC-opsætning Følg disse trin, når du vil oprette ODBC DSN-forbindelser, der skal bruges i Eksempel 4 og 7. DSN'er oprettes på den computer, Document Server er installeret på. 1 I Windows NT: Gå til Indstillinger Kontrolpanel. I Windows 2000/XP: Gå til Indstillinger Kontrolpanel Administration. 2 Vælg Datakilder (ODBC). 3 Vælg fanen System-DSN. Klik på Tilføj. Der vises en liste over ODBC-drivere, der er installeret på denne computer. Vælg "Driver til Microsoft Access (*.mdb)" på listen, og klik på Udfør. 4 Opsætningsdialogboksen til ODBC Microsoft Access vises. Til Eksempel 4 skal du angive Datakildenavn til "LDD1", og til Eksempel 7 skal den angives til "LDD2". Klik på knappen Vælg for at gå til den database, der skal bruges til denne forbindelse. Til Eksempel 4 skal du vælge databasen "resumes.mdb". Til Eksempel 7 skal du vælge "stores.mdb". Klik på OK. 5 Når du har tilføjet dem begge, vises de på listen System-DSN. 6 Klik på OK for at lukke dialogboksen. Forbindelserne er nu konfigureret og kan bruges i et script. Når du overfører scripts, kan du konfigurere ODBC-indstillingerne via lokale indstillinger i Eksempel 4 og 7. Generelt er det nødvendigt at angive to oplysninger for alle ODBC-forbindelser, mens der er to valgfrie indstillinger. DSN'en skal angives. Datakildenavnet er det, der angives i trin 5 ovenfor. Tabelnavnet skal angives. Det er navnet på den tabel, der indeholder de data, som skal bruges i scriptet. Hvis du bruger de databaser, der leveres sammen med eksemplerne, kan du bruge de standardnavne på tabeller, der findes under lokale indstillinger. Brugernavnet er valgfrit. Hvis der ikke kræves et logonnavn, kan du lade dette felt være tomt. (Som standard kræves der ikke et logonnavn til Microsoft Access). Adgangskoden er valgfri. Hvis der ikke kræves et logonnavn, kan du lade dette felt være tomt. 31
Appendiks B: FormSet-opsætning Dette appendiks indeholder oplysninger om de trin, der skal udføres for at overføre et FormSet og konfigurere den angivne pipe til at arbejde med det. Disse oplysninger bruges til at køre Eksempel 8 og 9. I Server Manager: 1 Overfør det script, der skal bruges til dette FormSet, hvis du ikke allerede har gjort det. Til disse eksempler skal du overføre scriptet "example08.xdd" eller "example09.xdd". 2 Klik på Tilføj FormSet på startsiden. Derved startes guiden Tilføj FormSet. Det første trin i guiden er at vælge det FormSet, der skal overføres. Til Eksempel 8 skal du vælge "debitmemo.fdd", og til Eksempel 9 skal du vælge "faxcover.fdd". De findes begge i det eksempelbibliotek, der installeres sammen med Forms Composer. Klik på Næste. På næste side i guiden kan du vælge, hvilken handling der skal udføres, når data modtages for dette FormSet. Der er tre valgmuligheder: Handlingen angives af pipen eller i datastreamen, En af de foruddefinerede handlinger skal bruges, eller Der skal anvendes et brugerdefineret script. I disse eksempler vil vi bruge et brugerdefineret script. Vælg det ønskede script på listen (example08 eller example09). 3 Klik på Næste. På sidste side i guiden findes en oversigt. Hvis du ikke før har oprettet en navngivet pipe, der skal bruges til eksemplerne, skal du markere det afkrydsningsfelt, der starter guiden Angivet pipe. 4 Klik på Afslut. Hvis du skal oprette den angivne pipe, starter guiden Angivet pipe. Ellers er du færdig og kan fortsætte med at køre scriptet. 5 I guiden Angivet pipe skal du først navngive pipen. I disse eksempler opretter vi kun én pipe. Den kan bruges til både Eksempel 8 og 9. Kald pipen "test", og angiv evt. en beskrivelse. Klik på Næste. 6 På næste side i guiden konfigureres pipen til at acceptere data for et bestemt FormSet eller flere FormSets. Da pipen oprettes til både Eksempel 8 og 9, skal du vælge "Denne pipe bruges af flere FormSets". Klik på Næste. 7 På næste side i guiden konfigureres den handling, der skal udføres, når der modtages data i pipen. Det svarer til siden i guiden Tilføj FormSet, hvor du kan konfigurere, hvad der skal ske, når der modtages data for FormSet'et. Da vi allerede har konfigureret, hvad der skal ske med FormSet'et (det kører et brugerdefineret script), skal du vælge "Handlingen angives i den udskrevne stream". Klik på Næste. 32
8 På næste side i guiden kan du konfigurere den type data, der modtages af pipen. I dette tilfælde skal vi sende tekstfiler. Derfor er datatypen altid den samme. Vælg "FormSets er altid af denne type", og vælg "en stream med almindelig tekst" på listen. Klik på Næste. 9 På sidste side i guiden vises en oversigt over de valgte indstillinger. Klik på Afslut. Du er nu klar til at køre scriptet. Yderligere oplysninger om de forskellige indstillinger til overførsel af FormSets og oprettelse af navngivne pipes finder du i online Hjælp til Server Manager. 33
Lexmark og Lexmark med diamantformen er varemærker tilhørende Lexmark International, Inc. og er registreret i USA og/eller andre lande. 2003 Lexmark International, Inc. 740 West New Circle Road Lexington, Kentucky 40550 www.lexmark.com