Xtract Report

This page shows how to use the Xtract Report component.
The Xtract Report component can be used to extract data from most standard and custom ABAP reports and SAP transactions. A report extraction is possible if the report returns a table-like structure in SAP.

About Reports

ABAP report programs extract and present huge amounts of data for SAP business applications. SAP offers predefined standard reports that cover the basic needs of customers. They can be executed via transaction codes.

Custom Reports

The extraction of custom reports (Z reports) is possible if the report returns a table-like structure in SAP. Issues specific to Z reports are not included in the scope of support provided by Theobald Software.

Prerequisites

• A connection to an SAP system is available, see SAP Connection.
• The SAP user has sufficient user rights, see SAP Authority Objects.
• The custom function module Z_XTRACT_IS_REMOTE_REPORT is installed in your SAP system, see Function Module for Reports. As of Z_XTRACT_IS_REMOTE_REPORT version 1.2 access to reports must be explicitly granted, see Knowledge BAse Article: Authorize Access to Specific Reports.
• The report must return a table-like structure in SAP.

General Workflow

The following graphic shows the general workflow of using the Xtract Report component:

Add an Xtract Report Component

Follow the steps below to add an Xtract Table component to your SSIS package:

1. Drag&drop the Xtract Report component from the SSIS toolbox into your data flow task.
   

2. Double-click the component. A connection manager is automatically assigned to the component and the main window of the component opens.

   Note

   If there are multiple connection managers, the window "Select Connection Manager" opens, see SAP Connection. Once a connection manager is selected, the main window of the component opens.

The majority of the functions of the component can be accessed in the main window.

Look up a Report or Transaction

1. In the main window of the component, click [ ]. The window “Report Lookup” opens.
   

2. In the field Report Name, enter the name of a report to extract . Use wildcards (), if needed. Alternatively, select TCODE* to look up SAP Transaction codes.
   
   

   Tip

   In some cases reports cannot be determined based on the TCODE. You can check the report name of a TCODE using the SAP GUI menu System > Status....

3. Click [ ] . Search results are displayed.

4. Select a report and click [OK] to confirm.

The application now returns to the main window of the component.

Define the Xtract Report Component

The Xtract Report component offers the following options for report extractions:

1. If the report has variants, select a variant from the drop-down-list Variant. For more information, see Choose a Variant.
   
2. In the section Selection Screen, edit a selection criterion you want to change or dynamize . For more information, see Edit Selections.
   
3. Optional: If your report has varying column widths, activate Dynamic column widths and offsets. The column widths and offsets are then adjusted dynamically at report runtime.
4. Click [Automatically detect columns] to execute the report based on the selected variant or selections and detect columns automatically.
   
5. Click [Load live preview] to display a live preview of the first 100 records.
6. Check if the automatically detected columns are accurate. When automatic column detection is not possible, the column names, widths and offsets must be set manually, see Define Columns manually.
7. Check the Settings before running the SSIS package.
8. Click [OK] to save the component.

You can now run the SSIS package.

Related Links

• SAP Wiki: Types of ABAP Reports
• Knowledge Base Article: Authorize Access to Specific Reports