LSPS documentation logo
LSPS Documentation
Exceptions

The LSPS Server returns an exception when a component of a model instance cannot perform the required action, for example, if data is missing, or entry data does not correspond with the expected data (a model throws an exception with the error() call, refer to Exception Handling).

When a model instance fails with an Exception, the Execution Engine rolls back the transaction that caused the exception.

Such error on model instances is recorded in the Exceptions log. For further information on transactions in model instance, refer to Transactions in Model Instances).

As part of the management features, you can resend inputs to such model instances.

Managing Exception from the Management Perspective

The list of such exceptions that occurred in model instances is displayed in the Exception Handling view with their details:

  • ID: unique exception identifier
  • Component: component which generated the exception
  • Creation Time: time when the exception occurred
  • Resend: time when the resend request was executed
  • Exception: exception message

In the view toolbar in the upper-right corner, the buttons for the following actions are available:

  • Remove ( ): removes the selected exception entry.
  • Resend ( ): resends the request.
  • Export to File ( ): saves one or multiple exceptions in a text file.
  • Filter ( ): filters the content of the displayed list.
  • Refresh ( ): refreshes the view content.

You can copy multiple rows to the clipboard with Ctrl + c.

ExceptionHandlingView.png
Exception Handling view
Double-clicking a table entry displays the respective exception detail view with detailed information about the selected exception and its complete stacktrace. From the detail view you can export the exception to a file: click the Export to File ( ) button in the view toolbar, to do so.

ExceptionDetailView.png
Exception detail

Managing Exception from Management Console

Exception that occurred in model instances are recorded on the Exceptions page.

From Management Console, you can do the following over Exceptions:

exceptionsweb.png

Displaying Exception Stacktrace

To display an exception stack trace, click the exception id on the Exception page. To display the full stacktrace, open Designer, connect to your server and inspect the exception in the Exception view of the Management perspective.

Removing Exceptions

To remove an exception entry, in the Exceptions view, select the exception and click the Remove button.

Resending Inputs on Model Instances with an Exception

Resend attempts to execute again a transaction that previously failed: on resend the system resends the inputs which caused the exception to the model instance. Before using this function you will typically fix the underlying data of the model instance or database data, or make sure that an external service was fixed, etc.

To resend the data, do the following:

  1. Select the exceptions in the table.
  2. Click the Resend button in the upper right corner.