Precondition can be created and used for multiple scripts with the same precondition. Please follow these steps:
Step 1: Click on the [Manage Test Precondition] button.
Step 2: Click on the [Add Precondition] button.
Step 3: Select a device to start creating a precondition. When “Available” is checked, it only shows device available.
Step 4: Select a precondition parent (if applicable).
Step 5: Click on the [Record script] button to switch to the recording mode to create steps for the precondition.
After selecting the pre-condition => the [Preview script] button will be displayed. You can select the [Preview script] button to run the pre-condition. (Follow step 10, 11).
Step 6: Select an element from the streaming screen of the device to perform actions.
Step 7: Choose the appropriate actions to take => The steps taken are recorded below.
Step 8: Click on the [Stop] button => the [Preview script] button will be enabled.
Step 9: Click on the [Preview script] button to run and view all created steps.
Step 10: Click on the [Run all] button to run all preconditions.
Step 11: Click on the [Run script] button to run the recorded steps one at a time => After running the script, the device’s streaming screen will show the live execution of whatever steps that were recorded. The step status will be displayed at the end of each step.
Step 12: Click on the [Back] button => the “Create script” screen will be displayed => Click on the [Save] button.
Step 13: Popup “Save as Pre-condition” will be displayed => Enter the information of the precondition that you want to save => Click on the [Save] button => This Precondition will be saved in the “Manage Precondition” screen.
The script creation screen is displayed by step: Click on the [Manage Test Script] item => Click [Create with ATOMP Studio] => Select any device.
Users can upload a CSV file containing two rows of data (key/value pairs) and use those pairs as variables inside ATOMP Studio.
From the “Predefined Actions” tab, click on “Expand” at “CSV External Input”, then click “Upload” to upload a CSV file.
A CSV file has the following format (Column A: Variable Name, Column B: Value)
After uploading the CSV file, users can use those variables in any textbox while creating test script by typing “$+variable name”.
To start creating a test script, you need to switch to the [Recording] mode by clicking on the button [Record script] or the Eye icon => below is a sample of the Recording mode.
Users can select a screen element (icon, button, text, etc…) to execute some actions.
Step 1: On the script creation screen, click on the [Add new] button.
Step 2: Select one or more preconditions from the precondition list of the project.
When the script is running, these selected preconditions will run from top to bottom. List of selected preconditions will be displayed as below:
Step 1: Switch to the “Select Element” mode (by clicking on the icon )
Step 2: Select an element on the streaming screen
Step 3: Select an action you want to take with the element selected in step 2
- If the selected element is an icon or a button, the available actions are (Tap, Double Tap, Long Press)
- If the selected element is a Text Input box, click on the [Send Keys] button to input text to the element.
- If you want check 2 images by AI when having automatic action to change screen, click on the [Add Blank Action] button to create a blank action, when this step is run, the automation script will not perform any action on the device.
Step 4: If the action is [Send Keys] -> a popup will be shown for users to input characters.
=> After executing 1 action, the tool automatically generates a test script for that action and displays as a step (refer to the picture below).
Step 1: Select an element that you need to check on the Streaming screen
Step 2: The PROPERTIES box will show the properties of the selected element –> choose a property to create an expectation that you want.
- If you want to check the UI of the screen, select the icon camera inside the “Expectation” column to capture screen as reference for future comparison.
- If you want to use AI Visual check, select icon to add AI Visual check expectation to compare visual images which help you increase accuracy and reduce effort for testing. AI Visual check will capture the screen to be a visual reference for later test and let you know if during regression test, the actual screen has difference with the captured screen.
- You can drag mouse to specify which part is dynamic data and can be excluded in visual comparison. After that, you click on “OK” button to save Expectation or click on icon to delete selected data area.
2) You can also click the link reference image in Expectation to view again or edit chosen data by following part (1). Click on icon if you want to delete AI Visual check expectation.
User can view evidence at Tester40 [Test Result] page.
The system also supports comparing images of element when confirming exepectation. Please follow these steps:
- Click on an element on the streaming screen à Click on [+] button besides text [Image] in Custom Properties.
Then [Compare image] pop up display. Popup has 2 options:
– Upload image: Allowing uploading an existing image or an image cutted from an xd file (JPG, JPEG, PNG format).
– Use curent image: Allowing to automatically capture the current screenshot, then based on the element position, automatically crop the image of that element.
Option 1: Upload image
Firstly, users must click on tab Upload image then select image file and press OK. After selecting image, photo is uploaded to ATOM Storage. If there is an existing image, the new uploaded image will replace the old one. ==> After uploading, the expectation added <Element> displays the same as <filename of the uploaded image>.
Option 2: Use current image
Click on button to use current element’s image as reference then click on [OK] button, image is used as expectation.
6. Feature IF – THEN – ELSE
Step 1: Add [IF] block
- On the [PREDEFINED ACTIONS] tab, click on [Command] menu to expand it
- Expand [Conditional] sub-menu
Click on [IF Statement] to add IF block to script.
After that, new block will appear on Recorded Script section.
1) Hover on to open menu
- Click on “Add condition” add a new condition to current [IF] block, it will open input form as above.
- Click on “Add Sub-IF” to add a [Sub-IF] block to current block
- Click on “Add ELSE IF” to add [ELSE IF] block after current [IF] block
- Click on “Add ELSE” to add [ELSE] block after current [IF] block
- Click on “Delete Block” to delete current block. If deleting a [IF] block will delete all [ELSE IF] and [ELSE] blocks that come with it. User must confirm before action to be executed.
2) Click on to stop working on current block
3) Click on to stop working on current block, to work on a block (pin – unpin block)
4) Delete a condition
5) Edit condition
6) Logical operator (uses when block has 2 more conditions)
7) Element to do comparison operation
8) Property of element (must be specified in order to save condition).
10) Value to compare (default is element’s property value).
11) Click to save condition.
12) Click to cancel input condition.
13) Block action (will be executed if condition is met).
Some cases when working with IF – THEN – ELSE function.
- When adding condition without select element or property to do comparison operation, a message will appear like bellow and condition will not be saved until user specify element & property.
When deleting all [IF] – [ELSE IF] block condition, a notification will appear with bellow content to inform user that block condition is empty.
- When working on [IF] – [ELSE IF] block which does not contain any condition, script will not be recorded and a notification with bellow content will appear.
- When trying to save script with an empty condition [IF] – [ELSE IF] block, script will not be saved and notify an error message like bellow.
Preview Script with IF – THEN – ELSE function.
- All [IF], [ELSE IF], [ELSE] block which condition(s) does not meet will be ignore & show error message like above.
- When previewing script with empty condition [IF] – [ELSE IF] block, script will break at block which condition is empty.
7. Feature Select Step to take evidence on Tester 4.0
Step 1: Tick on checkbox in the last column of test script which step you want to take evidence when running on Tester4.0.
Step 2: After running sprint done, you click “Download evidence” button to get the evidence ticked in step 1.
User can view evidence at Tester40 [Test Result] page.
- Clone one test step: Click on one test step which you want to clone => Right mouse and choose “Clone”.
- Clone some test steps:
If the test steps are continuous: Click on the first or the last test step and mouse hover all test steps which you want to clone => Right mouse and choose “Clone”.
If the test steps are not continuous: Click on any test steps and hold Ctrl and click on other test steps => Right mouse and choose “Clone”.
- Choose one step to clone before or clone after
Click on one test step what you want to clone after or before that => Right mouse and choose “Paste before” or “Paste after”.
Choose some step to clone before or clone after.
If the test steps are continuous: Click on the first or the last test step and mouse hover all test steps which you want to clone => Right mouse and choose “Paste before” or “Paste after”.
If the test steps are not continuous: Click on any test steps and hold Ctrl and click on other test steps => Right mouse and choose “Paste before” or “Paste after”.
Step 1: Click the [Stop] button to finish recording the test script.
Step 2: You can preview the created script from any available device by clicking on the [Preview script] button.
From this screen, users can preview the script from another device by clicking on the [Select device] button => Select device screen will be displayed. (The device selected for creating the script will be selected as default for preview).
-> After selecting device, click the button to start previewing the script.
Step 1: Click on the [Save script] button -> A dialog will be displayed.
Step 2: Input the reference ID and description for the script.
Step 3: Click on the [Save Test Script] button.
After a test script is saved, it can be found in the screen “Manage Test script” in Tester 4.0.
Step 1: From the “Manage Test Script” screen, select the “Edit” icon from the script you want to edit => Select device screen will be displayed => Perform a device selection just like creating a normal script.
Step 2: After the device is selected => The script creation screen will be displayed, and the users can edit the script normally => Then the users can save the script by 2 methods:
- Save to the existing script.
- Save as a new script.
12. Select other script
On the “Create script with ATOMP Studio” screen, users can also easily choose from the created script list to edit by following these steps:
Step 1: From the “Create script with ATOMP Studio” screen, select the “Select other script”.
Step 2: The created script list will be displayed, and the users can choose “Test script” or “Test precondition” to choose the script you want to edit.
Step 1: Click on the icon mirror -> The popup list of available devices will be displayed
Step 2: Select a device that will mirror the actions of the main device
After selecting a mirror device, the streaming of all mirror devices will be shown
User’s actions in the main device will also be performed in the mirror devices.
Step 3: Capture the evidence on all devices by clicking on the icon capture screenshot from the tab bar.
=> Screenshots in all devices will be shown (both main device and mirror devices).
Step 4: Click on the icon under each image => screenshot will be copied to the clipboard.
Step 5: Click on the [Download] button => download evidence (screenshot) from all devices.
This function is intended to increase productivity comparing the difference between UI and XD.
To use this function, please follow the steps below:
Step 1: Click on the “Ruler” icon from the navigation bar to open the MEASUREMENT screen.
Step 2: If you want to measure size and position please click [Ruler] tab, if you want to measure color code then click [Color] tab.
– “Ruler” tab
To pin an element, click on the [Measure] button, then click on any element from the streaming screen, or from the Source list.
– “Color” tab
To pin an element, Click on the [Filter] button, then click on any element from the streaming screen, or from the Source list.