User Guide - T-Plan
Contents
1. Java test scripts java G T Component Images P A comp0701 15 amp 85 comp0701 16 iq comp0701 17 iq comp0701 18 pa comp0701 19 P Scheduler Test Results LOCOCHE w BrowserTest tpr Report BrowserTest Results xml lick image template comp0701 15 Click image template comp070i i6 passrate 100 wait 1800 Type T Plan Test Automation Youtube wait 500 Press Enter Click image template comp070i i7 passrate i00 Click image template comp070i i2 passrate i00 Click image template comp070i i9 wait i3 lt 00 Press Fi yaho rfo 192 168 1 10 5901 Recorder History I ee x Today at 11 31 AM ou M Click comp0701 16 M Click comp0701 17 Click comp0701 18 Click comp0701 19 Recorded Images Click an image to open the image editor y image1 png 26x24 Recorded Command Click image template comp0701 15 Update e 2 1 Scale Fit The Recorder History pane also links in with the script editor such that when a line of code is clicked it will not only be highlighted itself but will also display the related captured image s Similarly selecting a captured image on the right will highlight the related line of code in the editor BrowserTest tpr 1 Report BrowserTest Results xml lick image template compi 01 15 3 Click image template comp 01 4 www t pla2. NewProject Ej t Test Scripts TPR test scripts tpr a F BrowserTest tpr i Java test scripts java Component Images 9 m a 6 Chrome Messaging Alarm amp clock Contacts Scheduler mn Test Results le a a i n Le LPL SSO E a SimCity Angry Birds TwoDots BrowserTest tpr Report BrowserTest Results xml Scale 113 976 There are a number of ways to initiate the Recorder these include Select Script Record from the Robot menu Use the keyboard shortcut Ctrl Alt R Select the Record icon from the Ribbon bar The recorder offers three different recording modes We will discuss each mode in turn throughout the following chapters 1 Interactive Mode 2 Rapid Mode 3 Legacy Mode Page 4 Interactive Mode This mode gives the user great control at every stage of the recording process Following each action performed against the live environment the user is able to define the exact commands and parameters that they wish to produce all achieved through simple dialogs NOTE This recording mode is not available when using the Local Desktop connection For this scenario we will select the icon Record This will invoke the recorder mode selection window providing the three options already mentioned For this section we will continue with the first Interactive mode Please choose the recorder mode Interactive CY This mode will
3. allow you to customize the template images and or the code created by the recorder Itis the default one for all connections except for the Local Desktop one Rapid This mode creates the template images and the code on the fly using the default settings without asking any questions This is the default mode for the Local Desktop connection we Legacy This mode sets on the legacy x y script recorder Known from the 2 x 3 x and 4 0 versions F Start recording Cancel Help Once the recorder has been initiated it will then react to every mouse action you perform within the Desktop Viewer window or on your keyboard as long as your mouse is over the Desktop Viewer to give it focus Keyboard actions will be posted directly to the script editor with no interaction required a When performing a mouse action i e Click the first thing that Robot does is to analyze the current display The purpose of this analysis is to allow Robot to determine the best image template s to create It does so using a complex algorithm to ascertain the best crop section which follows the standard best practises for template creation keep as small as possible needed while remaining unique Remember also that the image template doesn t always necessarily need to have any meaning in its own right For further guidelines on best practices please see our general help text and online tutorial www t plan com Page 6 Once Rob
4. amp www t plan com T Plan Robot Enterprise Advanced Recorder Or User Guide Summary This document covers the workings of the new recorder functionality provided within the 4 1 release of T Plan Robot Enterprise It intends to describe each option available whilst also providing a guide on how to use the feature The feature has been completely redesigned from the ground up to offer a much more robust end product whilst providing a comfortable user experience along the way The main driver for this update was the fact that the previous recorder feature produced code that contained hard coded coordinates as a basis for any mouse actions that were performed and therefore recorded This led many users to the wrong assumption that T Plan Robot was a coordinate based application which it isn t The areas covered in this document are as follows 1 Pre requisites Functionality gt Interactive Mode gt Rapid Mode gt Legacy Mode 3 Related Information gt New Scripting Command gt New Command Properties Dialog a Pre requisites The Recorder is a standard feature within T Plan Robot Enterprise and is therefore available to all users almost immediately In order to make use of the Recorder feature you must first ensure that you have a few certain things in place Until you have the following in place the recorder option will remain disabled Firstly you must ensure that you are connected to a test environment You
5. can connect via several avenues including the Robot launch screen the Robot menus or using the menu toolbar Connect The recorder feature is available for all of the different connection types Connection Type NESene ns Local Desktop OS Mirror static Image VNC Server Android over ADB dl i i Secondly you must have a Test Script created and open in the editor which in turn requires the presence of a Test Project Both a Project and Test Script can be created under the File menu option File Edit Script Desktop Tools Hel Fa New Project Ctrl Shift N PE Open Project Ctrl Shift O Reopen Project FS Close Project F New Test Script 9 Open Test Scri Reopen Test Script d l At least one Test Script must be open when the recorder is initiated as it will act as the target for the a resulting code Functionality Once all of the pre requisites are in place you can start using the Recorder feature to automatically generate your script commands based on actions you perform against the currently connected test environment The following image shows a typical setup whilst connected to a mobile device From here we are ready to start recording T Plan Robot Enterprise 4 1Beta rfb 192 168 1 12 5901 720x1280 File Edit Script Desktop Tools Help Be 23 Disconnect Record Capture Finch Zcc Execute Sel St Schedule Project D v amp 215 3 40
6. For example a button can have various states such as natural hovered pressed etc Although Robot captures these various image templates based on a complex intelligent algorithm they may require slight modification to ensure they are as you need Changes can be made by clicking the image preview or selecting the Edit button This will open the Template Preview window where you can adjust or reselect the desired template area Here you can also set reset the click point as required Once complete select Save amp Close Save amp Close Qi M 184 190 036107 S Al 88 12 28 y Messaging Alarm clock Contacts Similarly you may find that Robot occasionally captures additional or unwanted template images These can easily be removed from the collection by selecting the Delete button below the relevant template preview Are you sure to delete to delete the image Il Delete Cancel j Finally the bottom pane displays the actual script command that was generated by the recorder for the currently selected collection Recorded Command Click image template comp 7ci i5 As always any generated code can be edited at any time directly in the script editor window using any of the scripting aids and wizards Additionally the command can be edited from the context of the Recorder History window by selecting the Update button Update This will invoke the properties for t
7. e preceding search succeed Template Properti as Image Object TetOCR image1 png image png z Template images g Image Collection and collections Browser Custom pass rate in _ Comparison area Comparison timeout Image Search Parameters Image Search v2 locates components on the screen by template image s See the Image Search ve specification for details Result Sort Mode best Best match first Scale factor s No scaling Hit Compare to start _ Modes LE H T AUME cick OK Cancel S Help www t plan com Page 19
8. he command allowing you to adjust any parameters as required including perhaps the search area tolerance level passrate etc a Legacy Mode This mode reuses the pre 4 1 recoding mechanism It records mouse and keyboards actions directly into the script editor with no interruptions or popup interactions All mouse actions that are performed against the SUT during the recording generate script commands that are based on the mouse location using a coordinate approach This mode is generally used where the AUT is stable in terms of its layout and design Any changes that are required for the captured commands are achieved through the script editor window using he standard scripting aids and wizards Please choose the recorder mode Interactive J This mode will allow you to customize the template images and or the code created by the recorder Itis the default one for all connections except for the Local Desktop one Rapid This mode creates the template images and the code on the fly using the default settings without asking any questions This is the default mode for the Local Desktop connection _ gem Legacy s S This mode sets on the legacy x y script recorder known from the 2 x 3 x and 4 0 versions Start recording Cancel ee Help As the legacy mode produces code based on the Mouse Type and Press commands there is no built in mechanism to wait for something to occu
9. into the active editor Additionally Robot will insert a wait parameter in any command immediately prior to the Type or Press command BrowserTest tpr Report BrowserTest Results xml 2 3 Click image template Erorser walt 2s 4 Click image template GoogleSearch walt 25 5 Type T Plan Test Automation Youtube fi Press Enter ih Click image template TPRobst 5 Click image template TPPChannel wait 25 a Mouse wheeldown count 2 im Click image olate SantaVidec 1 Mouse wheelup count to x 327 v 967 Lu Press Fi l i TIP When applying keyboard actions ensure the mouse pointer remains within the bounds of the Desktop Viewer window in order that the SUT retains the focus and therefore also remains the target of the action a Rapid Mode The Rapid mode allows you to concentrate initially on the task at hand which is to quickly and efficiently record the actions you perform against your test environment such that they can then be replayed thereafter It does so without interruption instead presenting you with the option to customize the recorded data upon completion Given the nature of testing on the Local Desktop this is the default recording mode when using this connection type For this same reason the interactive mode is not available under the Local Desktop connection Once connected to your desired test environmen
10. l invoke the Component Capture wizard allowing you to customize the action that you wish to be recorded into your test script For more details on this option please see the Component Capture section of the online documentation Name When entering the name manually should it match an existing collections name the field will be highlighted yellow The collection name can be entered as a single value or as a folder path using the standard OS path separator For example in Windows you could enter Apps Web Browser For instances where any folder does not already exist it will be created otherwise it will be appended at the point of the lowest level existing folder Existing Collections Selecting the existing collections button will open a small dialog presenting the Component Images tree This allows you to browse all available collections in which to add your new template images Should you manually enter or select an existing collection that already contains a similar image template you will be asked to confirm whether or not you still wish to create the new template FE LE The collection already contains image of the selected component as image1 pnq Is not necessary to create anew one Do you want to force create it You will notice that any keyboard actions applied during the recording process do not invoke any interactive dialogs instead Robot immediately inserts the relevant script commands
11. le the success or failure outcomes with the Mouse click command within the relevant branch such as Waitfor match method search2 template Test1 png timeout 5s if _ EXIT_CODE gt 0 Exit 1 velse Mouse click to x _ COMPARETO CLICK_X y _ COMPARETO CLICK_Y All of this code can now be replaced with a single simplified command as follows Click image template Test1 png The Click command supports the same search parameters as the regular Waitfor and Compareto commands It can also be employed with either the image text or object search methods All of the parameters and options can be applied and edited through the new Click command Properties dialog see below a New Click Command Properties Dialog Along with the addition of the new Click command comes a new corresponding properties dialog allowing you to create or amend any aspect of the command through a point and click action as opposed to worrying about the code syntax should you make the same changes directly within the code editor The Click Properties dialog is essentially split into two main sections as highlighted below The top section relates to the search options what you want to find on the screen Select the desired tab to set the search type Image Object or Text and view all of the corresponding options and parameters The bottom section then handles the subsequent click action should th
12. n com 1 6 passrate 100 wait 1s00 Type T Plan Test Automation Youtube wait 500 Page 12 The Recorder History panel is presented in a tree view which contains a folder for each recording session performed within the current Robot session Within each folder it will list each image collection that was generated during the recording Within the Rapid mode the image collections are automatically named based on the convention Click comp lt mmdd gt lt n gt rfo 192 168 1 10 5901 Recorder History _ ay at 11 31 AM a Click comp me Click comp0701 16 m_ Click comp0701 17 m Click comp0701 18 mn Click comp0701 19 FETTET PEETTE The mini toolbar offers just a few options namely the ability to Delete the selected image collection ee a eren Upon selecting Delete you will be asked to confirm this action before the data is permanently deleted Are you sure to delete the selected code and the related images a Below the image collection tree you will see a preview thumbnail of each image template that was automatically captured during the recording process for the currently selected collection This may range from a single template as below to a number of templates Recorded Images Click an image to open the image editor r imaget png 26x24 If Robot detects that the clicked item can be displayed differently under certain states it may attempt to capture of these
13. ot has completed this task internally it will present the suggested crop area along with some controls to customize the action further Along with details of the size and location of the cropped selection you will also see a few options as follows Customize the resulting action based on the current selection Explained further below This is the name you wish to give to the auto generated Image Collection Existing Collections Select this if you wish to append the new template to an existing image collection To explain each of these options a little further Confirm Once you have confirmed the desired action Robot will proceed to apply the action to the SUT create the Image Collection template and also insert the required script command into the active editor EL Component Images il image1 png 23 Scheduler BrowserTest tpr 1 Report BrowserTest Results xml 2 3 Click image template Brovser 4 D Customize If you select to customize the action you will be presented with three sub options Cancel F Design code with Component Capture K Help on script recording Skip Will apply the click action into the SUT without recording it to your test script Cancel Will discard the action completely It will not be applied to the test environment nor will it generate any code within your test script Design code with Component Capture as it suggests this wil
14. r therefore this mode also inserts a Wait parameter for each command thus recording and eventually executing your actions in real time BrowserTesttpr LegacyRecorder tpr 1 Report Results xml 3 Mouse click to x 34 yr251 wait s200 4 Mouse click to x 267 v 661 wait 2300 5 Type T Plan Test Automation Youtube wait sigo f Press Enter wait oo T Mouse click to x 195 24 wgait 15500 S Mouse click to x 77 vid2l 4 Wait 25o90 a m eo 9 Mouse wheeldown to x 315 y 20 wait 2i100 WI House wheeldown count 2 to x 315 v 820 wait 1900 HE Mouse click to x 442 y 887 wait 7100 EI Mouse wheelup count 12 to x 367 y 818 wait 3200 3 Press Fi id Any required image text comparisons verification points or screenshots should be inserted after the recording and can be generated using the standard menus and scripting aids www t plan com Page 17 Related Information New Scripting Command Along with the new recorder feature comes a brand new scripting command Click The Click command offers a much simplified method of searching for an item and then clicking it when using either of the image text or object search types Previously a simple find and click action required the combination of firstly the search waitfor compareto followed then by an If Else statement to hand
15. t the recording is initiated in the standard ways as listed previously Please choose the recorder mode Interactive le This mode will allow you to customize the template images and or the code created by the recorder Itis the default one for all connections except for the Local Desktop one Rapid This mode creates the template images and the code on the fly using the default settings without asking any questions This is the default mode for the Local Desktop connection wm Legacy This mode sets on the legacy x y script recorder known from the 2 x 3 x and 4 0 versions T L Start recording Cancel a Help Once Rapid Mode selection has been made you can immediately begin to perform the desired actions against the SUT As the name suggests there will be no interactions or popup dialogs presented by Robot allowing you an uninterrupted session to record your test TIP When using the Local Desktop connection you must press RIGHT CTRL to end the recording a session and return to the Robot Ul When you have completed your recording session Robot will display the Recorder History window in the right hand pane 4 T Plan Robot Enterprise 4 1Beta rfb 192 168 1 10 5901 720x1280 File Edit Script Desktop Tools Help Obs gt E amp Record Capture F 1200 Execute Selectio Schedule Aiea X NewProject f Test Scripts 2 TPR test scripts tpr
Download Pdf Manuals
Related Search