Winshuttle STUDIO 11

TRANSACTION Developer
Basic Training
1

Copyright ADSOTECH Scandinavia Oy 2016

2014
 Basic Training Advanced Training 1 Advanced Training II

Contents Winshuttle Studio 11

TRANSACTION Developer
Basic Training

 Creating the First Script

 Problem Investigation
 Recording Modes

Winshuttle Studio 11 Winshuttle Studio 11

TRANSACTION Developer TRANSACTION Developer
Advanced Training I Advanced Training II
 Multiline Recordings (Loops)  Cell Based Mapping
 Script Linking  Dynamic Recordings (Conditions)
 Backup SAP Data  Managing Long Texts (Read and Update)
 Data Validation  Making Scripts Available for RUNNER Users
 Read From SAP  GUI Scripting (Optional)

2
 Basic Training Advanced Training 1 Advanced Training II

Today’s Agenda

 Creating the First Script

 Problem Investigation
 Recording Modes

3
 Basic Training Advanced Training 1 Advanced Training II

User Interface Overview

4
 Basic Training Advanced Training 1 Advanced Training II

User interface overview

Start creating a new script:

File – New

Open an existing script:

File – Open
-> select Recent Scripts or Computer

5
 Basic Training Advanced Training 1 Advanced Training II

User settings

File – Options – Locations

Important to know where all your data and script files are getting
stored by default. Recommended to save everything in one place.

6
 Basic Training Advanced Training 1 Advanced Training II

User settings

Look for these icons

on the bottom of
the screen to know
whether you are
connected to SAP
or not.

If you wish to log off from SAP after each script run, untick this option.

Staying logged on means you won’t be asked for credentials or SAP

system again as long as you keep the Winshuttle application open.

7
 Basic Training Advanced Training 1 Advanced Training II

Creating the First TRANSACTION Script

8
 Basic Training Advanced Training 1 Advanced Training II

Creating the first TRANSACTION script

• Transaction MM02

• Update some basic data fields

• Perform the script creation steps

• Record

• Map Tips!
• Know your transaction, rehearse the steps in SAP before recording
• Run • Know your data, know what materials to use
• Check for tips and tricks from support.winshuttle.com

9
 Basic Training Advanced Training 1 Advanced Training II

STEP 1
Create the recording

• Start new recording

• Update some fields in SAP

• Save the data

10
 Basic Training Advanced Training 1 Advanced Training II

Start recording
File – New – Transaction – Create from Recording

11
 Basic Training Advanced Training 1 Advanced Training II

Start recording

Give Tcode. Use Standard

recording mode and
Excel as data type.
If you are not logged on to SAP yet,
give your credentials.

12
 Basic Training Advanced Training 1 Advanced Training II

Update fields in SAP

13
 Basic Training Advanced Training 1 Advanced Training II

Update fields in SAP

Give material number and

press Enter.
Main idea is to use SAP as
you are used to using it.

14
 Basic Training Advanced Training 1 Advanced Training II

Update fields in SAP

Only select “Basic Data 1” on this

View selection screen.

It is always recommended to only

select this first view at this point. Even
if you need to access multiple views
you should select only the first here
and navigate to other views in the
actual data screen that follows.

15
 Basic Training Advanced Training 1 Advanced Training II

Update fields in SAP

When you use your keyboard in a

field in SAP, the system will later
remember that field and have it
ready for you to map against your
Excel file.

Note that it is not enough to just

place the cursor in a field, you need
to change the actual value or
overwrite one of the characters
with the same character in order
for the action and field to be
registered.

16
 Basic Training Advanced Training 1 Advanced Training II

Update fields in SAP

If the dropdown icon for views appears,
always use it to select the next view.

If there are less views

and no dropdown list
possibility, you can click
on your required tab
directly.

17
 Basic Training Advanced Training 1 Advanced Training II

Update fields in SAP

Normally it is okay to
search for a specific value
while recording. However,
the recommendation
remains to know your
transaction and appropriate
values before hand.

18
 Basic Training Advanced Training 1 Advanced Training II

Update fields in SAP

19
 Basic Training Advanced Training 1 Advanced Training II

