---
schema_version: "1"
id: a2cf7a140bb40122e7b51860865ede4cddd523fcc5d5912f4fe8bec5d7ff656a
title: Upgrading and Migrating Web Service Consumer Connector to Version 2.2
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/web-service-consumer-connector/latest/web-service-consumer-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/web-service-consumer-connector/latest/web-service-consumer-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: e09ee57be9d301d4dce362086b7bb34653ac119964575e8423e822eec7dadf8c
description: MuleSoft Documentation Site
release: "2.2"
latest: true
---
---
product: Web Service Consumer Connector
version: 2.2
is-latest-version: true
---

# Upgrading and Migrating Web Service Consumer Connector to Version 2.2

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Upgrade Web Service Consumer Connector to version 2.x.

## Supported Upgrade Paths

<table><colgroup><col> <col></colgroup><thead><tr><th>From Version</th><th>To Version</th></tr></thead><tbody><tr><td><div><div><p>1.x</p></div></div></td><td><div><div><p>2.x</p></div></div></td></tr></tbody></table>

## Changes in 2.2

- New `WSC:SECURITY` error type usable in `<error-handler>` blocks. Operations that fail because of
  a security-related cause now raise this error type.

- The `soap-engine` dependency is upgraded to version 2.4.0 with security improvements. XML parsing
  is hardened by default; if your integration legitimately requires DOCTYPE declarations or external
  entities in SOAP messages, see [Troubleshooting](https://docs.mulesoft.com/web-service-consumer-connector/latest/web-service-consumer-troubleshooting) for the
  system property to re-enable them.

## Changes in 2.1

- The WSS Sign Configuration Adapter type now includes the new **Expand XOP Include** field to
  define how XOP (XML-binary Optimized Packaging) includes are expanded inline within the SOAP
  message body.

## Changes in 2.0

Web Service Consumer Connector 2.0 includes these changes.

- Web Service Consumer Connector (and its dependencies) are now compilable and compatible only with
  Java 17.

- To align with modern development practices and ensure continued compatibility with secure and
  supported libraries, Web Service Consumer Connector is upgraded from Spring 5.x to Spring 6.x.

## Upgrade Prerequisites

Before you perform the upgrade, you must create a backup of your files, data, and configurations in
case you need to restore them.

## Upgrade Steps

Follow these steps to perform the upgrade:

1.  In Anypoint Studio, right-click the project and select **Manage Dependencies** > **Manage
    Modules**.

2.  Select `Web Service Consumer Connector - Mule 4` and click **Update version**.

3.  Click **Apply and Close**.

4.  Verify that the Web Service Consumer Connector dependency version is `2.0.0` in the `pom.xml`
    file in the Mule project.

Alternatively, you can manually update the Web Service Consumer Connector dependency version in the
`pom.xml` file in the Mule project, or simply add the updated connector to the project.

### Verify the Upgrade

After you upgrade 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.  Verify that there are no problems in the project `pom.xml` file.

3.  Test the connection to verify that the operations work.

## Troubleshoot

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

### Revert the Upgrade

If it is necessary to revert to the previous version of Web Service Consumer Connector, change the
Web Service Consumer Connector dependency version `2.0.0` in the project’s `pom.xml` to the previous
version.

You must update the project’s `pom.xml` in Anypoint Studio.

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Web Service Consumer Connector Reference](https://docs.mulesoft.com/web-service-consumer-connector/latest/web-service-consumer-reference)

- [Salesforce Help](https://help.salesforce.com)