Skip to end of metadata
Go to start of metadata

Basically, a test suite contains a list of test cases that are intended for testing certain aspects of the application under test.

Manage execution information

You can manage additional configurations for test suite execution by expanding the Execution Information section, as below:

where:

FieldDescription

Page load timeout:

 

The timeout period allowed to wait for a page to be loaded. You can choose among the following options:

 

Retry:

The maximum number of retries for execution until it is successfully passed. You can opt to retry only failed test cases.

 

Mail Recipients

The list of recipients who would receive the execution report once the test suite finishes its execution.

There’s also another list of recipients who will be receiving all the reports from Katalon by default. Refer to Emails Settings for more details.

Last run:

The datetime when the test suite was last executed. You can quickly open the report of this execution by clicking on the Last run hyperlink.

 

 

Manage test case list

Using the Test Suite editor, you can add a test case into a test suite by following the steps below:

  1. Open a test suite, then select option to add Add Test Case from command toolbar.


  2. All test cases in Katalon Studio are displayed in the Test Case Browser dialog. Select your preferred options then click OK.


  3. The selected test cases will be added in the test case list accordingly.


    The checkbox at the end of test case row is checked by default. It means that the test case will be executed when running a test suite.

Data for Test Execution

Katalon Studio provides users the ability to define test data that can be used later when executing automation test. Refer to the Manage Test Data for more detailed information about this function. This section shows how to design your automation test using predefined test data.

Test Data

Using the test suite editor, you can add a predefined test data file object which will be used later in a test case execution by following the steps below:

  1. In test suite editor, select a test case from the test case list. Click on Show Data Binding to load its data details.


  2. Katalon Studio will expand Data Binding Section with Test Data table and Variable Binding table


  3. In the expanded Data Binding section, select option to add Test Data from command toolbar.


  4. All test data will be displayed in Test Data Browser. Select the data for your test case and click OK.


  5. The selected test data will be added to the list accordingly.


  6. Double click on the Data Iteration cell to specify the data range to be used for execution.

    where:

    OptionDescription
    Run all rowsAll the data rows in the data file will be used during test execution.
    Run from row ... to row ...The data range from a certain row to a certain row in the data file will be used during test execution.
    Run with specific rows

    The data rows which are specified here will be used during test execution. You can use comma and hyphen characters to define the rows.

    For example:

    • to use three data rows (row 1, row 2, row 3), enter: 1,2,3
    • to use six data rows (row 1, row 2, row 3, row 4, row 5, row 9), enter: 1-5,9
  7. Click on the Type cell to toggle its value. Refer to Manage Test Data Relationship for more details.


Manage test data relationship

If you are specifying multiple test data, then you can further define the relationship among them to decide how the final data set used in the test execution will be. There are two types of relationship supported in Katalon Studio:

Relationship TypeDescription
One

The data set will be indicated as 'One' in the relationship with other data set.

ManyThe data set will be indicated as 'Many' in the relationship with other data set.

 

Therefore, we can have the following combinations among data sets:

RelationshipExample
One - One

Given there are two data sets as below:

Then the final data set used for test execution will be:

  • a1 b1
  • a2 b2
Many - Many

Given there are two data sets as below:

Then the final data set used for test execution will be:

  • a1 b1
  • a1 b2
  • a2 b1
  • a2 b2
  • a3 b1
  • a3 b2
One - Many

Given there are two data sets as below:

Then the final data set used for test execution will be:

  • a1 b1
  • a2 b1
  • a3 b1
  • a4 b1
  • a1 b2
  • a2 b2
  • a3 b2
  • a4 b2

Given there are three data sets as below:

Then the final data set used for test execution will be:

  • a1 b1 c1
  • a1 b1 c2
  • a2 b2 c1
  • a2 b2 c2

 

Variable Binding

If there’s any public variable defined in your test case, then you can manage variable binding for your test case execution. That is to specify which value would be used for which variables during test execution.

Follow the steps below to manage variable binding for a test case within the test suite:

  1. In test suite editor, select a test case from the test case list. Click on Show Data Binding to load its data details.


  2. All the public variables defined in that test case will be loaded into the Variable Binding section:



Bind Variable to Test Data

This option allows you to associate the variables with configured Test Data.

  1. Katalon Studio allows users to Set Type for variables all at once if the variables have the same Type. In this case Username and Password has the same type as Data Column. Simply highlight both rows. Click on Set Type and select Data Column:



  2. Both rows are still highlighted. Click on Set Test Data to decide which test data from the list to be used for execution:



  3. Click on Value cell to specify the data field of test data to be used.


  4. All headers of the related test data will be displayed. Select the header to be referred during execution then click OK.


  5. The selected header will be displayed accordingly in Variable Binding section.


    Save the test suite when you're done.

    In the above example, the global variable Username will look up to the column Username of the test data file "New Excel Data" during execution. Users can specify the number of data rows to be used in Data Iteration of Test Data table.

    Quick tip

    Using the Map All button, users can quickly match Variables of the test case with respective columns in the test data:

    In order for Katalon to automatically make the variable binding, the Variables need to have its respective columns in Test Data with the same name.

    For example: the variables 'Username' and 'Password' of the selected test case can be mapped automatically with columns 'Username' and 'Password' of the test data by Katalon Studio when user clicks on the Map All button.

Bind to Scripting value

This option allows you to associate the variables with other scripting value.

  1. Highlight rows No. 1 and No.2. Click Set Type and Select Script Variable:


  2. Specify the data to be used in Value cell. This value will be utilized this data during execution. 

 

Test Suite execution

Executing a test suite is more or less the same as executing a test case. Refer to Execute a test case for more details.

All historical execution can be found in Reports. Refer to Test Suite Report for more details.

 

  • No labels