July 30, 2023

tSAPConnection – Docs for ESB 7.x


Commits a whole Job data in one go to the SAP system as one

tSAPConnection opens a connection
to the SAP system for the current transaction.

tSAPConnection Standard properties

These properties are used to configure tSAPConnection running in
the Standard Job framework.

The Standard
tSAPConnection component belongs to the Business family.

The component in this framework is available in all Talend

Basic settings

Property type

Either Built-in or


Built-in: No property data is stored


Repository: Select the Repository file
where Properties are stored. The fields that follow are pre-filled in using
fetched data.

SAP API Version

Select a version from the drop-down list:

  • talend sap api: a custom business layer above the
    SAP JCO driver.
  • sap jco 3.*: a driver that enables the Studio to
    communicate with the SAP system through SAP’s RFC protocol.

Note that the opened SAP connection can be reused by
tSAPBapi and tSAPTableInput
only if talend sap api is selected.

Connection configuration

Client type: enter your usual SAP

Userid : enter user login.

Password: enter password.

Language: specify the language.

Host name: enter the IP address of the
SAP system.

System number: enter the system

To enter the password, click the […] button next to the
password field, and then in the pop-up dialog box enter the password between double quotes
and click OK to save the settings.

Specify a shared destination

Select this check box and specify the shared destination in the
Shared destination name field
displayed. The shared destination allows the SAP components to use the
shared destination on the Talend Runtime when they are executed as part of
an ESB Route or ESB Data Service within the Talend Runtime
container OSGi Environment.

This option is available only when you select sap jco
from the SAP API Version
drop-down list.

Besides specifying the shared destination name in the component,
you also need to setup the SAP DataSource for the Talend Runtime.
What you need to do to define the SAP DataSource and how to configure it are
described in the readme.txt provided in the Talend ESB
package within the /add-ons/datasource/sap folder.

Note that if you use the component’s own connection configuration,
your SAP connection will be closed at the end of the component. To prevent
this from happening, use a shared destination with its name specified.

SAP Properties

If you need to use custom configuration for the SAP system
being used, complete this table with the property or properties to be
customized. For example,

  • if you need to establish a Unicode connection between
    the SAP system and the
    Talend Studio
    , you have to add the jco.server.unicode
    property and set its value to 1.

  • if you need to set up an SAP connection with Secure
    Network Communications (SNC), you have to add the SNC parameters and
    set their values in this table. For more information about setting the
    SNC parameters, see SAP documentation.

Advanced settings

ftp and http based programs

To invoke from the SAP server a function which requires
document downloading, select this check box and make sure that SAPGUI has been
installed with the SAP system.

If this check box is selected but SAPGUI has not been
installed, errors will occur.

This check box will not be available if you select Use an existing connection check box in the
Basic settings tab.

Catcher Statistics

Select this check box to collect log data at the component

Global Variables

Global Variables

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
to access the variable list and choose the variable to use from it.

For further information about variables, see
Talend Studio

User Guide.


Usage rule

This component is more commonly used with other tSAP*
components, especially with the tSAPCommit and tSAPRollback components.


tSAPConnection should be used to interact with the ERP part
of SAP, including S4/HANA.


Specific jar and dll files provided by SAP must be added to your
Studio and the workstation hosting your Studio. The exact procedure varies
among platforms such as 32-bit or 64-bit Windows or Linux.

  • You can find an example of how to install SAP Java connectors in
    Talend Help Center (https://help.talend.com) and the “Centralizing SAP
    metadata” section in Talend Studio User Guide.

Related scenarios

No scenario is available for the Standard version of this component yet.

Document get from Talend https://help.talend.com
Thank you for watching.
Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x