Quickstart

In this section, learn how to use the UiPath Add-in for Salesforce in a simple Salesforce business process automation.

Introduction

The purpose of this guide is to show you how to use the UiPath Add-in for Salesforce in a simple Salesforce business process automation (via Process Builder). Using a Salesforce Opportunity object as an example, you'll complete the following:

1. Add a Connection
2. Create a Queue Template
3. Create a Job Template
4. Build an Automation Process (Process Builder)
5. Test your Automation Process

After completing the steps in this guide, you'll have a add-in that does the following:

1. Establishes an authenticated connection between your Salesforce platform and a UiPath Orchestrator Tenant. This guide uses an on-premise UiPath Orchestrator connection.
2. Adds a Queue item to an existing Queue when a Salesforce Opportunity object stage changes to Closed Won.

3. Creates a new Job to execute an existing Process when a Salesforce Opportunity object stage changes to Closed Won.

   Note:

   For more information about the UiPath Add-in for Salesforce and its features, see the following pages:

   • About
   • Setup
   • Connection Settings
   • Templates
   • Orchestrator Notifications

Prerequisites

Before you begin:

1. Complete the Setup steps.

2. Set up a new, or use an existing, UiPath Orchestrator instance that has a Tenant, Environment, Process, and Robot.

   Note:

   For the purposes of this guide, ensure that you have an available Robot that does not have existing jobs in the pending state; this makes it easier to verify the success of your setup and process.

Steps

1. Add a Connection.
2. Create a Queue Template.
3. Create a Job Template.
4. Build an Automation Process.
5. Test yout Automation Process.

Add a Connection

1. Go to the UiPath Setup page. You can use the App Launcher to search for UiPath Setup.
2. In the left-hand panel, click + Add a Connection (this opens the Connection Settings form).
3. Complete the Connection Settings form:
   • Enter a unique Connection Name. This name is only used in the UiPath Add-in for Salesforce application and it does not need to match the name of the tenant you're connecting. Your name can include alphanumeric characters (a-z, 0-9), special characters, and spaces. This name is not editable after you save the form via the Connect button.
   • Enter the UiPath Orchestrator URL that you're connecting to (e.g., https://myorchestrator.com).
   • Enter the Tenant Name that you're connecting to. This name must match the name of the UiPath Orchestrator tenant.
   • Enter the Email or Username that you want to use for your connection, and the Password associated with the corresponding email or username if you choose User Credentials as a connection type. As an alternative, you can choose Named Credential (see more details in How to Set up a Named Credentials Connection).
     • The user must have permissions to access the tenant. For more information, see About Users in the Orchestrator Guide.
4. Click the Connect button.
   • The system verifies the authentication information by establishing a connection.
   • If the connection is unsuccessful, a red notification stating "Unable to authenticate UiPath credentials. Please verify and try again." appears at the top of the screen. To resolve the issue, verify your form entries and click the Connect button again.
     
     

     

     
     

Create a Queue Template

1. In the left-hand panel, select the connection you created and click Templates.
2. In your Templates page, click the New button (this opens the Create New Template wizard).
   
   

   

   
   
3. Complete the first page of the template form:
   • Enter a Template Name (required). Your name must start with a letter and may only include alphanumeric characters (a-z, 0-9) and underscores. This field does not accept spaces or special characters.
   • Enter a Template Description (optional).
   • Select the Queue radio button.
4. Click the Next button.
   
   

   

   
   

   Note: The Connection field defaults to the connection that you select to create the template. You can't change the default connection during template creation, but you can after the template is created.
5. Complete the second page of the template form:
   • Select a Queue Name from the list of available Queues. If you don't see the Queue that you want to use, go to your UiPath Orchestrator and verify the Queues are present in your tenant.
   • Select a Priority (e.g., High). This sets the processing importance for the Queue item.
   • Click the Next button.
     
     

     

     
     
6. Complete the final page of the template form:
   • Select a Salesforce Object (e.g., Opportunity).
   • Select the Opportunity Fields that you want to use for your Queue item (e.g., Opportunity ID, Account ID).
7. Click the Save button.
   
   

   

   
   
8. Verify the new Queue Template appears in your list of templates.
   
   

   

   
   

You're done! Now, let's create a complementary Job Template.

Create a Job Template

