Selecting the Log Fields
The log produced by WTE consists of a list of line entries. Each line entry is written to the log as a result of a certain event (for example, a new call starts). For a list of events and the procedure for selecting the events to be logged, see Selecting Logging Events for an Application.
Each line entry in the log consists of many fields, each containing a unique piece of information. Because you might not want to log all the fields, the WTE lets you choose the fields to log and those to ignore. Unselected fields appear in the log as a dash ("-"). All fields can be unselected or selected, except for the "Date and Time" field when logging to ODBC, which is always logged.
To select logging fields through the WTE administration object model, use the WTELog.LogFieldSelection property.
This topic discusses the log fields by the order in which they appear in a line entry in the log. If you are using a private database for WTE logging, be sure to use the following field names for the columns, but without any spaces between the words.
- Session ID
- A unique identifier (ID) for each session. Every call handled by WTE is assigned a new session ID. The WTE assigns session IDs in ascending order. Every log that concerns this call will have its session ID logged in this field. The identifier is a 15-digit number; for example:
001255769230291
- Log Time
- The date and time of the logging. The format is Date, Hour:Minute:Second; for example:
12/9/1999 17:51:51
- Event Class
- A description of the event that caused the logging; for example:
Call Available
- Machine Name
- The name of the machine running the WTE; for example:
WteTEL6
- Address Group
- In this release, WTE does not use this field. In the next version, this field will give the name of the address group, if the address belongs to an address group. This field applies only if DNIS is supported.
- Address
- The address through which the call is connected. This address is usually a phone number; for example, 5551212
- Caller ID
- The identifier of the caller party. This ID is usually a phone number; for example, 5551212
- Called ID
- The identifier of the called party. This ID is usually a phone number; for example, 5551212. This field applies only if DNIS is supported.
- Reason
- The reason the call was transferred to the WTE, usually for voice-mail purposes; for example, "Busy On Forward".
- Application Name
- The name of the WTE application connected to this call; for example, "Test".
- Media
- The media mode of the call; for example, "Automated Voice".
- Page
- The page that the application is currently using; for example, "http://wtel2/demo/demointroduction.htm"
- DTMF Value
- The value of the DTMF digit received; for example, "5".
- Dest Address
- The address to which the call is transferred; for example, 1111.
- Hang Reason
- The reason the call was disconnected; for example, "Disconnected - Rendering Error".
- Transfer Type
- The type of call transfer; for example, "BlindTransfer" or "SupervisedTransfer".
- Error Type
- When a log is written due to an authoring error, this field holds the error type; for example, "Error opening the requested URL".
- Input Record File
- Some events cause recorded audio (.wav) files to be saved. This field contains the recorded file names; for example, "C:\Program Files\Log\Recordings\IS001255769230291.log
- Custom
- Your WTE application can set this field through the extended object model (ExOM). For more information, see Setting the Custom Log Field.