Purpose

The Loan Debugger is an innovative, user-friendly diagnostic tool.  Unlike the standard diagnostic tools that come with Encompass by default, the Loan Debugger evaluates actions and performance in real-time.  This allows administrators to catch errors as they occur, with the ability to determine the prior actions that could have caused the error.  The tool also provides a summary section detailing errors, triggers, calcs and field population. 


Activating the Loan Debugger Pro


Before using the Debugger, create the following folder on your computer, if it doesn't already exist:
C:\EncompassLog\DebugLog.

Loan Debugger Pro is activated by double-clicking the silver target icon in the bottom-right hand corner of the screen.


The Loan Debugger Pro options and testing screen will open. The user can select the debug mode that best suits their current debugging task. The user can run Performance Tests to assist is selecting the debugging mode that is best for them. 

Image Placeholder

If the purpose of using the PowerTool is to review processing times, it is possible to further limit the overhead added by having the Debugger running.  Any, or all, of the options below can be selected for any Mode to more closely replicate system performance when the Tool is disabled.




As an example - below are the results of the Set Field 500 times test for each of the 4 possible modes. 

Disabled
    Image Placeholder

Standard
Image Placeholder

Faster
Image Placeholder

Ultra
Image Placeholder

The "Run All Tests" allows the user to run and compare the results of all tests in one window which shows previous test results and where a new set can be run. Running all tests takes a few minutes, as indicated by the popup message. The results pane displays the results for all tests and for each mode.

Image Placeholder

If Loan Debugger is activated without a loan open, Performance Tests are not enabled.


Loan Debugger Pro options can be changed by accessing the menu by right-clicking on the icon.  Click "Debug Options" to change the Debug Mode or the Disable the Debugger.
Image Placeholder


Deactivating the Loan Debugger Pro

Loan Debugger Pro will be deactivated when Encompass is closed.  The tool can also be closed by right-clicking on the icon, selecting Debug Options, selecting Disable Diagnostics, and clicking Close.

Image Placeholder


Using the Loan Debugger Pro


Once the tool is activated, open a loan and click the target icon in the bottom-right hand corner of the screen.  This time the icon will be blue. 


Loan Debugger Pro will launch in a separate window.


Important Events Section (Top-Left)

The Important Events panel in the top-left hand corner of the debugger window is a running list of events that have taken place involving the loan file.  We recommend you check the "ignore common errors" checkbox on the top left. 

Image Placeholder

Loan Debugging and Troubleshooting


The Events Panel is the area where the user can monitor, in real-time, changes that occur as the loan is being updated.  Each event shows forms that are opened, fields that are changed, business rules that are run, and system events that occur. 

One of the most important features of the Loan Debugger Pro is the ability to track every event that occurs when there is a change to a loan.  If an event, such as a field value change, causes other events to occur, the events are grouped in a tree-like structure. This allows the user to follow the path of each change and the reason that the change occurred.   

Loan Debugger Pro displays an audit-trail like view of changes to field values. This allows the user to follow the trail of changes to a field, and easily determine which event caused the field to be set to a particular value.  Filtering the Event Viewer on the targeted field isolates the list, making it easier for the user to follow the field changes. 

Loan Debugger Pro also calculates the elapsed time of each event and group of events.  This information is invaluable to administrators attempting to determine if a calculation or business rule is causing latency in the loan.  Note that the time will be affected by the Debug Mode selected. If performing this type of analysis, we recommend setting Loan Debugger Pro to "Faster" or "ULTRA".


Debug Log (Top-Right)

The Debug Log is the primary diagnostic tool that shows line-by-line code execution results.  This is similar to the Ellie Mae diagnostic tool except that it can be viewed in real-time as changes are being made to the loan file.  The Loan Debugger log updates anytime a change occurs in the loan file (automatically or manually).  Selecting any event line in the Important Events section will select the line in the Debug Log section where that event occurred. This assist the user by displaying the actual system event.  The user can then easily navigate between events before and after to further investigate the issue.



A useful feature of the Debug Log is that any lines that contain errors or exceptions are highlighted in red. 


Summary Section (Bottom-Left)

The section in the bottom-left hand corner of the window is a summary section with the following tabs:  Errors, Triggers, Calcs and Fields.  The Errors tab shows a list of runtime errors compiled (in order) from the time that the loan was opened.  The Triggers  tab is a list of field trigger rules that have executed since the file was opened.  The Calcs tab is a list of field calculations that have taken place and the Fields tab is a list of fields that have been automatically populated/updated.  




This product installs the following:


Plugins

LoanDebuggerProPlugin3.dll (version 6.0.0.1 - updated 3/21/24)

CDO

LoanDebuggerProPlugin3LicenseKey.txt