Running TestComplete Tests

Prerequisites

Configure the Build Plan to Run TestComplete Tests

Run the Build Plan

1. If needed, open an interactive user session on your agent. To open a user session manually, you can log in to the agent by using Windows Remote Desktop. We recommend that you open an interactive user session (and run tests) automatically on your agent 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:

   

   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 for Jira 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 for Jira.

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:

   

   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 script to open an interactive user session on the agent and to run your TestComplete tests. To do this, you can use the SessionCreator utility that is shipped with TestComplete and TestExecute.

   Note: If you have a TestComplete version prior to version 14.10, open a user session on your agent manually and run your TestComplete tests by using the TestComplete command line.

   Specify the path to the utility executable. Use the RunTest command to open a user session and run tests. Specify the path to the project or project suite that stores the needed tests. If needed, configure the utility to export the test results to an external file.

   For example:

   cmd.exe

   SessionCreator.exe RunTest /UserName:Tester /Password:mypassword1 /ProjectPath:"C:\Tests\TestProject1\TestProject1.mds" /p:TestProject1

   

   Click the image to enlarge it.

   PowerShell

   $sessioncreator = SessionCreator.exe
   $path = 'C:\Tests\TestProject1\TestProject1.mds'
   $user = ‘Tester’
   $pass = ‘mypassword1’
   $UserName = ‘/UserName:’ + $user
   $Password = ‘/Password:’ + $pass
   $ProjectPath = ‘/ProjectPath:’ + $path
   $Project = '/p:TestProject1'
   $arguments = 'RunTest', $UserName, $Password, '/UseActiveSession', $ProjectPath, $Project
   Start-Process Start-Process -FilePath $sessioncreator -ArgumentList $arguments

   

   Click the image to enlarge it.

   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.

In Bamboo, run your 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.