Running TestComplete Tests

Applies to TestComplete 15.47, last modified on January 20, 2023

You can configure your build plan in Bamboo to run your TestComplete tests:

Prerequisites

  1. Open an interactive user session on your agent. You can do it manually, by logging in to the agent by using Windows Remote Desktop. However, we recommend that you open an interactive user session (and run tests) automatically by using the SessionCreator utility that is shipped with TestComplete. To learn how to do this, see below.

  2. If needed, create capabilities and requirements to specify agents on which your job will run TestComplete tests. See Specifying Agents to Run TestComplete Tests.

  3. Place TestComplete test files to a location where TestComplete (or TestExecute) on your Bamboo agent can access them.

    If you store your TestComplete in a source control, configure your build plan to get the TestComplete project files to a needed location:

    Running TestComplete tests from Bamboo: Getting TestComplete test project files from the repository

    Click the image to enlarge it.

    Note: We recommend that you add your TestComplete project files to source control directly from TestComplete IDE. This way, only the necessary files will be added. See Integration With Source Control Systems.

    As an alternative, you can place your TestComplete test projects to a shared network folder.

  4. If you run TestComplete tests by using a script file, place that file to a location where the appropriate utility on your agent can access it.

Note: In addition, if you use Zephyr Squad to plan and monitor your testing efforts, you can publish your TestComplete test results to your Jira projects. To do this, bind your TestComplete project to your Jira project and assign Zephyr tests to your TestComplete tests. To learn how to do this, see Integration With Zephyr Squad.

Configure the Build Plan to Run TestComplete Tests

You can use the Script task to command your build plan to run TestComplete tests by using the SessionCreator utility or TestComplete's (TestExecute's) command line.

  1. In Bamboo, click Build > All build plans.

  2. Select your build plan and click Configure plan.

  3. Switch to the Stages tabbed page of your plan and click a job that you want to run your TestComplete tests.

  4. Click Add Task and select the Script task in the Task types dialog:

    Running TestComplete tests from Bamboo: Adding a Script task to the job

    Click the image to enlarge it.

  5. In the Interpreter drop-down list, select the tool you want to use to run TestComplete.

  6. In the Script location drop-down list, select whether you want to run the inline script or a script file.

  7. To run the inline script, enter the needed script commands to the Script body field.

    To run a script file, enter the path to the needed file.

    Configure your task to run the needed tests on the agent.

    If your agent still does not have an interactive user session open, we recommend that you open it automatically and run the tests by using the SessionCreator utility that is shipped with TestComplete (and TestExecute) version 14.10 and later.

    Open an Interactive User Session and Run Tests (SessionCreator)

    Run Tests (TestComplete Command Line)

    For detailed information on the SessionCreator command line, see the utility description.

    For detailed information on the TestComplete command line, see TestComplete Command Line.

  8. If needed, specify additional parameters of the Script task.

  9. Save the changes.

Run the Build Plan

In Bamboo, run your build plan:

Running TestComplete tests from Bamboo: Running a build plan

Click the image to enlarge it.

The plan will run your test on your agents and will command the SessionCreator utility to open an interactive user session on the agent and to run the specified TestComplete tests.

To learn how to configure Bamboo build plans to get TestComplete test results, see Getting TestComplete Test Results.

See Also

Integration With Bamboo
TestComplete Command Line

Highlight search results