Example 1

This command line in the Run box

escapee /from REPORT.CSV,FILENAME,PAGE

calls file REPORT.csv containing this text:

"FILENAME","PAGE"
"REPORT.prn","2"
"REPORT.prn","5"
"REPORT.prn","6"

The PAGE field supplies the value of 'startpagefield' but as no 'endpagefield' values are supplied, EscapeE fills in default values for you. This results in the first segment consisting of pages 2, 3 and 4; the second segment of just page 5 and third segment, just page 6.

You might then go on to use this command line:

escapee REPORT.PRN /csv /save fecr#? /fields COUNT.EE

to create a log file containing the file name and page number. A log record is written every time a field is encountered that has the 'Write log record' option selected (see Setting Advanced options in field definitions), and also at the end of file. This file can then be read back and have the number of pages added using the {_numpages} special field. For example

escapee /from REPORT.CSV /pcl /fields MARKUP.EE

Example 2

A plain text log file may contain a "Text log file message". This can be set up on the 'Log file' page of the Configuration dialog (see Setting log file options) or on the command-line using the /LOGTEXT option. It can contain Special fields in composed strings as well as text. For example

escapee myfile.pcl /pdf /log 1T /logtext '{_Day}/{_Month}/{_Year} {_Hour}:{_Minute} input file {_ifilename}{_crlf}Exported as: {_ofilename}: {_sheets} pages'

The resulting log file "myfile.log" contains:

24/09/2009 15:15 input file C:\temp\myfile.pcl

Exported as: C:\temp\myfile.PDF: 5 pages

24/09/2009 15:15 input file C:\temp\myfile.txt

Exported as: C:\temp\myfile1.PDF: 2 pages

Should you wish to suppress the message on occasion, just add "~" to the /LOG options; there is no need to delete the "message":

escapee myfile.pcl /pdf /log 1T~ /logtext '{_Day}/{_Month}/{_Year} {_Hour}:{_Minute} input file {_ifilename}{_crlf}Exported as: {_ofilename}: {_sheets} pages'

Then if you want to return to showing the message, you only need to remove the ~ character.

Example 3

Command line options may be appended to component files specified in a LOF control file; see LOF details.

:\ESCAPEE
'C:\TEST\first file.pcl' /REM 'A3 example' /PAPER A3
'C:\TEMP\second file.pcl' /REM 'A4 example' /PAPER A4

Example 4

The syntax
/OPTIONS <option_file_name>
allows an option file to be specified which contains a number of options. Each line of the file should be of the form
option=value
as in this example file myopts.OPT:

The example options file formattif.OPT below sets up the output format:

so the command line to export the file would simply be:

ESCAPEE /OPTIONS formattif.OPT

---

Links

Running EscapeE from the command line

---