RPA.Robocorp.Process library | Robocorp documentation

RPA.Robocorp.Process

Create Input Work Item

Create an input work item for a process

Arguments

Argument	Type	Default value
payload	Any, None	None
files	str, List, None	None
process_id	str, None	None

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
process_name	str	null
workspace_id	str, None	None

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
process_run_id	str	null
step_run_id	str, None	None
process_id	str, None	None

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
process_run_id	str	null
step_run_id	str	null
artifact_id	str	null
filename	str	null
process_id	str, None	None

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
workitem_id	str	null
include_data	bool	False
process_id	str, None	None

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
process_run_id	str, None	None
process_id	str, None	None
include_data	bool	False
item_state	str, None	None

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
run_state	str, None	None
limit	int, None	10
process_id	str, None	None

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
run_state	str, None	None
limit	int, None	10
workspace_id	str, None	None

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
process_id	str, None	None
include_data	bool	False
item_state	str, None	None

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
workspace_id	str, None	None

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
process_run_id	str	null
step_run_id	str	null
process_id	str, None	None

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
work_item_id	str	null
process_id	str, None	None

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
apikey	str, None	None

param apikey:	workspace API access key

Set Credentials

Set credentials needed by the Process API

Arguments

Argument	Type	Default value
workspace_id	str, None	None
process_id	str, None	None
apikey	str, None	None

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
process_id	str, None	None

param process_id:	ID of the Control Room process

Set Workspace Id

Set Control Room workspace ID

Arguments

Argument	Type	Default value
workspace_id	str, None	None

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
config_type	ConfigurationType	default
extra_info	str, List, None	None
process_id	str, None	None

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
work_items	Dict, List[Dict], None	None
batch	bool	False
process_id	str, None	None

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