Salesforce Marketing Cloud 3.1 - Upgrade and Migrate - Mule 4

Upgrade Anypoint Connector for Salesforce Marketing Cloud (Salesforce Marketing Cloud Connector) to version 3.x.

Supported Upgrade Paths

From Version	To Version
2.2.x	3.x

From Version

To Version

2.2.x

3.x

Changes in This Release

This release contains the following changes:

Removed support for FuelSDK

The connector now uses the Mule HTTP client to perform the SOAP requests to the API.
Changed the supported connection types
Changed the Upsert entities operation
Removed some operations and grouped their functionality into fewer operations

Changes in Connection Types

This release contains the following changes to connection types:

Added support for using OAuth Client Credentials authentication
Removed the OAuth Username Password authentication type, because the Salesforce Marketing Cloud deprecated this authentication type

Changed Operations

When using the Upsert entities operation, the connector changed its request type from Update to Create. The name remains the same; only the request type has changed.

Removed Operations

Salesforce Marketing Cloud 3.x has the same functionality as the 2.x versions, but it implements this functionality with fewer operations.

The following operations were removed from Salesforce Marketing Cloud Connector:

Removed Operation Functionality Provided by

Removed Operation	Functionality Provided by
Configure Create	Configure action operation with the Action parameter set to `Create`
Configure Update	Configure action operation with the Action parameter set to `Update`
Configure Delete	Configure action operation with the Action parameter set to `Delete`
Perform Start	Perform action operation with the Action parameter set to `Start`
Perform Stop	Perform action operation with the Action parameter set to `Stop`
Perform Get Max Count	Perform action operation with the Action parameter set to `Get Max Count`

Configure Create

Configure action operation with the Action parameter set to Create

Configure Update

Configure action operation with the Action parameter set to Update

Configure Delete

Configure action operation with the Action parameter set to Delete

Perform Start

Perform action operation with the Action parameter set to Start

Perform Stop

Perform action operation with the Action parameter set to Stop

Perform Get Max Count

Perform action operation with the Action parameter set to Get Max Count

Changes in Operations Metadata

There are no changes related to keys, input metadata, or output metadata.

Upgrade Prerequisites

Before you perform the upgrade, you must:

Create a backup of your files, data, and configuration in case you must restore to the previous version.
Install Salesforce Marketing Cloud Connector v3.x.x.

Upgrade Steps

Follow these steps to perform the upgrade from Salesforce Marketing Cloud Connector v2.2.x to Salesforce Marketing Cloud Connector v3.x.x:

In Anypoint Studio, create a Mule project.
In the Mule Palette view, click Search in Exchange.
In the Add Dependencies to Project window, enter Salesforce Marketing Cloud 3 in the search field.
In the Available modules section, select Salesforce Marketing Cloud Connector and click Add.
Click Finish.
Verify that the mule-sfdc-marketing-cloud-connector dependency version is 3.x.x in the pom.xml file, where the first x is the minor release number and the second x is the patch release number.

Studio upgrades the connector automatically.

Verify the Upgrade

After you install the latest version of the connector, follow these steps to verify the upgrade:

In Studio, verify that there are no errors in the Problems or Console views.
Check the project pom.xml file and verify that there are no problems.
Test the connection and verify that the operations work.

Troubleshooting

If there are problems with caching the parameters or caching the metadata, try restarting Studio.

Revert the Upgrade

If it is necessary to revert to the previous version of Salesforce Marketing Cloud Connector, change the mule-sfdc-marketing-cloud-connector dependency version 3.x.x in the project’s pom.xml file to the previous version.