Execute Robotic Process Smart Service

Overview

Appian RPA customers can initiate robotic processes in their Appian process models. The Execute Robotic Process smart service streamlines the integration and executes the process synchronously in the context of the overall process model. Synchronous execution is useful if you want to return data from the robotic process execution and use it in subsequent nodes in the same process model.

To execute a robotic process in Appian RPA asynchronously, you can call the integration using the Call Integration smart service. When the robotic process is executed asynchronously, the process model moves to the next node whether or not the robotic process is complete, and the results aren't automatically returned.

Permissions Needed

This smart service calls the Execute Robotic Process integration set up using an Appian RPA Connected System object. When the smart service is called, the integration is executed using the service account used to set up the connected system, not the user who initiated the process model. You won't need to configure additional permissions for this smart service to execute.

Properties

  • Category: Process Management
  • Icon: Execute Robotic Process Icon
  • Assignment Options: Unattended/Attended.

Configuration options

Setup Tab

Select RPA Integration

The Setup tab allows you to select or create an Appian RPA integration.

  • Select Integration: Search or browse to select an existing RPA integration.
  • Edit Integration: Open the selected integration in the integration designer. This button is only shown when an integration is selected. Users with viewer access will see the View Integration button instead and will be able to open the integration designer in read-only mode.
  • Create Integration: Create a new Appian RPA integration to call with the smart service. The form allows you to enter the name and description of the new integration, where to save it, and what application to add it to. You can also select existing node inputs that should be added as inputs to the new integration.

Data Tab

Node Inputs

When an integration is selected, the integration's inputs will automatically appear as node inputs. If you change the selected integration or the inputs of the selected integration are updated outside the process modeler, the node inputs will be refreshed the next time you view the Data tab.

Node Outputs

Output Data Type Multiple Description
Success Boolean No Whether the robotic process started successfully or not.
ExecutionId Text No Id of the robotic process execution displayed in the Appian RPA Console.
Status Text No If the robotic process is started successfully, returns one of the following values: ENQUEUED, RUNNING, SUCCESS, FAILURE, ABORTED. If the status is anything other than SUCCESS or FAILURE, properties may include partial results.
Properties Any Type No Properties configured by the developer as key-value pairs.
Error IntegrationError No If the robotic process was not started successfully, this contains information about the error encountered. If the robotic process was started successfully but has a status of FAILURE or ABORTED, error details for that process are not provided here.

Runtime behavior

Once the Execute Robotic Process smart service is initiated, the integration calls the chosen robotic process. The robotic process continues running in the background even if the process model is paused, cancelled, or deleted. To pause or cancel the robotic process, visit the Appian RPA console.

If the robotic process is queued for execution, the node remains active. The node will time out after 5 hours, for any of the following reasons:

  • the robotic process is running, but stuck in an infinite loop.
  • the robotic process is still in the queue due to no available resources.
  • the robotic process just moved from the queue to start running, but won't complete before the node's time limit.

When the node times out, you'll receive an error. If the robotic process remains in the queue, it will be removed automatically.

Open in Github

On This Page

FEEDBACK