tSAPDSOOutput - 6.3

Talend Components Reference Guide

EnrichVersion
6.3
EnrichProdName
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 Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for Data Quality
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
task
Data Governance
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

Function

tSAPDSOOutput creates or updates DSO (Data Store Objects) data in an SAP BW table.

Purpose

tSAPDSOOutput allows you to create or update DSO data in an SAP BW table.

tSAPDSOOutput properties

Component family

Business/SAP

Basic settings

Property Type

Either Built-In or Repository.

  • Built-In: No property data stored centrally.

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

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

 

Use an existing connection

Select this check box and from the list displayed select the relevant connection component to reuse the connection details you have already defined.

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

Connection configuration

Server Type

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

 

Client

Specify the SAP system client ID.

 

UserId and Password

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

 

Language

Specify the language of the SAP system.

 

Host name

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

 

System number

Enter the system number.

This field is available only when Application Server is selected from the Server Type drop-down list.

 

System ID

Enter the system ID.

This field is available only when Message Server is selected from the Server Type drop-down list.

 

Group Name

Enter the group name.

This field is available only when Message Server is selected from the Server Type drop-down list.

Schema

Schema and Edit schema

A schema is a row description. It defines the number of fields (columns) to be processed and passed on to the next component. The schema is either Built-In or stored remotely in the Repository.

  • Built-In: You create and store the schema locally for this component only. Related topic: see Talend Studio User Guide.

  • Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs. Related topic: see Talend Studio User Guide.

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

 

 

Click Edit schema to make changes to the schema. If the current schema is of the Repository type, three options are available:

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

Table configuration

Table

Enter the name of the table into which the data will be written.

 

Action on data

On the data of the table defined, you can perform one of the following operations:

  • Insert: Create new DSO records.

  • Update: Update existing DSO records.

  • Upsert: Update existing DSO record with the given reference. If the DSO record does not exist, a new DSO record will be inserted.

Shared destination

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 tSAP* 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 within the /add-ons/datasource/sap folder.

Warning

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.

Advanced settings

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,

This table is not visible when the Use an existing connection check box is selected.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at the Job level as well as at each 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 usually used as an end component of a Job or Subjob and it always needs an input link.

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 the article How to install the SAP Java Connector on Talend Help Center (https://help.talend.com) and the Centralizing SAP metadata section in Talend Studio User Guide.

Due to SAP BW restrictions, currently only the transactional DSOs can be created or updated with this component.

Related scenario

No scenario is available for this component yet.