# tSAPDataSourceReceiver

Retrieves data requests stored on the Talend SAP RFC Server and related to a specific Data Source system.

tSAPDataSourceReceiver connects to the Talend SAP RFC Server, which acts as a bridge between Talend Studio and an SAP server, and retrieves data requests stored on the RFC server and related to a specific Data Source system, then the data requests can be processed later on by Talend Job to retrieve data from the Data Source system.

## tSAPDataSourceReceiver Standard properties

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

The Standard tSAPDataSourceReceiver component belongs to the Business family.

The component in this framework is available in all subscription-based Talend products.

## Basic settings

| Properties | Description |
| --- | --- |
| Failover | Select this option to use the RFC server failover feature. The RFC server failover feature is implemented by deploying brokers using the rfc.server.remote.broker.url parameter in *Remote broker section* of the tsap-rfc-server.properties file. After selecting this option, you need to provide the IP addresses and the port numbers of the brokers in the Host and Port columns in the table that appears. You can find the IP addresses and the port numbers of the brokers by checking the rfc.server.remote.broker.url parameter in *Remote broker section* of the tsap-rfc-server.properties file. See *Configuring the tsap-rfc-server.properties file* for related information. |
| Talend SAP RFC Server host | Enter the IP address of the Talend SAP RFC Server, or<br>localhost if it is installed on your local machine. |
| Port | Enter the port used by the Talend SAP RFC Server. |
| User and Password | Enter the username and password used to connect to the Talend SAP RFC Server.<br><br>To enter the password, click the [...] button<br>next to the password field, enter the password in double quotes in the pop-up dialog box,<br>and click OK to save the settings. |
| Use SSL Transport | Select this check box to use the SSL transport mechanism. For more information about SSL transport, see [SSL Transport Reference](http://activemq.apache.org/ssl-transport-reference.html). |
| Datasource name | Specify the name of the Data Source system. |
| Mode | Select one of the following modes for using this component from the<br>drop-down list.<br><br><ul> <li> <div> <span>Keep running forever</span>:										Select this mode if you want this component to keep										listening for the coming data requests until you stop the										execution of the Job. With this mode selected, you can also										specify the following two properties:<ul> <li> <p> <span>Maximum duration												(seconds)</span>: Specify the period of time												(in seconds) for which the Job should continue to												consume any data requests on the RFC Server. Once												this time limit is reached, the Job stops												consuming and closes the connection to the RFC												Server.</p> </li> <li> <p> <span>Maximum number of data												to consume</span>: Specify the maximum number												of data requests to be consumed by the Job. Once												this limit is reached, the Job stops consuming and												closes the connection to the RFC Server.</p> </li> </ul> </div> </li> <li> <p> <span>Batch (consume all data available											then terminate)</span>: Select this mode if you want										the Job to stop automatically once all data requests										available on the RFC server are consumed. With this mode										selected, you can also specify in the <span>Sleep time (seconds)</span> field the sleeping										time, in seconds, which corresponds to the time the process										will wait for the first message to be read.</p> </li> </ul> |
| Queue/Topic name prefix | Enter the prefix for the JMS queue or topic name used to receive BW Datasource<br>messages from the RFC Server. The value must match the<br>jms.datasource.queue.prefix property set in the<br>tsap-rfc-server.properties file. The default value is<br>TALEND.DATASOURCES.<br><br>This field is available from the 8.0.1-R2026-08 monthly release. To use this<br>feature, both Talend Studio and Talend SAP RFC Server must be updated to R2026-08 or later. |
| Schema and Edit schema | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br><ul> <li> <p> <span>Built-In</span>: You create and store the schema locally for this component                only.</p> </li> <li> <p> <span>Repository</span>: You have already created the schema and stored it in the                Repository. You can reuse it in various projects and Job designs.</p> </li> </ul><br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher Statistics | Select this checkbox to gather the Job processing metadata at the Job level<br>as well as at each component level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<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 variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is usually used as a start component of a Job or<br>subJob and it always needs an output link. |
| Limitation | Specific JAR and DLL files provided by SAP must be added to Talend Studio<br>and the workstation hosting Talend Studio.<br>The exact procedure varies among platforms such as 32-bit or 64-bit Windows or<br>Linux.<br><br><ul> <li> <p>For more information, see <a href="https://help.qlik.com/talend/r/en-US/8.0/components/sap/installing-sap-jco">How to install the SAP Java                              Connector</a> and <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/centralizing-sap-metadata" target="_blank">Centralizing SAP metadata</a>.</p> </li> </ul> |

**Related concepts**

* [Consuming Data Source objects using SSL Transport](https://help.qlik.com/talend/en-US/components/8.0/sap/tsapdatasourcereceiver-tsetkeystore-tlogrow-tlogrow-consuming-data-source-objects-using-ssl-transport-standard-component-enterprise-the)