Scenario: Consuming IDocs for processing by tHMap - 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

The following scenario creates a three-component Job that connects to a Talend SAP RFC server, in order to consume IDocs for processing by tHMap.

Note that the tHMap component is only available in the Palette of Talend Studio if you have subscribed to one of the Talend Platform products.

Also note that the tSAPIDocReceiver component can be linked directly to a tHMap component via a Row > Main connection. However, this does not work when your Job is deployed on a Job Server. In this case, you need to link the tSAPIDocReceiver component first to a tFlowToIterate component via a Row > Main connection, then the tFlowToIterate component to a tFixedFlowInput component via a Row > Iterate connection, finally the tFixedFlowInput component to the tHMap component via a Row > Main connection, and the Job will look like below.

Prerequisites:

  • The SAP server needs to be configured to operate with Talend SAP RFC Server. For more information, see the documentation related to how to configure SAP to operate with the Talend SAP RFC Server on Talend Help Center.

  • Talend SAP RFC Server needs to be installed, configured and running to receive IDocs from the SAP server. For more information, see the section Installing and configuring Talend SAP RFC Server in Talend Installation Guide.

Creating an SAP connection and importing the IDoc structures

  1. In the Integration perspective, in the Repository view, expand Metadata, right-click SAP Connections and then, in the contextual menu, click Create SAP connection. The [SAP Connection] wizard opens.

  2. Enter a name for your connection in the Name field, for instance SAPServerConnection, and then click Next.

  3. In the next screen of the wizard, enter the appropriate connection parameters to connect to your SAP server, and then click Finish to create the connection.

    If you do not have this information, contact the administrator of your SAP server for help.

  4. In the Repository view, under Metadata, expand SAP Connections, right-click the connection you just created and then, in the contextual menu, select Import Data Mapper IDoc Structures.

  5. In the [Search SAP for IDoc types] wizard that opens, enter some search criteria to reduce the number of results returned or leave all fields blank to return all available IDocs, and then click Search.

  6. Select the structure or structures you want to import, and then click Next.

  7. Enter IDocs in the Structure name field to import the structure into a folder called IDocs, and then click Next and then Finish to complete the import process.

Adding and linking the components

  1. In the Integration perspective, create a new Job and call it idoc_job.

  2. Click the point in the design workspace where you want to add the first component, start typing tSAPIDocReceiver, and then click the name of the component when it appears in the list proposed in order to select it.

  3. Do the same to add a tHMap component and a tLogRow component as well.

  4. Connect the tSAPIDocReceiver component to the tHMap component using a Row > Main link, then connect the tHMap component to the tLogRow component using a Row > Main link.

Defining the properties of tSAPIDocReceiver

  1. Select the tSAPIDocReceiver component to define its properties.

  2. If Talend SAP RFC Server is installed on your local machine, leave all the default settings unchanged.

    Otherwise, enter the IP address of Talend SAP RFC Server in the Talend RFC Server host field and update the Port, User and Password fields if necessary. Leave all the other settings unchanged.

Defining the properties of tHMap

  1. Select the tHMap component to define its properties.

  2. Click the Sync columns button to synchronise the schema between the different components of your Job.

  3. Click the [...] button next to the Open Map Editor field to create a new map.

  4. In the [tHMap Structure Generate/Select] dialog box that opens, select Select an existing hierarchical mapper structure for the input structure, and then click Next.

  5. Select the IDoc structure that you imported earlier, and then click Next and then Finish.

  6. Do the same for the output structure, again selecting the IDoc structure that you imported earlier, and then click Next and then Finish.

  7. In the Mapping perspective that opens, in the Data Mapper view, expand Hierarchical Mapper, Maps, Jobs and then idoc_job, and then right-click the tHMap_1 map and select Properties in the contextual menu.

  8. Click the [...] button next to the Output Representation field, select XML in the dialog box that opens, click OK, and then click OK again to close the [Properties] dialog box.

  9. In the map, drag the root element from the Input (Flat) side to its corresponding root element on the Output (XML) side to create a simple map in which the input file will be transformed into an XML file on output.

  10. Press Ctrl+S to save your changes to the map.

  11. Switch back to the Integration perspective to complete the settings for the tHMap component in your Job.

  12. Set Read Input As to Single column.

  13. Set Write Output As to String (single column).

Saving and executing the Job

  1. Press Ctrl+S to save your Job.

  2. In the Run tab, click Run to execute the Job.

    In the Console, the Job will display an XML version of your IDoc documents when it runs successfully.