Using the Eggplant DAI Runner

The Eggplant DAI Runner lets you run your pre-configured tests that were created in the Test Configuration tab and view the results of those tests via color coded dots. You can also schedule test runs from the Runner tab and see the tests that are in progress. To access the Runner tab, click Controller on the left menu of the Eggplant DAI interface.

The Runner page in Eggplant DAI. Click image to view larger.

Running Tests

To run a test, from the Runner tab, click the Run button against a test configuration that you want to run. Repeat this step if you need to run more tests.

Note: Remember to re-upload any scripts that you may have changed manually via Eggplant Functional or in the Eggplant DAI Snippet Editor back to the Execution Environment (Manage Agents > Manage Suites) before running the test, or your changes may be overwritten.

To stop a test configuration instance that's already in progress, click .

The Runner Interface displays the following information about your test configurations:

  • Test Configuration: The names of your test configurations. This column can be sorted alphabetically.
  • Model: The Eggplant DAI model used in a test configuration.
  • Schedule Type: The type of schedule for the test configuration. Displays No Schedule if none exists for a given test configuration.
  • Scheduled Start: The date and time that a scheduled test run will start for a given configuration. This field is blank if no schedule exists for that test configuration.
  • Previous Execution Results: Shows the results of the ten most recent test executions (if applicable) represented via color-coded dots (described below). Hovering on an individual dot shows the status and date/time of the execution. Click to expand to see a snapshot of the results of that execution. See Viewing Execution Results for more information.

    Indicates that the test has failed.

    pass icon Indicates that the test was successful.

    in-progress icon Indicates that the test configuration is in progress.

    cancel icon Indicates that the test resulted in error.

    abort status Indicates that the test run was aborted.

    incomplete status Indicates an incomplete test run.

  • Last Executed: The date and time of the most recent execution. Displays In Progress if a test execution is ongoing. This column can be sorted chronologically.

Viewing Execution Results

In the Previous Execution Results column, click the individual color-coded dots representing pass icon Success, Failure, In Progress in-progress icon, Error cancel icon to view the summary of that test execution in an expanded view.

The results show the below information, a donut chart that represents the number of passed, failed, and incomplete runs, along with the Open in Results button:

Clicking the Pass, Fail, In Progress dots shows the summary of the test execution

Click Open in Results to further drill down into the results of the selected test execution. This opens the Results tab showing all the individual test runs for the selected test execution, but you can switch to the default All Runs view by clicking View all results link at the top of the display. Note that the Open in Results button is available only for tests with Pass, In Progress, and Fail results but not for the test results with Error.

Clicking the Error execution dot shows the reason for the error in the expanded view:

Click to view the expanded summary

Scheduling Test Runs

Scheduling test runs adds great flexibility to your test runs, i.e., you can set your tests to run at specific intervals in the frequency you require. You can execute a test configuration with or without a schedule in the Eggplant DAI Runner interface.

Note: If a test execution is initiated (either at a scheduled time or by clicking the Run button) while another test execution for the same test configuration is in progress, then the newly-started test execution will immediately complete with an error.

Step-by-Step: Scheduling Tests

Follow these steps to schedule a test:

  1. In the Runner tab, select the test configuration that you want to create a schedule for.
  2. From the Actions menu , select Edit to open the schedule interface. The Edit test schedule opens a calendar interface.

  3. Make the required changes in the calendar interface, e.g., choose a specific date and time for the test to execute and frequency by selecting from the following options:
    • Run once: Lets you run the test immediately for the specified date and time.
    • Run every: Lets you schedule the test to run periodically. You can customize your test to run at specific Minute, Hour, Day of the Week, and Day of the Month.
  4. Click Save to preserve your changes.

In addition:

To disable an existing schedule, select the Disable checkbox from the top of the calendar interface.

To discard your changes, click Cancel.

 

This topic was last updated on July 08, 2020, at 06:07:51 PM.

Eggplant icon Eggplantsoftware.com | Documentation Home | User Forums | Support | Copyright © 2020 Eggplant