Tester

Tester allows you to verify if the created Decision Table, Function and Domain Elements are working as intended. In order to see Tester, select Tools → Tester in Main Toolbar.

After you enter Tester you will see Test panel with a list of all tests:

No. Column / Action Name Description
1. Test Name Full test case name. You can sort this column by left-clicking on the arrows visible next to the label.
2. User User’s login that made the last modification in the test case. You can sort this column by left-clicking on the arrows visible next to the label.
3. Last Modified The last modification date of the test case. You can sort this column by left-clicking on the arrows visible next to the label.
4. Actions List of quick access actions. Currently only the Remove action (bin icon) is available here. The Remove action deletes the desired test case. To learn more about removing a specific test case, go here.
5. + Add Test Allows creating a new Test case. To learn more about adding Test cases, go here.
6. Load Test Allows uploading Test case from an XLSX file. To learn more about uploading Test cases, go here.

You can see all Filters available in a Test panel below:

No. Filter Name Description
1. Search Text Field Filter by any string provided by the user.
2. Date Range Filter by last modified date in format YYYY/MM/DD-YYYY/MM/DD.
3. Modified By Filter by users who made the last modification in test cases.

Upload Test#

If you want to load a test case from Test panel screen, follow these steps:

  1. Choose Tools → Tester in Main toolbar.

  2. Choose Load test.

    a. Choosing Load brings up Load test case screen.

  3. Drag&drop desired file or Click to upload a file and choose file in File explorer.

    a. If you choose a file with extension other than XLSX, then validation error will pop up.

  4. When the message Upload successful appears, it means that test was loaded correctly. Close Load test case screen.

    a. You will be redirected to the loaded Test case screen. Bear in mind, that Test case has not been saved yet. In order to save loaded Test case, choose Save test.

    b. If validation error occurs (see above), then an upload process is being aborted.

Add Test Case#

If you want to add a new test case, follow these steps:

  1. Choose Tools → Tester in Main toolbar.

  2. Choose + Add test.

    a. Choosing + Add test opens New Test case screen.

    No. Name Description
    1. Enter Test Name Enter unique test case name here. Test case name can contain only characters from collection a-z; 0-9; “-”, “_”, and it can’t start with “-”.
    2. Download Test Downloads an XLSX file that contains all data from the currently opened Test Case
    3. Load Test Allows loading Test Case from an XLSX file. To learn more about loading Test Cases, go here.
    4. Save Test Allows saving Test Case. Action is grayed out until Tested Elements are provided.
    5. + Add New Element Opens Add New Element screen. You can choose here which elements will be added to the Test Case. Available elements are: - Decision Tables - Functions - Domain Configuration Elements
    6. Context Data Allows to complete input test data which refers to the context
    7. Function Attributes Allows to complete inputa data which refers to arguments of the functions

  3. Choose + Add new element. This step is necessary to save Test case.

    a. Choosing + Add new element brings up New element screen.

    No. Name Description
    1. Add to Test Add selected elements to the Test Case. Greyed out until at least one element is selected.
    2. Element Type Bar Allows switching between visible Element Types. Note that switching between different tabs will not uncheck already-checked elements.
    3. Elements Search Field Filters visible elements by any string provided by the user.
    4. Checkboxes Select one or multiple checkboxes to add elements to the Test Case.

  4. Select elements you wish to add to Test case.

    a. After you select at least one element, then Add to test button will activate.

  5. Choose Add to test.

    a. Selected elements are added to the Test case.

    b. Context and Function attributes are added automatically based on selected elements.

    c. If the context allows the use of a collection of elements, the tester displays the $size attribute, which specifies the number of elements in the collection. The individual elements are then numbered from 0…n. For example, if the collection contains 4 elements, then $size = 4, and the elements are labeled as [0], [1], [2], and [3].

  6. In Enter test name field enter unique test name.

  7. In Context and Function Attributes table fill Value fields accordingly. This step is optional to save a test case.

  8. Expand Elements to test to enter Expected value. This step is optional to save a test case.

  9. Choose Save test.

    a. Test case with data you provided is saved.

    b. If you enter the same name as one of the Test cases already created, then validation error will appear.

Remove Test Case#

If you want to remove a specific test case, follow these steps:

  1. Choose Tools → Tester in Main toolbar.

  2. Choose Remove action (bin icon) for Test case you want to delete.

    a. After choosing Remove action, confirmation pop up will appear.

  3. Choose Confirm.

    a. Specific Test case is being removed from the environment. This action is irreversible.

Test Case Details Screen#

You can access Test case details screen by left-clicking on specific Test case in Test panel.

No. Name Description
1. Test case name Enter unique test case name here. Test case name can contain only characters from the collection a-z; 0-9; “-”, and “_”, and it can’t start with ‘-’.
2. Column delimiter Select the delimiter character used to separate columns in the test data.
3. Generate Runtime Rest JSON Generates a Runtime Rest JSON file based on the currently opened Test case.
4. Download test Downloads an XLSX file that contains all data from the currently opened Test case. To learn more about downloading Test cases, go here.
5. Load test Allows loading a Test case from an XLSX file. To learn more about loading Test cases, go here.
6. Save test Allows saving the Test case. Action is greyed out until Tested elements are provided.
7. Context List of all available Test input data from context for Tested elements.
7a. Code Full Test input data code. You can change the order of Test input data by drag & dropping each of them.
7b. Description Description of Test input data.
7c. Type Type of Test input data i.e. string, integer, date etc.
7d. Value Value of Test input data entered by the user.
7e. Actions Available action for each Test input data: - Remove (bin icon): Removes Test input data from Test case. Bear in mind, that deleting Test input data may cause errors in test results.
8. Function attributes List of all available inputs from the function’s arguments
8a. Name Name of the function and function argument.
8b. Type Type of the function argument.
8c. Value Value of Test input data entered by the user.
8d. Actions Available action for each Test input data: - Remove (bin icon): Removes Test input data from Test case. Bear in mind, that deleting Test input data may cause errors in test results.
9. Add new element Click to add new element to the test.
10. Elements to test Click to expand Elements to test screen.
11. Run test Runs the currently opened Test case with set input values. When the process is finished, then Test results will be updated for each Tested element in Elements to test screen.

Download Test Case#

If you want to download a specific test case, follow these steps:

  1. Choose Tools → Tester in Main toolbar.

  2. Left-click on Test case you wish to download.

    a. Left-clicking on Test case opens Test case details screen.

  3. Choose Download test.

    a. Choosing Download test downloads an XLSX file that contains data from currently opened Test case.

Load Test Case#

If you want to load a test case from Test case details screen, follow these steps:

  1. Choose Tools Tester in Main toolbar.

  2. Choose + Add test or left-click on existing Test case in Test panel.

    a. choosing + Add test and left-clicking on Test case opens New Test case screen or Test case details screen accordingly.

  3. Choose Load test.

    a. Choosing Load test brings up Load test case screen.

  4. Drag&drop desired file or Click to upload a file and choose file in File explorer.

    a. If you choose a file with extension other than XLSX, then validation error will pop up.

  5. When the progress bar reaches 100%, it means that Test case was loaded correctly.

    a. If a validation error occurs (see above), then a load process is being aborted.

    b. Bear in mind, that if in step 2 you chose existing Test case, then loaded Test case will overwrite it.

Run Test Case#

If you want to run a test case, follow these steps:

  1. Choose Tools → Tester in Main toolbar.

  2. Left-click on Test case you wish to Run test for.

  3. Choose Run test.

    a. When Run test process is finished, then Test result column on the Elements to test screen will be updated for each Tested element.

    Test result can take status as:

    i. Success - Expected value matches value returned by system based on Test input data values

    ii. Failure - Expected value does not match value returned by system based on Test input data values or an error occurred while running test for specific Tested element. Check LOG in ACTIONS column for more information.

    iii. No expected value - Run test process finished with no errors, but there is no Expected value to compare with value returned by system based on Test input data values.

    You can click on the plus icon in the Result column to see value returned by system for each tested element.

If you want to run a test case with profiler:

  1. Select drop-down next to Run test button.
  2. Select one fo the options By count or By duration.
  3. Fill in the count/duration [s].
  4. Click Run.
No. Name Description
1. Expand Click to expand the Run test with profiler options.
2. By count Select to run the test a specified number of times.
3. By duration Select to run the test for a specified duration in seconds.
4. Count/Duration Enter the number of iterations or duration [s] for the profiler run.
5. Run Click to start the test with profiler using the selected settings.