Exception Viewer

image1

The Exception Viewer program is used to:

  • View TruckMate application errors logged to the database.

  • Send e-mail notifications to your Database Administrator if specific errors occur.

The left side of the window displays categories to filter the list to a more focused subset. Click the '+' sign just to the left of any one of these categories will expand the category and offer more sub-category options.

The grid on the right-hand side of the screen displays a breakdown of any exceptions and appears that appeared when using a specific program.

For further information on any specific error, double-click anywhere in the error line. An Exception Detail dialog box will appear showing the Error line’s ID number, application involved, version information of that application, the exception type, the Username, the machine, and the date and time this error occurred.

For errors occurring regularly, you may wish to configure the Exception Viewer program to notify your Database Administrator using the Exception Notification function.

  1. Customers using TM4Web and Veltion Webservice functionality can check the Exception Viewer program to see what calls were made to the Webservice, what information was passed, and if the call was successful, etc.

  2. The more programs you have used (and generated Errors within) the more programs will appear under the Applications category.

To access Exception Viewer:

From this location Go to

TruckMate Menu and TruckMate Task List

Utilities > Exception Viewer

Windows Start Menu

TruckMate 20xx > Exception Viewer

Windows Explorer

C:\Program Files (x86) > TruckMate 20xx > ExceptViewer.exe

Application Configurator options for Exception Viewer

Utilities > Application Configurator > EXCEPTVIEWER.EXE

Option Definition

Log Exceptions to DB

Causes all TruckMate application errors to be logged to your database when True. Otherwise the errors are logged to your local machine.

  • True

  • False (default)

Security Configuration for Exception Viewer

There are no specific options available in the Security > Business Events or other Security Configuration directly related to the Exception Wizard.

Viewing errors with the Exception Viewer program

  1. Ensure you have enabled the Application Configurator option for 'EXCEPTVIEWER.EXE' by setting it to True.

  2. Wait for an error in one or your TruckMate applications.

  3. Open Exception Viewer.

  4. The error information will appear in the grid on the right-hand side of the program. Double-clicking on any row within this grid will bring up an Exception Detail window, which offers further information about the error being generated.

Send e-mail to DBA automatically

To configure the Exception Viewer to send an e-mail to your Database Administrator upon receipt of a particular error:

  1. In Exception Viewer, select Exception Notifications from the toolbar or the View menu.

    An Exceptions Notifications window will open.

    image2

  2. Use the pull-down menu to select your Exception Type.

    For example, if you set the Exception Type to EDatabaseError, your database administrator would receive an email when any database error occurs. If your database administrator receives numerous similar errors, or recurring ones, they could forward the information to a TMW support representative for assistance in clearing up the errors.

  3. Complete the required informational fields in the window.

    Apply

    Apply your changes. When you click the 'Send Exception as Email' button, your changes will be automatically applied to the generated Email

    Import Template Values

    Import an email template values from your default email software if any are available

  4. Click OK to save.

View Exception Details

To view the exception details for a selected exception or error:

  1. Select the desired exception and do one of the following:

    • Double-click the desired exception.

    • Go to View > Exception Details

    • Click image3 Exception Details

The Exception Detail window opens. Information displayed is read-only.

image4

ID

Exception or error line’s ID number

Application

Name of the executable for the program reporting the exception

Version

Version number of the program

Exception Type

Type of exception being reported

User

Name of the user

Machine

Name of the workstation performing the task which triggered the exception

Occurred At

Date and time the exception occurred

Details

The full text of the exception or error message

This topic describes menu and toolbar options and functionality that are specific to the Exception Viewer window.

For information about common menu and toolbar options (i.e. File menu, Refresh, Multi-Company, etc.), see General menu and toolbar options.

Edit menu

Menu option Toolbar icon Keyboard shortcut Description

Send Exception as Email

image5

CTRL+M

Creates an Email (using your Windows Default Email software) with the subject line 'TruckMate Exceptions' and body text detailing the program name, version, the error details, User name and Date / Time information

Delete

imageDelete

Del

Deletes the log entry(s) currently highlighted.

Purge Exception Log

image6

Purges the exception log

*Warning:* Purging an Exception Log is permanent; you cannot get back the Logs you erase.

Select All

CTRL+A

Selects all Exception detail lines listed in the right-hand Exception window

Invert Selection

CTRL+I

Reverses the order of the highlighted items

View Menu

Menu option Toolbar icon Keyboard shortcut Description

Exception Notifications

image7

CTRL+N

Displays the Exception Notifications configuration window where you can setup the Exception Viewer to send emails automatically.

Exception Details

image3

Opens the Exception Detail window.

Toolbar

image9

Menu option Toolbar icon Keyboard shortcut Description

Exceptions From / To

Sets the date range to determine which exceptions are included in the list. Double-click to select dates from a calendar menu. The "From" date is on the far right side of the toolbar.

Delete

imageDelete

Del

Deletes the exception log.

Purge Exception Log

image10

Clears the contents of the exception log.

Send Exception as email

image11

CTRL + M

Send the text for an exception entry as an email.

Exception Details

image12

Open the Exeption Detail window to view the details for the selected exception entry.

Exception Notifications

image13

CTRL + N

Clears the contents of the exception log.