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.
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 |
|
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. |
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. |
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.
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.
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:
SAP Extensibility API | SAP Remote Function