Salesforce Marketing Cloud Connector Release Notes - Mule 4

Support Category: Select

Anypoint Connector for Salesforce Marketing Cloud (Salesforce Marketing Cloud Connector) enables you to connect to the Salesforce Marketing Cloud web services using the Salesforce Exact Target API. This connector exposes convenient methods for managing objects and calling services provided by the Salesforce Exact Target API, also known as Salesforce Marketing Cloud.

4.1.2

September 19, 2024

Compatibility

Application/Service Version

Mule

4.5.0 and later

Anypoint Studio

7.16.0 and later

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The org.apache.cxf libraries are upgraded to version 3.5.9 to address reported security vulnerabilities.

W-16783690

4.1.1

July 24, 2024

Compatibility

Application/Service Version

Mule

4.5.0 and later

Anypoint Studio

7.16.0 and later

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The proxy configuration is now also used when downloading the WSDL file.

W-16063541

4.1.0

April 24, 2024

Compatibility

Application/Service Version

Mule

4.5.0 and later

Anypoint Studio

7.16.0 and later

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The Bouncy Castle library (bcprov-jdk15on) is removed to address security vulnerabilities.

W-15310626

4.0.0

February 20, 2024

What’s New

  • The connector now supports multiple child organizations by specifying the Account Id field.

Compatibility

Application/Service Version

Mule

4.5.0 and later

Anypoint Studio

7.16.0 and later

OpenJDK

8, 11, and 17

3.2.13

January 12, 2024

What’s New

  • This connector is now compatible with Java 17.

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

OpenJDK

8, 11, and 17

3.2.12

February 15, 2023

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

OpenJDK

8 and 11

Fixed Issues

Issue Resolution ID

The connector no longer makes an extra API request for the Retrieve entities operation.

W-12487851

3.2.11

January 23, 2023

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue Resolution ID

The connector no longer throws an error when filtering null values.

W-12404291

The Apache CXF Core dependency is upgraded to version 3.5.5 to fix reported security vulnerabilities.

W-12390525

The Commons-IO dependency is upgraded to version 2.11.0 to fix reported security vulnerabilities.

W-12390525

3.2.10

December 14, 2022

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

The overall stability and performance of the connector are improved.

W-11991934

3.2.9

November 9, 2022

What’s New

  • The com.fasterxml.jackson.core library is upgraded to version 2.14.0.

  • The com.fasterxml.woodstox:woodstox-core library is upgraded to version 6.4.0.

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

The com.fasterxml.jackson.core library is upgraded to version 2.14.0 to address reported security vulnerabilities.

W-12029613

The com.fasterxml.woodstox:woodstox-core library is upgraded to version 6.4.0 to address reported security vulnerabilities.

W-12029613

3.2.8

September 28, 2022

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

The connector now properly handles null properties.

W-11807779

3.2.7

June 20, 2022

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

The connector no longer contains a policy violation in the sizeof-agent transitive dependency.

W-11282445

3.2.6

June 9, 2022

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

Fixed reported security vulnerabilities by upgrading the Spring Beans library from org.springframework:spring-beans:5.3.18 to org.springframework:spring-beans:5.3.20.

W-11226200

Fixed reported security vulnerabilities by upgrading the CXF RT Transports HTTP library from cxf-rt-transports-http:jar:3.3.5 to cxf-rt-transports-http:jar:3.5.2.

W-11220137

3.2.5

April 20, 2022

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

Fixed reported security vulnerabilities by upgrading the Mule SOAP Engine library from org.mule.connectors:mule-soap-engine:1.3.2 to org.mule.connectors:mule-soap-engine:1.6.9.

W-10920502, W-10927724

Fixed reported security vulnerabilities by upgrading the Jackson Databind library from com.fasterxml.jackson.core:jackson-databind:2.12.6 to com.fasterxml.jackson.core:jackson-databind:2.13.2.2.

W-10920505

