How can we help?
{{docApp.searchError}}
{{product.name}}
Searching in {{docApp.searchFilterBySpecificBookTitle}}
{{docApp.searchResultFilteredItems.length}} results for: {{docApp.currentResultsSearchText}}
in {{docApp.searchFilterBySpecificBookTitle}}
Search results have been limited. There are a total of {{docApp.searchResponse.totalResultsAvailable}} matches.
You have an odd number of " characters in your search terms - each one needs closing with a matching " character!
-
{{resultItem.title}}
{{resultItem.url}}
{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}
{{docApp.libraryHomeViewProduct.description}}
{{group.title || group.id}}
{{group.description}}
Description
Invoke this operation to execute a runbook process.
API Details
- Status:
- The required privilege level to invoke this method is
user
- The supported database role for this method is
none
System Rights | Database Rights | Mail Rights | Calendar Rights |
---|---|---|---|
sys.a.canSpawnProcess |
--- |
--- |
--- |
Request Parameters
The runbookRun method takes the following input parameters.
Note
When sending a JSON request payload to the API, the order of parameters is not significant. However, for XML request payloads, parameters must be provided in the exact order specified in this documentation to comply with input validation requirements.
Name | Type | Attributes | Description |
---|---|---|---|
name |
xs:string |
Required | The name of the orchestration to spawn. |
reference |
xs:anyURI |
Optional | An application defined reference, such as a URN to an entity or any other application-definable meaningful (to the application running the orchestration) reference. |
inputParam |
Array<inputParameterType> |
Optional | The input parameters for the runbook. |
Response Parameters
Name | Type | Attributes | Description |
---|---|---|---|
runbookId |
xs:string |
Required | The unique identifier of the running runbook instance. |
version |
xs:unsignedInt |
Required | The version of the runbook that was executed. |
state |
bpmStateType |
Required | This can be InProgress, Succeeded or Failed. |
failureMessage |
xs:string |
Optional | The error message in the case of a runbook runtime failure. |
- Version {{docApp.book.version}}
- Node {{docApp.node}} / {{docApp.build}}
In This Document