Document Distributor. Skripteksempler. Mars

Transkript

1 Document Distributor Skripteksempler Mars

2 Utgave: Mars 2003 Følgende avsnitt gjelder ikke for land der slike bestemmelser er uforenlige med gjeldende lover: LEXMARK INTERNATIONAL, INC., UTGIR DENNE PUBLIKASJONEN SOM DEN ER ( AS IS ) UTEN GARANTIER AV NOE SLAG, HVERKEN UTTRYKTE ELLER UNDERFORSTÅTTE, INKLUDERT, MEN IKKE BEGRENSET TIL, UNDERFORSTÅTTE GARANTIER FOR SALGBARHET ELLER EGNETHET TIL ET BESTEMT FORMÅL. I enkelte land og stater er ikke fraskrivelse av uttrykkelige eller underforståtte garantier tillatt i visse transaksjoner, så denne erklæringen gjelder kanskje ikke for deg. Denne publikasjonen kan inneholde tekniske unøyaktigheter eller typografiske feil. Informasjonen i dette dokumentet endres regelmessig. Slike endringer innarbeides i senere utgaver. Forbedringer eller endringer av de beskrevne produktene eller programmene kan finne sted når som helst. Kommentarer om denne publikasjonen kan sendes til Lexmark International, Inc., Department F95/032-2, 740 West New Circle Road, Lexington, Kentucky 40550, USA. I England og Irland sendes kommentarer til Lexmark International Ltd., Marketing and Services Department, Westhorpe House, Westhorpe, Marlow Bucks SL7 3RQ. Lexmark kan bruke og distribuere all informasjon du sender inn etter eget forgodtbefinnende, uten at det medfører noen forpliktelser overfor deg. I USA kan du kjøpe flere kopier av publikasjoner som er relatert til dette produktet ved å ringe I Storbritannia og Irland kan du ringe +44 (0) I andre land kan du kontakte kjøpsstedet. Referanser i denne publikasjonen til produkter, programmer eller tjenester innebærer ikke at produsenten har til hensikt å gjøre disse tilgjengelige i alle land der selskapet driver virksomhet. Eventuelle referanser til et produkt, et program eller en tjeneste er ikke ment å angi eller antyde at bare det produktet, det programmet eller den tjenesten kan brukes. Funksjonelt tilsvarende produkter, programmer eller tjenester som ikke krenker eksisterende immaterielle rettigheter, kan brukes i stedet. Evaluering og verifisering av bruk av andre produkter, programmer eller tjenester enn dem som er uttrykkelig utpekt av produsenten, er brukerens ansvar. Lexmark og Lexmark med rutermerket er varemerker for Lexmark International, Inc., som er registrert i USA og/eller andre land. Copyright 2003 Lexmark International, Inc. Med enerett. RETTIGHETER FOR USAS MYNDIGHETER Denne programvaren og all medfølgende dokumentasjon under denne avtalen er kommersiell dataprogramvare og dokumentasjon som er utviklet utelukkende for private midler.

3 Innhold Innledning...1 Document Distributor-skript...2 Eksempel 1: Lagre i en fil... 2 Eksempel 2: Skrive ut et dokument... 3 Eksempel 3: Be om e-postadresse og sende en e-post... 5 Eksempel 4: Lagre data i en database... 8 Eksempel 5: Skille sider ved hjelp av strekkoder Eksempel 6: Avansert bruk av ledetekster I Eksempel 7: Avansert bruk av ledetekster II Document Producer-skript...23 Eksempel 8: Flett data og skriv ut et skjema Eksempel 9: Flett data og faks et skjema Document Portal-skript...27 Eksempel 10: Skriv ut et tomt skjema Eksempel 11: Still brukeren et spørsmål og skriv ut et tomt skjema Tillegg A: ODBC-oppsett...31 Tillegg B: Formset-oppsett...32 iii

4 Innledning Dene boken inneholder eksempler på konstruksjonene og objektene som utgjør det skriptspråket som brukes i programsuiten Lexmark Document Solutions. Eksemplene er delt inn i tre kapitler, der hvert kapittel svarer til en av hovedkomponentene i programsuiten. Du kan velge om du vil lese gjennom alle fortløpende, eller bare de som gjelder for det aktuelle programmet. Alle eksemplene i denne boken er inkludert i programvaren Workflow Composer. Vi anbefaler at du har tilgang til Workflow Composer og Server Manager eller Document Portal Admin, slik at du kan arbeide med skriptene mens du går gjennom boken. Når du laster opp skript til Document Server, vil du bli bedt om å oppgi miljøspesifikk informasjon som er nødvendig for å kunne kjøre skriptene. Hvis du for eksempel må angi IP-adressen til SMTP-serveren, vil skriptet vise "local.mailserver". Dette vil bli erstattet av den verdien du angir. 1

5 Document Distributor-skript Eksempel 1: Lagre i en fil Oversikt: Lagre det skannede dokumentet i en fil. Detaljer: En person har behov for å skanne inn fakturaer med en multifunksjonsmaskin (MFP) og lagre dem i det lokale filsystemet. Skript: with SaveToFile.input=original.document.Path="c:\lexmark\invoice.tif".AppendTimestamp=TRUE.CreateDirectory=TRUE Slik kjører du dette skriptet: 1 Last det opp til serveren ved å bruke Workflow Composer eller Server Manager. 2 Opprette en profil på en multifunksjonsmaskin ved å bruke Server Manager. Merk: Ved å sette AppendTimestamp til TRUE, kan du være sikker på at hver fil som lagres får et unikt filnavn. Filnavnet som genereres vil være: c:\lexmark\invoice_mnd_dd_åååå_tt_mm_ss_ms.tif Det er viktig å være klar over at det samme tidsstempelet vil bli brukt gjennom hele skriptet, selv om SaveToFile kalles flere ganger i skriptet. Om nødvendig kan tidsstempelet bygges opp manuelt ved å bruke usertime-egenskapen for det originale objektet, og legge til en unik verdi. Du kan se et eksempel på dette i eksempel 5: Skille sider ved hjelp av strekkoder. Ved å gi CreateDirectory-egenskapen verdien TRUE, vil handlingen opprette eventuelle kataloger i banen som ikke finnes allerede. Dette er særlig nyttig hvis tidsstempelet brukes som en del av selve katalognavnet. 2

