The names/contents of data-fields can be exported, generating a log file. Options for the log file are set up in the Log File page of the 'Configuration' dialog, see below. (Some of these settings are reflected in the 'Export' dialog – see Log file export.)

To set options for the Log file
1.Click the Log File tab of the 'Options|Configuration' dialog (f8).
2.Select the 'Log File Format':
oXML
•You may click XML field options... to refine the choice of XML data-field options to be logged, see Outputting to XML.
oPlain text; you may also add a:
•Text log file message. Type in a string to be output to the log file; it may contain Special fields in composed strings. Tick Enabled to use the message. Unselect 'Enabled' to de-select the option without erasing the message. See also Examples: Command lines.
oComma separated. By default, the field names are used to create the first line of a CSV log file. The alternative is to tick the option to:
•Omit field names and suppress the output of the first line.
3.In the 'Logged Fields' panel, choose which data fields are to be included:
oall the data-fields defined in the job: click All defined fields, or
ojust some of the data-fields. Click Select... to display the 'Field Definitions' window.
•Right click on a field name in the Fields list/tree and choose Select for export.
•To cancel a selection, right click and choose Unselect for export.

Repeat for all the fields you wish to export.
Click OK to return to the 'Log File' window; the Selected fields option is selected automatically. See also Viewing data fields and tags.
Alternatively:

oSelect None of the data-fields: this switches off log-file export.
4.To show the file-names of the data-files which supply the data for the data-fields in the document (as well as the actual field-values) in the console log, tick Filenames.
5.Page numbers, Bates Page Numbers and/or Sheet numbers may be logged. If the format chosen for the log file is:
oCSV then the number for each page/sheet exported is recorded in the log file;
oXML then a number for each page/sheet exported is recorded in the log file. This is default option.
oPlain text then the count (number of pages/sheets exported from this document in this export) is added to the end of the log file.
6.Set up 'When to output' items for the Log – either output log entries for:
Every page (the default) or
When a field specifies it.
oYou may opt to output log entries only:
At end of file or
At end of file + 1 too: see Note below.
7.Set further options as required:
oRename log file when finished. See Note below.
oCreate a new log file for each output file. See Note below.
oMake one new log file entry for each output file; left unchecked, a new log file entry will be made for each page output instead.
8.Some jobs require a count of the pages in each of a number of repeated sets within a document: click Count pages (see below) then click OK.
9.If any errors occur an Error log file may be created along with the file. Setting up a path and filename in the edit box automatically ticks Enable (default is ERROR.LOG). See Note below.
10.Click OK.
Alternatively, you may choose to create a Shortcut icon that uses all the options you have set by clicking Shortcut... (see Shortcuts - the easy way to construct a command line) or click the Save button to retain these settings after you close the program.
Notes

The output files are constructed using the specified output file name; numbers appended so that the default output file-stems are xxxx1, xxxx2 etc.. The log files take the corresponding file-stems plus the extension .CSV, .XML or .LOG, depending on the log format that you have selected.

Rename log file when finished: during processing, the log file bears a temporary name and is not given its final name until the log file is complete. The temporary name is given an extension of .CS~, .XM~ or .LO~, indicating that it is still being created.

Create a new log file for each output file: the output file is split whenever a specified field (or tag) is encountered or when a field changes. Each log file has a name corresponding to its output file and field content (even if only one file is created), unless the input was from TCP/IP, in which case it has a name based on the first output file name.
For example if the file is called TEST.PCL, the field contains ABCD and the output specification is *=.PDF then the output file name will be TESTABCD.PDF and the Log file will be TESTABCD followed by the appropriate extension.

At end of file writes the log entries at the end of the file. At end of file + 1 writes the log entries as if on a page after the end of file, to simplify page counting. See also /LOG command-line option.

The Count pages dialog constructs a prototype RUN command set up with the options that you have selected, e.g.
EscapeE {ofilename},FILENAME,PAGE /INPUT CSV

An Error log file is only created when there are errors to log. When Enable is ticked the value of ERRORLOG symbol in the [PCLVIEW] section of RT.INI is set to the specified file. When 'Enable' is deselected the ERRORLOG value is set to N. See also /ERRORLOG.

 

Links

Log file export

Extract data