1. In your Templates page, click the New button (this opens the Create New Template wizard).
2. Complete the first page of the template form:
   • Enter a Template Name (required). Your name must start with a letter and may only include alphanumeric characters (a-z, 0-9) and underscores. This field does not accept spaces or special characters.
   • Enter a Template Description (optional).
   • Select the Job radio button.
3. Click the Next button.
   
   

   

   
   
4. Complete the second page of the template form:
   • Enter the Environment that you want to use to deploy your process (the available Environments are returned when you start typing). If you don't see the Environment name in the list, go to your UiPath Orchestrator and verify it's present in your tenant. For more information, see About Environments in the Orchestrator Guide.
   • Enter the Process that you want to run (the available Processes are returned when you start typing). The name must match the name of the Process in your tenant. If you can't find the process you're looking for, go to your UiPath Orchestrator and verify it's present in your tenant.
   • Select your run Strategy (e.g., All). Selecting All indicates that you want to run this job a single time, using the next available robot. For more information, see Templates .
   • Click the Next Button.
     
     

     

     
     
5. Complete the final page of the template form:
   • Select a Salesforce Object (e.g., Opportunity).
   • Select the Opportunity Fields that have the data you want as Input Values for your Job (e.g., Opportunity ID, Account ID).
6. Click the Save button.
   
   

   

   
   
7. Verify the Job Template was added to your list of templates.
   
   

   

   
   

You're done! Next, let's open the Salesforce Lightning Process Builder to build a simple automation process that uses your new templates.

Build an Automation Process

In this section, you use the Salesforce Lightning Process Builder to create a process that invokes your new templates when a Salesforce Opportunity stage is changed to Closed/Won.

For more information about the Salesforce Lightning Process Builder, see Lightning Process Builder in the Salesforce documentation.

1. Add Object.
   1. Open the Lightning Process Builder (Settings > Setup > Process Builder).
   2. In the upper right-hand corner, click the New button (this opens the New Process window).
      
      

      

      
      
   3. Enter your New Process details.
   4. For The process starts when field, select A record changes.
   5. Click the Save button (this opens your new process in the builder).
      
      

      

      
      
   6. In the design panel, click + Object.
   7. Enter your object details:
      • Select Opportunity for your Object.
      • Under Start the process, select the When a record is created or edited radio button.
   8. Click the Save button.
      
      

      

      
      
2. Add Criteria.
   1. In the design panel, click Add Criteria.
   2. Enter the following criteria details:
      • Enter a Criteria Name (e.g., OpportunityWon).
      • Under Criteria for Executing Actions, select the Conditions are met radio button.

      • Under Set Conditions, enter/select the following:

        • Field: Select Stage (displays as [Opportunity].StageName when selected)
        • Operator: Select Equals
        • Type: Select Picklist
        • Value: Select Closed Won.
      • Under Conditions, select the All of the conditions are met (AND) radio button.
   3. Click the Save button.
      
      

      

      
      
3. Add Immediate Actions.
   1. In the design panel, click +Add Action.
   2. Enter the following action details:
      • Under Action Type, select APEX (this indicates that you want to use an AppExchange application)
      • Enter an Action Name (e.g., CreateQueue).
      • Under Apex Class, select UiPath - Create Queue Notification.
      • Under Set Apex Variables, enter the following (two rows):
        • Field: Record ID (default value)
        • Type: Select Field Reference
        • Value: Select [Opportunity].Id. This value must match the Object you selected when you created.
        • Field: Connection Template Name (default value)
        • Type: Select String
        • Value: Enter your template name (e.g., OpportunityQueueItem).
      • Click the Save button.
        
        

        

        
        
   3. In the design panel, click Add Action.
   4. Enter the following action details:
      • Under Action Type, select APEX (this indicates that you want to use an AppExchange application).
      • Enter an Action Name (e.g., CreateJob).
      • Under Apex Class, select UiPath - Create Job Notification.
      • Under Set Apex Variables, enter the following (two rows):
        • Field: Connection Template Name (default value)
        • Type: Select String.
        • Value: Enter your template name (e.g., OpportunityJob).
        • Field: Record ID (default value).
        • Type: Select Field Reference.
        • Value: Select [Opportunity].Id. This value must match the Object you selected when you created the template.
      • Click the Save button.
        
        

        

        
        
   5. In the upper right-hand corner, click the Activate button (this locks your process and enables it for use).
      
      

      

      
      

   You're done! Now, let's test your automation process by updating a Salesforce Opportunity.