You can integrate your OutSystems applications with an SAP system. To do it, create a connection to that SAP system and import the SAP remote functions you want to use. Learn how to establish a connection to SAP.

Properties

Property

Description

Optionality

Default value

Obs.

Name

Name of the SAP connection.

Mandatory

"SAPConnection<#connection>"

 

Description

Description of the SAP connection.

Optional

 

 

Icon

Icon of the SAP connection. Actions under this SAP connection are identified by this icon in flows.

Mandatory

Default icon for SAP connections

 

Default Connection Settings - Double-click the SAP connection to edit these settings.

Application Server

The hostname of the SAP application server where the remote function calls are executed.

N/A

N/A

 

System ID

The three-letter identifier of the SAP installation to connect to.

N/A

N/A

An SAP System is the biggest unit of installation of SAP, containing all the necessary software components.

Instance Number

The two-digit number of the SAP instance to connect to.

N/A

N/A

An instance is a group of resources: work processes, allocated memory, gateway, etc.

SAP Router String

The router string to connect to the SAP application server. Example: /H/sap.acme.com/S/3299/H

N/A

N/A

 

Client

The three-digit client number that identifies which tenant's data to use in the remote function calls.

N/A

N/A

 

Language

Two-letter language key used for translating language-specific data when retrieving data from SAP.

N/A

N/A

 

Username

The username to authenticate in SAP.

N/A

N/A

 

Advanced

Send Default Value

Indicates if the default value of an optional parameter is sent in case there is no value assigned to it.

Mandatory

No

 

Events

A connection allows you to define callback actions to customize the calls to SAP remote functions. Once defined, they are executed on every call to any SAP remote functions under the connection.

Callback

Description

OnBeforeConnection

This callback is executed right before establishing the connection.
Use it, for example, to customize the connection parameters.

OnBeforeCall

This callback is executed before calling any SAP remote function defined under this connection. Use it, for example, to customize the values that are sent.

OnAfterCall

This callback is executed after receiving a response from a call to any SAP remote function defined under this connection.
Use it, for example, to customize the values that are received.

To make any of these callbacks available, simply go to the SAP connection, and select the callback action in the corresponding property. Then, implement the logic using the SAP Extensibility API.

Remote Functions of a Connection

In the development environment, the imported SAP remote functions are available under an SAP connection as actions. They share the properties and the authentication method defined for the SAP connection.

If you want to use different credentials for some SAP remote functions, you can create a new connection.

Authentication

The default authentication mechanism is to use the credentials provided when defining the connection. This applies to all SAP remote functions defined under the SAP connection. These default values can be configured in the environment management console.

It is also possible to use dynamic login. For each SAP remote function call you define what credentials to use. To implement dynamic login, select 'Add Dynamic Login' from the context menu of the SAP connection.

You can also use SAP Extensibility API to implement other authentication methods. These include for example SAP Logon Tickets or certificates. This method uses the 'OnBeforeConnection' callback to customise the connection.

You can authenticate against your SAP System in one of the following ways:

See Also

SAP Extensibility API | SAP Remote Function