Documentation

{{docApp.title}}

{{docApp.description}}

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!

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

{{group.title || group.id}}

{{group.description}}

  1. {{book.title}}

{{group.title}}

/ automation / runbookGetState

Description

Invoke this operation get information about the specified runbook instance.

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
--- --- --- ---

Request Parameters

The runbookGetState method takes the following input parameters. It is important to note that the parameters must be passed to the method in the same order as they appear here in order to satisfy the requirement of the input validation checks.

Name Type Attributes Description
runbookId xs:string Required The unique identifier of the spawned runbook process.
returnRuntimeContext xs:boolean Optional
Default=false
Set this to true if you would like to return the runtime context
waitSequence xs:unsignedInt Optional
Default=0
Provide the last value returned in the waitSequence response parameter to wait for a status change
waitTime xs:unsignedInt Optional
Default=10
The amount of time to wait (in seconds) for a staus change. Default is 10

Response Parameters

Name Type Attributes Description
name xs:string Required The name of the runbooks process
reference xs:anyURI Optional An application defined reference, such as a URN to an entity record or any other application-definable meaningful (to the application initiating the runbook) reference.
processState bpmStateType Required The state of the runbook process.
currentNode xs:string Optional The node identifier of the currently executed node in the runbook.
failureMessage xs:string Optional The error message in the case of process failure.
inputParam inputParameterType Optional
Array (0/∞)
The input parameters for the runbook.
outputParam outputParameterType Optional
Array (0/∞)
The output parameters from this runbook.
runtimeContext xs:string Optional Returns a JSON formatted object that represents the BPM runtime variables.
lastUpdated xs:dateTime Required Returns the date/time the process was last updated
waitSequence xs:unsignedInt Required You can use this value to call this operation again to wait for status changes
waitTimeout xs:boolean Required The wait timeout
In This Document