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: Use the default shortcut key to redo or undo any changes made to a step in the Editor.

To manually add a step:

  1. Make sure your application is open.

  2. To add a new step, move the cursor to the last step of the step list and directly press Enter.

  3. Click the double-arrow icon on the right to open the step editing pane. In the pane:

    1. Type a class in the Object class drop down. Type the first letter to view a list of the available classes. Click the Highlight object button to locate the selected object in the application.

      Note: The Highlight object button works only on applications launched from FT Design. Make sure your application is visible before you click the button.

    2. If applicable, type a name for the object or use an input parameter to define the object name. For details, see Use parameters in the step editing pane.

    3. Select or accept the default action for the selected object. Your selections are added to the current step.

    4. 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 PT indicator is added to the step.

    5. 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.

    6. If relevant, click Add Position. Specify a position and index for the object.

      If you specify a position, a P indicator is added to the step.

    7. If relevant, configure scroll settings and OCR languages for this step. For details, see Customize step settings.

  4. You can also type directly into the step box, using the syntax rules described in Step syntax.

    • As you type, if an error is detected or the syntax is incomplete, a red symbol is displayed in the step, incorrect text is underlined, and an error message is shown in the step editing pane.

    • As you type, you can configure additional step details in the step editing pane, such as Action, Position, Partial Text, and Verify step options such as Exists.

  5. 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 a Navigate to or Go back command.

    • Hover over the step number, click the button, and select Navigation > Navigate to URL or Go back.

  6. To add a Wait syntax to your script, do one of the following:

    • Directly type a Wait command.

    • Hover over the step number, click the button, and select Wait.

  7. 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.

Back to top

Manage your script

This section explains how to edit, move, duplicate, and otherwise manage the steps in your script.

To manage regular steps:

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. If the syntax is incomplete, a red symbol is displayed and incorrect text is underlined.

Reorder a step

Hover over the vertical drag bar in the left margin, and drag the step to the desired 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:

  • Right-click the step, and select Exclude from the test run.
  • Select the step in the Editor, and then select Exclude step from the test run at the bottom of the step editing pane.

To include an excluded step, right-click the step, and select Include in test run or clear the Exclude step from the test run option.

Duplicate a step

Do one of the following:

  • Right-click the step and select Duplicate. A same step is added in the row below the step.
  • Press CTRL, and drag the step to the location you want. A same step is added to the row you want.
Copy and paste one or more steps or step text
  • To copy and paste one or more steps, select these steps and press CTRL+C and V to paste them to empty rows. The metadata is also copied and pasted with the steps.

    If you paste them to existing steps, new steps with same metdadata are created in the next rows.

    You can also paste them from your script to any other editors as plain text.

  • To copy and paste a text in a step, select the text, and press CTRL+C and V.
  • You can copy and paste one or more plaintext steps from other sources to your script.

Note: After you successfully copied a step, the step is automatically copied to the clipboard in plain text.

Exclude, duplicate, or remove multiple steps

Press CTRL, select these steps, right-click them, and select Exclude from the test run, Duplicate, or Delete.

Note:  

  • You can right-click excluded steps and select Include in test run to include these steps again.
  • You cannot delete all steps. An empty step still remains in the Editor.

To manage conditions:

To... Do...
Remove a condition block

Do one of the following:

  • Right-click the If step and select Delete block.
  • To remove the Else parts from an If/Else block, right-click the Else step and select Delete.

Exclude a condition block temporarily

Do one of the following:

  • Right-click the If step and select Exclude from test run.

    If you right-click on the Else step and select Exclude from test run, only the Else parts are excluded.

    To restore the condition, right-click the block, and select Include from test run.

  • Select the If or Else step in the Editor, and then select Exclude condition from test run or Exclude else block from test run on the step editing pane.

    To restore the condition, clear the Exclude condition from test run or Exclude else block from test run option.

Duplicate a condition block

Right-click the If step, and then 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.

Back to top

See also: