tSAPConnection – Docs for ESB 5.x

Component family

Business

Function

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

Purpose

tSAPConnection allows to commit a
whole Job data in one go to the SAP system as one
transaction.

Basic settings

Property type

Either Built-in or Repository.

Since version 5.6, both the Built-In mode and the Repository mode are
available in any of the Talend solutions.

Built-in: No property data is
stored centrally.

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

SAP JCO Version

Select an SAP Java Connector version from the drop-down list:
talend sap api, sap jco 2.*, or sap
jco 3.*.

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
connection.

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
number.

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 then specify the shared destination in the Shared destination name field. The Shared
destination name allows the tSAPxxx components to use 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 3.*
from the SAP JCO 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.

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,

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.

tStatCatcher Statistics

Select this check box to collect log data at the component
level.

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 +
Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio
User Guide.

Usage

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

Limitation

n/a