--- schema_version: "1" id: c2bfe15e1cffd0a3ad04026108de3660d417042aad275112aebc8055f9557d34 title: Upgrading and Migrating Salesforce Connector to 12.x collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/salesforce-connector/latest/salesforce-connector-upgrade-migrate.md canonical_url: https://docs.mulesoft.com/salesforce-connector/latest/salesforce-connector-upgrade-migrate source_site: docs.mulesoft.com content_type: documentation content_hash: 5bb94722487b51ed4b0dbfe859bd0c015a682b1a3ee04e164c908eb3faa9bca6 description: MuleSoft Documentation Site release: "12.0" latest: true --- --- product: Salesforce Connector version: 12.0 is-latest-version: true --- # Upgrading and Migrating Salesforce Connector to 12.x > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Upgrade Anypoint Connector for Salesforce (Salesforce Connector) from version 11.x to version 12.x. ## Supported Upgrade Paths
From VersionTo Version

11.x

12.x

## Changes ### 12.0 - This connector is now compatible with Java 17 only. - The **OAuth Username Password** connection type is removed because Salesforce is retiring the OAuth 2.0 Username-Password flow. Applications that use this connection type fail to deploy on 12.0.0. Migrate to another supported connection type, such as [OAuth 2.0](https://docs.mulesoft.com/salesforce-connector/latest/salesforce-connector-reference#sfdc-config_config-with-oauth), [OAuth Client Credentials](https://docs.mulesoft.com/salesforce-connector/latest/salesforce-connector-reference#sfdc-config_oauth-client-credentials), [OAuth JWT](https://docs.mulesoft.com/salesforce-connector/latest/salesforce-connector-reference#sfdc-config_jwt), or [OAuth SAML](https://docs.mulesoft.com/salesforce-connector/latest/salesforce-connector-reference#sfdc-config_saml). - The new **Query Time Buffer (Seconds)** field enables you to configure a polling time buffer (from `0` to `120` seconds) for source listeners to prevent missing records committed between polls for the **On New Object**, **On Modified Object**, and **On Deleted Object** sources. The query buffer time for the **On Modified Object** source now defaults to `0` seconds, instead of the former hardcoded default of `2` seconds. Applications that rely on the previous 2-second buffer must explicitly configure this value in the **Query Time Buffer (Seconds)** field. - The **On Modified Object** source now honors the read timeout configured in the connector configuration for internal `DescribeSObjects` calls. Previously, these calls defaulted to an infinite timeout (`readTimeout=0`), which caused connections to hang under certain network conditions. - These libraries are upgraded to address reported security vulnerabilities: - The Apache CXF library is upgraded to version 4.1.7. - The `jackson-core` and `jackson-databind` libraries are upgraded to version 2.21.5. - The `woodstox-core` library is upgraded to version 6.7.0. - The `httpclient` library is upgraded to version 4.5.14. - The `commons-codec` library is upgraded to version 1.22.0. - The `opencsv` library is upgraded to version 5.12.0. - The `jackson-annotations` library is upgraded to version 2.21. - The `gson` library is upgraded to version 2.12.0. - The `jaxws-rt` library is upgraded to version 2.3.7. - The `jetty` library is upgraded to version 12.1.10. - The `cometd-java` library is upgraded to version 8.0.7. ## Requirements Ensure your system meets the following compatibility requirements before you perform the upgrade:
Application/ServiceVersion

Mule runtime

4.9.0 and later

Java

17

Anypoint Studio

7.21 and later

## Upgrade Prerequisites Before you perform the upgrade, you must: 1. Create a backup of your files, data, and configuration in case you need to restore to the previous version. 2. Ensure that your environment meets the version 12.x requirements, including Java 17, Mule runtime 4.9.0 or later, and Anypoint Studio 7.21 or later. 3. If your app uses the **OAuth Username Password** connection type, migrate to the **OAuth Client Credentials**, **OAuth JWT**, **OAuth SAML**, or **OAuth 2.0** connection type, because the **OAuth Username Password** connection type is removed in version 12.x. 4. Install Salesforce Connector 12.x to replace the Salesforce operations that were previously included in Salesforce Connector 11.x. ## Upgrade Steps Follow these steps to perform the upgrade from Salesforce Connector v11.x to Salesforce Connector v12.x: 1. In Anypoint Studio, create a Mule project. 2. In the Mule Palette view, click **Search in Exchange**. 3. In the **Add Dependencies to Project** window, enter `Salesforce` in the search field. 4. In the **Available modules** section, select **Salesforce Connector - Mule 4** and click **Add**. 5. Click **Finish**. 6. Verify that the `salesforce-connector` dependency version is `12.x.x` in the `pom.xml` file, where `x.x` is the minor release and patch version number. For example, if you are upgrading to v12.0, the dependency version in the `pom.xml` file should be `12.0.0`. Studio upgrades the connector automatically. ## Verify the Upgrade After you install the latest version of the connector, follow these steps to verify the upgrade: 1. In Studio, verify that there are no errors in the **Problems** or **Console** views. 2. Check the project `pom.xml` file and verify that there are no problems. 3. Test the connection and verify that the operations work. ## Troubleshooting If there are problems with caching the parameters and caching the metadata, try restarting Studio. ## Revert the Upgrade If it is necessary to revert to the previous version of Salesforce Connector, change the `salesforce-connector` dependency version in the project’s `pom.xml` file to the previous version. You must update the project’s `pom.xml` file in Anypoint Studio. ## See Also - [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Salesforce Help](https://help.salesforce.com)