6 Eksempel 2: Skrive ut et dokument Oversikt: Skriv ut et skannet dokument på en annen skriver. Detaljer: En person har behov for å sende en intern faks, dvs. en faks fra ett sted i firmaet til et annet. Siden hele firmaet er koblet til et lokalt nettverk, og alle avdelingene har en skriver, vil dette skriptet skrive ut direkte til en skriver i stedet for å sende en faks. Dette gir bedre kvalitet på utskriften og sparer tellerskritt. I tillegg blir det lagt et tidsstempel inn på utskriften, slik at den ligner mer på en faks. Skript: 1 Bruk separate-metoden til å dele usertime-verdien opp i enkeltdelene. Deretter skal du bygge opp informasjonsstrengen som "stemples" på hver side av utskriften. Strengens format er "Sendt av IP-adresse den dato kl. klokkeslett" stringarray time = original.usertime.separate("_") string stamp = "Sendt av " + original.userip stamp.concatenate(" den " + time[2] + " " + time[3] + " " + time[4]) stamp.concatenate(" kl. " + time[5] + ":" + time[6]) 2 Bruk ImageText-handlingen til å legge inn tidsstrengen nede til høyre på alle sidene som 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 Bruk ConvertToDocument-handlingen til å konvertere TIFF-bildet til PostScript slik at det kan skrives ut. Legg merke til at vi bruker utdataene fra ImageText-handlingen, slik at vi kan få TIFF-bildet med tidsstempel-informasjonen. with ConvertToDocument.input=ImageText.output.Format=LDD_DOCFORMAT_PS.AllPages=TRUE.PaperSize=LDD_PAPERSIZE_LETTER.Orientation=LDD_ORIENTATION_AUTO 3

7 4 Bruk PrintJob-handlingen til å sende PostScript-filen til den angitte skriveren. Hvis skriveren har en ImageQuick SIMM installert, kan TIFF-filen sendes direkte til skriveren uten at den må konverteres 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) Slik kjører du dette skriptet: 1 Last det opp til serveren ved å bruke Server Manager. 2 Konfigurer skriverens IP-adresse gjennom de lokale innstillingene. 3 Opprett en profil på en multifunksjonsmaskin (MFP). 4

8 Eksempel 3: Be om e-postadresse og sende en e-post Oversikt: Bruk optisk tegngjenkjenning (OCR) på et dokument og send det til brukeren via e-post. Detaljer: Et firma vil gjøre det enkelt for sine ansatte å skanne inn papirdokumenter og gjøre dem om til redigerbar tekst uten å måtte installere OCR-programvare på firmaets datamaskiner. Dette skriptet ber brukeren om å oppgi en e-postadresse, og spør deretter om dokumentet skal være på RTF-format (som kan leses av de fleste tekstbehandlingsprogrammer) eller PDF-format. Skriptet konverterer dokumentet og sender det til e-postadressen som brukeren har angitt. Skript: 1 Dette skriptet stiller brukeren spørsmål, så vi må definere dem. Det første spørsmålet er en streng og ber om en e-postadresse. Det andre er en enkeltvalgs alternativliste der brukeren skal angi formatet på filen. stringprompt .setprompttext("skriv inn e-postadressen") stringprompt format with format.setprompttext("velg filformat").addpromptoption("rtf").addpromptoption("pdf") 2 Spørsmålene er klare. Nå brukes ledetekstblokken til å stille spørsmålene. Når brukeren velger dette skriptet, kjøres denne delen av skriptet før skanningen blir utført. Siden svarene på spørsmålene ikke har innvirkning på senere spørsmål, og siden de ikke skal verifiseres, kan spørsmålene stilles i ett trinn. prompt step "prompts" ask( ) ask(format) laststep endprompt 3 Når spørsmålene er stilt, blir dokumentet skannet inn og sendt på samme måte som med jobber uten ledetekst. Kjøringen av skriptet fortsetter herfra når jobben startes på nytt. 5

9 4 Se hvilket format som er valgt og konverter inndokumentet til PDF eller RTF. Utdataene lagres i variabelen ocr slik at de kan brukes til e-posthandlingen. 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 SMTP-handlingen brukes nå til å sende e-posten med det OCR-konverterte (redigerbare) dokumentet som vedlegg. E-postadressen som skal brukes er den brukeren oppga da jobben ble sendt. IP-adressen til SMTP-serveren ble definert som en lokal innstilling. Når skriptet lastes opp til serveren, spør Server Manager hvilken verdi som skal brukes for denne egenskapen. with SMTP.Server=local. server.To= .From= .Subject="Ditt skannede dokument".message="her er det skannede dokumentet på det formatet du ba om.".characterset=ldd_smtpcharset_us.attachments=ocr 6

10 Slik kjører du dette skriptet: 1 Last det opp til serveren ved å bruke Server Manager. 2 Konfigurer SMTP-serverens adresse gjennom de lokale innstillingene. 3 Hvis du skal bruke dette skriptet på en multifunksjonsmaskin (MFP), må den være utstyrt med en berøringsskjerm. Hvis du ikke har det, kan du bruke Select'N'Send eller Print'N'Send i stedet. Hvis du har det, kan du opprette en profil for TIFF-format, oppløsning på 300 dpi og mørkhet på 4. Dette vil gi de beste resultatene mht. tegngjenkjenning (OCR). Merk: SMTP-handlingen kan erstattes med spesifikke GroupWare-kompatible objekter, for eksempel Lotus Notes ( Notes), Microsoft Exchange ( Exchange) og Novell GroupWise (GWMail). Den viktigste fordelen med å bruke disse objektene er at skriptet kan dra nytte av adresseboken og GroupWare-spesifikke funksjoner. Det stilles imidlertid større krav til konfigurasjonen ved bruk av slike objekter. I de fleste tilfeller kan GroupWare-servere konfigureres slik at de godtar SMTP-basert e-post. Hvis skriptet ikke har behov for spesialfunksjonene, bør den mer generelle SMTP-handlingen være tilstrekkelig. 7

