Overview

The Salesforce plug-in includes steps that use Salesforce CLI (SF CLI) to deploy and retrieve metadata changes and Apex classes. The plug-in was migrated from the Ant Migration Tool to Salesforce CLI to maintain compatibility with the Salesforce Winter ’27 release and support ongoing Salesforce deployments.For a detailed tutorial and example use-cases, refer to the Usage page.

To add the Salesforce plug-in steps to processes, click CRM > Salesforce in the step palette of the process editor.

Compatibility

The IBM DevOps Deploy automation plug-in for Salesforce works with Force.com Winter 24 and later, and with Metadata API version 41 through 68.

This plug-in requires version 7.3 or later of IBM DevOps Deploy.

Agent Prerequisites

1. Node.js and Salesforce CLI v2 installed on every agent that runs these steps.

2. Groovy (GROOVY_HOME), as before.

3. Outbound HTTPS to your Salesforce instance, directly or through an HTTP proxy. SOCKS proxies are not supported by Salesforce CLI v2.

Installation

No special steps are required for installation. See Installing plug-ins in DevOps Deploy.

History

Version 13

Migrated Salesforce plugin from Ant Migration Tool to Salesforce CLI.

Version 12

DT495677 - Fix NullPointerException and NumberFormatException when proxy properties are not defined on the resource.

Version 11

Resolve Groovy compatibility issues.

Version 10

Resolved property validation issue due to which plugin was unable to load in some UCD versions.

Version 9

Added hidden fields for pollWaitMillis and maxPoll parameters to various steps.

Version 8

Fix issue with build listeners finding more element types than expected.

Version 7

RFE 104828Added ability to run and specify tests.

Version 6

Fixes APAR PI80241Setting a directory as Deploy Root causes failure.

Version 5

Version 5 of the plug-in includes the following enhancements:

• Added checkOnly option to Deploy step.
• Added step Deploy Recent Validation.
• Logging improvements.

Version 4

Version 4 of the plug-in adds support for property file encryption.

Version 3

Version 3 of the plug-in adds hidden properties for each step, which support using a proxy.

Version 2

Version 2 of the plug-in includes the following steps: List Metadata, Describe Metadata, and Bulk Retrieve.

Version 1

Version 1 is the initial release of the plug-in.