Lexmark Document Distributor User manual

www.lexmark.com
Basic Script Writing
April 2002
Document Distributor

Edition: April 2002
The following paragraph does not apply to any country where such provisions are inconsistent with local
law: LEXMARK INTERNATIONAL, INC., PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of
express or implied warranties in certain transactions; therefore, this statement may not apply to you.
This publication could include technical inaccuracies or typographical errors. Changes are periodically made to
the information herein; these changes will be incorporated in later editions. Improvements or changes in the
products or the programs described may be made at any time.
Comments about this publication may be addressed to Lexmark International, Inc., Department F95/032-2, 740
West New Circle Road, Lexington, Kentucky 40550, U.S.A. In the United Kingdom and Eire, send to Lexmark
International Ltd., Marketing and Services Department, Westhorpe House, Westhorpe, Marlow Bucks SL7 3RQ.
Lexmark may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you. You can purchase additional copies of publications related to this product by calling
1-800-553-9727. In the United Kingdom and Eire, call [phone]. In other countries, contact your point
of purchase.
References in this publication to products, programs, or services do not imply that the manufacturer intends to
make these available in all countries in which it operates. Any reference to a product, program, or service is not
intended to state or imply that only that product, program, or service may be used. Any functionally equivalent
product, program, or service that does not infringe any existing intellectual property right may be used instead.
Evaluation and verification of operation in conjunction with other products, programs, or services, except those
expressly designated by the manufacturer, are the user’s responsibility.
Lexmark and Lexmark with diamond design are trademarks of Lexmark International, Inc. registered in the United
States and/or other countries.
© Copyright 2002 Lexmark International, Inc.
All rights reserved.
UNITED STATES GOVERNMENT RESTRICTED RIGHTS
This software and documentation are provided with RESTRICTED RIGHTS. Use, duplication or disclosure by the
Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and
Computer Software clause at DFARS 252.227-7013 and in applicable FAR provisions: Lexmark International, Inc.,
Lexington, KY 40550.

i
Table of contents
Introduction ........................................................................ 1
Chapter 1: Your First Script ..............................................2
Example of a work flow process ............................................. 2
Using the ScriptWizard to write your script ............................. 4
EmailSMTP ................................................................................ 8
ConvertToDocument ............................................................... 12
FaxByPrinter ............................................................................ 15
Compiling your new script .................................................... 18
Creating a Profile .................................................................. 20
Using the MFP ProfileWizard .................................................. 21
Summary .............................................................................. 25
Chapter 2: Parts of a Script ............................................26
Objects ................................................................................. 26
Properties and methods .......................................................... 26
Data Objects ............................................................................ 28
Action Objects ......................................................................... 32
System Objects ....................................................................... 33
Helper Objects ......................................................................... 35
Summary .............................................................................. 38

ii
Chapter 3: Using the Script Editor .................................39
Script Editor Toolbar ............................................................. 40
Adding an Action Using the Insert Actions Wizard ............... 41
Add Actions Manually ........................................................... 45
Compilation Prompts ............................................................ 47
Summary .............................................................................. 47
Chapter 4: Flow Control ..................................................48
Conditional Statements ........................................................ 48
If/Then ..................................................................................... 48
Switch/Case ............................................................................. 51
Repetitive Statements .......................................................... 52
Loop ......................................................................................... 52
Repeat ..................................................................................... 53
Summary .............................................................................. 54
Chapter 5: User Data .......................................................55
Creating User Data in a Script .............................................. 57
Types of User Data ............................................................... 59
Using User Data in a Script .................................................. 64
Summary .............................................................................. 65

1
Introduction
This document provides an introduction to writing scripts for the Lexmark Document Distributor (LDD)
Version 2.1. It is assumed you are familiar with basic programming concepts and have some
experience with a programming language such as C, C++, or Visual Basic. For a detailed technical
specification of the scripting language, see the “Script Reference”. To study example scripts for the
Document Distributor, see the “Script Examples”. Both of these documents are located at Start
Programs Lexmark Document Distributor Client.
Included in this book:
Chapter 1, "Your First Script"—Planning and creating your first script.
Chapter 2, "Parts of a Script"—Explores the script created in Chapter 1. Covers objects, data types,
system objects, helper objects, and Actions.
Chapter 3, "Using the Script Editor"—Add Actions and other features to scripts created with
ScriptWizard.
Chapter 4, "Flow Control"—Insert logic statements that control execution of other parts of the script.
Chapter 5, "User Data"—Prompt end users for additional information when a script is run, then use
the data in a script.

2
1Your First Script
To unleash the power of Document Distributor you need to create a script. To create a script you will
need to understand the business process that you want to automate. Processes that are rarely
performed or procedures that require a large amount of human intervention throughout the process
probably aren't good candidates for Document Distributor automation. These guidelines can help you
decide if your process qualifies for automation:
Does your task:
•Have steps done repeatedly in exactly the same way or with only minor variations?
•Have multiple steps?
•Already have a partially automated process (Document Distributor can further automate it)?
•Have a means of getting documents into a back-end process that end users don't need to
know about?
•Have parts of a process that may change, but your end users don't need to know about it?
•Need to be simplified for your end users?
Once you've decided that Document Distributor can improve your workflow process, analyze the steps
involved in the process.
Example of a work flow process
The Human Resources Department must post job openings within the hospital every week in various
locations throughout the hospital. Each week the list of job openings is faxed to various departments in
the hospital. The recipients in the department then put the list of job openings on their bulletin board.
Some departments are willing to receive the job listing as an e-mail rather than a fax. But until
everyone is willing to receive an e-mail, someone must fax the list to those who prefer a fax and e-mail
the list to everyone else.
This is a process that is repeated regularly and has multiple steps. As more departments are willing to
accept an e-mail, the process will change as the e-mail list grows and the fax list shrinks. The end
users are Human Resource employees that are familiar with the job openings, but not necessarily with
the e-mail addresses and fax numbers of all the various departments throughout the hospital.

3
Now look at the Actions provided by Document Distributor and see how they match up with the
example process.
In the hospital example, you need to break down the Document flow and then pick the Actions that
correspond:
1E-mail listings to departments (EmailSMTP)
2Convert document to fax (ConvertToDocument)
3Fax job listings to departments (FaxByPrinter)
Next, write the script using the ScriptWizard.
Route Documents Print Documents Store and Retrieve Documents
EmailExchange PrintASCII DatabaseNotes
EmailNotes PrintByAssoc FTPget
EmailSMTP PrintByDriver FTPput
FaxByPrinter PrintIP GWDiscuss
GWMail PrintPDF GWCheckIn
LaunchExe PrintTIF ODBCRead
PrintURL ODBCWrite
SaveToFile
Manipulate Documents Recognize Document Content EDMS Integration
ConvertImageFormat ConvertBarcodeToText DominoDocCheckin
ConvertToDocument ConvertForm DominoDocRetrieve
ImageCombine ConvertToText SharePointRead
ImageCrop SharePointWrite
ImageDeskew
ImageInvert
ImageMerge
ImageRotate
ImageSeparate
ImageText

4
Using the ScriptWizard to write your script
The ScriptWizard helps you quickly create scripts to automate your workflow.
1Start the ScriptWizard by clicking the ScriptWizard icon
2A Dialog box appears listing the steps to take to create a script. Click Next.
3Choose which Document Server will process this script. Select Primary Server for your first
script. Click Next.

5
4Give your script a name. This is the name your end users see when selecting a profile from an
MFP or workstation. The name can be up to 15 characters long. You may also provide a longer
description to help identify this work flow process. This description can be seen by end users
who submit jobs from a workstation through Select'N'Send or Print'N'Send. For this example,
enter "JobList" as the script name. Click Next.

6
5In the “Example of a work flow process”on page 2, the end user will scan the list of job
openings or submit the list using Print'N'Send, so select Yes, a document is required for this
job. No user data is needed in this script. To learn more about user data, see “User Data”on
page 55.

7
6Select the Actions. Choose which Actions will be used in your script. For this example, you
need one e-mail Action, one conversion Action, and one fax Action.
•Select EmailSMTP. Click Add.
•Select ConvertToDocument. Click Add.
•Select FaxByPrinter. Click Add.
There are now three Actions in your script.
When creating a script, you can add as many Actions as you want. You can also add the same
Action several times. For example, add FaxByPrinter again if you want to fax the document
twice. The Actions are carried out in the order they are added to the script. If you need to use
the results of one Action in another Action, be sure to put them in the correct order. For
example, in this script you need a PostScript document for faxing with the FaxByPrinter Action.
So you first added the ConvertToDocument Action that converts our scanned document to
PostScript before faxing it.
Now you're ready to configure each Action. Click Next.

8
EmailSMTP
In order to send e-mail, you need to specify some properties. Click on each of the following to specify
the property.
•Server
•To
•From
•Subject
•Message
•Attachments
1Click the Server Property. This property indicates the mail server that sends the e-mail. Select
Use value specified, and type in the name of the mail server.

9
2Click the To property. This property indicates to whom the e-mail is sent. Select Use value
specified, and type in the recipient of the e-mail.
3Click the From property. This property is the sender’s e-mail address. Select Use value
specified, and type in the sender’s e-mail address.

10
4Click the Subject property. This string is the subject of the e-mail that is sent. Select Use
value specified, and type in the subject.

11
5Click the Message property. This string is the text of the e-mail that is sent, along with any
attachments. Select Use value specified, and type in the message.
6Click the Attachments property. This property indicates what documents to attach to the
e-mail. Since this script e-mails the original document received from the user, click Use a
variable or property and choose original.document from the list. This indicates the
originally scanned document.
7Click Next to set the properties of the ConvertToDocument Action.

12
ConvertToDocument
The FaxByPrinter Action requires the input document be in PostScript format. Because of this, the
ConvertToDocument Action is used first to produce a PostScript file.
The following properties need to be set:
•Input
•Format
•Output
1Click the Input property. This is the document the action will operate on. Click on Use a
variable or property and choose original.document from the list. This is the document
originally scanned by the user.
Note: Before using an action, check the “Script Reference”located at Start Programs
Lexmark Document Distributor Client, to see what kind of document is required for
the Action.

13
2Click the Format property. This property specifies the file format of the output from this Action.
Choose PostScript as the conversion format.

14
3Click the output property. This property specifies where to keep the output from this Action.
Click Create a new variable called in order to create a new document variable. Type in
PSDocument as the name of the new document. This document can be used in subsequent
Actions.
4Click Next to set the properties of the FaxByPrinter Action.

15
FaxByPrinter
This Action is used to send a fax using a Lexmark MFP. The following properties need to be specified:
•Input
•IPAddress
•FaxNumber
•StationID
1Click the Input property. This is the document that will be faxed. Click on Use a variable or
property, select the PostScript document created by the ConvertToDocument Action called
PSDocument.

16
2Click on the IPAddress property. Provide the IP address or DNS name of the fax-enabled
Lexmark printer to be used for faxing.