# Using Gondola Test Designer

# Add a new test line

  1. In GTD (Gondola Test Designer), hover over the first column of the line that you wish to add a new line below
  2. The delete line button and the add new line button will appear on the right hand side of the field
  3. Click the add new line button Gondola Test Designer New Line Icon
  4. A new line will appear beneath the current one

# Delete an existing line

  1. In GTD, hover over the first column of the line that you wish to delete
  2. The delete line button and the add new line button will appear on the right hand side of the field
  3. Click the delete line button Gondola Test Designer Delete Line Icon
  4. The line will be deleted

# Blocks

For better readability, GTD uses keyword blocks to separate sections. Keywords (children) that are part of a Test Case will be inside that Test Case block (parent). Keywords that are part of an If statement will be inside that If block. The following keywords can be block parents:

  • Test/Suite Initial

  • Test/Suite Final

  • Test Case, Method

  • If, Else and While.

    For Example:

Block Example

In the example above, there are 3 Test Case blocks and an If block which is child of first Test Case block. All the children inside the block have the same level but more indent than its parent and also other block parents.

Users can add a new row directly below the block by clicking on Gondola Test Designer New Line Icon button in parent block cell.

To insert new child at the top of a block, select the first child row (directly beneath the parent), and use the keyboard shortcut Ctrl + Shift + I

TIP

You can add rows using Keyboard Shortcuts: Ctrl+I (add a row beneath the selected row) or Ctrl+Shift+I (Add a row above the selected row)

Clicking the delete button Gondola Test Designer Delete Line Icon on a parent row will delete the whole block. The expand/collapse Collapse Button button will help to expand or collapse the block.

# Viewing/Editing an ABT Test or Page Object

Here are the steps for viewing an ABT or Page Object in GTD or in TypeScript

  • Navigate to the directory src/tests for an ABT test or src/pages for a Page Object
  • GTD
    • Right click on the file and click on Open with Gondola Test Designer
    • Keyboard Shortcut: Ctrl+Alt+V
  • TypeScript
    • Double click on the file

# Saving the file

  • Gondola Test Designer
    • Click the save icon in the top right hand corner ABT Save Icon
    • Keyboard Shortcut:
      • Windows/Linux: Ctrl+S
      • Mac: Ctrl+S
  • TypeScript mode
    • In the menu bar click File->Save or on the keyboard hit Ctrl+S (+S on a Mac)

# Comments

Comments are generally used to explain what a row or block of actions will do. Gondola Test Designer currently supports single-line comments in Test Modules and Page Objects.

# Add a new comment line

  1. In GTD (Gondola Test Designer), right click on the row that you want to add a comment above to open the comment context menu.
  2. Click on the Add Comment option on the context menu Comment context menu
  3. The new comment row will appear right above the selected row. The new row's default content is 'comment'. Comment with default content
  4. Double click on the comment row to edit it. Edited Comment

If you've selected the comment row, you can also enter editing mode by pressing enter, just like a normal GTD cell.

TIP

You can also add a comment above other comments using the steps above. This can improve readability when you have several comment lines above a large action block. Edited Comment

# Delete an existing comment line

  1. In GTD (Gondola Test Designer), right click on the comment row that you want to remove; the comment context menu will open.
  2. Click on Remove Comment Remove Comment Option

# Adding tags to Test Cases

You can add tags to Test Cases in GTD and use them to only run Test Cases with the specified tag. In order to add your tags, follow the steps below:

  1. In GTD (Gondola Test Designer), go to the Test Case where you want to add your tags, double-click on the tag cell and type "smoke-test". Create Tag
  2. Press Enter or left-click on Create tag "smoke-test" to add the suggested tag.

TIP

You can also use the combination Ctrl + Enter to add the tag you entered.

  1. Once saved, you can now search for the tagged Test Case by using keyword smoke-test with the Visual Studio Code search function.

TIP

You can use the command npm run test -- --grep "smoke-test" to run Test Cases with tagged with smoke-test.

# Undo and redo (beta)

# Undo

You can undo editing actions in Gondola Test Designer. You can undo changes, even after you have saved the test, and then save it again. Currently, the beta version of Gondola Test Designer allows you to undo the last 10 actions

If you prefer to use the mouse instead, click the Undo button on the Quick Toolbar located in the top left of the Gondola Test Designer view. Create Tag

For example, if you delete an action row accidentally, you can easily revert the change by clicking on the Undo button or pressing Ctrl+Z.
Undo Example

Undo Example

Note

Not all actions are supported by the undo function.

# Redo

To redo something you've undone, press the keyboard shortcut for redo.

If you prefer to use the mouse instead, click the Redo button on the Quick Toolbar located in the top left of the Gondola Test Designer view. The Redo button only appears after you've undone an action.

Continuing with the example above, if you want to revert a change made using undo you can click the Redo button or press Ctrl+Y.

Undo Example

TIP

You can press Undo/Redo button (or the keyboard shortcut) repeatedly if you want to undo or redo multiple actions.

Last Updated: 1/19/2021, 11:29:14 AM