Recording step is completed

SAP window closes and Winshuttle compiles the
script. Be patient and wait for the Map view.

20
 Basic Training Advanced Training 1 Advanced Training II

STEP 2
Map fields

• Map SAP fields with Excel columns

• Mapping by drag-and-drop

• Save script and the newly created Excel template

21
 Basic Training Advanced Training 1 Advanced Training II

Mapper – recorded fields

Choice of tab determines what fields and actions you see.

Mapping type
Field descriptions Field values
Technical names

22
 Basic Training Advanced Training 1 Advanced Training II

Mapper – data template

You can create a new Excel file here or use an existing one. In this
example we use the new empty Excel file (Untitled for now).

23
 Basic Training Advanced Training 1 Advanced Training II

Mapping
• Connecting SAP fields to Excel columns
• Done in the View and Map menus
• Simple drag-and-drop
• Think about the direction of the drag
• Dragging Excel to SAP = data going from Excel to SAP
• Dragging SAP to Excel = data going from SAP to Excel
• Once dragged
• Mapping type shows data direction
• Value shows Excel column reference
24
 Basic Training Advanced Training 1 Advanced Training II

Mapping
Drag with your mouse from Column A
to SAP field Material Number.

25
 Basic Training Advanced Training 1 Advanced Training II

Mapping

Once mapped, the mapping type shows the direction of data flow
and value indicates the Excel column connected to this SAP fieId.
In Excel the column gets a headline and shows the original recorded
value on row 2.
26
 Basic Training Advanced Training 1 Advanced Training II

Mapping Drag-and-drop the rest of the fields in similar fashion. If there

are fields that should always get the same fixed value, leave
those as they are. Here Checkbox field should be left unmapped,
as fixed value (see the red icon). This field is the selection of
Basic Data 1 in the popup screen for the list of different views.
This selection should never be changed, therefore fixed value.

27
 Basic Training Advanced Training 1 Advanced Training II

Save

Click the Save button.

In the popup window
give both files an
appropriate name.

It is recommended to
use the same name
for both files and to
save them in the
default folders.

28
 Basic Training Advanced Training 1 Advanced Training II

DEMO

• MM02 recording and mapping

29
 Basic Training Advanced Training 1 Advanced Training II

STEP 3
Run the recording

• Prepare Excel data

• Run script in test

• Once tested, run in production

30
 Basic Training Advanced Training 1 Advanced Training II

Prepare data
Go to Run menu and add a few rows of data to your
file. 3 rows should suffice.You can save the data file
by clicking the Save button above the Excel rows.

31
 Basic Training Advanced Training 1 Advanced Training II

Execute

Click Run to execute the script.You will get

the log message in the first available column.

By default the script is set to run rows from 2 until

there is no more data. These can be changed as needed.
32
 Basic Training Advanced Training 1 Advanced Training II

Error message
Checking the log messages, you see that most rows were ok.
On row 4 there is an error message pointing to a typo in the
data. This error message was retrieved from SAP.

We attempt to fix it by setting the

correct value for Base Unit of Measure.

33
 Basic Training Advanced Training 1 Advanced Training II

Rerun error rows

After fixing the

data you should
rerun the script.
This time click on
the down arrow of
the Run button
and select Run
Only Error Rows.

Run Only Error Rows

option will only run the
rows that have the orange
error message on them.

34
 Basic Training Advanced Training 1 Advanced Training II

Rerun results

After the rerun (Run Only Error Rows) everything

is fine if there are no more error messages in
orange but previously orange rows have switched
to light green background.

35
 Basic Training Advanced Training 1 Advanced Training II

DEMO

• MM02 running the script

36
 Basic Training Advanced Training 1 Advanced Training II

Problem investigation

37
 Basic Training Advanced Training 1 Advanced Training II

Problem investigation
First things to check:
• The Excel log column
• Retrieve all messages from SAP = Extended log
• Run in foreground = Debug
• In some cases Start SAP GUI option helps

First excel row ok, others always fail:

Debug more than one row

38
 Basic Training Advanced Training 1 Advanced Training II

Extended Log
Capture the warning, information and other messages
that appear during the execution of a transaction

In the Map menu, select Expert View and

you should see Extended Log listed as the
second field. Tick on the Enable tick box
and give an available Excel column as Value.

39
 Basic Training Advanced Training 1 Advanced Training II

Extended Log

After running the script you will see both normal

and Extended logs in corresponding columns.
Normal log always contains just one message and
Extended may list several messages per item.
40
 Basic Training Advanced Training 1 Advanced Training II

Error Handling

Running a script you will specify the

row range of your desired rows to run.
Within that row range you can decide
to only run the first 5 rows or only the
ones with orange error messages.

If you don’t know what is causing the

error you get or you simply want to
see the SAP actions happening, you
should click on Debug. This option
will open SAP GUI and show you the
actions taken.

41
 Basic Training Advanced Training 1 Advanced Training II

Error Handling
If you cannot figure out what is causing the error you get or you simply
want to see the SAP actions happening, you should click on Debug.

Debug will open SAP GUI and

perform the recorded actions
on your computer screen. The
run will pause on each SAP
screen giving you time to view
the screen and fields. Once you
are ready for the next step, you
can click the green tick button This option will also run based on the defined row
in the popup window that has range at any given time.You have 2 Debug options: to
appeared. run only the first row of your range or to run all of
the rows within the range. The range can be defined
as one row (Rows 5 to 5).

42
 Basic Training Advanced Training 1 Advanced Training II

Debug Run
• Allows us to step through every screen in the script
• Useful in error situations, especially with new scripts
• You drive the execution with the OK code window
• Press Enter in the SAP window only if needed to
accept information and warning messages
• Besides the above, not seeing the OK code popup
means you have probably found the issue
• Carefully compare execution dialog with recorded
dialog in order to identify the difference
43
 Basic Training Advanced Training 1 Advanced Training II

When to use Start SAP GUI?

The option may be on or off
automatically. No need to touch
it unless you get error messages.

Common cases to consider Start SAP GUI:

• “Park” in Accounting Transactions
• File input/output dialogs or other Windows resources
• Normal run fails but debug is successful all the time
• Whenever you see runtime errors

44
 Basic Training Advanced Training 1 Advanced Training II

Problem investigation

More help:

• Product online help

• Recreate the script using another recording mode

• Knowledgebase:
support.winshuttle.com

45
 Basic Training Advanced Training 1 Advanced Training II

DEMO

• Problem investigation using MM02

46
 Basic Training Advanced Training 1 Advanced Training II

Recording modes

47
 Basic Training Advanced Training 1 Advanced Training II

Recording Modes
• Standard mode
• Upload, download, dynamic actions & user parameters
involved, Extended Log, Long Texts
• Batch Input mode
• Upload only, most Tcodes for creation of data
• GUI Scripting mode
• Must be enabled in the SAP system, special recording
requirements
Tips! Check Winshuttle Support site for recording
mode recommendations before recording your
transactions.

48
 Basic Training Advanced Training 1 Advanced Training II

Why use Batch Input mode ?

• Some of the SAP transactions are optimized to run
in this mode
• Does not remember individual user settings if sharing
the scripts
• SAP screens may look different compared to manual
operation
• Messages may be different in the transaction
• May suppress information or warning popups

49
 Basic Training Advanced Training 1 Advanced Training II

GUI Scripting mode

• Use when other modes don’t work
• Need to use dynamic treeview control
• Need to use Index Based looping
• Must be enabled in the SAP system and for user
• Execution slower, always in foreground
• More technical, error prone, low level
• All screens and popups are recorded
• Do as little as possible with GUI Scripting, link to
other scripts to complete the task at hand
50
 Basic Training Advanced Training 1 Advanced Training II

DEMO

• MM02 using GUI scripting

51
 Basic Training Advanced Training 1 Advanced Training II

Contacts in the Nordics

ADSOTECH Scandinavia Oy
Piispanportti 5
02240 Espoo
Finland
+358 10 321 6260

Sales:
Christer Mäkelä +358 10 321 6262
[email protected] +358 40 900 9990

Support:
[email protected] +358 10 321 6267

52