Fixed reported security vulnerabilities by upgrading the Spring Framework library from org.springframework:spring-context:5.1.6.RELEASE to org.springframework:spring-context:5.3.19.

W-11001897

Fixed reported security vulnerabilities by upgrading the Bouncy Castle library from org.bouncycastle:bcprov-jdk15on:1.67 to org.bouncycastle:bcprov-jdk15on:1.70.

W-11001900

3.2.4

January 7, 2022

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

Fixed reported security vulnerabilities by upgrading the XMLSec library from com.fasterxml.jackson.core:jackson-databind:2.11.3 to com.fasterxml.jackson.core:jackson-databind:2.12.6.

CONN-9832

3.2.3

December 7, 2021

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

Fixed reported security vulnerabilities by removing the transitive dependency for the com.google.code.gson:gson:2.8.5 library.

CONN-9296

3.2.2

October 21, 2021

Compatibility

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

Issue ID

Fixed reported security vulnerabilities by upgrading the XMLSec library from org.apache.santuario:xmlsec:2.1.4 to org.apache.santuario:xmlsec:2.2.3.

CONN-8996

3.2.1

June 10, 2021

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • Expired token did not refresh properly for the On new object and On modified object sources. (SE-20989)

  • Fixed a vulnerability issue by upgrading the Bouncycastle dependency org.bouncycastle:bcprov-jdk15on:1.65 to org.bouncycastle:bcprov-jdk15on:1.67. (CONN-8332)

3.2.0

June 2, 2021

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

New Features

  • The Since parameter for sources supports date values included in a time zone.

  • The sources return values for all of the object fields.

Fixed Issues

  • The On Modified Objects source did not support all of the objects listed in the dropdown. The source uses the Modified Date field, which is not retrievable for all objects. The dropdown is now filtered to display only objects that retrieve the Modified Date field. (SE-20516)

  • There was a connection error while deploying the connector in a closed environment without internet access. To fix this, the connector resources now include an etframework.wsdl`and `ETFrameworkFault.xsd. (SE-19993)

3.1.6

March 24, 2021

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • The connector threw INVALID_INPUT errors after the app restarted in Anypoint Runtime Manager. (SE-19926)

  • The connector did not reconnect after it encountered a network disruption. (SE-20010)

3.1.5

November 17, 2020

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • The Retrieve operation did not throw an exception when the query didn’t execute succcessfully. (SE-18218)

  • Fixed a vulnerability issue by upgrading the Jackson Databind dependency com.fasterxml.jackson.core:jackson-databind:2.10.3 to com.fasterxml.jackson.core:jackson-databind:2.11.3.

3.1.4

October 6, 2020

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • Misleading errors appeared in DEBUG mode. (SE-17810)

3.1.3

September 9, 2020

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • Fixed a vulnerability issue by upgrading the Commons-IO dependency commons-io:commons-io:2.4 to commons-io:commons-io:2.7

3.1.2

August 10, 2020

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • Encountered an ArrayIndexOutOfBoundsException when executing the Update operation. (SE-16999)

  • Fixed a vulnerability issue by upgrading the Apache CXF dependency org.apache.cxf:cxf-rt-transports-http:3.3.0 to org.apache.cxf:cxf-rt-transports-http:3.3.5

3.1.1

July 23, 2020

Salesforce Marketing Cloud Connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • Fixed the NewObject and ModifyObject input sources to correctly parse date values that have the format yyyy-MM-dd’T’HH:mm:ss. (CONN-1620)

  • Fixed the following vulnerability issues:

    • Updated the Commons Codec dependency commons-codec:commons-codec:1.13 to commons-codec:commons-codec:1.14

    • Excluded the Bouncy Castle dependency org.bouncycastle:bcprov-jdk15on from org.mule.connectors:mule-soap-engine:1.3.2 and org.cryptacular:cryptacular:1.2.4

    • Excluded the Bouncy Castle dependency org.bouncycastle:bcprov-jdk15on from org.cryptacular:cryptacular:1.2.4