11 Eksempel 4: Lagre data i en database Oversikt: Lagre det skannede dokumentet i en database. Detaljer: En personalavdeling har ansvar for å holde oversikt over alle CV-ene. Dette skriptet skal brukes til å lagre CV-ene i en database. I tillegg blir hver CV konvertert til tekst, som også blir lagret i databasen. Ved at teksten lagres kan databasen gjennomsøkes etter visse nøkkelord, og deretter kan en liste over alle CV-ene som stemmer med søkekriteriene returneres. Siden selve CV-en ligger der også, kan den vises, skrives ut eller rutes til et annet sted. Skript 4A bør brukes av databaser som bruker BLOB (Binary Large Objects). BLOB brukes av databaser som man kan lagre filer i. Eksempler på slike databaser er Oracle, Microsoft SQL Server og IBM DB2. Skript 4B bør brukes av databaser som Microsoft Access, som ikke kan bruke BLOB. Dokumentet må da lagres i det lokale filsystemet for å oppnå samme resultat. Da vil filens plassering bli lagret i databasen, slik at den kan gjenfinnes senere. Skript 4A: 1 Konverter det sendte dokumentet til tekst. Denne teksten vil bli lagret i databasen og koblet til CV-en, slik at den blir søkbar. with ImageToText.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.OneLine=TRUE.SeparateParagraphs=TRUE.PageBreaks=FALSE.AppendEOF=FALSE.AllPages=TRUE 2 Bruk textfile-objektet til å lese inn teksten som produseres av ImageToText-handlingen og lagre den i en streng. textfile tf string ocrtext tf.open(imagetotext.output) ocrtext = tf.read(tf.size()) tf.close() 3 Sett CV-en sammen med teksten inn i databasen, slik at den kan hentes ut igjen senere. Egenskapene for databaseinformasjonen konfigureres via lokale innstillinger når skriptet lastes opp 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

12 Slik kjører du dette skriptet: 1 Konfigurer databasen som skal brukes på servermaskinen. Filene LDDOracleTable.sql og LDDSQLServerTable.sql er inkludert med programmet for å lage eksempeltabeller i Oracle og Microsoft SQL Server. Disse filene ligger i katalogen for skripteksempler for Workflow Composer. Når du har konfigurert databasen, må du konfigurere ODBC-forbindelsen. Hvis du vil vite mer om dette, kan du se Tillegg A: Konfigurere ODBC-DSN (Data Source Names). 2 Last opp skriptet til serveren ved å bruke Server Manager. 3 Konfigurer informasjonen om ODBC-forbindelsen gjennom de lokale innstillingene. 4 Opprett en profil på en multifunksjonsmaskin (MFP). 9

13 Skript 4B: 1 Konverter det sendte dokumentet til tekst. Denne teksten vil bli lagret i databasen og koblet til CV-en, slik at den blir søkbar. with ImageToText.input=original.document.Language=LDD_LANG_ENGLISH.TextType=LDD_TEXTTYPE_NORMAL.OneLine=TRUE.SeparateParagraphs=TRUE.PageBreaks=FALSE.AppendEOF=FALSE.AllPages=TRUE 2 Bruk textfile-objektet til å lese inn teksten som produseres av ImageToText-handlingen og lagre den i en streng. textfile tf string ocrtext tf.open(imagetotext.output) ocrtext = tf.read(tf.size()) tf.close() 3 Angi banen der filen skal lagres. Filen vil bli lagret i det lokale filsystemet i katalogen c:\lexmark. Filnavnet vil være resume_timestamp.tif. string filepath = "c:\lexmark\resume" + original.usertime + ".tif" 4 Siden selve dokumentet ikke kan settes inn i databasen, må dokumentet lagres i det lokale filsystemet. Verdien for AppendTimestamp settes til FALSE, siden vi har lagt inn tidsstempelet manuelt i trinnet ovenfor. Verdien for CreateDirectory settes til TRUE, slik at c:\lexmark opprettes hvis den ikke finnes allerede. with SaveToFile.input=original.document.AppendTimestamp=FALSE.Overwrite=FALSE.Path=filepath.CreateDirectory=TRUE 10

14 5 Sett filnavnet sammen med teksten inn i databasen, slik at det kan hentes ut igjen senere. Egenskapene for databaseinformasjonen konfigureres via lokale innstillinger når skriptet lastes opp til serveren. with ODBCWrite.DataSource=local.DataSource.TableName=local.TableName.LogonName=local.LogonName.LogonPassword=local.LogonPassword.AssignValue("ScanDate","").AssignValue("OCRText",ocrText).AssignValue("ResumeFile",filepath) Slik kjører du dette skriptet: 1 Konfigurer databasen som skal brukes på servermaskinen. Microsoft Access-databasen med filnavnet resumes.mdb er laget for bruk i dette eksemplet. Denne filen ligger i katalogen for skripteksempler for Workflow Composer. Når du har konfigurert databasen, eller hvis du bruker den som følger med programmet, må du konfigurere ODBC-forbindelsen. Hvis du vil vite mer om dette, kan du se Tillegg A. 2 Last opp skriptet til serveren ved å bruke Server Manager. 3 Konfigurer informasjonen om ODBC-forbindelsen gjennom de lokale innstillingene. 4 Opprett en profil på en multifunksjonsmaskin (MFP). 11

15 Eksempel 5: Skille sider ved hjelp av strekkoder Oversikt: Bruk en skilleside med strekkode for å dele inn jobber med varierende sidelengde i separate filer. Detaljer: En person har behov for å skanne inn og behandle flere sett med dokumenter. Hvert sett kan skannes inn separat, men det ville vært enklere (og mer ønskelig) å skanne inn alle på én gang. Dette kan utføres ved å bruke en skilleside med strekkode for å indikere starten på et nytt sett. Ved hjelp av slike skillesider kan hvert sett inneholde et vilkårlig antall sider. Skriptet vil se etter en strekkode på hver side i det skannede dokumentet. Når en strekkode blir funnet, vil den angi slutten på det aktuelle settet, som vil bli lagret i en fil, og begynnelsen på et nytt sett. Skript: 1 Deklarer alle variablene som brukes i dette skriptet. doc separated int i, startpage, lastpage bool found string fullpath, bcode 2 Separer det skannede dokumentet slik at hver side legges inn i en egen fil. Dette er nødvendig for at hver gruppe med sider som utgjør et sett, senere skal kunne settes sammen til én fil. with ImageSeparate.input=original.document.AllPages=TRUE.separated =.output 3 Bruk startpage-variabelen til å angi den første siden i det aktuelle settet. Initialiser den til den første siden i det skannede settet. startpage = 1 4 Bla gjennom alle sidene som er blitt sendt. loop i from 1 to separated.getnumberfiles() 5 Variabelen som er funnet indikerer en ny gruppe med sider som er klar til å bli lagret. Tilbakestill før hver side behandles. found = false 12

