Manually create and edit steps
This topic describes how to manually create and fine tune steps in your script.
Manually add and edit steps
You can create steps manually by adding an object and an action, using FT Design's artificial intelligence.
Tip: You can use the Windows keyboard shortcuts to redo or undo any changes made to a step in the Editor.
To manually add and edit a step:
-
Make sure your application is open.
-
To add a new step, move the cursor to the last step of the step list and press Enter.
-
Click the double-arrow
icon on the right to open the step editing pane. In the pane:
-
Type a class in the Object class drop down. Type the first letter to view a list of the available classes.
-
If applicable, type a name for the object or use an input parameter to define the object name. For details, see Pass a value to a step.
-
Select or accept the default action for the selected object. Your selections are added to the current step.
-
For text steps, you can set the object class property to Partial Text. This capability finds your text anywhere and clicks it, even if it is part of a larger text block.
If you select the Partial Text option, a
indicator is added to the step.
-
For a condition, select Exists or Does not exist to specify which condition the step checks and define a Timeout in seconds for how long to wait for the step's condition to be met.
-
If relevant, click Add position. Specify a position and index for the object.
If you specify a position, a
indicator is added to the step.
-
If relevant, configure scroll settings and OCR languages for this step. For details, see Customize step settings.
-
-
You can also type directly into the step box, using the syntax rules described in Step syntax.
As you type, configure additional step details in the step editing pane, such as Action, Position, Partial Text, and Verify step options such as Exists.
-
To add a step that navigates to a specific web URL or returns back to the previous URL, do one of the following:
-
Directly type Navigate to or Go back into an empty step box.
-
Hover over an empty step line, click the
button, and select Navigation > Navigate to URL or Go back.
-
-
To add a Wait command to your script, do one of the following:
-
Directly type Wait into the step box.
-
Hover over an empty step line, click the
button, and select Wait.
-
-
To omit a step temporarily from your test run, select the Exclude step from the test run check box on the step editing pane. You can re-enable it any time. For details, see Manage your script.
Synchronize your script
You can synchronize your tests, making sure steps are performed only when your application is ready for them.
You can add generic Wait steps, that simply wait for a specified number of second to pass, or more specific Verify steps, that check for the existence of a specific object.
We recommend using Verify steps that wait for a relevant object, rather than more arbitrary Wait steps.
Add a Wait step
Syntax: Wait <number> seconds
A Wait step instructs the script to pause the run for a specified number of seconds. This allows time for the application to be ready for the next step.
Example:
Wait 6 seconds
Click the hamburger_menu
Click the profile
Type 'aidemo1' into 'USER NAME' input
Type 'Aidemo1' into 'PASSWORD' input
Click the 'LOGIN' button
Add a Verify step
Syntax: Verify <object> exists
A Verify step checks whether an object exists in the application. This ensures the object is present before the script performs any operation on it, increasing the test run success rate.
Define a timeout for the Verify step, to specify how long to wait for the object.
For details on adding and editing a Verify step, see Add verification steps.
Example:
Verify the hamburger_menu exists
Click the hamburger_menu
Click the profile
Type 'aidemo1' into 'USER NAME' input
Type 'Aidemo1' into 'PASSWORD' input
Click the 'LOGIN' button
Manage your script
This section explains how to edit, move, duplicate, and otherwise manage the steps in your script.
To... | Do... |
---|---|
Edit a step |
Edit a step using the syntax rules described in Step syntax. As you type, you can check whether your syntax or object is valid. |
Reorder a step |
Hover over the vertical drag bar in the left margin, and drag the step to a preferred location in the step list.
|
Remove a step |
Right-click the step and select Delete. The last remaining step cannot be deleted, but you can manually remove its content. |
Exclude a step from the test run |
Do one of the following:
To include an excluded step, right-click it, and select Include in test run or clear the Exclude step from the test run option. |
Duplicate a step |
Do one of the following:
|
Copy and paste a step or step text |
Note: After you successfully copied a step, the step is automatically copied to the clipboard in plain text. |
Exclude, duplicate, or remove multiple steps |
Select the steps, right-click, and select Exclude from the test run, Duplicate, or Delete. Note:
|
To manage conditions:
To... | Do... |
---|---|
Remove a condition block |
Do one of the following:
|
Exclude a condition block temporarily |
Do one of the following:
|
Duplicate a condition block |
Right-click the If step, and select Duplicate block. The whole If or If/Else block (including Else parts) is duplicated. Note: The duplicate function is not supported for Else parts. |
Exit a condition block |
Select the last step of the condition block and press Enter twice to exit it. |
Manage steps inside a condition block |
See To manage regular steps: to manage steps inside a condition block. If you right-click the If step and select Delete, the If step is deleted and the rest part in the If or If/Else block becomes regular steps without indentation. Note: An Else step becomes invalid if it exists independently. |
Manage steps inside different condition blocks |
If you duplicate multiple steps inside different condition blocks, all selected steps are copied to rows outside of the blocks in original execution order. |
See also: