tSAPIDocReceiver Standard properties - 7.3

SAP

Version
7.3
Language
English
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
Data Governance > Third-party systems > Business applications > SAP components
Data Quality and Preparation > Third-party systems > Business applications > SAP components
Design and Development > Third-party systems > Business applications > SAP components
Last publication date
2024-02-21

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

The Standard tSAPIDocReceiver component belongs to the Business family.

This component is available in Talend Data Management Platform, Talend Big Data Platform, Talend Real Time Big Data Platform, Talend Data Services Platform, Talend MDM Platform and Talend Data Fabric.

Basic settings

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.
Note: This option is available only if you have installed the R2021-01 Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

Talend SAP RFC Server host

Enter the IP address of the Talend SAP RFC server, or localhost if it is installed on your local machine.

Port

Enter the port used by the Talend SAP RFC server.

User

Enter a valid username used to connect to the Talend SAP RFC server.

Password

Enter the password that corresponds to the username provided in the previous field.

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.

Use SSL Transport

Select this check box to use the SSL transport mechanism. For more information about SSL transport, see SSL Transport Reference.

The component is linked to tHMap

Select this check box if the Job contains a tHMap component to be used by the tSAPIDocReceiver component to define its structure and then, in the Mapping list drop-down list, select the name of the component in question.

If the tSAPIDocReceiver component does not use a tHMap component to define its structure, specify the IDoc type in the IDoc type field between double quotes instead.

Mode

Select Keep running forever if you want the component to keep listening for new IDocs until you stop the execution of the Job.

Select Batch (consume all IDocs available and terminate) if you want the Job to stop automatically once all the IDocs available are consumed. If you select Batch mode, you can also specify the sleeping time, in seconds, which corresponds to the time the process will wait for the first message to be read.

Maximum duration (seconds)

If you select this check box, you can specify the period of time (in seconds) for which the Job should continue to consume any IDocs sent by the RFC Server. Once this time limit is reached, the Job stops consuming and closes the connection to the RFC server.

Maximum number of IDocs to consume

If you select this check box, you can specify the maximum number of IDocs to be consumed by the Job. Once this limit is reached, the Job stops consuming and closes the connection to the RFC server.

Advanced settings

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a Job level as well as at each component level.

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 + 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

Usage rule

Once executed, this component keeps listening for new IDocs (at least until it reaches the maximum duration or maximum number of IDocs to consume) and sends them downstream to the next component, unless an exception occurs or you stop the execution.

Connections

Outgoing links (from this component to another):

Row: Main, Iterate.

Trigger: On Subjob Ok, On Subjob Error, Run if, On Component Ok, On Component Error.

For further information regarding connections, see Talend Studio User Guide.

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.
  • For more information, see How to install the SAP Java Connector and the "Centralizing SAP metadata" section in Talend Studio User Guide.

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

To use this component, you must have already installed and configured a Talend SAP RFC server.