3.1.0

June 16, 2020

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

The connector did not support parameter expressions for the Service URL parameter. (SE-16129)

3.0.4

May 29, 2020

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

The Upsert operation sent an API request with the wrong SOAP action. The operation now uses the SOAP Update action. (SE-16073)

3.0.3

May 7, 2020

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • The OAuth access token was not refreshed correctly when it expired. (SE-15630)

  • Upgraded the following dependency versions to fix vulnerability issues:

    • Jackson Databind com.fasterxml.jackson.core:jackson-databind:2.9.3 upgraded to com.fasterxml.jackson.core:jackson-databind:2.10.0

    • Cryptacular org.cryptacular:cryptacular:1.1.1 upgraded to org.cryptacular:cryptacular:1.2.4

    • Apache CXF Core org.apache.cxf:cxf-core:3.3.0 upgraded to org.apache.cxf:cxf-core:3.3.6

    • Apache CXF RT Management org.apache.cxf:cxf-rt-management:3.3.1 upgraded to org.apache.cxf:cxf-rt-management:3.3.6

    • Woodstox Core com.fasterxml.woodstox:woodstox-core:5.0.3 upgraded to com.fasterxml.woodstox:woodstox-core:6.1.1

    • Commons Bean Utils commons-beanutils:commons-beanutils:1.9.2 upgraded to commons-beanutils:commons-beanutils:1.9.4

    • Dom4j org.dom4j:dom4j:2.1.1 upgraded to org.dom4j:dom4j:2.1.3

    • Commons Codec commons-codec:commons-codec:1.11 upgraded to commons-codec:commons-codec:1.13

    • XMLSec org.apache.santuario:xmlsec:2.1.2 upgraded to org.apache.santuario:xmlsec:2.1.5

3.0.2

April 2, 2020

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • The OAuth Connection Provider did not refresh the access token when it expired. (SE-13371)

  • The connector could not retrieve the DataExtensionObject if the column name contained spaces in the Where clause or in the selected fields. (CONN-4183)

3.0.1

December 18, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Fixed Issues

  • When using the upsert operation, the connector sent an incorrect request to the API. It changed the request from UpdateRequest to CreateRequest. (SE-14064)

3.0.0

October 31, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.2.1 and later

Anypoint Studio

7.3 and later

Features

  • Added the OAuth client credentials connection provider to enable the use of the OAuth mechanism for authentication.

  • Removed FuelSDK and used Mule HTTP client to perform the SOAP requests to the API.

2.2.0

October 1, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.1.1 and later

Anypoint Studio

7 and later

Fuel SDK

v1.2.2

Fixed Issues

  • Fixed a bug where sensitive information was displayed in logs by making logging optional. You can enable logging by using the new Enable Soap Logging parameter in the connector configuration. (SE-13059)

2.1.5

August 8, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.1.1 and later

Anypoint Studio

7 and later

Fuel SDK

v1.2.2

Features

  • Upgraded the File Connector dependency to version 1.3.0. (CONN-2523)

Fixed Issues

  • The Salesforce Marketing Cloud Connector was throwing the UNKNOWN error on an invalid query. The error handling has been improved and now, when a query is invalid, the correct exception is thrown. (SE-12523)

2.1.4

May 29, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.1.1 and later

Anypoint Studio

7 and later

Fuel SDK

v1.2.2

Fixed Issues

  • Salesforce Marketing Cloud Connector did not parse queries correctly. The connector now translates an SOQL query correctly when including a clause in parentheses. (SE-11721)

2.1.3

May 6, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.1.1 and later

Anypoint Studio

7 and later

Fuel SDK

v1.2.2

Fixed Issues

  • SFMC (Salesforce Marketing Connector) no longer erroneously appends a timestamp to the value in a SQL statement(SE-11603).

  • Now works with Mule 4.2.0 and Java 11. Added the following missing dependencies: com.sun.xml.messaging.saaj:saaj-impl:1.5.1, javax.ws.rs:javax.ws.rs-api:2.1.1 and javax.xml.ws:jaxws-api:2.3.1

2.1.2

March 11, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.1.1 and later

Anypoint Studio

7 and later

Fuel SDK

v1.2.2

Fixed Issues

  • Cannot connect to Salesforce Marketing: com.ctc.wstx.exc.WstxEOFException: Unexpected EOF in prolog. This issue was fixed by wrapping the thrown exception with a more readable one, SFDC-MARKETING-CLOUD:UNKNOWN.

2.1.1

February 7, 2019

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.1.1 and later

Anypoint Studio

7 and later

Fuel SDK

1.2.2

Fixed Issues

  • Fixed error in parser date.

2.1.0

November 20, 2018

The Salesforce Marketing Cloud connector is compatible with:

Compatibility

Application/Service Version

Mule

4.1 and later

Anypoint Studio

7 and later

Fuel SDK

1.2.2

Features

  • Support for Salesforce Marketing Cloud API v43 based on Fuel SDK v1.2.2.

2.0.0

January 19, 2018

Release notes for the Salesforce Marketing Cloud connector.

Compatibility

The Salesforce Marketing Cloud connector is compatible with:

Application/Service Version

Mule

4.0 and later

Anypoint Studio

7 and later

Exact Target API

v145.3

Features

  • Configure Create - Calls the "Configure" command with "Create" as the action attribute when connected to the Marketing Cloud SOAP web service.

  • Configure Delete - Calls the "Configure" command with "Delete" as the action attribute when connected to the Marketing Cloud API SOAP web service.

  • Configure Update - Calls the "Configure" command with "Update" as the action attribute when connected to the Marketing Cloud API SOAP web service.

  • Create - Creates a new object on the Marketing Cloud API web server.

  • Delete - Deletes an existing object on the Marketing Cloud API web server.

  • Perform get max count - Calls the "Perform" command with "GetMaxCount" as the action attribute when connected to the Marketing Cloud API SOAP web service.

  • Perform start - Sends a "Perform" command having "Start" as an action attribute when connected to the Marketing Cloud API SOAP web service.

  • Perform stop - Sends a "Perform" command having "Stop" as an action attribute when connected to the Marketing Cloud API SOAP Web service.

  • Retrieve - Retrieves objects from the Marketing Cloud API web server in a SQL query-like fashion.

  • Schedule start - Calls the "Schedule" command with "Start" as the action attribute when connected to the Marketing Cloud API SOAP web service.

  • Update - Updates an existing object on the Marketing Cloud API web server.

  • Upsert - Creates an object if the object does not already exist, or delete an existing object on the Marketing Cloud API web server. This operation is achieved by using "Create" method of the Marketing Cloud API SOAP API.

Fixed Issues

This is the first version of the connector, thus no fixes were required; there are only new features.

Known Issues

Providing a Subclass as Type To a Complex Field

Some objects have complex fields that represent a base class from Salesforce Marketing. So, if instead of the base class, you want to pass a subclass of it as value to that field, that is not possible because the connector is not recognize the fields that do not belong to the base class. You must manually map those fields in Transform Message and add a field named "concreteClassType" with the name of the subclass as value. For more information and an example, read the connector guide.

Retrieving Fields From a Hierarchy Not Possible

Querying fields that are lower than level 1 in the hierarchy is not supported by the API. For example,queries like Select Attributes.Name from Subscriber because Name is at level 2 in the hierarchy.

Server Results that Contain an Automation Object Structure Cause Exception to Be Thrown

When performing operations on an Automation object, the result of the operation causes an exception to be thrown because the response has a field that cannot be parsed by the API. To bypass this, make those types of operations asynchronous.