Last Updated on

What’s New In Transact 4.5?


Scripting | Display Error Cause for Default Scripts

 

In previous versions of Transact, default scripts did not include information on the exceptions thrown. If any default script went into error, the batch status reflected the “Error” but the “Error Cause” was not populated on the Batch Instance Management screen.

C:\Users\Ephesoft\AppData\Local\Microsoft\Windows\INetCache\Content.Word\error4.png

In Ephesoft Transact v4.5.0.0, the default scripts have been modified to include error comments.

C:\Users\Ephesoft\AppData\Local\Microsoft\Windows\INetCache\Content.Word\script1.png

The administrator can also view script error details in the dcma-all and catalina logs in the Application folder.

C:\Users\Ephesoft\AppData\Local\Microsoft\Windows\INetCache\Content.Word\dcma.png

Now, the Batch Execution Details on the Batch Instance Management screen will include the error message if the batch goes into error state at any level of the batch processing workflow.

C:\Users\Ephesoft\AppData\Local\Microsoft\Windows\INetCache\Content.Word\error3-1.png

Error comments are now included in all default scripts except ScriptPageProcessing and ScriptValidation.

Below is the list of error messages found in Ephesoft Transact default scripts:

Error Message Scripts
“Document doesn’t exist.” ScriptAddNewTable
“Input document is null.” ScriptAddNewTable

ScriptAutomaticValidation

ScriptDocumentAssembler

ScriptExport

ScriptExtraction

ScriptFieldValueChange

ScriptFunctionKey

ScriptNewTableRowInsert

ScriptTableCellValueChange

“Unable to find the local folder path in batch xml file.” ScriptAddNewTable

ScriptAutomaticValidation

ScriptDocumentAssembler

ScriptExport

ScriptExtraction

ScriptFieldValueChange

ScriptFunctionKey

ScriptNewTableRowInsert

ScriptTableCellValueChange

“Unable to find the batch instance ID in batch xml file.” ScriptAddNewTable

ScriptAutomaticValidation

ScriptDocumentAssembler

ScriptExport

ScriptExtraction

ScriptFieldValueChange

ScriptFunctionKey

ScriptNewTableRowInsert

ScriptTableCellValueChange

“Unable to read the zip switch value. Taking default value as true. Exception thrown is:” ScriptAddNewTable

ScriptAutomaticValidation

ScriptDocumentAssembler

ScriptExport

ScriptExtraction

ScriptFieldValueChange

ScriptFunctionKey

ScriptNewTableRowInsert

ScriptTableCellValueChange

“************* Error occurred in scripts.” ScriptAddNewTable

ScriptAutomaticValidation

ScriptDocumentAssembler

ScriptExport

ScriptExtraction

ScriptFieldValueChange

ScriptFunctionKey

ScriptNewTableRowInsert

ScriptPageProcessing

ScriptTableCellValueChange

ScriptValidation

 

You can find all default scripts in the Batch Class folder created at the time of Batch Class configuration (UNC folder):

C:\Users\Ephesoft\AppData\Local\Microsoft\Windows\INetCache\Content.Word\scripts.png

It is recommended to leave error messages in default scripts unchanged. If required, you can customize the entire script and provide any error message as needed.