The DataException is a specialized subclass of ServoyException designed to handle SQL-related errors in the Servoy environment. It provides detailed methods for inspecting the root causes of database issues, exposing properties such as the SQL query, SQL state, vendor error code, and associated parameters.
The class includes methods to retrieve the chained exception messages from underlying SQL errors, along with scripting-friendly accessors like js_getSQL, js_getSQLState, and js_getVendorErrorCode. These methods ensure integration into client-side logic. Additionally, the exception can capture and return the parameters of the offending SQL query, providing further insight for error resolution.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
ACQUIRE_LOCK_FAILURE
Exception code for ACQUIRE_LOCK_FAILURE.
This code is used when a database failed to lock a row or table.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
BAD_SQL_SYNTAX
Exception code for BAD_SQL_SYNTAX.
This code is used when a database exception is recognized as an sql syntax error.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
CLIENT_NOT_AUTHORIZED
Exception code for CLIENT_NOT_AUTHORIZED.
This code is used when an client performs an action that requires the user to be logged in and the user has not logged in yet.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
DATA_ACCESS_RESOURCE_FAILURE
Exception code for DATA_ACCESS_RESOURCE_FAILURE.
This code is used when a database exception received an error accessing storage devices.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
DATA_INTEGRITY_VIOLATION
Exception code for DATA_INTEGRITY_VIOLATION.
This code is used when a database exception is recognized as an integrity exception (like constraint violation).
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
DEADLOCK
Exception code for DEADLOCK.
This code is used when a deadlock is detected by the database.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
DELETE_NOT_GRANTED
Exception code for DELETE_NOT_GRANTED.
This code is used when a record deletion was rejected by a pre-delete Servoy trigger.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
EXECUTE_PROGRAM_FAILED
Exception code for EXECUTE_PROGRAM_FAILED.
This code is used when an external program was not executed correctly.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
INCORRECT_LOGIN
Exception code for INCORRECT_LOGIN.
This code is used when the user enters invalid credentials.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
INVALID_INPUT
Exception code for INVALID_INPUT.
This code is used when the user enters data that could not be validated.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
INVALID_RESULTSET_ACCESS
Exception code for INVALID_RESULTSET_ACCESS.
This code is used when a data is requested that is not selected in the sql.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
MAINTENANCE_MODE
Exception code for MAINTENANCE_MODE.
This code is used when a client could not be registered with the server because the server is in maintenance mode.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
MUST_ROLLBACK
Exception code for MUST_ROLLBACK.
This code is used when an update is not performed because of a previous sql-exception within a transaction.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
NO_ACCESS
Exception code for NO_ACCESS.
This code is used when a user wants to view data and this is disallowed by security settings.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
NO_CREATE_ACCESS
Exception code for NO_CREATE_ACCESS.
This code is used when a user wants to create new records and this is disallowed by security settings.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
NO_DELETE_ACCESS
Exception code for NO_DELETE_ACCESS.
This code is used when a user wants to delete data and this is disallowed by security settings.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
NO_LICENSE
Exception code for NO_LICENSE.
This code is used when a client could not be registered with the server because of license limitations.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
NO_MODIFY_ACCESS
Exception code for NO_MODIFY_ACCESS.
This code is used when a user wants to update data and this is disallowed by security settings.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
NO_PARENT_DELETE_WITH_RELATED_RECORDS
Exception code for NO_PARENT_DELETE_WITH_RELATED_RECORDS.
This code is used when a record could not be deleted because a non-empty relation exists for the record that does not allow parent delete when having related records.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
NO_RELATED_CREATE_ACCESS
Exception code for NO_RELATED_CREATE_ACCESS.
This code is used when a user wants to create new related records and this is disallowed by security settings.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
PERMISSION_DENIED
Exception code for PERMISSION_DENIED.
This code is used when a database exception is recognized as a authorization error.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
RECORD_LOCKED
Exception code for RECORD_LOCKED.
This code is used when a record could not be updated or deleted because it is locked by another client.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
RECORD_VALIDATION_FAILED
Exception code for RECORD_VALIDATION_FAILED.
This code is used when a record update/insert was rejected by a pre-update/insert Servoy trigger.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
SAVE_FAILED
Exception code for SAVE_FAILED.
This code is used when a javascript exception occurred during saving data to the database.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
UNEXPECTED_UPDATE_COUNT
Exception code for UNEXPECTED_UPDATE_COUNT.
This code is used when a data could not be deleted or updated when expected (for example
when a record was deleted outside Servoy and a Servoy client wants to update the record).
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
UNKNOWN_DATABASE_EXCEPTION
Exception code for UNKNOWN_DATABASE_EXCEPTION.
This code is used when an unrecognized database exception has occurred.
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
Returns the error code for this ServoyException. Can be one of the constants declared in ServoyException.
Returns:Number the error code for this ServoyException. Can be one of the constants declared in ServoyException.
Sample
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
getMessage()
Returns the string message for this ServoyException.
Returns:String the string message for this ServoyException.
Sample
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
getParameters()
Returns the parameters of the SQL query that caused this DataException in an array.
Returns:Array the parameters of the SQL query that caused this DataException in an array.
Returns the SQL query that caused this DataException.
Returns:String the SQL query that caused this DataException.
Sample
var record = array[i];application.output(record.exception);if (record.exception instanceofDataException){application.output("SQL: "+record.exception.getSQL());}
getSQLState()
Returns the SQLState for this DataException.
This is a "SQLstate" string, which follows either the XOPEN SQLstate conventions or the SQL 99 conventions.
The values of the SQLState string are described in the appropriate spec.
Returns:String the SQLState for this DataException.
Sample
var record = array[i];application.output(record.exception);if (record.exception instanceofDataException){application.output("SQLState: "+record.exception.getSQLState());}
getScriptStackTrace()
Returns the script stack trace for this ServoyException if this could be created.
Returns:String the string stack trace for this ServoyException.
Sample
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
getStackTrace()
Returns the stack trace for this ServoyException.
Returns:String the string stack trace for this ServoyException.
Sample
//this sample script should be attached to onError method handler in the solution settingsapplication.output('Exception Object: '+ex)application.output('MSG: '+ex.getMessage())if (ex instanceofServoyException){/** @type{ServoyException} */var servoyException = ex;application.output("is a ServoyException")application.output("Errorcode: "+servoyException.getErrorCode())var trace ="";if (ex.getScriptStackTrace) trace =servoyException.getScriptStackTrace();elseif (servoyException.getStackTrace) trace =servoyException.getStackTrace();if (servoyException.getErrorCode() ==ServoyException.SAVE_FAILED) {plugins.dialogs.showErrorDialog( 'Error','It seems you did not fill in a required field','OK');//Get the failed records after a savevar array =databaseManager.getFailedRecords()for( var i =0 ; i <array.length ; i++ ) {var record = array[i];application.output(record.exception);if (record.exception instanceofDataException) {/** @type{DataException} */var dataException =record.exception;application.output('SQL: '+dataException.getSQL())application.output('SQLState: '+dataException.getSQLState())application.output('VendorErrorCode: '+dataException.getVendorErrorCode()) } }returnfalse }}//if returns false or no return, error is not reported to client; if returns true error is reported//by default error report means logging the error, in smart client an error dialog will also show upreturntrue
getValue()
Returns the value for this DataException.
The value is the object thrown in table pre-insert, pre-update or pre-delete triggers.
var record = array[i];application.output(record.exception);if (record.exception instanceofDataException){application.output("VALUE: "+record.exception.getValue());}
getVendorErrorCode()
Returns the error code of the error thrown by the back-end database server.
Returns:Number the error code of the error thrown by the back-end database server.
Sample
var record = array[i];application.output(record.exception);if (record.exception instanceofDataException){application.output("VendorErrorCode: "+record.exception.getVendorErrorCode());}