---
schema_version: "1"
id: 607f36e867ae91e19b0099dc381f92487291aa8584859d42e33fb4fc5400f690
title: Upgrading and Migrating to SAP Connector 5.x
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/sap-connector/latest/sap-connector-5-upgrade.md
canonical_url: https://docs.mulesoft.com/sap-connector/latest/sap-connector-5-upgrade
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 91845edcf81385a1e7b70cf6c8866267f6bb713a93e66d73b6a9318f2999dfff
description: MuleSoft Documentation Site
release: "5.9"
latest: true
---
---
product: SAP Connector
version: 5.9
is-latest-version: true
---

# Upgrading and Migrating to SAP Connector 5.x

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

Anypoint Connector for SAP version 5.x has enhancements and changes. Some of the main changes
introduced in SAP Connector 5.x are:

- The `Create` operation is renamed to `Retrieve IDoc`.

- The execute BAPI functions over qRFC, tRFC, and sRFC operations are merged into Synchronous Remote
  Function Call (sRFC) and Asynchronous Remote Function Call (aRFC) operations.

- The `Disable function template cache` flag is renamed to `Disable JCo internal cache`, and applies
  to both functions and sources. The default value is `false`.

- The sources now have `-listener` in their aliases instead of `source`. For example, the XML is
  changed from `sap:document-source` to `sap:document-listener`.

- The SAP configuration has the following changes:

- The SAP Inbound and SAP Outbound configurations are merged into the new SAP configuration.

- The **Message Server** field is now in the **General** tab.  
  The new configuration makes understanding what configuration to use in the connector more
  intuitive.

These new features and enhancements may cause backward compatibility issues.

## Upgrade Steps

Follow these steps to perform the upgrade:

1.  In Anypoint Studio, create a Mule project.

2.  In the **Mule Palette** view, click **Search in Exchange**.

3.  In **Add Dependencies to Project**, enter `sap` in the search field.

4.  In **Available modules**, select **SAP Connector - Mule 4** and click **Add**.

5.  Click **Finish**.

6.  Verify that the SAP Connector dependency version is 5.x.x in the `pom.xml` file in the Mule
    project, where `x.x` is the minor release and patch version number. For example, if you are
    upgrading to v5.2, the dependency version in the pom.xml file should be 5.2.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.  Verify that there are no problems in the project `pom.xml` file.

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

### Revert the Upgrade

If it is necessary to revert to the previous version of SAP Connector, change the `sap-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)