JAutomate The third generation GUI test automation tool

Transcription

1 JAutomate The third generation GUI test automation tool JAutomate Copyright Innovative Tool Solutions (33)

2 Table of Contents JAutomate...4 Pure Java...4 Scripting...4 Images...4 Comments Special...5 Script...5 Parameter File...5 Parameter File...6 Recording a Script...6 Recording Options...7 Start an Application to Test...7 Recording a New Step...7 Recapture Image...9 Rename Image...9 Running a Script...9 Running a Suite of Scripts...10 Iterations...10 Call a Script with...10 Test Suite...10 Execution Log...10 Test Log...10 Running Tests in a Batch File...10 Running Tests in FitNesse...11 FitNesse Test...11 Script Doctor...11 Manual Tests...12 Manual Recovery...12 Automatic Recovery...12 Manual Run...13 Using the JAutomate API from Java...13 Java Class...13 Reports...14 Customizing Reports...14 Test Summary Report...14 Test History Report...15 Test Run Report...16 List of Commands...17 Begin...17 Call...17 CallIf...18 CallIfNot...18 CallWhile...19 JAutomate Copyright Innovative Tool Solutions (33)

3 CallWhileNot...19 Catch...19 Doctor...20 DoubleCheck...20 End...20 IndexPosition...21 Iterations...21 ManualTest...21 ManualRecovery...22 Mode...22 MouseMove...22 MouseMoveRelative...23 MouseMoveText...23 MouseLeftClick...24 MouseMiddleClick...24 MouseRightClick...24 MouseLeftPress...24 MouseMiddlePress...24 MouseRightPress...24 MouseLeftRelease...24 MouseMiddleRelease...24 MouseRightRelease...24 MouseScroll...24 ReadText...25 ReadTextSensitivity...25 RelativePosition...26 Search...26 Sensitivity...27 Start...27 StartFile...27 StartWeb...27 StepDelay...28 StopIfFailed...28 Timeout...28 UniquePosition...28 Verify...29 VerifyNot...29 Wait...29 WaitMouseMove...30 WaitMouseMoveText...30 WaitReadText...31 WaitStableScreen...32 WaitText...32 WaitVerify...32 WorkingDirectory...32 Write...33 JAutomate Copyright Innovative Tool Solutions (33)

