TRANSACTION Developer Advanced Training II - … · Winshuttle TRANSACTION Developer Advanced Training I ... Data Validation Read From SAP Winshuttle TRANSACTION Developer Advanced

TRANSACTION Developer Advanced Training II

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)


Todayrsquos Agenda Cell-Based Mapping Dynamic Recordings (Conditions) Managing Long Texts (Read and Update) Making Scripts Available for RUNNER Users GUI Scripting (Optional)

3


4

Cell-Based Mapping


Usagesbull Whenbull Especially useful feature when creating pre-

formatted Excel input ldquoformsrdquo

bull Functionbull Map specific Excel cells to sap fieldsbull Fields within a loop still mapped to columns

5


Cell based mapping ndash VA01

6

Step 1 Switch Mapping to Cell Based


Cell based mapping ndash Loop definition

7

Step 2 Create the loop



8

Step 3 Outside the loop map Excel cells to SAP fields

Step 4 Inside the loop map Excel columns to SAP fields


Demobull Transaction VA01 - How to make mapping

9


10


11

Dynamic recordings - Conditions


Dynamic recordings - Conditions Default record amp run behavior Conditions based on input dataSAP data Skip screen ndash dynamic condition

12


Recording vs script execution ndash Default behaviour

13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN

By default the recorded dialog must match the dialog appearing during script execution

Sap fields in script which are enabled and update data must exist on respective screens

Otherwise the execution will fail


Recording vs script execution ndash Explicit conditions

14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans

If sap field XIf excel column

If sap field Y

Different condition types can be defined

Condition scope 1-n screens 1-n fields

Can be nested

Relies on the fact that you know what to expect depending on data in excel or sap

Define in Expert mode


Conditional Executionbull An Excel field or SAP field can be used to control

whether to perform a specific part of script

bull Logical Operators can be used to give a conditional input to the fields

bull By putting the condition around the complete script specific input rows may be totally skipped

bull ldquoIF first transactionrdquo condition can be applied when the initial screen is different from the first record executed to the subsequent records

15


Condition definitionbull Mapper ndash Expert mode ndash Select rows ndash press

condition

16

Several comparison operators are available

Logical IF-ELSE Conditions can be specified


Recording vs script execution ndash Skip screen if not found

17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN ndash SKIP SCREEN

Skip screen if not found

Dynamic check during run

Defined on screen level

Use it when it is not possible to define explicit condition



bull Define in Expert mode select appropriate screen open properties

bull Not used in GUI Scripting mode

bull Skip screen cannot be used in the loop18


Skip screen if not found - Example

bull Transaction TK11 ndash Create condition

bull Screen rdquoOverlapping validity periodsrdquo may appear based on existing data but it is not an error situation

bull Impossible to know before run if it will appear

bull Skip screen if not found solves the issue

19


DEMObull FB50 withwithout Company promptingbull Show rsquoSkip screen if not foundrsquo-solutionbull Show other possible if conditions

20


21


22

Managing long texts


Managing Long Textsbull TRANSACTION supports reading and updating of

long text fieldsbull Examples Sales Text Purchasing Texts for Materials Item texts

during Order creation and many more

bull Long texts can be accessed in two different modesbull Default mode ndash The complete text is just one long text field

potentially displayed on multiple rowsbull Line mode ndash The long text field consists of one or more lines

where the maximum length is 72 chars for each line

23


Long text ndash default mode vs line mode

24


Managing Long Texts ndash Recording modesbull Non-batch input with SAP Controls supports

bull Long text update in default text modebull Long text update in line modebull Long text read from SAP in line mode

bull Batch input mode supportsbull Long text update in line mode

bull GUI Scripting supportsbull Read and Update in any modebull Reading a multi-line text in default mode causes text formatting to

be cleared

25


Long texts in Default modebull Requires Non-batch with SAP Controls recordingbull Long text update onlybull Long text field not shown in mapper by default press

long text button to toggle normal long text view

bull Long text can not be inside loop or conditionbull In default mode the whole text will be mapped to

one excel column

26


Accessing the long text in default mode (Non-batch with SAP Controls recording)

27


Long texts in Line modebull Each line is reflected by a SAP field named

something like RSTXT_TXLINE(nn)

bull You can update or read these fields

bull Each line is mapped to different excel column

28


Accessing the long text in line mode Non-batch with SAP Controls recording (readupdate)

29


Accessing the long text in line mode Batch recording (update only)

30


DEMObull MM02 readupdate longtext fields

31


32


33

Making scripts available for TRANSACTION runner user


Script execution alternativesbull From TRANSACTION (developer application)

bull From RUNNER (runtime application)

bull Directly from Excel with Excel add-in installedbull TRANSACTION or RUNNER must be installed on the workstationbull If excel file contains published script(s) can only execute one of

those at the timebull If no published script in the excel file user can pick any script

which is available in the filesystem

34


The Excel Add-inbull Publish script(s) to Excel workbook or template

bull Run scripts from excel directly no need to open TRANSACTION or RUNNER

bull Installed and activated by default when installing TRANSACTION or RUNNER

bull Enabledisable (close excel first) in TRANSACTION Tools -gt Options -gt Application defaults (administrative authority on pc required)

35


Publish Scriptbull Embed the script in Excel to make it run from the excelbull Developer will publish the scriptbull This is for Connect Users only

36

Publish the script in Excel

Save it as a template


The Excel Add-in functionalitybull Excel may contain multiple scriptsbull Run rows by row numbers selected filteredbull SAP Values popup pick list

37


DEMObull Show cellbased VA01 published to excel

38


39


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

40


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

41


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

42


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)



3


4

Cell-Based Mapping





5



6




7




8





9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



3


4

Cell-Based Mapping





5



6




7




8





9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42


4

Cell-Based Mapping





5



6




7




8





9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42





5



6




7




8





9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



6




7




8





9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



7




8





9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



8





9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



9


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42


10


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42


11




12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



12



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



13

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN






14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



14

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

RUN - CONDITIONS

If first trans


If sap field Y



Can be nested









15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42







15



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



condition

16





17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



17

Screen A

Screen B

Screen C

Screen D

Screen E

RECORDScreen A

Screen B

Screen C

Screen D

Screen E

















19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42












19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42







19



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



20


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42


21


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42


22

Managing long texts








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42








23



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



24






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42






be cleared

25





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42





one excel column

26



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



27






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42






28



29



30



31


32


33








34






35



36





37



38


39






40






41






42



29



30



31


32


33








34






35



36





37



38


39






40






41






42



30



31


32


33








34






35



36





37



38


39






40






41






42



31


32


33








34






35



36





37



38


39






40






41






42


32


33








34






35



36





37



38


39






40






41






42


33








34






35



36





37



38


39






40






41






42







34






35



36





37



38


39






40






41






42






35



36





37



38


39






40






41






42



36





37



38


39






40






41






42



37



38


39






40






41






42



38


39






40






41






42


39






40






41






42






40






41






42






41






42






42

Documents

TRANSACTION Developer Advanced Training II - … · Winshuttle TRANSACTION Developer Advanced Training I ... Data Validation Read From SAP Winshuttle TRANSACTION Developer Advanced