Exception Details

Contents ShowHide

The Exception Details screen is used to review the nature of all errors that occurred during the generation of custom letters.

Screen Access

Display the Custom Letter Sent Summary screen > Click the Exceptions Details button.

Interface Initialization

Upon initial display of the screen, the following occurs:

The title bar text is set to "Exception Details".

The first row in the data grid is initially selected as the default.

All text and value labels are read-only.
The Select All button is visible and enabled as the default.
The Save for Restart button is visible and enabled as the default.
The Save for Help Desk button is visible and enabled as the default.
The Copy to Clipboard button is visible and enabled as the default.

The Close button is visible and enabled as the default.

Screen Elements

Unless otherwise stated below, all controls on the Exception Details screen are visible and enabled when:

The screen is active.

If one or more special conditions exist that affect a control on the Exception Details screen, the condition(s) are documented for that specific control below.

Exception Log data grid

View the information in the Exception Log data grid.

The data grid displays details about each of the exceptions generated while processing custom letters. Select a row in the data grid to view the full exception details in the Exception Details group box.

The data grid consists of the following control(s):

Run ID column

This column displays the sequence counter specifying record placement in the custom letter generation process for each record displayed within the data grid.

The title of the column is set to "Run ID". The information displayed within the column is read-only.

Reference ID column

This column displays the reference identification number for each record displayed within the data grid.

The title of the column is set to "Reference ID". The information displayed within the column is read-only.

Reference Message column

This column displays the exception message that occurred for the run for each record displayed within the data grid. If the run is cancelled by a user, an exception with a message of "Cancelled by <USERID>." will be generated.

The title of the column is set to "Reference Message". The information displayed within the column is read-only.

Vendor ID column

This column displays the vendor identification number for each record displayed within the data grid.

The title of the column is set to "Vendor ID". The information displayed within the column is read-only.

The control is visible and enabled when:

A search for Vendors was performed on the Send Form Letters screen.

Vendor Name column

This column displays the vendor trade name for each record displayed within the data grid.

The title of the column is set to "Vendor Name". The information displayed within the column is read-only.

The control is visible and enabled when:

A search for Vendors was performed on the Send Form Letters screen.

Corporate Parent ID column

This column displays the corporate parent identification number for each record displayed within the data grid.

The title of the column is set to "Corporate Parent ID". The information displayed within the column is read-only.

The control is visible and enabled when:

A search for Corporate Parents was performed on the Send Form Letters screen.

Corporate Parent column

This column displays the name of the corporate parent for each record displayed within the data grid.

The title of the column is set to "Corporate Parent". The information displayed within the column is read-only.

The control is visible and enabled when:

A search for Corporate Parents was performed on the Send Form Letters screen.

Communication Option column

This column displays the communication option where the custom letter is being routed (e-mail, fax, or mail) for each record displayed within the data grid.

The title of the column is set to "Communication Option". The information displayed within the column is read-only.

Recipient column

This column displays the entity that a custom letter is being routed to for each record displayed within the data grid.

The title of the column is set to "Recipient". The information displayed within the column is read-only.

Exception Details group box

Complete the information in the Exception Details group box.

This group box displays exception details for the record selected in the Exception Log data grid. It consists of the following text and value labels:

Run ID text and value label

This value label displays the sequence counter specifying record placement in the custom letter generation process for each record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

Reference ID text and value label

This value label displays the reference identification number for the record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

Reference Message text and value label

This value label displays the exception message that occurred for the run for the record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

Vendor ID text and value label

This value label displays the vendor ID for the record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

The control is visible and enabled when:

A search for Vendors was performed on the Send Form Letters screen.

Corporate Parent ID text and value label

This value label displays the corporate parent ID for the record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

The control is visible and enabled when:

A search for Corporate Parents was performed on the Send Form Letters screen.

Communication Option text and value label

This value label displays the communication option where the custom letter is being routed (e-mail, fax, or mail) for the record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

Vendor Name text and value label

This value label displays the trade name of the selected vendor for the record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

The control is visible and enabled when:

A search for Vendors was performed on the Send Form Letters screen.

Corporate Parent text and value label

