ITN ERP Connector for Pentaho Data Integration (Kettle) Contents. 1. Introduction

Transcription

1 ITN ERP Connector for Pentaho Data Integration (Kettle) Draft documentation Version 1 Contents 1. Introduction 1 2. Installation Functionality and Screenshots Setup connection to SAP and select SAP table Select exported fields Where options Other functionality Example Introduction The ITN ERP Connector is a commercial open source Business Intelligence (BI) interface between SAP and Open Source Business Intelligence platform Pentaho Data Integration (PDI) aka Kettle. ITN ERP Connector provides PDI users with flexible and efficient tool for connecting to their SAP database and exporting tables content into open source environment (Fig. 1). Fig.1. ITN ERP Interface between SAP System and PDI ITN ERP Connector supports implementation of different business tasks with SAP data: both standardized performance measurement systems and ad-hoc analysis based on the integrated business data. Thus controlling and management departments have a professional open source tool for corporate management. This document describes the functionality of ITN ERP Connector. In the next sections we present installation procedure, screen shots of step-by-step PDI Input and finally small complete working example. In case of further questions, functionality requests, exceptions or error messages please send an to Evgenia Egorova at business-intelligence@it-novum.de. ITN ERP Connector for Pentaho Data Integration (Kettle) 3.2 can be downloaded from our internet home page, it-novum 1/6

2 2. Installation SAP JCo3 This Input plugin is using SAP JCo connector. You find it on the SAP service marketplace To download the software you have to have a valid user. After unpacking archive with SAP JCo3 file sapjco3.jar should be copied into folder <dataintegration\libext> and file sapjco3.dll in <data-integration\libswt\win32> ITN ERP Connector Plugin Archive file "ITNERPConn.zip should be unpacked into folder <data-integration\plugins\steps>. After unzipping, plugin folder < ITNERPConnection> should contain 3 files: itnlogo.gif ITNERPConnector.jar plugin.xml 3. Functionality and Screenshots After successful installation of SAP JCo and ITN ERP Connector open PDI (Spoon). The ITN ERP Connector should appear in the Input section. Drug-n-drop it to the new Transformation window, Fig. 2. The sequence of the steps to setup ITN ERP Connector Input is following: 1. Enter new connection to SAP R/3 System using your settings, Fig Enter table name, Fig You can filter exported fields by pressing 'Select fields' button, Fig. 8. Results of the selection are shown in Fig Finally it is possible to filter data by entering SQL data filter in the Where condition field, Fig Setup connection to SAP and select SAP table Fig. 2. Drug-n-drop ITN ERP Connector to the new Transformation window Fig. 3.Setup new connection to SAP (or choose existing one from the list) Figs. 4, 5, 7 show the error messages in the language of the SAP System it-novum 2/6

3 Fig. 4. SAP Client, user name or password are wrong Fig. 5. Such table does not exists Fig. 6. Correct table name. But it will be verified when you try to execute the transformation or when you select fields. Fig. 7. Your account was probably blocked due to many login errors. You have to contact your SAP responsible Select exported fields Fig. 9. You can see the fields to extract but to modify the list you have to press the Select fields button Fig. 8.Selection of exported fields. If you choose none of the fields, is the same, as if you have chosen all the fields to extract Where options There is an option to filter extracted data by specifying SQL WHERE data filter. Values should be given in single quotes ' '. You can use () to separate AND and OR options it-novum 3/6

4 Fig. 10. SQL request Example 1: NAME = 'Leonardo' AND SURNAME = 'da Vinci' Example 2: CODE = '001' OR PRICE > '1000' Example 3: (CODE = '001' OR CODE = '005') AND PRICE >= '1000' Example 4 (only 2005): DATE LIKE '2005%' Example 5 (only February for all years): DATE LIKE ' 02%' In the last example year is substituted by 4 underscore _ signs, where SAP 'Year' format is 'YYYYMMDD' Other functionality There is a short Help window with reminder of the steps and Where field format, Fig. 11. Besides there is Log.. button, which opens a text log file with history of all transformation made for current connection, Fig. 13. Fig. 12. Log file is created at the first attempt to lunch the transformation. Fig. 13. Log file contains information about all transformations that were performed, including the unsuccessful ones. Fig. 11. Help 2010 it-novum 4/6

5 4. Example: ITN ERP Connector in the example transformation 1. Setup connection to SAP sflight table 2. Rename exported values 3. Sort data using currency field 4. Include Excel file with conversion rates 2010 it-novum 5/6

6 5. Use INNER Join to merge SAP data and Excel table 6. Calculator 7. Result: transformation flow and output table 2010 it-novum 6/6