In this example, any script execution error should be returned in qErrorData by the GetProgress method.
1. Configure the reload of the script. The handle of the request is -1 because the ConfigureReload method applies at global level.
qUseErrorData is set to true so that any script execution error is returned in qErrorData.
The script execution should not be halted in case of errors (qCancelOnScriptError is set to false).
The client sends:
{
"jsonrpc": "2.0",
"id": 2,
"method": "ConfigureReload",
"handle": -1,
"params": [
false,
true,
false
]
}
The engine returns:
{
"jsonrpc": "2.0",
"id": 2,
"result": {}
}
The configuration is done.
2. Set an invalid script.
The client sends:
{
"jsonrpc": "2.0",
"id": 3,
"method": "SetScript",
"handle": 1,
"params": [
"Load RecNo() as Dimension01 AutoGenerate 3; Load ReNo() as Dimension02 AutoGenerate 3;"
]
}
The engine returns:
{
"jsonrpc": "2.0",
"id": 3,
"result": {}
}
3. Reload the script. The handle of the request is 1 because the app uses 1 as a handle.
The client sends:
{
"jsonrpc": "2.0",
"id": 4,
"method": "DoReload",
"handle": 1,
"params": []
}
The engine returns:
{
"jsonrpc": "2.0",
"id": 4,
"result": {
"qReturn": true
}
}
The reload is successful. The script has been entirely executed even if it contains an error.
4. Get information about the call to DoReload.
The client sends:
{
"jsonrpc": "2.0",
"id": 5,
"method": "GetProgress",
"handle": -1,
"params": [
0
]
}
The engine returns:
{
"jsonrpc": "2.0",
"id": 5,
"result": {
"qProgressData": {
"qStarted": true,
"qFinished": true,
"qCompleted": 0,
"qTotal": 0,
"qKB": 0,
"qMillisecs": 0,
"qPersistentProgress": "AUTOGENERATE(3) 3 Lines fetched\n",
"qErrorData": [
{
"qErrorString": "Error in expression:\nRENO is not a valid function\n",
"qLineEnd": "\r\n",
"qLine": "Load ReNo() as Dimension02 AutoGenerate 3",
"qErrorDataCode": "EDC_ERROR"
}
],
"qPersistentProgressMessages": [
{
"qMessageCode": 0,
"qMessageParameters": [
"AUTOGENERATE(3)"
]
},
{
"qMessageCode": 21,
"qMessageParameters": [
"3"
]
}
],
"qTransientProgressMessage": {
"qMessageCode": 0,
"qMessageParameters": [
""
]
}
}
}
}
qErrorData describes the script execution error.