16 6 Bruk BarcodeRead-handlingen til å avgjøre om det er en strekkode på denne siden. 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 For dette eksemplet (og den medfølgende eksempelfilen) er strekkoden ordet "BREAK". Sjekk om dette er funnet på denne siden. if (bcode.contains("break")) then 8 En strekkode er funnet. Hvis startpage er lik den aktuelle siden (for eksempel hvis startpage er 1 og den første siden i det skannede dokumentet er en skilleside), er det ikke behov for å lagre noen sider. I så fall settes startpage for det neste settet lik neste side. I motsatt fall settes lastpage for det aktuelle settet til forrige side. (Den skal ikke settes lik den aktuelle siden, siden da vil skillesiden også bli lagret.) Bruk found-flagget til å indikere at vi har et sett med sider som skal lagres. if (startpage == i) startpage = i + 1 else lastpage = i - 1 found = true endif 9 Ingen strekkode er funnet. Sjekk om denne siden er lastpage for det skannede dokumentet. Hvis den er det, må dette være lastpage for det aktuelle settet. Sett verdien for lastpage til aktuelle side, og bruk found-flagget til å indikere at vi har et sett med sider som skal lagres. else if (i == separated.getnumberfiles()) then lastpage = i found = true endif endif 10 Hvis et nytt sett med sider er blitt funnet, skal de lagres. if (found == true) then 13

17 11 Bruk ImageCombine-handlingen til å sette sidene sammen til ett dokument. with ImageCombine.input=separated.GetFileRange(startpage, lastpage).format=ldd_imgformat_tifg4.colordepth=ldd_imgdepth_bw 12 Finn filnavnet som skal brukes til å lagre det nye dokumentet. Dokumentsettene vil bli lagret i katalogen c:\lexmark. Filnavnet vil være set_tidsstempel_side.tif. Siden alle filene som lagres i én jobb vil ha samme tidsstempel, blir sidenummeret lastpage for hvert sett lagt til for å sikre at alle filnavnene er unike. fullpath = "c:\lexmark\set" + original.usertime + "_" + lastpage.asstring() + ".tif" 13 Lagre det nye dokumentet på disken. Verdien for AppendTimestamp settes til FALSE, siden vi har lagt inn tidsstempelet manuelt i trinnet ovenfor. Verdien for CreateDirectory settes til TRUE slik at katalogen c:\lexmark opprettes hvis den ikke finnes. with SaveToFile.input = ImageCombine.output.Path=fullpath.AppendTimestamp=FALSE.Overwrite=FALSE 14 Nå er det aktuelle settet lagret. Sett startpage for det neste settet til neste side i dokumentet. Ikke bruk verdien for aktuelle side, siden det vil føre til at skillesiden blir tatt med som en del av det neste lagrede dokumentet. startpage = i + 1; endif endloop Slik kjører du dette skriptet: 1 Last opp skriptet til serveren ved å bruke Server Manager. 2 Opprett en profil på en multifunksjonsmaskin (MFP) ved å bruke TIFF, oppløsning på 300dpi og en mørkhet på 3 eller 4. 3 Filen fullset.tif ligger i katalogen for skripteksempler for Workflow Composer. Denne filen kan skrives ut og skannes eller sendes ved hjelp av Select'N'Send. Når den brukes sammen med dette skriptet, vil det bli produsert tre separate filer med henholdsvis tre, to og fire sider. 14

18 Eksempel 6: Avansert bruk av ledetekster I Oversikt: Bruk svarene på ledetekstspørsmål til å avgjøre det neste spørsmålet som skal stilles. Detaljer: Med dette skriptet kan en bruker skanne inn et dokument og sende originalversjonen eller en redigerbar versjon via e-post. Dette er en utvidelse av skriptet i eksempel 3: Be om e-postadresse og sende en e-post. Brukeren vil bli bedt om å oppgi en e-postadresse som dokumentet skal sendes til, og skal deretter velge om dokumentet skal gjennomgå en tegngjenkjenningsprosess (gjøres redigerbart). Basert på svaret vil det neste spørsmålet be om å angi ønsket format. Selv om dette er et enkelt skript, viser det styrken i bruk av ledetekster, og hvordan et svar på ett spørsmål kan avgjøre hva det neste spørsmålet skal være. Skript: 1 Dette skriptet stiller brukeren spørsmål, så vi må definere dem her. Det første spørsmålet er en streng og ber om en e-postadresse. Det andre er boolsk (ja/nei). Brukeren merker av hvis dokumentet skal gjøres redigerbart. Hvis ikke, sendes det som et bilde. stringprompt .setprompttext("e-postadressen der dokumentet skal sendes") boolprompt ocr ocr.setprompttext("klikk for å gjøre dokumentet redigerbart.") 2 Hvis brukeren velger å gjøre dokumentet redigerbart, brukes dette spørsmålet. Dette er en enkeltvalgsliste for valg av format på det redigerbare dokumentet. stringprompt ocrformat with ocrformat.setprompttext("velg redigerbart format").addpromptoption("rtf").addpromptoption("pdf (Searchable)") 3 Hvis brukeren velger å ikke gjøre dokumentet redigerbart, brukes dette spørsmålet. Dette er en enkeltvalgsliste for valg av format på bildedokumentet. stringprompt imgformat with imgformat.setprompttext("velg bildeformat").addpromptoption("tiff").addpromptoption("pdf (Not Searchable)") 4 Spørsmålene er klare. Nå brukes ledetekstblokken til å stille spørsmålene. Når brukeren velger dette skriptet, kjøres ledetekstdelen av skriptet før skanningen blir utført. Siden svarene på spørsmålene brukes til å velge det neste spørsmålet, bruker vi flere trinn. prompt 15

19 5 Dette trinnet inneholder to spørsmål: hva er e-postadressen, og om dokumentet skal gjøres redigerbart. Begge spørsmålene stilles i ett trinn, siden de ikke påvirker hverandre. Når spørsmålet om å gjøre dokumentet redigerbart blir stilt, kontrolleres returverdien. Hvis brukeren svarer ja (merker av i boksen), er det neste spørsmålet som skal stilles oformat. Hvis ikke, er det neste trinnet iformat. Hvert trinn må ha et nextstep- eller laststep-direktiv. step " " ask( ) ask(ocr) if (ocr == TRUE) nextstep "oformat" else nextstep "iformat" endif 6 Dette trinnet velges hvis brukeren vil gjøre dokumentet redigerbart. Det ber brukeren om å angi det redigerbare formatet på dokumentet. Dette er det siste spørsmålet i denne forgreningen, så derfor bruker vi laststep-direktivet. step "oformat" ask(ocrformat) laststep 7 Dette trinnet velges hvis brukeren ikke vil gjøre dokumentet redigerbart. Det ber brukeren om å angi formatet på bildet. Dette er det siste spørsmålet i denne forgreningen, så derfor bruker vi laststep-direktivet. step "iformat" ask(imgformat) laststep endprompt 8 Når spørsmålene er stilt, blir dokumentet skannet inn og sendt på samme måte som med jobber uten ledetekst. Kjøringen av skriptet fortsetter herfra når jobben startes på nytt. Kontroller ocr-ledeteksten for å se om brukeren vil gjøre dokumentet redigerbart. doc attach if (ocr == TRUE) 16

