Log Element

The log element is used to create log files tracing the activity of the Business Importer. This element is available by default for a business adapter running in connected mode on your central application server, and can be manually added for adapters running in disconnected mode on an inventory beacon. When added in disconnected mode (perhaps using the Business Adapter Studio to specify the logging), the log contains only query-to-query information, and naturally excludes any data about server-side database actions.

Example

This example creates a log, using the date, time, and import name for the file name:

<Log 
    Name ="NewLog"
    Output="file"
    Loglevel="warnings"
    filename="[DATE][TIME][IMPORT NAME].log.txt">
</Log>

Contains

No further elements: <Log /> is an empty XML element, relying entirely on its attributes.

Contained by

Import.

Supported attributes

Name

Mandatory. This is the friendly name of the log element.

Output

Mandatory. Sets the destination of the log. Possible values are:

• Console means send the log output to the console.
• File means save the log to a file on the disk (see FileName attribute).

Content

Mandatory. Sets the content of the log. Valid values are:

• Detailed means information for each object is logged according to the LogLevel specified.
• Summary means a summary for each object is output at the end of the import.
• All provides a combination of the Summary and Detailed log.

FileName

Optional. Sets the name (and optionally, the path) of the log file. This attribute supports UNC or a relative file path (relative to the directory where the Business Importer is executing).

FileName can be dynamically created using keywords. Valid keywords are:

• [DATE] is replaced by the date the import was started (formatted as yyyymmdd).
• [TIME] is replaced by the time the import was started (formatted as hhmmss).
• [IMPORT NAME] is replaced by the value of the Name attribute of the Import element containing this Log.

If Output="File" but the FileName is not specified, the default is to write the log file in the directory where the Business Importer is executing, with the name MBI.log.txt.

LogLevel

Sets the logging level to control logging output. Enabling logging at a given level, also enables logging at all higher levels. Valid values (organized from highest to lowest) are:

• Silent
• Critical
• Errors
• Warnings
• Information
• Debug.

More detailed tracing (written to the database) is also available for each import: see Detailed Tracing.