Create Input Work Item

Create an input work item for a process

Arguments

Argument Type Default value Description
payloadAny, NoneNonework item data
filesstr, List, NoneNoneabsolute filepaths as single string or list
process_idstr, NoneNonespecific process to which item belongs to
param payload:work item data
param files:absolute filepaths as single string or list
param process_id:
 specific process to which item belongs to
return:The integer that represents the work item id

Get Process Id By Name

Get a process id of the process by name

Arguments

Argument Type Default value Description
process_namestrnullname of the process in the Control Room
workspace_idstr, NoneNonespecific Control Room workspace to which process belongs to
param process_name:
 name of the process in the Control Room
param workspace_id:
 specific Control Room workspace to which process belongs to
return:the next iteration id or None

Get Process Run Status

Get a process run status by run id

Arguments

Argument Type Default value Description
process_run_idstrnullid of the process run
step_run_idstr, NoneNoneid of the process step run
process_idstr, NoneNonespecific process to which runs belongs to
param process_run_id:
 id of the process run
param step_run_id:
 id of the process step run
param process_id:
 specific process to which runs belongs to
return:the response JSON

Get Robot Run Artifact

Get a download URL for a process run artifact

Arguments

Argument Type Default value Description
process_run_idstrnullid of the process run
step_run_idstrnullid of the process step run
artifact_idstrnullid of the run artifact
filenamestrnullfilename of the run artifact
process_idstr, NoneNonespecific process to which runs belongs to
param process_run_id:
 id of the process run
param step_run_id:
 id of the process step run
param artifact_id:
 id of the run artifact
param filename:filename of the run artifact
param process_id:
 specific process to which runs belongs to
return:url for file download

Get Work Item

Get work item from Control Room

Arguments

Argument Type Default value Description
workitem_idstrnullid of the work item
include_databoolFalseinclude work item payload and files in the response (default False)
process_idstr, NoneNonespecific process to which runs belongs to
param workitem_id:
 id of the work item
param include_data:
 include work item payload and files in the response (default False)
param process_id:
 specific process to which runs belongs to
return:the JSON of the work items associated with a given process

List Process Run Work Items

List work items belonging to a specific process run

Arguments

Argument Type Default value Description
process_run_idstr, NoneNonespecific process step run to which items belongs to
process_idstr, NoneNonespecific process to which items belongs to
include_databoolFalseinclude work item payload and files in the response (default False)
item_statestr, NoneNonestate of work items to return (default all)
param process_run_id:
 specific process step run to which items belongs to
param process_id:
 specific process to which items belongs to
param include_data:
 include work item payload and files in the response (default False)
param item_state:
 state of work items to return (default all)

List Process Runs

List of runs related to a process

Arguments

Argument Type Default value Description
run_statestr, NoneNonestate of runs to return (default all)
limitint, None10number of runs to return (default 10)
process_idstr, NoneNonespecific process to which runs belongs to
param run_state:
 state of runs to return (default all)
param limit:number of runs to return (default 10)
param process_id:
 specific process to which runs belongs to
return:the JSON data of the process runs based on the provided parameters

List Process Runs In Workspace

List all process runs in a workspace

Arguments

Argument Type Default value Description
run_statestr, NoneNonestate of runs to return (default all)
limitint, None10number of runs to return (default 10)
workspace_idstr, NoneNonespecific Control Room workspace to which process belongs to
param run_state:
 state of runs to return (default all)
param limit:number of runs to return (default 10)
param workspace_id:
 specific Control Room workspace to which process belongs to
return:the JSON data of the process runs based on the provided parameters

List Process Work Items

List work items belonging to a process

Arguments

Argument Type Default value Description
process_idstr, NoneNonespecific process to which items belongs to
include_databoolFalseinclude work item payload and files in the response (default False)
item_statestr, NoneNonestate of work items to return (default all)
param include_data:
 include work item payload and files in the response (default False)
param item_state:
 state of work items to return (default all)
param process_id:
 specific process to which items belongs to
return:the JSON data of the process runs based on the provided parameters

List Processes

List all processes in a workspace

Arguments

Argument Type Default value Description
workspace_idstr, NoneNonespecific Control Room workspace to which process belongs to
param workspace_id:
 specific Control Room workspace to which process belongs to
return:the JSON data of the process runs based on the provided parameters

List Run Artifacts

List Robot run artifacts

Arguments

Argument Type Default value Description
process_run_idstrnullid of the process run
step_run_idstrnullid of the process step run
process_idstr, NoneNonespecific process to which runs belongs to
param process_run_id:
 id of the process run
param step_run_id:
 id of the process step run
param process_id:
 specific process to which runs belongs to
return:the response JSON

Retry Work Item

Retry processing of work item in FAILED state

Arguments

Argument Type Default value Description
work_item_idstrnullID of the work item to retry
process_idstr, NoneNonespecific process to start
param work_item_id:
 ID of the work item to retry
param process_id:
 specific process to start
return:the response JSON

Set Apikey

Set Workspace API access key

Arguments

Argument Type Default value Description
apikeystr, NoneNoneworkspace API access key
param apikey:workspace API access key

Set Credentials

Set credentials needed by the Process API

Arguments

Argument Type Default value Description
workspace_idstr, NoneNoneID of the Control Room workspace
process_idstr, NoneNoneID of the Control Room process
apikeystr, NoneNoneworkspace API access key
param workspace_id:
 ID of the Control Room workspace
param process_id:
 ID of the Control Room process
param apikey:workspace API access key

Set Process Id

Set Control Room process ID

Arguments

Argument Type Default value Description
process_idstr, NoneNoneID of the Control Room process
param process_id:
 ID of the Control Room process

Set Workspace Id

Set Control Room workspace ID

Arguments

Argument Type Default value Description
workspace_idstr, NoneNoneID of the Control Room workspace
param workspace_id:
 ID of the Control Room workspace

Start Configured Process

Start a Control Room process with the provided configuration

Arguments

Argument Type Default value Description
config_typeConfigurationTypedefaulttype of the start, (ConfigurationType.default)
extra_infostr, List, NoneNonedata to be sent with the start, for example. work item IDs
process_idstr, NoneNonespecific process to start
param config_type:
 type of the start, (ConfigurationType.default)
param extra_info:
 data to be sent with the start, for example. work item IDs
param process_id:
 specific process to start
return:string of the request response

Start Process

Start a Control Room process

Arguments

Argument Type Default value Description
work_itemsDict, List[Dict], NoneNoneinput work items for the process (default empty)
batchboolFalseset to True if sending list of workitems to start each as a separate run
process_idstr, NoneNonespecific process to start
param work_items:
 input work items for the process (default empty)
param batch:set to True if sending list of workitems to start each as a separate run
param process_id:
 specific process to start
return:JSON of the request response

Table showing different results depending on parameter values.

work_items batch result
None False Trigger a process with empty a work item
None True Error. work_items needs to be a list
dict False Trigger a process with a work item containing payload of a dict
dict True Error. work_items needs to be a list
list False Trigger a process with a work item containing payload of a list
list True Trigger multiple process runs with work items each containing payload of a dict