A1.

4 - Transformation
Level Topic
A1 (Basic One) This tutorial describes the fundamentals for executing transformations.
Transformation Cockpit is a user interface which enables TC-expert to execute
export and import for a migration according to assigned rules.
Keys
Transformation, export,
import, forerunner
Content
Estimated time:
• Export blocks
1h • Forerunners
• Imports
TC release:
XX.XX SPXX Goals

SNP provides certain environment for carve outs and fusions that use SNP
Related JIRA tests:
Transformation Cockpit. The transformation cockpit will be used for exporting
..., ... the selected data from source system as compressed files to the file system.
The data will be transferred later regards defined import rules to target system.
The data transfer by import happens on a database table transfer level per
Last changes: database direct update.

29-Jan-18 Prerequisites:

• Modules, data objects and tables have been created

• The source and target systems have been assigned
• The correct export directory for the scenario has been defined (please make
sure that the import directory refers to the same directory)

Nice to have:

• All previous tutorials of this level.

Necessary tutorials to complete beforehand:

• All previous tutorials of this level.

Following Tutorials can be recommended afterwards:

• All remaining tutorials of this level.

Level: A1 (Basic One) Seite 1

Topics:
Export Blocks ....................................................................................................................................................... 1
Creating Export Blocks .................................................................................................................................... 1
Editing the Properties of Export Blocks............................................................................................................ 3
Displaying Details of Export Blocks ................................................................................................................. 4
Starting Export Blocks ...................................................................................................................................... 5
Forerunners ......................................................................................................................................................... 9
Prerequisite: Creating a Forerunner Data Object ............................................................................................ 9
Editing the Properties of Forerunner Blocks .................................................................................................. 10
Displaying Details of Forerunner Blocks ........................................................................................................ 11
Starting Forerunner Blocks ............................................................................................................................ 12
Imports ............................................................................................................................................................... 13
Creating Import Blocks ................................................................................................................................... 14
Editing the Properties of Import Blocks .......................................................................................................... 16
Displaying Details of Import Blocks................................................................................................................ 17
Starting Import Blocks as Simulations ........................................................................................................... 18
Starting Import Blocks .................................................................................................................................... 21
Table Mode .................................................................................................................................................... 22
Downloading the Transformation Tree........................................................................................................... 23
Export Blocks

Creating Export Blocks

Values Result

1 Switch to the Transformation area on the An empty export The detail dialog for
left-hand side of the page. block with the name transformations opens. An
Export is created overview of the available
automatically. data objects opens as well
as a tree structure to
manage transformations.

2 Right-click Run to display the context menu.

3 Select the entry Create block => Export. You can create A popup opens:
multiple export
Create transformation
blocks.
block

4 Enter an ID into the Name text field. The Type of

transformation
block "EXP"
indicates that it is
an export block.

Basic Tutorials Page 1

 Values Result

5 Enter the Number of processes. You can parallelize Reasonable Number of

the execution of the processes: 1 – 4.
export block by
using more than
one batch process.

6 Click the green tick and save your entries. You have created the block.
You can view it in the
transformation tree.

7 Select the data objects that you want to

assign to the export block.

8 Drag & drop the data objects onto the export This process can
block. Another option is to select both the data take some time
object and the block. depending on the
size of the data
Click Apply to add the table.
objects.

9 Save and expand the export block. The data object and table
are appended in the tree.

Basic Tutorials Page 2

 Values Result

10 Delete the empty export block that was After the deletion, the tree
created automatically by the system. displays only one remaining
export block. This export
block contains the
previously created data
object and its table.

Editing the Properties of Export Blocks

Values Result

1 Right-click the export block and select A dialog with the heading
Properties. Edit transformation block
appears.

Basic Tutorials Page 3

 Values Result

2 Adjust the properties. You can change the Name

and the Number of
processes. The type of
transformation block
cannot be changed.

3 Save by clicking the green tick. Make sure that the name of
the export block has
changed and that the
number of processes (table
column: Proc.) corresponds
to the executed change.

Displaying Details of Export Blocks

Values Result

1 Double-click the export block or right-click it The details are displayed in

and select Log. the lower area of the
window. The area is divided
into Block, Processes,
Tables and Log.

Basic Tutorials Page 4

 Values Result

Starting Export Blocks

Values Result

1 Right-click the export block and select Start

block in background.

2 Execute the export by confirming the During this time, Success message: “The
message “Do you really want to start the the syntax check is transformation block …
block in the background” with Yes. executed and the was started”.

Basic Tutorials Page 5

 Values Result
tables are The status of the export
generated. changes to Released. The
status of the data object and
the table remains
Unprocessed.

3 Click Refresh to display the progress of the The export can The status of the block, the
export. take some time. data object and the table
changes to Complete. For
the Progress of the table,
100.00% is indicated. The
Runtime and Start time
columns are filled with
appropriate data.

4 Double-click the export block or right-click it A row appears containing

and select Log. the exported table. The
Status should be
Click Tables.
Complete. The Total
number of records should
be equal to the Number of
processed records
because no selections have
been created. Note that the
Total number of records
and Number of processed

Basic Tutorials Page 6

 Values Result
records are also displayed
on the right-hand side of the
table of the transformation
tree.

5 Switch to the target system and use The number of entries

transaction SE16. Select the table MARA and should be equal to the
click Number of entries. number of exported data
records.

6 Right-click the table and select Display A window with the heading
export files to view the exported data File display opens.
records.

Basic Tutorials Page 7

 Values Result

7 In the file display, you can change the number You can use the The exported data is
of displayed data records and add filters to the Configure fields displayed according to the
displayed results. button to add filters filters used.
to other table fields
Click Start search to display the files.
in addition to
MANDT
(Mandant/client)
and MATNR
(Materialnummer/m
aterial number).

8 Switch to the target system and use The data on the source
transaction SE16. Select the table MARA and system is exactly the same
click execute to view the data records of the as the exported data.
table. Compare the data of the table on the
source system with the exported data.

Information

If an error in a table occurs during the export, this table is skipped and a corresponding message appears.
You can fix the error and start the export block again. When you start a new block that contains successfully
exported tables, these tables will be not be exported again.

Basic Tutorials Page 8

 Forerunners
You can use forerunner blocks to adjust exported data prior to the import into a target system. This tutorial
explains how to create, adjust and execute forerunners. You can only execute forerunner tables after a
successful export.

Prerequisite: Creating a Forerunner Data Object

Values Result

1 Switch to the Transformation area. The detail dialog for

transformations opens. An
overview of the available
data objects opens as well
as a tree structure to
manage transformations.

2 Right-click Run. Select Create block A dialog window with the

=> Forerunner. heading “Create
transformation block”
appears.

3 Enter a Name. The Type of The Name and the Number

transformation block of processes are editable
“FOR” indicates that it is a text fields.
forerunner.

4 Change the Number of processes. You can parallelize the Reasonable Number of
execution of the export processes: 1 – 4.
block by using more than
one batch process.

5 Confirm the creation by clicking The block has been created

the green tick. and appears in the
transformation tree.

Basic Tutorials Page 9

6 Select a data object of the type You can only assign data After expanding the
Forerunner and assign it to the objects of the type forerunner block, the
forerunner block. You can do this by Forerunner for which an created table should appear
using drag & drop or by clicking the export has been executed in the tree.
Apply button. successfully.

Editing the Properties of Forerunner Blocks

Values Result

1 Right-click the forerunner block and select A popup appears with the
Properties. heading “Edit
transformation block”

Basic Tutorials Page 10

2 Enter a new Name and change the Number You can parallelize Reasonable Number of
of processes. the execution of the processes: 1 – 4.
export block by
using more than
one batch process.

3 Save by clicking the green tick. Check that The new Name and the
the applied changes have been saved Number of processes
correctly. (table column: Proc.) have
been saved according to
your adjustments.

Displaying Details of Forerunner Blocks

Double-click the forerunner block or right-click it and select Details. The details are displayed in the lower
area of the window. The area is divided into the tabs Block, Processes, Tables and Log.

Basic Tutorials Page 11

Starting Forerunner Blocks

Values Result

1 Right-click the forerunner block and select A dialog with the following
Start block in background. message appears: “Do you
really want to start the
block in the background?”

Basic Tutorials Page 12

2 Confirm the message. Success message: “The
transformation block …
was started”. The Status
of the forerunner changes to
Released.

3 Click Refresh to display the progress of the The execution can The status of the forerunner
execution. take some time. block, the data object and
the table changes to
Complete. For the
Progress of the table,
100.00% is indicated. The
Records in total column
must equal the number of
previously exported data
records.

Imports

Import blocks are the basis for inserting, updating and deleting data records from a table of the target
system. This tutorial explains how to create, adjust and execute import blocks.

Basic Tutorials Page 13

Prerequisites:

All tables to be imported must have previously exported data available. A target system has been assigned
in the system maintenance.

Creating Import Blocks

Values Result

1 Switch to the Transformation area. An overview of the available

data objects opens as well
as a tree structure to
manage transformations.

2 Right-click Run to open the context You can create multiple A dialog window appears:
menu. Select Create block => blocks. “Create transformation
Import/Delete. block”

3 Enter a Name. The type of block “IMP” A Name has been entered.
indicates that it is an
import.

4 Enter the Number of processes. You can parallelize the Reasonable Number of
execution of the export processes: 1 – 4.
block by using more than
one batch process.

Basic Tutorials Page 14

 Values Result

5 Use the value help (F4) for the Block Five modes are listed. The
mode text field. default block mode INSERT
is mainly used. This mode
leads to the termination of
the import if a data record is
imported whose primary key
values already exist.
Duplicate key fields are not
allowed in SAP tables.

6 Choose if you want to use the rule Two options: The import Without rule
base or not. base allows you to execute
- With rule base
an import that ignores all
- Without rule base Events, Rules, Functions,
Mappings and Offsets.

7 Save by clicking the green tick. The block has been created
and is displayed in the tree.

Basic Tutorials Page 15

 Values Result

8 Select a data object to import and You cannot add a After expanding the import
assign it to the import block. You can forerunner to an import block, the created table
do this by using drag & drop or by block. should appear in the tree.
clicking the Apply button.

9 Expand the import block and check that This process might take The data object and table
the data object with its table has been some time depending on are displayed in the tree.
added. the size of the data
objects.

Editing the Properties of Import Blocks

Values Result

1 Right-click the import block and select A dialog opens: “Edit

Properties. transformation block”

2 Adjust the properties. You cannot change the

Type of block text field.
The other text fields in the
dialog can be changed.

Basic Tutorials Page 16

 Values Result

3 Change the Name, the Number of When you change

processes and the Block mode. Save by properties, this affects the
clicking the green tick. transformation tree. The
name and the values in the
columns Proc. and Mode
have been edited
successfully.

Displaying Details of Import Blocks

Double-click the import block or right-click Log in the context menu of the block. A detail window divided into
the tabs Block, Processes, Tables and Log appears.

Basic Tutorials Page 17

Starting Import Blocks as Simulations
Simulation mode executes the import without inserting data into the target system. This allows you to check
for possible error messages and the number of processed records prior to the import. You can repeat a
simulation several times, but not after the execution of the import block.

Values Result

1 Right-click the import block and select You can only use Message: “Do you really
Simulate block in background. tables for which want to simulate the block
you have executed in the background?”
an export
successfully.

Basic Tutorials Page 18

 Values Result

2 Confirm the dialog by clicking Yes. Success message: “The

simulation of the
transformation block …
was started”
The status of the block
changes to Released
(Simulation).

Basic Tutorials Page 19

 Values Result

3 Click Refresh to display the progress of the The import can The status of the block, the
import simulation. take some time. data object and the table
changes to Complete. For
the Progress of the table,
100.00% is indicated. The
Runtime and Start time
columns are filled with
appropriate data. The
Records in total and the
Processed records equal
the number of exported data
records because no
constraints have been
applied.

Basic Tutorials Page 20

Starting Import Blocks

Values Result

1 Right-click the import block and select Start If the import block A dialog opens: “Do you
block in background. contains tables that really want to start the
have not been block in the background?”
exported
successfully, the
import terminates
with an error
message.

2 Confirm the message with Yes. Success message: “The

transformation block …
was started”
The status of the import
changes to Released. The
status of the data object and
the table remains
Unprocessed.
If a simulation has been
executed, it disappears and
is replaced by the current
import in the transformation
tree.

3 Click Refresh to display the progress of the The status of the block, the
import. data object and the table
changes to Complete. For
the Progress of the table,
100.00% is indicated. The
Runtime and the Start time

Basic Tutorials Page 21

 Values Result
columns are filled with
appropriate data. The
Records in total equal the
number of exported data
records.

4 Check the table log for messages. If the import aborts No messages appear. The
with warning number of Records in total
messages, the and Processed records
error occurred due must equal the number of
to duplicate keys in exported data records.
the target system.

Table Mode
By using certain indicators, you can adjust the behavior of an import block. There are different modes that
can be defined in the settings of a block.

Switch to the Transformation area on the left-hand side of the page.

The detail dialog for transformations opens. A tree structure appears.

Right-click an import block.

Select Properties.

Select the F4 help from field Mode.

Basic Tutorials Page 22

 Mode Description

INSERT Data records are inserted into a table (standard).

INSERT_ADK Data records with double keys are inserted. If the data record is available with the
same key in the data table, this data record won't be changed in the database.

UPDATE Existing data records are updated.

MODIFY Existing data records are updated and new data records are inserted (combination of
UPDATE and INSERT).

DELETE Existing data records are deleted.

START_ONLY Only the start routine is executed.

Use the Without rule set? option to decide if you want to execute rule sets such as field rules, global rules
or other results.

Click the green tick.

Your adjustments have been saved.

Downloading the Transformation Tree

Use this function to download the transformation tree.

In the Transformation area, click Download.

Specify the storage location.

The transformation will be downloaded as a ZIP file that includes the transformation as an HTML file.

Unpack the ZIP file.

Open the file index.html

Log

The log displays all exported and imported tables. If you execute the export or import of a table multiple
times, only the last run of the table remains visible.

Prerequisites

You have exported at least one table.

Opening the Log

Switch to the Transformation area on the left-hand side of the page.

A detail view with the two tabs Transformation and Log opens.

Basic Tutorials Page 23

You can also access the log in the Data objects area via the Log context menu. However, the view will be
limited to the tables of the selected object.

Click the Log tab to display all executions.

The Type column indicates whether the table has been assigned to an export, import or forerunner block.

Current Execution/All Executions

When you access the log, the most current execution of the table is displayed.

Click Execute all in the upper part of the toolbar to display all executions.

Click Current executions to return to the recent view.

Total Runtimes

The Total Runtime column displays the runtimes of the executed tables.

Select the row to sum the runtime from. If you did not select any rows, the total runtime will be displayed.

Click Total runtime in the upper toolbar.

The runtime is displayed in a popup window.

Displaying Block/Object/Table Logs

The Messages column displays whether messages are available for the recent export or import and the type
of message.

Select the rows for which you want to display messages. If you select multiple rows, the messages will be
displayed all together.

Click Logs in the upper toolbar.

The messages are displayed in a popup window

Displaying Files

The Number of records column displays how many data records were processed during an execution.

Select the row for which you want to display data records.

Click Files in the upper toolbar.

The File display is displayed.

Select the row of an export block and click Table in System. The login screen for the respective system
opens. Please make sure that the mask always suggests the standard login client. If necessary, adjust it to
log in to the correct client.

After you log in into the target system, you can view the specified table in the selection screen of the
data browser. If you choose an import table, you will jump to the specified table of the target system.

Basic Tutorials Page 24

Basic Tutorials Page 25