20 9 Brukeren vil gjøre det redigerbart, så sjekk hvilket format som skal brukes og utfør konverteringen. Lagre utdataene fra konverteringen i variabelen 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 Brukeren vil ikke gjøre dokumentet redigerbart, så sjekk ønsket bildeformat og utfør konvertering hvis det er nødvendig. Siden dokumentet er skannet inn som et TIFF-bilde, er det ikke nødvendig å konvertere hvis brukeren velger det formatet. Lagre utdataene fra konverteringen i variabelen 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 SMTP-handlingen brukes nå til å sende e-posten med dokumentet på valgt format som vedlegg. E-postadressen som skal brukes er den brukeren oppga da jobben ble sendt. IP-adressen til SMTP-serveren ble definert som en lokal innstilling. Når skriptet lastes opp til serveren, spør Server Manager hvilken verdi som skal brukes for denne egenskapen. with SMTP.Server=local. server.To= .cc="".bcc="".From= .ReplyTo="".Sender="".Subject="Skannet dokument".message="her er det/de skannede dokumentet/ene".characterset=ldd_smtpcharset_us.attachments=attach Slik kjører du dette skriptet: 1 Last det opp til serveren ved å bruke Server Manager. 2 Konfigurer SMTP-serverens adresse gjennom de lokale innstillingene. 3 Hvis du skal bruke dette skriptet på en multifunksjonsmaskin (MFP), må den være utstyrt med en berøringsskjerm. Hvis du ikke har det, kan du bruke Select'N'Send eller Print'N'Send i stedet. Hvis du har det, kan du opprette en profil for TIFF-format, oppløsning på 300 dpi og mørkhet på 4. Dette vil gi de beste resultatene mht. tegngjenkjenning (OCR). 18

22 Eksempel 7: Avansert bruk av ledetekster II Oversikt: Utfør datavalidering når brukeren svarer på dynamiske ledetekster. Detaljer: En person skal skanne inn dokumenter, men ønsker å skille dem, avhengig av hvilken butikk som trenger dokumentene og den aktuelle avdelingen i butikken. Skriptet spør etter butikknummeret. Hvis butikknummeret er gyldig, vises en liste over avdelingene for den butikken til brukeren. Hvis ikke det er gyldig, får brukeren en feilmelding og blir bedt om å angi butikknummeret på nytt. Når all den nødvendige informasjonen er registrert, blir dokumentet skannet inn og lagret på riktig sted i det lokale filsystemet. Skript: 1 Dette skriptet stiller brukeren spørsmål, så vi må definere dem først. Den første ledeteksten er et heltall som representerer butikknummeret. Den andre er en feilmelding som vises hvis det angitte butikknummeret er ugyldig. Den tredje ledeteksten deklareres her, men settes opp etter at spørsmålet er besvart. Alle ledetekster og eventuelle variabler som brukes i ledetekstblokken må deklareres før ledetekstblokken starter. intprompt store store.setprompttext("oppgi butikknummer:") messageprompt errmsg errmsg.setprompttext("ugyldig butikknummer, prøv igjen.") stringprompt dept string storename, item 2 Noen av spørsmålene er gjort klare og de resterende er blitt deklarert. Nå brukes ledetekstblokken til å stille spørsmålene. Når brukeren velger dette skriptet, kjøres denne delen av skriptet før skanningen blir utført. Siden svarene skal valideres og brukes til å utforme de andre spørsmålene, må vi bruke flere trinn. prompt 19

23 3 Dette trinnet inneholder ett spørsmål: hva butikknummeret er. Når butikknummeret er angitt, slår skriptet opp i databasen for å kontrollere at det er et gyldig butikknummer. Hvis det er gyldig, hentes butikknavnet ut fra databasen og verdien for nextstep settes til dept. Hvis det ikke er gyldig, settes verdien for 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 trinnet brukes hvis brukeren oppgir et ugyldig butikknummer. Det viser en feilmelding og ber brukeren om å forsøke på nytt. Brukeren bekrefter meldingen, og verdien for nextstep settes til storenum, noe som medfører at det første spørsmålet blir stilt på nytt. step "error" ask(errmsg) nextstep "storenum" 5 Dette trinnet brukes når brukeren har angitt et gyldig butikknummer. Ledeteksten angis her, slik at den kan inkludere navnet på den valgte butikken. De gyldige avdelingene for den aktuelle butikken hentes deretter fra databasen. step "dept" dept.setprompttext("velg avdeling i " + storename) with ODBCRead.Reset().DataSource=local.DataSource.TableName="departments".LogonName=local.LogonName.LogonPassword=local.LogonPassword.DataColumns="Department".WhereClause="StoreNumber=" + store.asstring() 20

24 6 Hver avdeling legges inn som et alternativ på en enkeltvalgsliste. repeat until (.GetNextRow() == FALSE) item =.GetString("Department") dept.addpromptoption(item) endrepeat.finished() 7 Nå er spørsmålsoppsettet ferdig. Brukeren kan velge hvilken avdeling det skannede dokumentet er til. Dette er det siste spørsmålet, så derfor bruker vi laststep-direktivet. ask(dept) laststep endprompt 21

25 8 Når spørsmålene er stilt, blir dokumentet skannet inn og sendt på samme måte som med jobber uten ledetekst. Kjøringen av skriptet fortsetter herfra når jobben startes på nytt. Generer fullstendig filbane og filnavn som skal brukes til å lagre filen. Filen skal lagres i katalogen c:\lexmark under en katalog som bruker butikknummeret og deretter en underkatalog for den aktuelle avdelingen. Det ferdige navnet vil se slik ut: c:\lexmark\butikknr\avdelingsnavn\scan_tidsstempel.tif. string filepath = "c:\lexmark\" + store.asstring() + "\" + dept + "\scan.tif" 9 Filen lagres på disken ved hjelp av SaveToFile-handlingen og filbanen som ble angitt i det forrige trinnet. Verdien for AppendTimestamp settes til TRUE for å sikre at filnavnet er unikt. Verdien for CreateDirectory settes til TRUE, slik at eventuelle kataloger som ikke finnes blir opprettet. with SaveToFile.input=original.document.Path=filepath.AppendTimestamp=TRUE.CreateDirectory=TRUE Slik kjører du dette skriptet: 1 Konfigurer databasen som skal brukes på servermaskinen. Microsoft Access-databasen med filnavnet stores.mdb er laget for bruk i dette eksemplet. Denne filen ligger i katalogen for skripteksempler for Workflow Composer. Konfigurer ODBC-forbindelsen. Hvis du vil vite mer om dette, kan du se Tillegg A. 2 Last opp skriptet til serveren ved å bruke Server Manager. 3 Konfigurer informasjonen om ODBC-forbindelsen gjennom de lokale innstillingene. 4 Hvis du skal bruke dette skriptet på en multifunksjonsmaskin (MFP), må den være utstyrt med en berøringsskjerm. Hvis du ikke har det, kan du bruke Select'N'Send eller Print'N'Send i stedet. Hvis du har det, kan du opprette en profil. 5 Databasen har tre butikknumre: 10, 20 og 30. Hvis du angir et ugyldig nummer, vil du få en feilmelding. Dette skriptet demonstrerer noen av mulighetene ved å bruke skript til å validere data som brukeren oppgir, og bruke svarene til å lage dynamiske alternativer for brukeren. Dette eksemplet lagrer filen på disken, men det kunne også vært brukt til å utvide eksempel 2: Skrive ut et dokument. I så fall kunne IP-adressen til skriveren i den valgte butikken og avdelingen vært hentet ut fra databasen og brukt til å sende utskriftsjobben. 22

26 Document Producer-skript Eksempel 8: Flett data og skriv ut et skjema Oversikt: Flett data inn i et skjema og skriv det ut. Detaljer: Ved å bruke Document Producer skal et firma omdirigere sin ASCII-utskriftsstrøm fra en skriver som inneholder forhåndsutskrevne skjemaer til Document Server. Dette skriptet brukes til å flette de innkommende dataene sammen med et formset som er laget med Forms Composer, og skrive resultatet ut på vanlig papir. Skript: 1 Bruk de innkommende dataene, original.dataset, sammen med MergeForm-handlingen til å generere en PDF-fil med det utfylte skjemaet. with MergeForm.input=original.dataset 2 Utskriftsalternativer for tosidig utskrift (dupleks), papirkilde og papirstørrelse konfigureres når formsetet opprettes, og sendes via printoptions-egenskapen. Alternativer for ferdiggjøring, for eksempel stifting og hulling, kan ikke angis i formsetet. Hvis du vil legge til flere innstillinger eller overstyre formset-innstillingene, kan du opprette et printoptions-objekt og angi de ønskede innstillingene. I dette tilfellet blir hulling slått på. printoptions po = MergeForm.printoptions po.setjoboption(ldd_printoption_holepunch, LDD_HOLEPUNCH_ON) 3 Bruk PrintForm-handlingen til å skrive ut PDF-skjemaet. Skriverens IP-adresse og type konfigureres gjennom de lokale innstillingene. Hvis skriveren som brukes er utstyrt med en ImageQuick-SIMM, sendes PDF-skjemaet direkte til skriveren. Hvis ikke, konverteres PDF-skjemaet til PostScript før det sendes til skriveren. with PrintForm.input=MergeForm.output.IPAddress=local.PrinterAddress.PrinterType=local.PrinterType.PrintOptions=po.WaitForCompletion=FALSE 23

27 Slik kjører du dette skriptet: 1 Last opp skriptet til serveren ved å bruke Server Manager. 2 Konfigurer skriverinformasjonen gjennom de lokale innstillingene. 3 Last opp "debit memo"-eksemplet som følger med Forms Composer. Opprette en navngitt pipe med navnet "test". Hvis du vil vite mer om dette, kan du se Tillegg B. 4 Åpne et kommandoledetekst-vindu på maskinen der Document Server er installert. Bruk eksempeldatafilen som følger med Forms Composer til å emulere en utskriftsstrøm ved å skrive inn følgende: copy /b debittext.txt \\.\pipe\test Parameteren /b utfører en binær kopiering. Filen debittext.txt inneholder en eksempel-datafil som er formatert slik at den kan sendes til en skriver. Strengen \\.\pipe\test kopierer filen til den navngitte pipen som ble opprettet i Tillegg B. Hvis du kjører fra en annen datamaskin enn den Document Server er installert på, må du erstatte "." (punktumet) med IP-adressen til maskinen der serveren er installert. Merk: Hvis du vil vite hvordan du kan konfigurere utskriftskøer i Windows, kan du se den skjermbaserte hjelpen i Forms Composer og Server Manager. 24

28 Eksempel 9: Flett data og faks et skjema Oversikt: Flett data inn i et skjema og faks det. Detaljer: Ved å bruke Document Producer skal et firma omdirigere sin ASCII-utskriftsstrøm fra en skriver som inneholder forhåndsutskrevne skjemaer til Document Server. Dette skriptet brukes til å flette de innkommende dataene sammen med et formset som er laget med Forms Composer, og fakse resultatdokumentet. Skript: 1 Bruk de innkommende dataene, original.dataset, sammen med MergeForm-handlingen til å generere en PDF-fil med det utfylte skjemaet. with MergeForm.input=original.dataset 2 Resultatet av MergeForm-handlingen er en PDF-fil. Den må konverteres til et TIFF-bilde, slik at det kan konverteres til PostScript. with ConvertImageFormat.input=MergeForm.output.Format=LDD_IMGFORMAT_TIFG4.ColorDepth=LDD_IMGDEPTH_BW.AllPages=TRUE 3 Konverter TIFF-bildet til PostScript slik at det kan fakses. with ConvertToDocument.input=ConvertImageFormat.output.Format=LDD_DOCFORMAT_PS.AllPages=TRUE.PaperSize=LDD_PAPERSIZE_LETTER.Orientation=LDD_ORIENTATION_AUTO 4 Hent ut faksnummeret fra det sendte dataset-et. Enhver verdi av enhver variabel i et formset kan hentes ut og brukes i et skript. string faxnumber = original.dataset.getdataitem("fax_number") 25

29 5 Bruk FaxByPrinter-handlingen til å sende faksen. Faksen sendes gjennom en multifunksjonsmaskin (MFP) med faksfunksjonalitet. IP-adressen til multifunksjonsmaskinen konfigureres via en lokal innstilling. with FaxByPrinter.input=ConvertToDocument.output.IPAddress=local.IpAddress.StationID="Fax Station ID".FaxNumber=faxnumber.WaitForCompletion=FALSE.RedialMinutes=5.RedialTimes=3 Slik kjører du dette skriptet: 1 Last opp skriptet til serveren ved å bruke Server Manager. 2 Konfigurer skriverinformasjonen gjennom de lokale innstillingene. 3 Last opp faksomslag-eksemplet ("fax cover") som følger med Forms Composer. Opprette en navngitt pipe med navnet "test". Hvis du vil vite mer om dette, kan du se Tillegg B. 4 Åpne et kommandoledetekst-vindu på maskinen der Document Server er installert. Bruk eksempeldatafilen som følger med Forms Composer til å emulere en utskriftsstrøm ved å skrive inn følgende: copy /b faxcover.txt \\.\pipe\test Parameteren /b utfører en binær kopiering. Filen faxcover.txt inneholder en eksempel-datafil som er formatert slik at den kan sendes til en skriver. Strengen \\.\pipe\test kopierer filen til den navngitte pipen som ble opprettet i Tillegg B. Hvis du kjører fra en annen datamaskin enn den Document Server er installert på, må du erstatte "." (punktumet) med IP-adressen til maskinen der serveren er installert. Merk: Dette skriptet leser bare faksnummeret, men det er også mulig å lese en e-postadresse, et kundenummer eller en hvilken som helst annen variabel i et formset. Disse verdiene kan deretter brukes i skriptet. I dette skriptet har vi valgt å fakse fra en multifunksjonsmaskin, men det er også mulig å skrive et skript som fakser via en faksserver som støtter SMTP e-post. Skjemaet kunne også blitt lagret for senere bruk av andre handlinger som støttes av serveren. 26

30 Document Portal-skript Eksempel 10: Skriv ut et tomt skjema Oversikt: Skriv ut et tomt skjema Detaljer: Dette er et grunnleggende skript som brukes av Document Portal til å skrive ut tomme skjemaer med en PostScript-skriver. Skript: 1 Opprett et dataset som skal sendes til MergeForm-handlingen. Dette dataset-et skal bare inneholde navnet på formsetet som skal brukes, og ingen data skal sendes siden vi vil skrive ut et tomt skjema. Formsetet som skal brukes sendes via formsetname-egenskapen til det originale objektet. dataset merge_input merge_input.setformset(original.formsetname) 2 Bruk MergeForm-handlingen til å generere det tomme PDF-skjemaet. with MergeForm.input=merge_input 3 Bruk PrintForm-handlingen til å skrive ut PDF-filen som genereres av MergeForm-handlingen. IP-adressen til skriveren og utskriftsalternativene som skal brukes sendes via printeripog printoptions-egenskapene til det originale objektet. Disse innstillingene konfigureres i Document Portal Admin. I dette tilfellet settes skrivertypen til PostScript. Hvis skriveren som skal brukes er utstyrt med ImageQuick-tillegget, kan du endre skrivertypen til LDD_PRINTERTYPE_LEXIQ. with PrintForm.input=MergeForm.output.IPAddress=original.printerip.PrinterType=LDD_PRINTERTYPE_LEXPS.PrintOptions=original.printoptions.WaitForCompletion=FALSE 27

31 Slik kjører du dette skriptet: 1 Last opp skriptet til serveren ved å bruke Document Portal Admin. 2 Hvis ingen PDF-filer eller formset er blitt lastet opp til serveren, kan du gjøre det nå. Koble skriptet til et opplastet formset. 3 Bruk en multifunksjonsmaskin (MFP) med berøringsskjerm, og velg skjemaikonet og deretter skjemaet som er knyttet til dette skriptet. 28

32 Eksempel 11: Still brukeren et spørsmål og skriv ut et tomt skjema Oversikt: Still brukeren et spørsmål og skriv ut det valgte skjemaet. Detaljer: Dette skriptet er nyttig for fargeskrivere. Det spør brukeren om skjemaet skal skrives ut i farger eller sort/hvitt. På den måten kan ett skript brukes til begge typene utskrift. Skript: 1 Dette skriptet stiller brukeren et spørsmål, så vi må definere det her. Spørsmålet er en enkeltvalgsliste der brukeren kan velge utskrift i farger eller i sort/hvitt. I likhet med alle skript som stiller spørsmål, må alle ledetekster og variabler som brukes i ledetekstblokken deklareres før ledetekstblokken starter. stringprompt color with color.setprompttext("angi ønsket fargevalg for utskriften:").addpromptoption("sort/hvitt").addpromptoption("farger") 2 Spørsmålet er klart. Nå brukes ledetekstblokken til å stille spørsmålet. Når brukeren velger dette skriptet, kjøres denne delen av skriptet før jobben sendes til serveren. Siden det bare er ett spørsmål, er det bare behov for ett trinn. prompt step "prompts" ask(color) laststep endprompt 3 Når spørsmålet er stilt, blir jobben sendt på samme måte som med jobber uten ledetekst. Kjøringen av skriptet fortsetter herfra når jobben startes på nytt. 4 Opprett et dataset som skal sendes til MergeForm-handlingen. Dette dataset-et skal bare inneholde navnet på formsetet som skal brukes, og ingen data skal sendes siden vi vil skrive ut et tomt skjema. Formsetet som skal brukes sendes via formsetname-egenskapen til det originale objektet. dataset merge_input merge_input.setformset(original.formsetname) 5 Bruk MergeForm-handlingen til å generere det tomme PDF-skjemaet. with MergeForm.input=merge_input 29

33 6 Skriptet modifiserer utskriftsalternativene som sendes sammen med jobben. Basert på brukerens valg, vil jobben bli skrevet ut i farger eller bare i sort. printoptions opts = original.printoptions if (color == "Farger") opts.setjoboption(ldd_printoption_colormodel, LDD_COLORMODEL_CMYK) else opts.setjoboption(ldd_printoption_colormodel, LDD_COLORMODEL_BLACK) endif 7 Bruk PrintForm-handlingen til å skrive ut PDF-filen som genereres av MergeForm-handlingen. Skriverens IP-adresse sendes via printerip-egenskapen til det originale objektet. Utskriftsalternativene er den modifiserte versjonen som ble laget i det forrige trinnet. De opprinnelige utskriftsinnstillingene konfigureres i Document Portal Admin. I dette tilfellet settes skrivertypen til PostScript. Hvis skriveren som skal brukes er utstyrt med ImageQuick-SIMM, kan du endre skrivertypen til LDD_PRINTERTYPE_LEXIQ. with PrintForm.input=MergeForm.output.IPAddress=original.printerip.PrinterType=LDD_PRINTERTYPE_LEXPS.PrintOptions=opts.WaitForCompletion=FALSE Slik kjører du dette skriptet: 1 Last opp skriptet til serveren ved å bruke Document Portal Admin. 2 Hvis ingen PDF-filer eller formset er blitt lastet opp til serveren, kan du gjøre det nå. Koble skriptet til et opplastet formset. 3 Bruk en multifunksjonsmaskin (MFP) med berøringsskjerm som er koblet til en fargeskriver, og velg skjemaikonet og deretter skjemaet som er knyttet til dette skriptet. 30

