# 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 products.

Information noteNote: When prompted that this component requires sapjco.jar, download and install the module as prompted.

## Basic settings

| Property type | Either Built-in or<br>Repository. |
| --- | --- |
|  | Built-in: No property data is stored<br>centrally. |
|  | Repository: Select the Repository file<br>where Properties are stored. The fields that follow are pre-filled in using<br>fetched data. |
| SAP API Version | Select a version from the drop-down list:<br><br><ul> <li> <span>talend sap api</span>: a custom business layer above the                           SAP JCO driver.</li> <li> <span>sap jco 3.*</span>: a driver that enables the Studio to                           communicate with the SAP system through SAP's RFC protocol.</li> </ul><br><br>Note that the opened SAP connection can be reused by<br>tSAPBapi and tSAPTableInput<br>only if talend sap api is selected. |
| Connection configuration | Client type: enter your usual SAP<br>connection.<br><br><br>Userid : enter user login.<br><br><br>Password: enter password.<br><br><br>Language: specify the language.<br><br><br>Host name: enter the IP address of the<br>SAP system.<br><br><br>System number: enter the system<br>number.<br><br>To enter the password, click the [...] button next to the<br>password field, and then in the pop-up dialog box enter the password between double quotes<br>and click OK to save the settings. |
| Specify a shared destination | Select this check box and specify the shared destination in the<br>Shared destination name field<br>displayed. The shared destination allows the SAP components to use the<br>shared destination on the Talend Runtime when they are executed as part of<br>an ESB Route or ESB Data Service within the Talend Runtime<br>container OSGi Environment.<br><br>This option is available only when you select sap jco<br>3.\* from the SAP API Version<br>drop-down list.<br><br>Besides specifying the shared destination name in the component,<br>you also need to setup the SAP DataSource for the Talend Runtime.<br>What you need to do to define the SAP DataSource and how to configure it are<br>described in the readme.txt provided in the Talend ESB<br>package within the /add-ons/datasource/sap folder.<br><br>Note that if you use the component's own connection configuration,<br>your SAP connection will be closed at the end of the component. To prevent<br>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,<br><br><ul> <li> <p>to establish a Unicode connection between the SAP system and <span>Talend Studio</span>, you need to add the property <kbd>jco.server.unicode</kbd> and set its value to <kbd>1</kbd>. Note that this property works if you are using SAP Java Connector 2.x and is unnecessary for SAP Java Connector 3.0 and higher versions. </p> </li> <li> <p>to set up an SAP connection with Secure Network Communications (SNC), you need to add and set the following properties in this field.</p> <ul> <li> <span>jco.client.snc_mode</span> </li> <li> <span>jco.client.snc_myname</span> </li> <li> <span>jco.client.snc_lib=.../sapcrypto/sapcrypto.dll</span> </li> <li> <span>jco.client.snc_partnername</span> </li> <li> <span>jco.client.snc_qop</span> </li> </ul> <div><span>Information note</span><span>Note:</span>  The values of the above properties vary with the system environment. Contact your SAP system administrator if you are not sure how to set the properties.</div> <p>For more information about setting the SNC parameters, see <a href="https://help.sap.com/viewer/10977ac76c531014a966b3f130d4f853/7.0.36/en-US/d9e8a740bbaa4d8f8bee6f7b173bd99f.html" target="_blank">Configuring SNC: External Programs to AS ABAP Using RFC</a> and <a href="https://help.sap.com/viewer/10977ac76c531014a966b3f130d4f853/7.0.36/en-US/76128150317a47b6a326e63a17017729.html" target="_blank">Communication Paths that Support SNC</a>.</p> </li> </ul><br><br>This property is not visible when the Use an existing connection check box is selected. |

## Advanced settings

| ftp and http based programs | To invoke from the SAP server a function which requires<br>document downloading, select this check box and make sure that SAPGUI has been<br>installed with the SAP system.<br><br>If this check box is selected but SAPGUI has not been<br>installed, errors will occur.<br><br>This check box will not be available if you select Use an existing connection check box in the<br>Basic settings tab. |
| --- | --- |
| tStat<br>Catcher Statistics | Select this check box to collect log data at the component<br>level. |

## Global Variables

| Global Variables | ERROR\_MESSAGE: the error message generated by the component when an<br>error occurs. This is an After variable and it returns a string. This variable functions<br>only if the Die on error check box<br>is cleared, if the component has this check<br>box.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a<br>variable, press Ctrl + Space to<br>access the variable list and choose the variable to use from it.<br><br>For further information about variables, see *Talend Studio*<br>*User Guide*. |
| --- | --- |

## Usage

| **Usage rule** | This component is more commonly used with other tSAP\*<br>components, especially with the tSAPCommit and tSAPRollback components. |
| --- | --- |
| **Support** | tSAPConnection should be used to interact with the ERP part<br>of SAP, including S4/HANA. |
| Limitation | 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.<br><br><ul> <li> <p>For more information, see <cite>How to install the SAP Java Connector</cite> and the "Centralizing SAP metadata" section in <cite> <span>Talend Studio</span> User Guide</cite>.</p> </li> <li> <p>You can find an example of how to install SAP Java connectors in <span>Talend Help Center</span> (<a href="https://help.talend.com/" target="_blank">https://help.talend.com</a>) and the "Centralizing SAP metadata" section in <span>Talend Studio</span> User Guide.</p> </li> </ul> |