4 JAutomate JAutomate is a third generation GUI test automation tool that will make test automation of a user interface easier and much more reliable. There are now three generations of automated GUI test tools: 1. Position based. Record and replay using fixed coordinates. Worked fine for old command line applications since the screen resolution was fixed and all applications operated in full screen mode. 2. Object based. Window based application can have any screen size and location. The GUI widgets are encapsulated by objects to be able to record scripts that are tolerant to changes in the user interface. This fixes the problem with the first generation tools but object based automation tools are very sensitive to third party or customized widgets. This makes them really inefficient to use unless the application under test was designed with test automation, and the selected test automation tool, in mind. 3. Image recognition. The test tool can actually visually identify (see) the position on the screen to interact with just like a manual tester. This makes the third generation test automation tools insensitive to both fixed coordinates and implementation details of the user interface. A third generation test automation tool can automate any type of application regardless of framework and operating system used. Pure Java JAutomate is 100% pure Java and contains no native code. This means that you will be able to record and playback scripts on any platform that supports Java. JAutomate can also be used for automating any type of application that has a user interface regardless of how it is implemented. Scripting A test consists of a script and a number of images. Use JAutomate Studio or a normal text editor to edit the scripts. Specify one command on each row in a script. A command may have one or more parameters. See List of Commands for details about available commands. Images Images are used by many of the commands to find something on the screen instead of specifying the exact coordinates. Images are captured with the JAutomate Recorder or by using a screen capture (grabber) tool, like Snagit ( Make sure that you capture the images before moving the mouse pointer since that might affect the appearance on screen. Also make sure that you save the images using a non-lossy compression algorithm, like png, and without transparency. Comments Add blank lines and comments to the script to make the script more readable. A commented line begins with two forward slashes //. JAutomate Copyright Innovative Tool Solutions (33)

5 Pass parameters to the script from the command to make the script more reusable. You may, for example, like to pass the number of milliseconds to wait between script operations. are also useful for making the script language independent by passing information of where to find the images to use for the comparisons. There might be several folders with different image versions, one for each language. are enclosed in brackets, for example: {delay} Special There are some built-in special parameters that are set by JAutomate during script execution. Special parameters are listed in the table below: Parameter ReadText CurrentX CurrentY Description Text read by the ReadText command. The last X-coordinate set by the MouseMove or WaitMouseMove commands. Useful for moving one coordinate only. The last Y-coordinate set by the MouseMove or WaitMouseMove commands. Useful for moving one coordinate only. Script // Start the jautomate.com website StartWeb StepDelay {delay} // Demo the website WaitMouseMove images/ png MouseLeftClick WaitMouseMove images/ png MouseLeftClick WaitMouseMove images/ png MouseLeftClick WaitMouseMove images/ png MouseLeftClick WaitMouseMove images/ png MouseLeftClick WaitMouseMove images/ png MouseLeftClick // Verify that we are back at the first page WaitVerify images/ png Parameter File Use a Comma Separated Values (CSV) file to pass parameters to the script. This makes data-driven testing possible. Specify one parameter per column in the CSV file. The script will be executed one time for each row in the CSV file. JAutomate Copyright Innovative Tool Solutions (33)

6 Specify the parameter names in the first line of the CSV file. Parameter names are case sensitive. You may use any common (like TAB, colon, semicolon) column delimiter, JAutomate will automatically detect the delimiter used. Parameter File LoginId Password MenuItem Tom Secret File Erica Secret Edit Recording a Script The script recorder makes it a lot easier to quickly create a test script. Creating a test script is a three step process: 1. Record your test case with the application. JAutomate will store a number of screenshots to use in the next step. The Recorder will automatically create steps and images during recording if that feature is enabled. See Recording Options. 2. Go through the recorded screenshots one step at a time. Add commands and images to the script when needed. 3. Manually edit the script to make optional adjustments before trying to run the script. Follow the steps below to record and create a test script for an application: 1. Open the Recorder by pressing the Record button or selecting that option from the Script menu. 2. If you are not recording an already visible application then begin by opening the application to test using the Start or Start Web buttons. See Start an Application to Test below for details. 3. Start recording your test case by pressing the Record button. 4. Record your test case slowly step-by-step. 5. Press the Stop button when done. The Command Wizard will appear. Use the Command Wizard to add commands to the script. Step through the recorded screenshots step-by-step and add commands when needed. 6. Use the slider or the Next/Previous buttons to step through the recorded test case. You may also use the Page Up and Page Down keys. 7. Select one of the buttons to record a new command or step. See Recording a New Step below. 8. Close the Command Wizard when done. 9. Modify the script if needed and try running the script to verify that it works. JAutomate Copyright Innovative Tool Solutions (33)

7 Recording Options JAutomate can generate a script automatically when recording an application. There are three options in the Script menu: Record mouse clicks (Windows only) Record mouse moves Record keystrokes (Windows only) JAutomate will enclose all steps, with Begin and End commands, when recording a script if the Manual Recovery option is enabled in the Script menu. See Manual Recovery for more information. Start an Application to Test If you are not recording an already visible application you should open the application or web site to test before recording the script. Select the Start button to open the application to test. Browse to find the application or file to launch. You may select an executable or a file associated with an executable. Use the StartWeb button if you need to record a web site or application. Recording a New Step Select the Click, Click text, Move, Write, Verify or Read buttons to record a new step when using the Command Wizard. Click Selecting the Click button will start the capture of a mouse click. Follow the steps below: 1. Move the mouse cursor to the position to click. 2. Adjust the size of the image to capture by using the arrow keys on the keyboard. You need to make the screen capture large enough in order to make the image unique enough to be able to find upon playback. Reset the size of the capture rectangle by pressing the Home button on your keyboard. Press Esc on the keyboard to cancel the operation. 3. Press the left, middle or right button on your mouse to record the event into your script at the current cursor position. The captured image will appear in the image list to the right. 4. Repeat steps 1-3 to capture another mouse click. Press the Esc key or select another button to quit. Click text Select the Click text button to add a WaitMouseMoveText command to the script. Follow the steps below: 1. Enter the text to click on. 2. Select the font name, size and type manually or press the Autodetect button to automatically detect font, size and type. Use the Locate button to verify that the JAutomate Copyright Innovative Tool Solutions (33)

8 Move system can find the text on screen. The Preview button will display the selected font. 3. Press OK to insert a command to the script at the current cursor position. Select the Move button to move the mouse pointer or cursor. Follow the steps below: Write 1. Move the mouse cursor to the position to move to. 2. Adjust the size of the image to capture by using the arrow keys on the keyboard. You need to make the screen capture large enough in order to make the image unique enough to be able to find upon playback. Reset the size of the capture rectangle by pressing the Home button on your keyboard. Press Esc on the keyboard to cancel the operation. 3. Press the left button on your mouse to record the event into your script at the current cursor position. The captured image will appear in the image list to the right. 4. Repeat steps 1-3 to record another move. Press the Esc key or select another button to quit. Select the Write button to write text to the widget in focus. Use the Write command to write text to, for example, a text field. The Write command simulates key-presses (and key-releases) from a keyboard. Follow the steps below: 1. Enter a text to write. 2. The command will be added to your script at the current cursor position. Verify Selecting the Verify button will start the capture of a verification. Follow the steps below: Read 1. Move the mouse cursor to the result to verify. 2. Adjust the size of the image to capture and verify by using the arrow keys on the keyboard. Reset the size of the capture rectangle by pressing the Home button on your keyboard. Press Esc on the keyboard to cancel the operation. 3. Press the left button on your mouse to record the event into your script at the current cursor position. The captured image will appear in the image list to the right. 4. Repeat steps 1-3 to capture another verification. Press the Esc key or select another button to quit. Select the Read button to read text from the screen using Object Character Recognition (OCR). Follow the steps below: 1. Move the mouse cursor to a text or image close to the area to capture. The image to capture is indicated by a yellow rectangle. 2. Adjust the size of the image to capture by using the arrow keys on the keyboard. You need to make the screen capture large enough in order to make the image unique enough to be able to find upon playback. Reset the size of the capture rectangle by pressing the Home button on your keyboard. Press Esc on the keyboard to cancel the operation. JAutomate Copyright Innovative Tool Solutions (33)

9 3. Press the left button on your mouse to capture the relative image. 4. Move the mouse cursor to select the area to read from. You may only read one line of text. The area to read from is indicated by a red rectangle. 5. Adjust the size of the area to read from by using the arrow keys on the keyboard. You need to make the screen capture large enough in order to make the image unique enough to be able to find upon playback. Reset the size of the capture rectangle by pressing the Home button on your keyboard. Press Esc on the keyboard to cancel the operation. 6. Press the left button on your mouse to select the read area rectangle. 7. Enter a sample text. Enter the current text in the area to read from, if possible, since that will make it easier to choose the correct font. 8. Select the font name, size and type manually or press the Autodetect button to automatically detect font, size and type. Use the Locate button to verify that the system can find the text on screen. The Preview button will display the selected font. 9. Press OK to insert a command to the script at the current cursor position. Recapture Image Recapture images by right-clicking an image in the image list and selecting the Recapture option. Adjust the size of the image to capture by using the arrow keys on the keyboard. You need to make the screen capture large enough in order to make the image unique enough to be able to find upon playback. Reset the size of the capture rectangle by pressing the Home button on your keyboard. Press Esc on the keyboard to cancel the operation. Press the left mouse button to recapture the image. Rename Image Image names are automatically generated by the recorder. You may rename images easily by right-clicking an image in the image list and selecting the Rename option. Renaming a file will also adjust the script automatically. Running a Script Click the Run button, or select that option from the Script menu, to run the script. The output will be displayed in the log window below the script. You may also run a portion of the script. Select a number of rows and press the Run selected button to run the selected rows. JAutomate Copyright Innovative Tool Solutions (33)

10 Running a Suite of Scripts A script may call other scripts. You may create a test script, or suite, that only calls other scripts. The suite would only contain a number of Call commands. The Call command may contain parameters to the script to execute. You may also specify a number of times to repeat the script before completing. For details, see the Call command in List of Commands. Iterations Scripts can be repeated. Specify the number of times to run the script(s) by providing a number before the first script name. You may repeat one or many scripts several times: Call 10 scripts/script1.txt scripts/script2.txt Call a Script with Pass parameters to a script to make the script more reusable. Keys and values are separated with an = sign and parameters are separated by an & character. Provide a list of parameters before the script, for example: Call sensitivity=90&wait=1000 scripts/script1.txt Test Suite StopIfFailed No Call "scripts\script1.txt" Call "scripts\script2.txt" Execution Log All executed commands are logged in the execution_log.txt file. You may also see the results of any of the Verify commands. A script will terminate with an error message in the execution log if any operation fails. Test Log All scripts are logged in the test_log.txt file. The log contains date and time when scripts started, completed or failed. Running Tests in a Batch File You may execute one or many scripts using the JAutomate.jar file. Place the calls in a batch file to be able to execute JAutomate several times in order to complete an entire test suite. Use, for example, the operating system command below to run a test: java -jar JAutomate.jar scripts\script.txt You may run several scripts at a time: java -jar JAutomate.jar scripts/script 1.txt scripts/script 2.txt You may repeat one or many scripts several times: JAutomate Copyright Innovative Tool Solutions (33)

11 java -jar JAutomate.jar 10 scripts/script1.txt scripts/script2.txt Provide a list of parameters before the script on the command line, for example: java -jar JAutomate.jar sensitivity=90&wait=1000 scripts/script1.txt Provide a CSV file that contains parameters: java -jar JAutomate.jar scripts/parameters.csv scripts/script.txt Running Tests in FitNesse You may export scripts to FitNesse and run the tests there. FitNesse is an open source tool for acceptance testing and can be downloaded from: Follow the steps below to run a test in FitNesse: 1. Use the Export as FitNesse option from the File menu to save a script as a FitNesse test. 2. The JAutomate.jar file needs to be copied to the same folder as the "fitnesse.jar" file. 3. Copy the "images" folder to the same folder as the "fitnesse.jar" file to make it possible for JAutomate to find them. 4. Copy the exported FitNesse test into a FitNesse page and run the test. FitNesse Test!path JAutomate.jar!define TEST_SYSTEM {slim}! script jautomate.jautomatefixture execute StartWeb execute WaitMouseMove images/ png execute MouseLeftClick execute WaitMouseMove images/ png execute MouseLeftClick execute WaitMouseMove images/ png execute MouseLeftClick execute WaitMouseMove images/ png execute MouseLeftClick execute WaitMouseMove images/ png execute MouseLeftClick execute WaitMouseMove images/ png execute MouseLeftClick execute WaitVerify images/ png Script Doctor Use the Script Doctor to automatically improve the images in your script. The Doctor will detect images that can be improved while running a script. The Doctor will ask the user before performing any changes after running a script. Activate or deactivate the Script Doctor from the Script menu or by using the Doctor command. Deactivate the Doctor to improve the script playback speed. JAutomate Copyright Innovative Tool Solutions (33)

12 Manual Tests Some steps in the test case might be difficult to automate. In JAutomate you may create manual or semi-manual tests using the ManualTest command. JAutomate will show the Manual Test dialog containing the manual test instruction. The user selects the Pass or Fail button after trying to perform the instruction. See the ManualTest command for more information. Manual Recovery JAutomate may ask the user to complete a failed command manually instead of failing the test when manual recovery is enabled. Semi-automated tests are less fragile than fully automated tests. The user may, for example, be instructed to manually click on a button that JAutomate failed to find. JAutomate will enclose all steps, with Begin and End commands, when recording a script if the Manual Recovery option is enabled in the Script menu. The Begin command contains a manual instruction that will be used if the automated script fails before reaching the End command. See the ManualRecovery and Begin commands for more information. Automatic Recovery To make a script even more reliable it is possible to insert one or many Catch commands between the Begin and End commands. The commands between the Catch command and the next Catch or End command will be executed automatically before recovering manually if the script fails before reaching the Catch command.. You may insert any number of Catch commands and JAutomate will try them one-by-one until one of them is executed without problems. See the Catch command for more information. JAutomate Copyright Innovative Tool Solutions (33)

13 Manual Run A script that contains ManualTest or Begin commands can be run manually. Click the Manual Run button in the toolbar or select the Manual Run option from the Script menu to run a script manually. Using the JAutomate API from Java Use the JAutomate API to create powerful test scripts or applications in Java. The API documentation can be found in the javadoc folder. Make sure to add the JAutomate.jar file to the project build path. Java Class public class Test { public void RunTest() { ScriptRunner scriptrunner=new ScriptRunner(ScriptLogger()); scriptrunner.runscript("testscript", "WaitMouseMove \"images/ png\" 33 50", null); scriptrunner.runscript("testscript", "MouseLeftClick", null); } } JAutomate Copyright Innovative Tool Solutions (33)

14 Reports View your test results from a set of customizable reports. Reports are only available in the Pro version of JAutomate Studio. Generate and view a report from the Reports menu in JAutomate Studio Pro. The reports are based on the statistics stored in the test_history.csv file. Both the standard and pro versions of JAutomate Studio stores test statistics from all test runs in this file. Customizing Reports All reports in JAutomate can be customized using the templates provided. Each type of report has it s own template. The templates can be found in the Reports folder and their filename ends with _template.htm. You may customize anything from font, language, date & time format, colors and formatting. Test Summary Report The Test Summary Report lists all tests that have been run. Click on the script filename link to get more information about each run. The table columns are: Column Script Runs Passed Failed Last Status Description The filename of the script. The total number of times run. The number of times that the script was run without problems. The number of failed runs. The status (Passed or Failed) of the latest run. JAutomate Copyright Innovative Tool Solutions (33)

15 Test History Report The Test History Report lists all runs for a given script. Click on the date or time link to get more information about the script execution. The table columns are: Column Date Time Passed Failed Description The date that the script was run. The time that the script was run. The number of commands that was executed without problems. The number of failed commands. JAutomate Copyright Innovative Tool Solutions (33)

16 Test Run Report The Test Run Report lists all commands that have been executed in a test run. The table columns are: Column Command Run Status Description The script command. Passed or Failed. JAutomate Copyright Innovative Tool Solutions (33)

17 List of Commands Command names are case insensitive. Some commands are followed by one or many parameters. Command and parameters are separated by spaces. Enclose a parameter in double quotes if it contains spaces. Paths can be absolute or relative to the jar (Java executable) file. Begin The Begin commands indicates the starting point of one step in the script. A Begin command should be ended with an End command. The Begin command contains a manual instruction that will be used if the automated script fails before reaching the End command. Note that the Begin command may take any number of Instruction and/or ImagePath parameters. This makes it easy the create instructions containing both text and images. The Begin command uses the same syntax as the ManualTest command. Instruction [ImagePath] [ResultParameter=] The instruction that appears in the Manual Test dialog in HTML format. An optional path to an image to display after the instruction. An optional parameter that will hold the result entered by the user. The Result field is only displayed if the Begin command has a ResultParameter. Note that the ResultParameter needs to have a trailing equal (=) sign. Begin Click the OK button Begin "Left click on icons/check_small.png <br>write \"{text}\" Begin Enter the sum of the calculation in the Result field MyResult= Call Calls another script. The execution will continue when/if all the steps in the called script are completed. Calls are useful for creating test suites. The called script will not inherit the settings from the calling script. [Iterations] [] ScriptPath Number of times to repeat the called script. This parameter is optional and defaults to 1. to the called script. This is optional and defaults to no parameters. Keys and values are separated with an = sign and parameters are separated by an & character. Enclose parameters in double quotes if it contains spaces. Path to the script to call. You may specify any number of scripts to call. s JAutomate Copyright Innovative Tool Solutions (33)

18 Call 10 scripts/calc.txt Call scripts/calc1.txt scripts/calc2.txt Call wait=1000&path=scripts scripts/calc.txt CallIf Calls another script if the provided image can be found. The execution will continue when/if all the steps in the called script are completed. Use CallIf to add conditional steps to your test suite. The called script will not inherit the settings from the calling script. ImagePath [Iterations] [] ScriptPath Path to an image. The script is called if the image is currently visible on the screen. CallIf will not wait for the image to appear. Number of times to repeat the called script. This parameter is optional and defaults to 1. to the called script. This is optional and defaults to no parameters. Keys and values are separated with an = sign and parameters are separated by an & character. Enclose parameters in double quotes if it contains spaces. Path to the script to call. You may specify any number of scripts to call. s CallIf images/loginbutton.png scripts/calc.txt CallIf images/loginbutton.png 10 scripts/calc.txt CallIf images/loginbutton.png scripts/calc1.txt scripts/calc2.txt CallIf images/loginbutton.png wait=1000&path=scripts scripts/calc.txt CallIfNot Calls another script if the provided image cannot be found. The execution will continue when/if all the steps in the called script are completed. The called script will not inherit the settings from the calling script. ImagePath [Iterations] [] ScriptPath Path to an image. The script is called if the image is not visible on the screen. Number of times to repeat the called script. This parameter is optional and defaults to 1. to the called script. This is optional and defaults to no parameters. Keys and values are separated with an = sign and parameters are separated by an & character. Enclose parameters in double quotes if it contains spaces. Path to the script to call. You may specify any number of scripts to call. s CallIfNot images/listitem.png scripts/calc.txt JAutomate Copyright Innovative Tool Solutions (33)

19 CallWhile Calls another script while an image can be found on screen. The CallWhile operation will continue calling the other script until the image can not be found. The called script will not inherit the settings from the calling script. The operation will complete after a certain number of iterations. The number of iterations can be adjusted with the Iterations command. ImagePath [] ScriptPath Path to an image. The script is called if the image is currently visible on the screen. While will not wait for the image to appear. to the called script. This is optional and defaults to no parameters. Keys and values are separated with an = sign and parameters are separated by an & character. Enclose parameters in double quotes if it contains spaces. Path to the script to call. You may specify any number of scripts to call. s CallWhile images/loginbutton.png scripts/calc.txt CallWhile images/loginbutton.png wait=1000&path=scripts scripts/calc.txt CallWhileNot Calls another script while an image cannot be found on screen. The CallWhileNot operation will continue calling the other script until the image is found. The called script will not inherit the settings from the calling script. The operation will complete after a certain number of iterations. The number of iterations can be adjusted with the Iterations command. ImagePath [] ScriptPath Path to an image. The script is called until the image is found on the screen. to the called script. This is optional and defaults to no parameters. Keys and values are separated with an = sign and parameters are separated by an & character. Enclose parameters in double quotes if it contains spaces. Path to the script to call. You may specify any number of scripts to call. s CallWhileNot images/loginbutton.png scripts/calc.txt Catch A Catch command should be inserted after a Begin command but before an End command. Commands between the Catch command and the End command will be executed if any of the commands between the Begin and Catch command fails. JAutomate Copyright Innovative Tool Solutions (33)

20 Begin Click the login button // First try MouseMove images/loginbutton.png MouseLeftClick Catch // Second try MouseMove images/loginbutton2.png MouseLeftClick Catch // Third try MouseMove images/loginbutton3.png MouseLeftClick End Doctor Use the Script Doctor to automatically improve the images in your script. The Doctor will detect images that can be improved while running a script. The Doctor will ask the user before performing any changes after running a script. Enable Select Yes to activate the Script Doctor. No, by default. Doctor Yes DoubleCheck Images are normally checked twice before JAutomate accepts the image as a match. The first check is if the image in the script matches the target on screen. The second check is if the target on screen matches the image in the script. The second check will not be performed if DoubleCheck is disabled. There are mainly two reasons for disabling this option: 1. To improve the speed of image comparisons. 2. To take advantage of the one-way comparison. For example, to traverse through a table regardless if it contains text or not. An image that contains an empty cell would match regardless if the cell on screen contains text or not. Enable Select No to disable double checks. Yes, by default. DoubleCheck No End The End commands indicates the ending point of one step in the script. A Begin command should be ended with an End command. See the Begin command for more information. JAutomate Copyright Innovative Tool Solutions (33)

21 IndexPosition Use IndexPosition when you need to find anything but the first image or text on screen. You might, for example, like to click on the second OK button instead of the first. JAutomate searches for images from top to bottom and from the left to the right. The first found image has IndexPosition zero. IndexPosition The index of the image or text to find. Default set to 0. IndexPosition 1 Specify a value between 0 and Iterations Sets the maximum number of iterations for the CallWhile and CallWhileNot commands. Iterations Maximum number of iterations. Default set to Specify a value between 1 and Iterations 10 ManualTest Some steps in the test case might be difficult to automate. In JAutomate you may create manual or semi-manual tests using the ManualTest command. JAutomate will show the Manual Test dialog containing the manual test instruction. The user selects the Pass or Fail button after trying to perform the instruction. Note that the ManualTest command may take any number of Instruction and/or ImagePath parameters. This makes it easy the create instructions containing both text and images. Instruction [ImagePath] [ResultParameter=] The instruction that appears in the Manual Test dialog in HTML format. An optional path to an image to display after the instruction. An optional parameter that will hold the result entered by the user. The Result field is only displayed if the ManualTest command has a ResultParameter. Note that the ResultParameter needs to have a trailing equal (=) sign. ManualTest Fetch the report from the printer and verify the output ManualTest "Left click on icons/check_small.png <br>write \"{text}\" JAutomate Copyright Innovative Tool Solutions (33)

22 ManualTest Enter the sum of the calculation in the Result field MyResult= ManualRecovery JAutomate may recover from failed commands using a manual test instruction. A failed command will, in most cases, be replaced by a manual test instruction if ManualRecovery is enabled. Yes/No Yes to enable manual recovery. No, by default. ManualRecovery Yes Mode Select the type of image comparison algorithm. The Auto mode is the default. When the Auto mode is selected, JAutomate will first try to find the image using the Fast mode. If the image can not be found, JAutomate will try again using the Tolerant mode. Auto is the most reliable mode but also the slowest. Set the mode manually to make the script execution faster. The Fast mode is quick and will almost certainly give an accurate result when finding an image. The Fast mode will not always find an image if there are small changes between the recorded image and the actual image on screen. The Tolerant mode compares by contrast instead of colors and is much more tolerant to deviations between the recorded and actual image. The Tolerant mode will in most cases, for example, find a text that was selected during recording but was not during playback. The Tolerant mode may however find incorrect matches. Try to use larger images when using the Tolerant mode. Note the you may also adjust the sensitivity if you get an incorrect playback result. Mode Auto, Fast or Tolerant. Default is Auto. Mode Tolerant MouseMove Moves the mouse position to a screen position indicated by an image. The mouse position will be placed in the center of the image by default. You may optionally set a relative position where to place the mouse cursor. The default value of 50, 50 will place the mouse position in the center of the image. A value of 0, 0 will place the mouse position in the upper, left corner of the image. A value of 100, 50 will place the mouse position in the middle, right corner of the image. JAutomate Copyright Innovative Tool Solutions (33)

23 The mouse position may also be specified using fixed screen coordinates or using two images. The first images gives the X-coordinate and the second image gives the Y- coordinate to move to. This is useful when automating tables. ImagePath [PercentX] [PercentY] Or X or ImagePathX Y or ImagePathY Path to the image to move the mouse position to. Enclose the path in double quotes if it contains spaces. The relative X-position in percent of the image height. The relative Y-position in percent of the image width. X coordinate to move the mouse position to or path to the image to get the X-coordinate to move to. Y coordinate to move the mouse position to or path to the image to get the Y-coordinate to move to. s MouseMove images/loginbutton.png MouseMove images/loginbutton.png MouseMove MouseMove images/columnheader.png images/rowheader.png MouseMove {CurrentX} images/rowheader.png MouseMoveRelative Moves the mouse position relative the current cursor position. X Y Relative X coordinate movement. Relative Y coordinate movement. MouseMoveRelative MouseMoveText Moves the mouse position to a screen position indicated by a text. A text will be located on screen given the font type, style and size. Note that JAutomate may find a text included in any media, for example in images or movies. The mouse position will be placed in the center of the text by default. You may optionally set a relative position where to place the mouse cursor, see RelativePosition. Font Size Style The font name. The size of the font in points. The font style. Options: Plain, Bold, Italic or BoldItalic. JAutomate Copyright Innovative Tool Solutions (33)

24 Font Text The font name. The text to locate and move the mouse position to. MouseMoveText Segoe UI 10 Plain File MouseLeftClick Send a mouse press followed by a release to the current position. MouseMiddleClick Send a mouse press followed by a release to the current position. MouseRightClick Send a mouse press followed by a release to the current position. MouseLeftPress Send a mouse press to the current position. MouseMiddlePress Send a mouse press to the current position. MouseRightPress Send a mouse press to the current position. MouseLeftRelease Send a mouse release to the current position. MouseMiddleRelease Send a mouse release to the current position. MouseRightRelease Send a mouse release to the current position. MouseScroll Scrolls the mouse wheel a number of steps. Steps No of steps to scroll. A positive number will scroll down and a negative value will scroll up. Specify a value between -100 and 100. JAutomate Copyright Innovative Tool Solutions (33)

25 s MouseScroll 1 MouseScroll -2 ReadText Reads a text from the screen using Object Character Recognition (OCR). Useful for reading some output and use that text to write or select something at a later stage in the test script. Only one line of text may be read. The result of the ReadText command will be stored in the ReadText parameter. Use the read text by inserting the parameter {ReadText} somewhere below the ReadText command in the script. Note that the ReadText command is more accurate on larger fonts. Also try to specify a CharSet to improve the results. Font Size Style ImagePath DeltaX DeltaY Width Height [CharSet] The font of the text to read. The size of the font in points. The font style. Options: Plain, Bold, Italic or BoldItalic. The path to a relative image. The relative image is used to find the absolute position of the capture rectangle. This image might contain the text to the left or above the text field to read from. Distance in pixels from the relative image to the capture rectangle. Distance in pixels from the relative image to the capture rectangle. Width of the capture rectangle. Height of the capture rectangle. An optional character set. Specify a CharSet to improve the accuracy of the text recognition. The default is AlphaNum. Lower and Upper will only detect lowercase or uppercase characters or digits. s Options: Num, AlphaNum, Hex, Uuid, Lower, Upper ReadText "Segoe UI" 10 Plain "images\ png" "alphanum" MouseMoveText "Segoe UI" 10 Plain {ReadText} ReadTextSensitivity Adjust the sensitivity of the image comparison algorithm when reading text using OCR. Modify the sensitivity if the text is not captured correctly by the ReadText command. JAutomate Copyright Innovative Tool Solutions (33)

26 Percent Sensitivity in percent. Default set to 80. Specify a value between 1 and 100. ReadTextSensitivity 70 RelativePosition The position relative to the image, found by a MouseMove command, to place the mouse position. The default value of 50, 50 will place the mouse position in the center of the image. A value of 0, 0 will place the mouse position in the upper, left corner of the image. A value of 100, 50 will place the mouse position in the middle, right corner of the image. The RelativePosition is reset to the default value (50, 50) after the MouseMove command has been executed. PercentX The relative X-position in percent of the image height. 50 by default. PercentY The relative Y-position in percent of the image width. 50 by default. s RelativePosition RelativePosition RelativePosition 0 0 Search The Search command simplifies scripting and can be used to handle scrollbars and next/previous buttons automatically when trying to find an image. The Search command instructs JAutomate how to search for an image if not found directly by the WaitMouseMove command. JAutomate will try to click with the left mouse button on the first image. JAutomate will try the next image if the first image is not found on screen. JAutomate will continue trying until the time-out occurs. You may specify any number of images to use. Call Search will no parameters to disable search. Note that JAutomate will click in the center of each search image. It is not possible to set a relative position. ImagePath1 ImagePath2... Path to an image to try first. Path to an image to try if the first was not found. JAutomate Copyright Innovative Tool Solutions (33)

27 s Search images/scrolldown.png images/scrollup.png Search Sensitivity Adjust the sensitivity of the image comparison algorithm. A value of 100 requires an almost perfect match. Reduce the sensitivity if an image is not recognized. You will get invalid matches if you reduce the sensitivity too much. Note that you also may try to grab the image again or change the image recognition mode. Percent Sensitivity in percent. Default set to 95. Sensitivity 90 Specify a value between 1 and 100. Start Starts an application to test. You may either test on a running application or start an application from the script. Set the WorkingDirectory before executing this command if needed. ApplicationPath Path to an application to launch for test. You may include any number of parameters after the file path. Enclose the path including parameters in double quotes if it contains spaces. Start explorer StartFile Launches a file with the associated application. FilePath Path to a file to launch for test. Enclose the filepath in double quotes if it contains spaces. StartFile JavaApplication.jar StartWeb Launches the default web browser with the supplied URL. JAutomate Copyright Innovative Tool Solutions (33)

28 URL Web address to the page to start. Enclose the URL in double quotes if it contains spaces. StartWeb StepDelay The number of milliseconds to wait before executing the next step (line) in the script. This is an alternative to using the Wait command. Milliseconds The number of milliseconds to wait before executing the next step (line) in the script. Specify a value between 0 and StepDelay 1000 StopIfFailed Decide if the script should stop executing when one step fails. Otherwise the script will continue running with the next row. Set to No in the beginning of a test suite to continue calling other test cases after one failed call. StopIfFailed Yes to stop the script if one step fails. No to continue executing if a step fails. Yes, by default. StopIfFailed No Timeout Set the maximum amount of time to wait for an image to appear on screen before failing. Seconds The number of seconds to wait for an image to appear on screen before failing. 30 seconds by default. Specify a value between 1 and 600. Timeout 120 UniquePosition A MouseMove command will only find unique hits when UniquePosition is set to Yes. The MouseMove command will otherwise return with the first found position of the image. JAutomate Copyright Innovative Tool Solutions (33)

29 This option is recommended with the Tolerant mode that might otherwise return with a non-unique image position. UniquePosition Yes to only return with unique image positions. No to return with the first found image position. No by default. UniquePosition Yes Verify Verify that an image appears on screen. ImagePath [X] [Y] Path to image to verify. Enclose the path in double quotes if it contains spaces. Optional X coordinate to verify against an exact position. Optional Y coordinate to verify against an exact position. Verify images/confirm_dialog.png Verify images/confirm_dialog.png {CurrentX} {CurrentY} VerifyNot Verify that an image does not appear on screen. ImagePath Path to image to verify. Enclose the path in double quotes if it contains spaces. VerifyNot images/confirm_dialog.png Wait Wait a number of milliseconds before executing the next command. You may also wait for an image to appear on screen. The default timeout period for waiting for an image to appear is 60 seconds. You may modify this value using the Timeout command. NoMilliseconds or ImagePath The number of milliseconds to wait before executing the next command. Specify a value between 0 and Image to wait for until it appears on screen. Enclose the path in double quotes if it contains spaces. JAutomate Copyright Innovative Tool Solutions (33)

30 s Wait 1000 Wait images/ok_button.png WaitMouseMove Moves the mouse position to a screen position indicated by an image. Waits until the image appears on the screen. The mouse position will be placed in the center of the image by default. You may optionally set a relative position where to place the mouse cursor. The default value of 50, 50 will place the mouse position in the center of the image. A value of 0, 0 will place the mouse position in the upper, left corner of the image. A value of 100, 50 will place the mouse position in the middle, right corner of the image. The mouse position may also be specified using two images. The first images gives the X-coordinate and the second image gives the Y-coordinate to move to. This is useful when automating tables. ImagePath [PercentX] [PercentY] Or X or ImagePathX Y or ImagePathY Path to the image to move the mouse position to. Enclose the path in double quotes if it contains spaces. The relative X-position in percent of the image height. The relative Y-position in percent of the image width. X coordinate to move the mouse position to or path to the image to get the X-coordinate to move to. Y coordinate to move the mouse position to or path to the image to get the Y-coordinate to move to. s WaitMouseMove images/loginbutton.png WaitMouseMove images/loginbutton.png WaitMouseMove images/columnheader.png images/rowheader.png WaitMouseMove {CurrentX} images/rowheader.png WaitMouseMoveText Moves the mouse position to a screen position indicated by a text. Waits until the text appears on the screen. A text will be located on screen given the font type, style and size. Note that JAutomate may find a text included in any media, for example in images or movies. The mouse position will be placed in the center of the text by default. You may optionally set a relative position where to place the mouse cursor, see RelativePosition. Font Size The font name. The size of the font in points. JAutomate Copyright Innovative Tool Solutions (33)

31 Font Style Text The font name. The font style. Options: Plain, Bold, Italic or BoldItalic. The text to locate and move the mouse position to. WaitMouseMoveText Segoe UI 10 Plain File WaitReadText Reads a text from the screen using Object Character Recognition (OCR). Waits until the relative image appears on the screen. Useful for reading some output and use that text to write or select something at a later stage in the test script. Only one line of text may be read. The result of the ReadText command will be stored in the ReadText parameter. Use the read text by inserting the parameter {ReadText} somewhere below the ReadText command in the script. Note that the ReadText command is more accurate on larger fonts. Also try to specify a CharSet to improve the results. Font Size Style ImagePath DeltaX DeltaY Width Height [CharSet] The font of the text to read. The size of the font in points. The font style. Options: Plain, Bold, Italic or BoldItalic. The path to a relative image. The relative image is used to find the absolute position of the capture rectangle. This image might contain the text to the left or above the text field to read from. Distance in pixels from the relative image to the capture rectangle. Distance in pixels from the relative image to the capture rectangle. Width of the capture rectangle. Height of the capture rectangle. An optional character set. Specify a CharSet to improve the accuracy of the text recognition. The default is AlphaNum. Lower and Upper will only detect lowercase or uppercase characters or digits. s Options: Num, AlphaNum, Hex, Uuid, Lower, Upper WaitReadText "Segoe UI" 10 Plain "images\ png" "alphanum" JAutomate Copyright Innovative Tool Solutions (33)

32 WaitMouseMoveText "Segoe UI" 10 Plain {ReadText} WaitStableScreen Wait for the screen to become stable before moving the mouse when WaitStableScreen is set to Yes. JAutomate will wait at most two seconds for the screen to stop moving. The WaitStableScreen option will make playbacks a lot more reliable without the need for additional Wait commands. Disable this option to improve the script playback speed. WaitStableScreen Yes to wait until the screen becomes stable. No to move the mouse as fast as possible. Yes by default. WaitStableScreen No WaitText Waits until a text appears on the screen. A text will be located on screen given the font type, style and size. Note that JAutomate may find a text included in any media, for example in images or movies. Font Size Style Text The font name. The size of the font in points. The font style. Options: Plain, Bold, Italic or BoldItalic. The text to wait for. WaitText Segoe UI 10 Plain File WaitVerify Verify that an image appears on screen before the end of the Timeout period. ImagePath Path to image to wait for. Enclose the path in double quotes if it contains spaces. WaitVerify images/confirm_dialog.png WorkingDirectory Sets the working directory for an application before using the Start command. This step is optional but may be required for some applications. JAutomate Copyright Innovative Tool Solutions (33)

33 FolderPath Path to the working folder for an application to start. Enclose the path in double quotes if it contains spaces. WorkingDirectory c:/program/myapp Write Simulate text written by the keyboard. Make sure that you have clicked inside a text field or similar before executing this command. Text The text that should be typed into the widget with the cursor. Enclose the text in double quotes if it contains spaces, for example: Hello there. Insert tags to simulate some keyboard events, like enter or tab. See below for a full list of tags. Tags List of supported tags: [ENTER], [TAB], [DELETE], [ESCAPE], [BACKSPACE], [INSERT], [PRINT_SCREEN] [ALT_PRESS], [ALT_RELEASE] [SHIFT_PRESS], [SHIFT_RELEASE] [CTRL_PRESS], [CTRL_RELEASE] [ALT_GR_PRESS], [ALT_GR_RELEASE] [F1], [F2], [F3], [F4], [F5], [F6], [F7], [F8], [F9], [F10], [F11], [F12] [PAGE_UP], [PAGE_DOWN], [HOME], [END] [UP], [DOWN], [LEFT], [RIGHT] s Write Hello there Write 10[TAB]20[TAB][ENTER] Write [CTRL_PRESS]s[CTRL_RELEASE] JAutomate Copyright Innovative Tool Solutions (33)