RPA.Robocorp.Process

Create an input work item for a process

Arguments

ArgumentTypeDefault valueDescription
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 a process id of the process by name

Arguments

ArgumentTypeDefault valueDescription
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 a process run status by run id

Arguments

ArgumentTypeDefault valueDescription
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 a download URL for a process run artifact

Arguments

ArgumentTypeDefault valueDescription
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 from Control Room

Arguments

ArgumentTypeDefault valueDescription
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 work items belonging to a specific process run

Arguments

ArgumentTypeDefault valueDescription
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 of runs related to a process

Arguments

ArgumentTypeDefault valueDescription
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 all process runs in a workspace

Arguments

ArgumentTypeDefault valueDescription
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 work items belonging to a process

Arguments

ArgumentTypeDefault valueDescription
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 all processes in a workspace

Arguments

ArgumentTypeDefault valueDescription
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 Robot run artifacts

Arguments

ArgumentTypeDefault valueDescription
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 processing of work item in FAILED state

Arguments

ArgumentTypeDefault valueDescription
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 Workspace API access key

Arguments

ArgumentTypeDefault valueDescription
apikeystr, NoneNoneworkspace API access key
param apikey:workspace API access key

Set credentials needed by the Process API

Arguments

ArgumentTypeDefault valueDescription
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 Control Room process ID

Arguments

ArgumentTypeDefault valueDescription
process_idstr, NoneNoneID of the Control Room process
param process_id:
 ID of the Control Room process

Set Control Room workspace ID

Arguments

ArgumentTypeDefault valueDescription
workspace_idstr, NoneNoneID of the Control Room workspace
param workspace_id:
 ID of the Control Room workspace

Start a Control Room process with the provided configuration

Arguments

ArgumentTypeDefault valueDescription
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 a Control Room process

Arguments

ArgumentTypeDefault valueDescription
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_itemsbatchresult
NoneFalseTrigger a process with empty a work item
NoneTrueError. work_items needs to be a list
dictFalseTrigger a process with a work item containing payload of a dict
dictTrueError. work_items needs to be a list
listFalseTrigger a process with a work item containing payload of a list
listTrueTrigger multiple process runs with work items each containing payload of a dict