transaction developer basic training - … · winshuttle transaction developer basic training ......

63
TRANSACTION Developer Basic Training 1 Copyright ADSOTECH Scandinavia Oy 2014

Upload: dangkien

Post on 21-Aug-2018

240 views

Category:

Documents


1 download

TRANSCRIPT

Page 1: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

TRANSACTION Developer Basic Training

1

Copyright ADSOTECH Scandinavia Oy 2014

Basic Training Advanced Training IIAdvanced Training 1

Contents

2

Winshuttle TRANSACTION Developer Basic Training

TRANSACTION User Interface Creating the First Script Problem Investigation Recording Modes Reporting a Script Problem to ADSOTECH

Winshuttle TRANSACTION Developer Advanced Training I

Multi-line Recordings (Loop Functionality)

Script Linking Backup SAP Data Data Validation Read From SAP

Winshuttle TRANSACTION Developer Advanced Training II

Cell-Based Mapping Dynamic Recordings (Conditions) Managing Long Texts (Read and Update) Making Scripts Available for RUNNER

Users GUI Scripting (Optional)

Basic Training Advanced Training IIAdvanced Training 1

Todayrsquos Agenda TRANSACTION User Interface Creating the First Script Problem Investigation Recording Modes Reporting a Script Problem to ADSOTECH

3

Basic Training Advanced Training IIAdvanced Training 1

4

TRANSACTION User Interface Overview

Basic Training Advanced Training IIAdvanced Training 1

User interface overview

5

Create new script Open Script from filesystem

Recent Scripts

Favorite Scripts

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash Application defaults

6

Select Tools -gt Options -gt Application Defaults

You do not need to change these settings

The first two paths are important to know because all your Excel files and Script files (txr) that you create will by default be stored in these folders

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash SAP Defaults

7

Select Tools -gt Options -gt SAP Defaults

This option causes TRANSACTION to remember the last SAP password you entered as long as the TRANSACTION product is kept open

Without this option the password needs to be entered manually every time when starting a recording or executing a script

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 2: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Contents

2

Winshuttle TRANSACTION Developer Basic Training

TRANSACTION User Interface Creating the First Script Problem Investigation Recording Modes Reporting a Script Problem to ADSOTECH

Winshuttle TRANSACTION Developer Advanced Training I

Multi-line Recordings (Loop Functionality)

Script Linking Backup SAP Data Data Validation Read From SAP

Winshuttle TRANSACTION Developer Advanced Training II

Cell-Based Mapping Dynamic Recordings (Conditions) Managing Long Texts (Read and Update) Making Scripts Available for RUNNER

Users GUI Scripting (Optional)

Basic Training Advanced Training IIAdvanced Training 1

Todayrsquos Agenda TRANSACTION User Interface Creating the First Script Problem Investigation Recording Modes Reporting a Script Problem to ADSOTECH

3

Basic Training Advanced Training IIAdvanced Training 1

4

TRANSACTION User Interface Overview

Basic Training Advanced Training IIAdvanced Training 1

User interface overview

5

Create new script Open Script from filesystem

Recent Scripts

Favorite Scripts

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash Application defaults

6

Select Tools -gt Options -gt Application Defaults

You do not need to change these settings

The first two paths are important to know because all your Excel files and Script files (txr) that you create will by default be stored in these folders

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash SAP Defaults

7

Select Tools -gt Options -gt SAP Defaults

This option causes TRANSACTION to remember the last SAP password you entered as long as the TRANSACTION product is kept open

Without this option the password needs to be entered manually every time when starting a recording or executing a script

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 3: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Todayrsquos Agenda TRANSACTION User Interface Creating the First Script Problem Investigation Recording Modes Reporting a Script Problem to ADSOTECH

3

Basic Training Advanced Training IIAdvanced Training 1

4

TRANSACTION User Interface Overview

Basic Training Advanced Training IIAdvanced Training 1

User interface overview

5

Create new script Open Script from filesystem

Recent Scripts

Favorite Scripts

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash Application defaults

6

Select Tools -gt Options -gt Application Defaults

You do not need to change these settings

The first two paths are important to know because all your Excel files and Script files (txr) that you create will by default be stored in these folders

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash SAP Defaults

7

Select Tools -gt Options -gt SAP Defaults

This option causes TRANSACTION to remember the last SAP password you entered as long as the TRANSACTION product is kept open

Without this option the password needs to be entered manually every time when starting a recording or executing a script

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 4: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

4

TRANSACTION User Interface Overview

Basic Training Advanced Training IIAdvanced Training 1

User interface overview

5

Create new script Open Script from filesystem

Recent Scripts

Favorite Scripts

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash Application defaults

6

Select Tools -gt Options -gt Application Defaults

You do not need to change these settings

The first two paths are important to know because all your Excel files and Script files (txr) that you create will by default be stored in these folders

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash SAP Defaults

7

Select Tools -gt Options -gt SAP Defaults

This option causes TRANSACTION to remember the last SAP password you entered as long as the TRANSACTION product is kept open

Without this option the password needs to be entered manually every time when starting a recording or executing a script

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 5: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

User interface overview

5

Create new script Open Script from filesystem

Recent Scripts

Favorite Scripts

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash Application defaults

6

Select Tools -gt Options -gt Application Defaults

You do not need to change these settings

The first two paths are important to know because all your Excel files and Script files (txr) that you create will by default be stored in these folders

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash SAP Defaults

7

Select Tools -gt Options -gt SAP Defaults

This option causes TRANSACTION to remember the last SAP password you entered as long as the TRANSACTION product is kept open

Without this option the password needs to be entered manually every time when starting a recording or executing a script

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 6: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash Application defaults

6

Select Tools -gt Options -gt Application Defaults

You do not need to change these settings

The first two paths are important to know because all your Excel files and Script files (txr) that you create will by default be stored in these folders

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash SAP Defaults

7

Select Tools -gt Options -gt SAP Defaults

This option causes TRANSACTION to remember the last SAP password you entered as long as the TRANSACTION product is kept open

Without this option the password needs to be entered manually every time when starting a recording or executing a script

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 7: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

User settings ndash SAP Defaults

7

Select Tools -gt Options -gt SAP Defaults

This option causes TRANSACTION to remember the last SAP password you entered as long as the TRANSACTION product is kept open

Without this option the password needs to be entered manually every time when starting a recording or executing a script

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 8: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

8

Creating the First TRANSACTION Script

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 9: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Creating the first TRANSACTION script

bull Transaction MM02

bull Update some basic data fields

bull Perform the script creation stepsbull Recordbull Mapbull Run

9

Tips bull Know your transaction rehearse the steps on SAP before recordingbull Know your data know what materials to usebull Check for transactionrsquos tips and tricks from supportwinshuttlecom

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 10: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

bull Start recording

bull Connect to SAP

bull Use the transaction to update fields

bull Finally save the data

10

STEP 1 Create the recording

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 11: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Start recording

11

Press ldquoNewrdquo to start recording enter transaction code to record and then press ldquoGordquo

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 12: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Connect to SAP

12

Provide SAP credentials

First time when connecting to SAP select correct system then check ldquoUse selected system as defaultrdquo This mean all scripts will be run against this system by default Otherwise you have to select the system every time connecting to SAP

Note The scripts are not system dependent

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 13: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Accept the default recording properties

13

The default recording mode is good in most cases

For special recording requirements you may be advised to use some other recording mode

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 14: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Enter material number

14

Enter the material number manually

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 15: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Select Basic Data 1

15

Only select ldquoBasic Data 1rdquo 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 do it once you get into the actual transaction data screen

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 16: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Update fields

16

When you touch some fields in SAP the TRANSACTION product will later in the mapping step recommend that these fields will be the ones that you should map against your Excel file

Note that ldquotouchingrdquo a field means more than just placing the cursor in a field Not until you change the actual value or simply overwrite one of the characters (for example with same value) in a field the action will be registered as a change and field will be recommended by TRANSACTION

Note also that even if you do NOT touch a field you can still map it in TRANSACTION (for the screen you have visited) In this case however you will first need to enable the field in the mapper

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 17: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Go to Basic Data 2

17

Note If you have so many views that not all view tabs are visible simultaneously then a dropdown list icon will appear If this icon appears always use this dropdown list to select the next view

If there are less views and there is no dropdown list possibility simply click on the ldquoBasic Data 2rdquo tab directly

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 18: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Change the Basic material

18

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 19: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

SAP ndash Press back and then Yes to save

19

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 20: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Recording step is completed

20

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 21: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

STEP 2 Map fields

bull Map SAP fields with Excel columns

bull Mapping by drag-and-drop

bull Save script and the newly created Excel template

21

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 22: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Select Create Mapping

22

