---
schema_version: "1"
id: 8db7aefe6692f2d1cd449a97a4449182180f61dddfb62998890f689ec35c7100
title: Using Anypoint Studio to Configure SAP S/4HANA SOAP Connector 2.6
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/sap-s4hana-soap-connector/latest/sap-s4hana-soap-connector-studio.md
canonical_url: https://docs.mulesoft.com/sap-s4hana-soap-connector/latest/sap-s4hana-soap-connector-studio
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 7347bcacf6946e082dcfa4e00cf20960115d4d83b4b622fc2a5e391aad732482
description: MuleSoft Documentation Site
release: "2.6"
latest: true
---
---
product: SAP S/4HANA SOAP Connector
version: 2.6
is-latest-version: true
---

# Using Anypoint Studio to Configure SAP S/4HANA SOAP Connector 2.6

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

Anypoint Studio (Studio) editors help you design and update your Mule applications, properties, and
configuration files.

To add and configure a connector in Studio:

1.  [Create a Mule project](#create-mule-project).

2.  [Add the connector to your Mule project](#add-connector-to-project).

3.  [Configure an input source for the connector’s flow](#configure-input-source).

4.  [Add a connector operation to the flow](#add-connector-operation).

5.  [Configure a global element for the connector](#configure-global-element).

If you are new to configuring connectors in Studio, see
[Using Anypoint Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio).

## Create a Mule Project

In Studio, create a new Mule project in which to add and configure the connector:

1.  In Studio, select **File > New > Mule Project**.

2.  Enter a name for your Mule project and click **Finish**.

## Add the Connector to Your Project

Add SAP S/4HANA SOAP Connector to a Mule project to automatically populate the XML code with the
connector’s namespace and schema location, as well as to add the required dependencies to the
project’s `pom.xml` file.

1.  In Studio, create a Mule project.

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

3.  In **Add Modules to Project**, type `SAP S/4HANA SOAP` in the search field.

4.  Click the SAP S/4HANA SOAP connector name in **Available modules**.

5.  Click **Add**.

6.  Click **Finish**.

Adding a connector to a Mule project in Studio does not make that connector available to other
projects in your Studio workspace.

## Configure an Input Source

An input source initiates a flow when a specified condition is met. You can configure one of these
input sources to use with SAP S/4HANA SOAP Connector:

- **Outbound Message Listener**, which listens for incoming SAP S/4HANA SOAP outbound messages

- **HTTP Listener**, which initiates a flow each time it receives a request on the configured host
  and port

- **Scheduler**, which initiates a flow when a time-based condition is met

For example, to configure **HTTP Listener**, follow these steps:

1.  In the **Mule Palette** view, select **HTTP** > **Listener**.

2.  Drag **Listener** to the Studio canvas.

3.  On the **Listener** tab, optionally change the value of the **Display Name** field.

4.  Specify a value for the **Path** field.

5.  Click the plus sign (+) next to the **Connector configuration** field to configure a global
    element that can be used by all instances of `HTTP Listener` in the app.

6.  On the **General** tab, specify connection information.

7.  On the **TLS** tab, optionally specify TLS information.

8.  On the **Advanced** tab, optionally specify reconnection information, including a reconnection
    strategy.

9.  Click **Test Connection** to confirm that Mule can connect with the specific server.

10. Click **OK**.

## Add a Connector Operation to the Flow

When you add a connector operation to your flow, you immediately define a specific operation for
that connector to perform.

To add an operation for SAP S/4HANA SOAP Connector, follow these steps:

1.  In the **Mule Palette** view, select **SAP S4 HANA SOAP** and then select the desired operation.

2.  Drag the operation onto the Studio canvas to the right of the input source.

## Global Configuration Elements

To use SAP S/4HANA SOAP Connector in a Mule app, you can configure a global SAP S/4HANA
configuration element for use by SAP S/4HANA Connector operations in your application.

You can put placeholder values in the `mule-artifact.content` configuration file in the
`src/main/resources` folder of your project.

You can either enter your credentials in the global configuration content or reference a
configuration file that contains the values for your credentials. Using a configuration file is
recommended for simpler maintenance and better reuse of your project. Keeping these values in a
separate file is useful if you need to deploy to different environments, such as production,
development, and QA, where access credentials might differ.

### Configure the SAP S/4HANA SOAP Config

When you configure a connector, it is best to configure a global element that can be used by all
instances of that connector in the app. Configuring a global element requires you to provide the
authentication credentials the connector uses to access the target SAP S/4HANA system. SAP S/4HANA
Connector supports both Basic authentication and OAuth 2.0 client credentials authentication.

To configure the global element for SAP S/4HANA SOAP Connector, follow these steps:

1.  In your project, click the **Global Elements** tab at the base of the canvas.

2.  In the **Global Configuration Elements** screen, click **Create**:

    ![Global configuration elements screen with Create button](/mulesoft/current/en-us/sap-s4hana-soap-connector/latest/_images/sap-hana-global-config-wizard.png)

3.  In the **Choose Global Type** wizard, expand **Connector Configuration**, select **SAP S/4HANA
    SOAP Config**, and click **OK**.

4.  In the **General** tab, select the connection authentication from the **Connection** drop-down:

    - [**Basic Authentication**](#basic_authentication)

    - [**Certificate Authentication**](#certificate-authentication)

    - [**OAuth 2 Client Credentials Authentication**](#oauth-client-credentials)

5.  Enter the required information for the selected connection type and click **OK**.

6.  Click **Test Connection** to ensure that your access credentials are correct.

7.  Click the **Addressing** tab to configure the following values:

    <table><colgroup><col> <col></colgroup><thead><tr><th>Studio Field</th><th>Description</th></tr></thead><tbody><tr><td><p><strong>Version</strong></p></td><td><div><div><p>WS-Addressing version. If nothing is specified, the connector uses the value from configuration.</p></div></div></td></tr><tr><td><p><strong>From</strong></p></td><td><div><div><p>Reference of the endpoint where the message originated from. If nothing is specified, the connector uses the value from configuration.</p></div></div></td></tr></tbody></table>

8.  Click the **Advanced** tab to configure the following values:

    <table><colgroup><col> <col></colgroup><thead><tr><th>Studio Field</th><th>Description</th></tr></thead><tbody><tr><td><p><strong>Discovery Service Enabled</strong></p></td><td><div><div><p>Feature switch for service discovery. If disabled, the service discovery relative path is not applied.</p></div></div></td></tr><tr><td><p><strong>Discovery Service Path</strong></p></td><td><div><div><p>Relative path from the base URL to the service to use for automatic services discovery</p></div></div></td></tr><tr><td><p><strong>Service directory</strong></p></td><td><div><div><p>Common HTTP directory for all SAP services. You can leave this parameter blank and specify the HTTP directory individually for every service in the unlisted services list.</p></div></div></td></tr><tr><td><p><strong>Unlisted services</strong></p></td><td><div><div><p>List of services to add to the list of discovered services</p></div></div></td></tr><tr><td><p><strong>Service discovery resolution timeout</strong></p></td><td><div><div><p>Connection timeout for service discovery</p></div></div></td></tr><tr><td><p><strong>Service discovery timeout unit</strong></p></td><td><div><div><p>Time unit to use in the service discovery resolution timeout configuration</p></div></div></td></tr><tr><td><p><strong>Default headers</strong></p></td><td><div><div><p>Custom headers to include in each request sent</p></div></div></td></tr><tr><td><p><strong>Default query parameter</strong></p></td><td><div><div><p>Custom query parameters to include in each request sent</p></div></div></td></tr><tr><td><p><strong>TLS configuration</strong></p></td><td><div><div><p>TLS configuration</p></div></div></td></tr><tr><td><p><strong>Proxy configuration</strong></p></td><td><div><div><p>Configuration for executing requests through a proxy</p></div></div></td></tr></tbody></table>

9.  Click **OK** to save the global connector configuration.

### Basic Authentication

Enter the following information on the **General** tab of the **Global Element Properties** screen
to configure basic authentication:

- **Service Base URL**  
  URL of the SAP S/4HANA instance you want to manage

- **Username**  
  User name used to initialize the session

- **Password**  
  Password used to authenticate the user

### Certificate Authentication

Enter the following required information on the **General** tab of the **Global Element Properties**
screen to configure certificate authentication:

- **Service Base URL**  
  URL of the SAP S/4HANA instance you want to manage

### OAuth 2.0 Client Credentials Authentication

Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more
information, refer to
[Configuring OAuth 2.0 for Connectors](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2),
[Configuring OAuth 2.0 for Connectors on CloudHub](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2-cloudhub),
or [OAuth Support in the SDK](https://docs.mulesoft.com/mule-sdk/latest/oauth).

Enter the following required information on the **General** tab of the **Global Element Properties**
screen to configure OAuth 2.0 client credentials authentication:

- **Service base URL**  
  Base URL of the service provider of the SAP S/4HANA system to access from the connector  
  All other endpoints are derived from the base URL.

- **Client ID**  
  OAuth client ID that is registered with the service provider.

- **Client secret**  
  OAuth client secret that corresponds to the client ID and is registered with the service provider.

### Configure the SAP S/4HANA SOAP Listener Config

Use the Global Element Properties configuration dialog to configure a global element for SAP S/4HANA
SOAP Connector:

1.  In your project, click the **Global Elements** tab at the base of the canvas.

2.  In the **Global Configuration Elements** screen, click **Create**:

    ![Global configuration elements screen with Create button](/mulesoft/current/en-us/sap-s4hana-soap-connector/latest/_images/sap-hana-source-global-config-wizard.png)

3.  In the **Choose Global Type** wizard, expand **Connector Configuration**, select **SAP S/4HANA
    SOAP Listener Config**, and click **OK**.

4.  Configure the following values in the **General** tab:

    - **HTTP Listener**  
      Reference to a global HTTPS Listener configuration, for example: `HTTPS_Listener_config`. This
      configuration must be secured by using **HTTPS protocol** in order to receive outbound
      messages from the SAP S/4HANA system.

    - **WSDL Path**  
      Specify the paths to the WSDL definitions to use for resolving metadata keys.

    - **Encoding**  
      Character encoding used in the messaging.

5.  Click **OK** to save the global connector configuration.

It is possible to share the same path between multiple sources, but sources that share a path cannot
listen to the same message type.

The list of message types specifies the message types the source can listen to. Message types are
built from the provided WSDL definitions. The message type **ANY**, which is always present, allows
the source to listen to any outbound message type sent from the SAP S/4HANA system.

## Next Step

After configuring the SAP S/4HANA SOAP Connector for use in Studio, see the
[Examples](https://docs.mulesoft.com/sap-s4hana-soap-connector/latest/sap-s4hana-soap-connector-examples) topic for more examples of configuring the connector
in Studio.

## See Also

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