Saving log information for ReadSoft Collector: Overview

Logging, in connection with ReadSoft Collector, is managed with log configurations that are created or adjusted  using the settings on the Logging tab of the General settings dialog. These configurations specify if and how to save log information when invoices are interpreted using this product. All logging options that are specified are generated for all jobs that use ReadSoft Collector as the input source.

• When a log configuration is created, the corresponding log is automatically created according to the specified settings unless or until the associated log configuration is deleted. If the log file itself is deleted without deleting the log configuration, the file is created again the next time a log event occurs.

• If a log configuration is deleted and the corresponding log file is not, the log file remains but no additional information is added to it.

Log information

We highly recommend that at least one logging alternative is selected when configuring ReadSoft Collector  so that you have the necessary information when errors occur. If no logging alternative is specified, errors are logged to the Windows event log by default. This is the information that is logged:

• The reason for the error.

• The email that was not processed because of the error.

• Which file attachments were processed and those that were not.

Available log file types

• Rolling flat file: This log type is used to keep log-file size at a minimum to save space on the hard drive. You specify the name and location of the file, the maximum file size, and the time format (used in the text for logged events). After the maximum size is reached, a backup copy of the file is created, and log information continues in a new file. However, once the second file has reached the maximum specified size, the original backup file is overwritten with any additional log information.
  
  Starting with HF22, an infinite number of files can be created so that no information is lost. Once the specified maximum size is reached, a backup copy of the current file is created, and log information continues in the next file. The name of the file is appended with the date and an incremental sequence number.

• Event log: Events are logged in Windows Event Log. The size of the file is specified in the Event Viewer in Windows.

• Mail log: A log is sent in the body of an email to the specified email address. Note that email log messages can only be sent using SMTP through the default TCP/IP port (25).

Level

You can also specify what level of information you want in the log:

• 1 - Error: Only error events are included in the log.

• 2 - Information: More information is included in the log resulting in a longer file.

• 3 - Debug: All available information is provided to aid in debugging. However, the file size can be considerable.