CI/CD integrations user guide

Last updated May 23, 2025

UiPath Run Job

You can use this task to execute a process that's been already deployed on an Orchestrator instance. For more information, see Processes and Jobs.

Configuration

Use the following table to configure the UiPath Run Job inputs.

Input	Description
Display name (Required)	Enter a name for your task.
Orchestrator connection (Required)	Configure the service connection to access UiPath Orchestrator services. You can configure a connection only for this step or use an existing global connection. For more information, see Configuring UiPath Orchestrator service connection.
Process (Required)	The process is the package version that is linked to a particular folder type. You need to configure this input based on the type of folder on which the process is deployed.For modern folders, the input is the name of the process that's listed in the Processes tab. To find out the process name, you can open Orchestrator, open your folder, and navigate to Automations > Processes.For classic folders (deprecated), the input is the name of the process name, followed by and underscore, and then the environment name, where the Robots are hosted.As an example for this naming convention, consider the following variables: The name of the process is`TestAutomation`. The name of the environment is `Production`.Your process name for this input is `TestAutomation_Production`.
Input parameters	Specify the file path to a JSON input file, such as `Input\jobParameters.json`. JSON file format example: `{ "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }`{ "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
Priority	Select the priority of the job execution if you want to set a specific order at the process level. By default, this input is set to `Normal`.
Orchestrator folder (Required)	Specify the folder where the process is being deployed. For classic folders, you can use specific robot names. For modern folders, you can use specific user and machine names. To input subfolders make sure to input both the parent folder name and the name of the subfolder. For instance, use AccountingTeam\TeamJohn.
Strategy	Specify the execution strategy for dynamic allocation or robot-specific. For dynamically allocated jobs, the process is executed under the account and machine that is available. Alternatively, you can choose robot-specific jobs.
Job Type	Available only on modern folders.Choose the license model of the runtime under which the job is to be executed. For more information, see Robot licensing.
No. of jobs	Available only for dynamic allocation strategy.Specify the number of times you want to run this task. By default, this input is set to `1`.
User	Available only on modern folders alongside a dynamic allocation strategy.Add the machine username. For example, a local user for this input is `MachineName\UserName`.
Machine	Available only on modern folders alongside a dynamic allocation strategy.The name of the machine that runs the execution.
Output	The results are collected in a JSON file. You need to specify the path of the job results (e.g., `Output\testResults.json`). If you leave this input blank, the default output is sent to the artifact staging directory under the following name `UiPathResults.json`.
Timeout	Specify the number of seconds to wait before the request times out.
Fail task when job fails	Select this input if you want to set the task as failed when at least one job failed. This input is selected by default.
Wait for job completion	Wait for job run completion. This input is selected by default.
Trace Level	Select the logging level from the dropdown list.
robotsIds	Comma-separated list of specific robot names.

YAML pipeline

You can preview a fully parsed YAML document for the UiPath Run Job.

- task: UiPathRunJob@2
  displayName: 'Start ProcessProject'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #processName: 'ProccessProject_CI-Pipeline' # The name of the process
    #parametersFilePath: 'Input\\jobParameters.json' # json file with input values if the process requires them
    #priority: 'Low' # Options 'Low', 'Normal', 'High'
    #folderName: 'MyFolder' # Specify the folder to deploy to. For clasic folders, you can use specific robot names. For modern folders, you can use specific user and machine names.
    #strategy: 'Dynamically' # Options 'Specific', 'Dynamically'
    #jobCount: 1 # The number of job runs. (default 1) - used if strategy is 'Dynamically'
    #user: 'MyUser'
    #machine: 'machine'
    #robotsIds: 'robot1, robot2'
    #resultFilePath: 'Output\\testResults.json'
    #timeout: 3600
    #failWhenJobFails: false
    #waitForJobCompletion: false,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None- task: UiPathRunJob@2
  displayName: 'Start ProcessProject'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #processName: 'ProccessProject_CI-Pipeline' # The name of the process
    #parametersFilePath: 'Input\\jobParameters.json' # json file with input values if the process requires them
    #priority: 'Low' # Options 'Low', 'Normal', 'High'
    #folderName: 'MyFolder' # Specify the folder to deploy to. For clasic folders, you can use specific robot names. For modern folders, you can use specific user and machine names.
    #strategy: 'Dynamically' # Options 'Specific', 'Dynamically'
    #jobCount: 1 # The number of job runs. (default 1) - used if strategy is 'Dynamically'
    #user: 'MyUser'
    #machine: 'machine'
    #robotsIds: 'robot1, robot2'
    #resultFilePath: 'Output\\testResults.json'
    #timeout: 3600
    #failWhenJobFails: false
    #waitForJobCompletion: false,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

On this page

Configuration
YAML pipeline

Was this page helpful?

PREVIOUSAdding UiPath tasks to pipeline agent pool

NEXTUiPath Manage Assets

Support and Services

Get The Help You Need

UiPath Academy

Learning RPA - Automation Courses

UiPath Forum

UiPath Community Forum

Trust and Security

Cookies Policy