tSAPADSOInput Standard properties

Property Type

Either Built-In or Repository.

• Built-In: No property data stored centrally.

• Repository: Select the repository file where the properties are stored.

Connection type

Host

The IP address or hostname of the database.

This option is available when Hana JDBC is selected from the Connection type drop-down list.

Port

The listening port number of the database.

This option is available when Hana JDBC is selected from the Connection type drop-down list.

Table Schema

The table schema name.

This option is available when Hana JDBC is selected from the Connection type drop-down list.

Username and Password

The database user authentication data.

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.

These two options are available when Hana JDBC is selected from the Connection type drop-down list.

A schema is a row description. It defines the number of fields (columns) to be processed and passed on to the next component. When you create a Spark Job, avoid the reserved word line when naming the fields.

• Built-In: You create and store the schema locally for this component only.

• Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs.

Click Edit schema to make changes to the schema. If you make changes, the schema automatically becomes built-in.

• View schema: choose this option to view the schema only.

• Change to built-in property: choose this option to change the schema to Built-in for local changes.

• Update repository connection: choose this option to change the schema stored in the repository and decide whether to propagate the changes to all the Jobs upon completion.

  If you just want to propagate the changes to the current Job, you can select No upon completion and choose this schema metadata again in the Repository Content window.

Name

Enter the name of the active Advanced Data Store Object from which data will be retrieved.

This option is available when Hana JDBC is selected from the Connection type drop-down list.

Use an existing connection

Select this check box and from the Connection configuration drop-down list displayed, select the component in which the relevant reused database connection is configured.

When a Job contains a parent Job and a child Job, the list displayed presents only the connection components in the same Job level.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Server Type

Select the type of the SAP server to be connected, either Application Server or Message Server.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Client

The SAP system client ID.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

UserId and Password

The user connection ID and password.

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.

These two options are available when SAP JCO 3 is selected from the Connection type drop-down list.

Language

The language of the SAP system.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Host name

The name or IP address of the host on which the SAP server is running.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

System number

The SAP system number.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list and Application Server is selected from the Server Type drop-down list.

System ID

The SAP system ID.

This field is available when SAP JCO 3 is selected from the Connection type drop-down list and Message Server is selected from the Server Type drop-down list.

Group Name

The SAP group name.

This field is available when SAP JCO 3 is selected from the Connection type drop-down list and Message Server is selected from the Server Type drop-down list.

Service name

The name of the operational delta queue.

For more information, see Introduction to Operational Delta Queues.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Subscriber name

The name of the subscriber that consumes data from SAP.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Subscriber process name

The name of the subscriber process.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Execute a full extraction

Select this check box to perform a full extraction to retrieve all data from an SAP system. By default, this check box is cleared and a delta extraction will be performed to retrieve only changed data.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Reset subscriber

Select this check box to reset the subscriber to make an initial load.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Selection Group

Specify the search condition(s) used to filter data to be retrieved by clicking the [+] button to add as many rows as needed, each row for a search condition, and set the value of the following attributes for each condition.

• Column: enter the name of the schema column based on which retrieved data will be filtered.

• Sign: select either Include or Exclude from the drop-down list.

  • Include: the data that meets the condition will be retrieved.

  • Exclude: the data that doesn't meet the condition will be retrieved.

• Operator: select from the drop-down list the data filter operator used to build the search condition.

• Value: specify the search value used to build the search condition. Note that wildcard characters are not supported.

• High value: specify another search value used to build the search condition for the Between operator.

  When using a column of Date type to specify a filter, the date and time values in the Value and High Value columns should be in the format yyyyMMdd and HHMMSS, which might be different from the format defined in the schema editor. Note that wildcard characters are not supported.

This table is available when SAP JCO 3 is selected from the Connection type drop-down list.

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.

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

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

Additional JDBC Parameters

Enter additional JDBC parameters in the format of parameterName1=value1&parameterName2=value2&.... This field allows you to provide metadata for Advanced DataStore Objects.

This option is available when you select Hana JDBC from the Connection type drop-down list.

Fetch size

Enter the maximum size of the resultset (in number of rows) that can be returned from the SAP BW database in response to a BAPI call or a request.

A value of -1, the default, uses the default fetch size, which is determined by the Java code or the BAPI on SAP side.

It is recommended to set this field according to the memory space allocated to your Job and the number of fields requested. With a given memory space, the more fields requested, the smaller the fetch size.

This option is available when SAP JCO 3 is selected from the Connection type drop-down list.

SAP Properties

This table is available when SAP JCO 3 is selected from the Connection type drop-down list and the Use an existing connection check box is not selected in the Basic settings view.

tStatCatcher Statistics

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

ERROR_MESSAGE

The error message generated by the component when an error occurs. This is an After variable and it returns a string.

Usage rule

This component is usually used as a start component of a Job or subJob and it always needs an output link.