34 Tillegg A: ODBC-oppsett Følg denne fremgangsmåten for å opprette ODBC DSN-forbindelser som kan brukes til eksempel 4 og 7. DSN-forbindelsene blir opprettet på den maskinen der Document Server er installert. 1 Hvis du har Windows NT: Velg Innstillinger Kontrollpanel. Hvis du har Windows 2000/XP: Velg Innstillinger Kontrollpanel Administrative verktøy. 2 Velg Datakilder (ODBC). 3 Velg kategorien System-DSN. Klikk på Legg til. Dette åpner en liste over ODBC-drivere som er installert på denne maskinen. Velg "Microsoft Access-driver (*.mdb)" på listen og klikk på Fullfør. 4 Dialogboksen for ODBC Microsoft Access-konfigurasjon åpnes. Angi datakildenavnet "LDD1" for eksempel 4, og "LDD2" for eksempel 7. Klikk på Velg for å bla gjennom databasen som skal brukes av denne forbindelsen. Velg databasen "resumes.mdb" for eksempel 4. Velg "stores.mdb" for eksempel 7. Klikk på OK. 5 Når begge to er lagt til, vil de være oppført på System DSN-listen. 6 Klikk på OK for å lukke denne dialogboksen. Forbindelsene er nå konfigurert og kan brukes fra et skript. Når du skal laste opp skript, vil det være lokale innstillinger for eksempel 4 og 7 som du kan bruke til å konfigurere ODBC-innstillingene. Generelt sett er det to obligatoriske og to valgfrie innstillinger for alle ODBC-forbindelser. DSN (Data Source Name) må angis. Dette er angitt i trinn 5 over. Tabellnavnet må angis. Dette er navnet på tabellen som inneholder de dataene som brukes i skriptet. Hvis du bruker databasene som er inkludert sammen med eksemplene, kan du bruke standardvalgene for tabellnavn i de lokale innstillingene. Brukernavnet er valgfritt. Hvis det ikke er nødvendig å logge seg inn, kan dette stå tomt. (Som standard er det ikke nødvendig å logge seg inn på Access.) Passordet er valgfritt. Hvis det ikke er nødvendig å logge seg inn, kan dette stå tomt. 31

35 Tillegg B: Formset-oppsett Dette tillegget viser hvordan du kan laste opp et formset og konfigurere den navngitte pipen til å samarbeide med den. Denne informasjonen brukes til å kjøre eksempel 8 og 9. Gjør følgende i Server Manager 1 Hvis du ikke allerede har gjort det, må du laste opp skriptet som skal brukes til dette formsetet. For disse eksemplene skal du laste opp skriptene "example08.xdd" og "example09.xdd". 2 Klikk på Legg til et formset på startsiden. Veiviseren for innlegging av formset starter. Det første trinnet i veiviseren er å velge hvilket formset som skal lastes opp. For eksempel 8 skal du velge "debitmemo.fdd", og for eksempel 9 skal du velge "faxcover.fdd". Begge disse ligger i eksempelkatalogen som ble installert sammen med Forms Composer. Klikk på Neste. På den neste siden i veiviseren skal du velge hvilken handling som skal utføres når dataene mottas for dette formsetet. Det er tre alternativer: Handlingen vil bli angitt av pipen eller i datastrømmen En av de forhåndsdefinerte handlingene skal brukes Et egendefinert skript skal brukes For våre eksempler skal vi bruke et egendefinert skript. Velg det aktuelle skriptet på listen (example08 eller example09). 3 Klikk på Neste. Den siste siden i veiviseren viser en oppsummering. Hvis du ikke allerede har laget en navngitt pipe som skal brukes for eksemplene, kan du merke av i boksen som starter veiviseren for navngitt pipe. 4 Klikk på Fullfør. Hvis du trenger å opprette en navngitt pipe, starter veiviseren for navngitt pipe. Hvis ikke, er du ferdig, og du kan fortsette å kjøre skriptet. 5 I veiviseren for navngitt pipe, er det første trinnet å gi pipen et navn. For våre eksempler skal vi bare opprette én pipe. Den kan brukes både i eksempel 8 og 9. Kall pipe for "test" og skriv inn en beskrivelse hvis du ønsker det. Klikk på Neste. 6 Den neste siden i veiviseren konfigurerer pipen slik at den kan motta data for ett eller flere formset. Siden pipen skal brukes både for eksempel 8 og 9, må du velge "Denne pipen vil bli brukt av flere formset". Klikk på Neste. 7 Den neste siden i veiviseren konfigurerer handlingen som skal utføres når dataene mottas i pipen. Dette ligner på siden i veiviseren for innlegging av formset, der du kan konfigurere hva som skjer når dataene for formsetet mottas. Siden vi allerede har konfigurert hva som skal skje med formsetet (det kjører et egendefinert skript), skal du velge "Handlingen vil bli angitt i utskriftsstrømmen". Klikk på Neste. 32

36 8 Den neste siden i veiviseren kan du bruke til å konfigurere hvilken datatype som skal mottas av pipen. I vårt tilfelle skal vi bare sende tekstfiler, så datatypen vil alltid være den samme. Velg "Dataene er alltid av denne typen" og deretter "en strøm med vanlig tekst". Klikk på Neste. 9 Den siste siden i veiviseren inneholder en oppsummering av de valgte alternativene. Klikk på Fullfør. Nå er du klar til å kjøre skriptet. Hvis du vil vite mer om de ulike alternativene for å laste opp formset og opprette navngitte piper, kan du se den skjermbaserte hjelpen i Server Manager. 33

37 Lexmark og Lexmark med rutermerket er varemerker for Lexmark International, Inc., som er registrert i USA og/eller andre land Lexmark International, Inc. 740 West New Circle Road Lexington, Kentucky 40550, USA