The ldquoAuto Mappingrdquo feature can be used to automatically map all enabled fields It is a very quick way to perform the mapping We will use the ldquoCreate Mappingrdquo option since it provides full control over how the fields are mapped

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 23: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash SAP fields

23

The Mapper shows by default all the ldquoEnabledrdquo SAP fields In practice this means fields which were touched during the recording

Field descriptions

Technical names

Mapping type

Values entered

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 24: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Excel content

24

Initially the Excel window shows an empty file In this example the mapping will be performed against this empty Excel file This will result in a new Excel file being created in addition to the script file

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 25: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping

25

The purpose with the mapper is to map SAP fields with Excel columns

Easiest way to perform the mapping is by Drag-and-drop

Note that the Drag-and-drop action must be performed in the correct direction

Dragging from Excel to SAP means data is transferred from Excel to SAP

Dragging from SAP to Excel means data is transferred from SAP to Excel (=Read from SAP)

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 26: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapping material number

26

Drag with your mouse from Column A to SAP field Material number

Drag-and-drop

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 27: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped material number

27

Once mapped the mapping type shows the data direction and value A indicates data is taken from Excel Cell A

Because we started with an empty Excel file the Excel header and first data row is also automatically filled based on the mapping and based on what data was entered when the recording was made

It is also possible to map the fields to excel file containing existing data

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 28: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Mapper ndash Mapped all fields

28

This is the result when all fields are mapped in the same way from Excel to SAP

Note that the ldquoCheckboxrdquo field has not been mapped This field is the ldquoBasic Data 1rdquo entry which was selected on the initial ldquoView selectionrdquo screen It has not been mapped because the mapping type is ldquoFixed valuerdquo (red icon) and we want the recording to always do this on the View selection screen

In this way you can simply leave a field unmapped and enforce a fixed value in the recording

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 29: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Save Excel file

29

Click on the Back arrow and then save the new Excel file

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 30: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Save script file

30

You will also be asked to save the new script

Note It is strongly recommended that you do NOT browse to any other folder than suggested by the product simply provide the desired name for the file and store it in the folder suggested

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 31: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Map completed ndash user presented with Run window

31

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 32: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 recording and mapping

32

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 33: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

STEP 3 Run the recording

bull Prepare Excel data

bull Run script in test

bull Once tested run in production

33

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 34: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Open Excel file

34

The Excel file can be opened from the Run window by pressing the small green Excel icon

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 35: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Prepare the Excel file

35

And save the excel file

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 36: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Execute the recording

36

You may keep the Excel file open when you start the execution Open the TRANSACTION window and press Run SAP Logon screen appears but if you did set the ldquoRemember last login passwordrdquo at the start you only need to press enter on the login screen

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 37: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Result of first execution ndash some data error

37

Most rows were ok On row 4 there was a data error The error message was retrieved from SAP We attempt to fix it by setting the correct value for ldquoBase unit of measurerdquo

Set correct value

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 38: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Rerun rows in error after Excel fixed

38

The ldquoRun on errorsrdquo option means re-run only rows with errors

Select this option and then press ldquoRunrdquo again

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 39: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Result of the second execution ndash everything ok

39

The ldquoGreenrdquo row indicates execution was successful after a re-run

At this point all rows have been successfully updated

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 40: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Running in production

40

Every time when you execute a script you will be presented with the Logon screen

On this screen you always have the possibility to click on the ldquoSystemrdquo button and pick any target SAP system you like

For example executing a script in production only requires you to select the production SAP from here and provide authentication details for that system

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 41: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 running the script

41

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 42: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

42

Problem investigation

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 43: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Problem investigation

43

bull First things to checkbull The excel log columnbull Retrieve all messages from SAP ndash Extended logbull Run in foreground ldquoStep-by-step stop on all

screensrdquobull In some cases ldquoLaunch GUIrdquo option helps

bull First excel row ok others always failbull Step-by-step mode see problem diagnosis guide

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 44: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Problem investigationbull More helpbull TRANSACTION online helpbull Re-create using other recording mode (batchnon-

batch)bull Knowledgebasebull supportwinshuttlecom

44

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 45: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

bull The feature helps you capture the warning messages information messages and other messages that appear during the execution of a transaction

bull The extended Log can be obtained in a different column in the excel or as a comment in the Log column

45

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 46: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Extended Log in the Excel

46

Additional Log Column which gives the detailed error obtained while the transaction ran in SAP

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 47: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Error Handling

