Contact Free trial Login

SAP S/4HANA SOAP Cloud Connector Reference

Support Category: Premium

SAP S/4HANA SOAP Cloud v2.0

The main class of an extension is the entry point from which configurations, connection providers, operations, and sources are declared.

Configurations


Config

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types to provide to this configuration.

x

Connection timeout

Number

Connection timeout for the request

30

Connection Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit to use in the Timeout configurations

SECONDS

Encoding

String

Default character encoding to use in all the messages. If not specified, the default charset in the mule configuration will be used

Name

String

The identifier of this element used to reference it in other components

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

Connection Types

Basic Authentication

Basic authentication is the simplest way of enforcing access controls because it does not require cookies, session identifiers, or login pages. Instead, it uses standard fields in the HTTP header, removing the need for handshakes. This mechanism provides no confidentiality protection for the transmitted credentials. They are merely encoded with Base64 in transit, but not encrypted or hashed in any way.

Parameters
Name Type Description Default Value Required

Service base URL

String

The base URL of the service on SAP S/4HANA to be accessed from the connector.

x

Username

String

The account username with which to log in to SAP S/4HANA.

x

Password

String

The account password with which to log in to SAP S/4HANA.

x

Discovery Service Enabled

Boolean

Enables automatic service discovery

true

Discovery Service Path

String

URL to use for automatic services discovery

/sap/bc/srt/wsil_ext

Service directory

String

Common HTTP directory for all SAP services

Unlisted services

Array of String

List of services that will be added to the list of discovered services

Service discovery resolution timeout

Number

Connection timeout for service discovery

30

Service Discovery Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit to use in the Timeout configuration

SECONDS

Default HTTP headers

Object

Default HTTP headers to include in the message.

Default query parameters

Object

Default query parameters to include in the request.

Proxy configuration

Proxy configuration for the connector.

TLS configuration

TLS

Protocol to use for communication. Valid values are HTTP and HTTPS. When using HTTPS the HTTP communication is secured using TLS or SSL. If HTTPS was configured as the protocol then the user needs to configure at least the keystore in the tls:context child element of this listener-config.

HTTP

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

OAuth 2.0 Client Credentials Authentication

OAuth 2.0 authentication provides a secure way of authenticating against the resource using the provided client ID and client secret. Authentication is ensured using an access token generated by the resource. The generated token has a limited lifespan and is automatically refreshed by initiating a refresh dance, after the token expires.

Parameters
Name Type Description Default Value Required

Service base URL

String

The base URL of the SAP S/4HANA SOAP service to access from the connector

x

Discovery Service Enabled

Boolean

Enables automatic service discovery

true

Discovery Service Path

String

URL to use for automatic services discovery

/sap/bc/srt/wsil_ext

Service directory

String

Common HTTP directory for all SAP services

Unlisted services

Array of String

List of services that will be added to the list of discovered services, for example: /sap/bc/srt/wsdl_ext/flv_10002S111AD1/srvc_url/sap/bc/srt/scs_ext/sap/creditmanagementaccountbyidqu1
If the Service directory parameter is not specified, then the HTTP directory needs to be prepended before every service name in this list, in the following format: {directory}/{service-name}.

Service discovery resolution timeout

Number

Connection timeout for service discovery

30

Service Discovery Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit to use in the Timeout configuration

SECONDS

Default HTTP headers

Object

Default HTTP headers the message should include

Default query parameters

Object

Default Query parameters the request should include

Proxy configuration

Proxy configuration for the connector

TLS configuration

TLS

Protocol to use for communication. Valid values are HTTP and HTTPS. When using HTTPS, the HTTP communication is secured using TLS or SSL. If HTTPS was configured as the protocol, then the user needs to configure at least the keystore in the tls:context child element of this listener-config.

HTTP

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Client Id

String

The OAuth client ID as registered with the service provider

x

Client Secret

String

The OAuth client secret as registered with the service provider

x

Token Url

String

The service provider’s token endpoint URL

https://{host-name}/{oauth-service}/{generate-token-resource}

Scopes

String

The OAuth scopes requested during the dance. If not provided, it defaults to those in the annotation.

Object Store

String

A reference to the object store used to store each resource owner ID’s data. If not specified, the default one is provisioned automatically by Mule.

Supported Operations

Operations

Invoke

<s4hana-soap:invoke>

Consumes an operation from an S/4HANA SOAP Web Service.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component

x

Service name

String

Name of the service

x

Operation name

String

The operation name of the service

x

Message

Binary

The content of the message.

#[payload]

Connection timeout

Number

Connection timeout for the request

Connection Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit to use in the Timeout configurations

Custom HTTP headers

Object

Custom headers that the request will include. The headers specified here will be merged with the default headers specified in the configuration.

Custom query parameters

Object

Custom query parameters that the request will include. The query parameters specified here will be merged with the default query parameters specified in the config.

Target Variable

String

The name of a variable in which to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors

Output

Type

SOAP Output Envelope

Attributes Type

For Configurations

Throws

  • S4HANA-SOAP:CONNECTIVITY

  • S4HANA-SOAP:PROCESSING_ERROR

  • S4HANA-SOAP:RETRY_EXHAUSTED

Unauthorize

<s4hana-soap:unauthorize>

Deletes all the access token information of a given resource owner ID so that it’s impossible to execute any operation for that user without repeating the authorization dance.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component

x

For Configurations

Types

Proxy Configuration

Field Type Description Default Value Required

Host

String

Host where the proxy requests is sent

x

Port

Number

Port where the proxy requests is sent

x

Username

String

The username to authenticate against the proxy

Password

String

The password to authenticate against the proxy

Non Proxy Hosts

Array of String

A list of hosts against which the proxy should not be used

Ntlm Domain

String

The domain to authenticate against the proxy

TLS

Field Type Description Default Value Required

Enabled Protocols

String

A comma-separated list of protocols enabled for this context

Enabled Cipher Suites

String

A comma-separated list of cipher suites enabled for this context

Trust Store

Key Store

Revocation Check

Truststore

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system if possible) of the truststore

Password

String

The password used to protect the truststore

Type

String

The type of store used

Algorithm

String

The algorithm used by the truststore

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

Keystore

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system if possible) of the keystore.

Type

String

The type of store used.

Alias

String

When the keystore contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the keystore.

Algorithm

String

The algorithm used by the keystore.

Standard Revocation Check

Field Type Description Default Value Required

Only End Entities

Boolean

Only verify the last element of the certificate chain

Prefer Crls

Boolean

Try CRL instead of OCSP first

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before)

Soft Fail

Boolean

Avoid verification failure when the revocation server can not be reached or is busy

Custom OCSP Responder

Field Type Description Default Value Required

Url

String

The URL of the OCSP responder

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the truststore) if present

CRL File

Field Type Description Default Value Required

Path

String

The path to the CRL file

Reconnection

Field Type Description Default Value Required

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

The reconnection strategy to use.

Reconnect

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect

Blocking

Boolean

If false, the reconnection strategy will run in a separate, non-blocking thread

Count

Number

How many reconnection attempts to make

Reconnect Forever

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect

Blocking

Boolean

If false, the reconnection strategy will run in a separate, non-blocking thread

Expiration Policy

Field Type Description Default Value Required

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance can be idle before it’s considered eligible for expiration

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the maxIdleTime attribute

SOAP Output Envelope

Field Type Description Default Value Required

Attachments

Object

Body

Binary

Headers

Object

SOAP Attributes

Field Type Description Default Value Required

Transport Additional Data

Object

Transport Headers

Object