Web API for Scripts: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
Scripts API is used to create, delete and edit script properties.
Scripts API is used to create, delete and edit script properties.
Note that the [[Web API for Workspace Elements|Workspace Elements API]] supports also scripts.


==Methods==
==Methods==

Revision as of 14:26, 22 February 2021

Scripts API is used to create, delete and edit script properties.

Methods

The scripts API has the following methods.

Start script run

GET api/scripts/run/{scriptId}

Starts a run of the script with given id. Returns id of the started script run operation. Returns immediately without waiting for a script run to be finished. Returns 0 if the script is already running. Requires the global RunScript permission. Returns NotFound if a script does not exist, or Forbidden if current user has no access to the script.

End script run

GET api/scripts/end/{scriptId}

Terminates a run of the script with given id. Returns id of the terminated script run operation. Returns immediately without waiting for a script run to be aborted. Returns 0 if the script is not running. Requires the global RunScript permission. Returns NotFound if a script does not exist, or Forbidden if current user has no access to the script.

Get current run log

GET api/scripts/runlog/current/{scriptId}

Gets the current run log of the script with given id, i.e. a run that is currently in progress. Returns the object with the following fields: Log, Exceptions, AdditionalData, OperationId. Returns null if the script is not running. Requires the global RunScript permission. Returns NotFound if a script does not exist, or Forbidden if current user has no access to the script.

Get last run log

GET api/scripts/runlog/last/{scriptId}

Gets the last completed run log of the script with given id. Returns the object with the following fields: Log, Exceptions, AdditionalData, OperationId. Returns null if the script is has never been run yet. Requires the global RunScript permission. Returns NotFound if a script does not exist, or Forbidden if current user has no access to the script.