47

bull Fix Error in Excel Filebull Choose Run on Errorsbull Only the records with errors will be selected and run

Use the step-by-step feature to find causes of errors in running a transaction or to simply playback a recording

Debugging amp Troubleshooting options in case of errors

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 48: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Debug Run Optionsbull Step-by-Step Stop on all Screens

bull Debug option which helps us to step through every screen in the recording

bull Useful in situations when you do not understand what is actually happening during execution

bull You can drive the execution by working on the OK code windowbull Only press enter in main sap window if needed to accept

information and warning messages In other cases if you do not get a pop-up window for the OK code then it is probably an issue

bull Carefully compare execution dialog with recorded dialog in order to identify where there is a difference

48

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 49: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

When to use Launch GUI

49

bull Use default setting If therersquore issue with the run then change the setting

bull ldquoParkrdquo Accounting Transactions

bull Transactions using file inputoutput dialog boxes or other Windows resources

bull Transactions that run successfully in step-by-step mode but not in normal runs

bull Transactions which give run-time error messagesbull ldquoTransaction Terminated by Userrdquobull ldquoProtocol error when communicating with SAPGUIrdquo

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 50: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

DEMObull Problem investigation using MM02

50

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 51: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

51

Recording modes

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 52: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Recording Modes Non Batch Input Mode - Default

bull Upload Download(Read Data) Dynamic actions amp User parameters involved Extended Logging Long Texts

Batch Input Modebull Upload only Most transactions for creation of data

GUI Scriptingbull Scripting must be enabled in the SAP system ndash Special recording

requirements

52

Tips Check Winshuttle Support site for recording mode recommendations before recording your transactions

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 53: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Why use Batch Input mode Batch input modebull Some of the SAP transactions are optimized to run in

this mode bull Does not remember individual user settings if sharing

the scripts bull The beginning and input screens are different

(remove this line)bull Messages may be different in the transactionbull Suppressing the Information pop-up

53

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 54: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Batch Input mode

Do not use batch input bull If need to read from SAPbull If need to remember your user settings

Batch input mode examplesbull Material Classification Characteristics MM02bull Bill of material CS01 CS02

54

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 55: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Why use Function Modulebull Only available from Winshuttle version 1041 and

abovebull Recommended for use with SAP BASIS 700

Support Package 24 EHP5 or later

55

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 56: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Why use GUI Scripting modebull When nothing else works

bull For example using the dynamic treeview control in PA40 etc transactions works only in this mode

bull Link to other scripts to add features

bull Detailsbull GUI scripting must be enabled for user in SAPbull Execution slower always in foregroundbull Recording more technical ldquolow-levelrdquo more error-pronebull All screens and popups are recorded

bull Index based looping feature56

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 57: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

DEMObull MM02 using GUI scripting

57

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 58: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

58

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 59: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

59

Reporting a Script problem to ADSOTECH

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 60: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Reporting a script problem to ADSOTECH

Check the problem investigation recommendations firstbull Slide 42-50

If you cannot solve the problem please provide the following information to supportadsotechcombull Problem description print screens transaction code etc

bull Problematic script file and related Excel file The Excel file should contain the execution result Also include the bak file having the same name as the script file and which is located in the same folder as the script file

bull Describe the outcome of the ldquoStep-by-step stop on all

60

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 61: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Where to find more informationbull Product itself

bull Starting tourbull Online helpbull Product manual

bull wwwwinshuttlecombull Step-by-step guidesbull Case studiesbull Etc

bull supportwinshuttlecom bull Knowledgebase

61

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 62: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Adsotechlsquos servicesbull Training

bull Tailored on-site trainingbull Certification training at Espoo Finlandbull Web trainings

bull Consultancybull ScriptWorkflow developmentbull Best practicesbull Installation services

bull Winshuttle User Group meetingsbull User Groups in Finland Denmark Norway amp Sweden

62

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63

Page 63: TRANSACTION Developer Basic Training - … · Winshuttle TRANSACTION Developer Basic Training ... window and press Run. SAP Logon screen appears but if you did set the “Remember

Basic Training Advanced Training IIAdvanced Training 1

Further contacts in Nordic Countries

ADSOTECH Scandinavia OyPiispanportti 502240 EspooFinland+358 10 321 6260

SalesChrister Maumlkelauml +358 10 321 6262christermakelaadsotechcom +358 40 900 9990

Supportsupportadsotechcom +358 10 321 6267

63