This value label displays the name of the selected corporate parent for the record selected in the Exception Log data grid.

The information displayed is read-only. The value label displays in the inverse color of the screen.

The control is visible and enabled when:

A search for Corporate Parents was performed on the Send Form Letters screen.

Recipient text and value label

This value label displays the entity that a custom letter is being routed to in the following format:

E-mail: Target Name<Target@Email.Address>

Fax: Target Name<Fax Number>

Recipient:

Target Name

Address Line 1

Address Line 2

City StateCode, ZipCode

The information displayed is read-only. The value label displays in the inverse color of the screen.

Select All button

Click the Select All button to select all records in the Exception Log data grid.

It has a mnemonic of "A".

Save for Restart button

Click the Save for Restart button to save the selected records in the Exception Log data grid to an .XML file that can be reloaded at a later date once issues that caused exceptions have been resolved.

A Windows Save File As screen displays when the button is clicked.

If all of the records in the Exception Log data grid are selected, the requested action is performed. If only some of the records in the Exception Log data grid are selected, a standard confirmation message displays

A standard confirmation message (C0041) displays. The options of Yes and No are available. If the user clicks Yes, the process continues. If the user clicks No, the process is terminated and the Exception Details screen displays so that the Select All button can be clicked.

It has a mnemonic of "R".

Save for Help Desk button

Click the Save for Help Desk button to save the selected records in the Exception Log data grid to a text file that can be given to Help Desk personnel for diagnostic purposes.

A Windows Save File As screen displays when the button is clicked.

It has a mnemonic of "H".

Copy to Clipboard button

Click the Copy to Clipboard button to copy the selected records in the Exception Log data grid to the clipboard in the same text format used for the Save for Help Desk button.

This allows the exceptions to be pasted into another text editor such as a spreadsheet or Word document.

It has a mnemonic of "C".

Close button

Click the Close button to close the screen.

The Custom Letter Sent Summary screen displays when clicked.

Processing

If data can be validated and saved on the screen, the following processes occur when the screen is processed:

A process to check for required controls as identified in the Data Map below is performed.
A process to check for valid entries as identified individually for each applicable control in Screen Elements above is performed.
A process to check for edits and cross edits as identified for each applicable control in Screen Elements above is performed.
If any checks or processes fail, a standard error message displays.

If no data can be validated and saved on the screen:

No cross edits are performed.
All values are considered legitimate.
No data is written to the database.

Data Map

The Data Map defines the values saved for all controls on the screen. If available, any additional notes or comments are displayed in the Notes column.

Control Label	Control Type	Table. Column	Notes
Exception Log	data grid label	·	·
Run ID	column	·	The run ID of the item in the batch run.
Reference ID	column	EXCEPTIONLOG. EXCEPTIONLOGID	Error recorded during the batch run.
Reference Message	column	EXCEPTIONLOG. MESSAGE	Error message recorded during the batch run.
Vendor ID	column	V_VENDORLIST. VENDORID	·
Vendor Name	column	V_VENDORLIST. TRADENAME	·
Corporate Parent ID	column	V_CORPORATEPARENT. CORPORATEPARENTID	·
Corporate Parent	column	V_CORPORATEPARENT. CORPORATEPARENTNAME	·
Communication Option	column	·	Communication option for the item of the batch run.
Recipient	column	·	Formatted string to determine where the recipient goes.
Run ID	value label	·	Same as Run ID column.
Reference ID	value label	EXCEPTIONLOG. EXCEPTIONLOGID	Same as Reference ID column.
Reference Message	value label	EXCEPTIONLOG. MESSAGE	Same as Reference Message column.
Vendor ID	value label	V_VENDORLIST. VENDORID	Same as Vendor ID column.
Vendor Name	value label	V_VENDORLIST. TRADENAME	Same as Vendor Name column.
Corporate Parent ID	value label	V_CORPORATEPARENT. CORPORATEPARENTID	Same as Corporate Parent ID column.
Corporate Parent	value label	V_CORPORATEPARENT. CORPORATEPARENTNAME	Same as Corporate Parent column.
Communication Option	value label	·	Same as Communication Option column.
Recipient	value label	·	Same as Recipient column.

Software Version: 2.40.00