Integration With Continuous Integration (CI) Systems

The computers, where your CI system will run TestComplete tests, are often called agent machines. They must meet the following requirements:

• They must have TestComplete or TestExecute installed.

• Important: The agent machines must have an interactive user session started. These sessions imply that a user works with the operating system and applications through the GUI (windows, menus, controls and so on). Quite often, CI systems use GUI-less sessions on agent machines. TestComplete tests cannot work in these sessions, because the GUI does not exist, and TestComplete cannot simulate user actions on windows and controls.

  If you have TestComplete (or TestExecute) version 14.10, you can use the SessionCreator utility to open user sessions on your agent machines automatically. Otherwise, you will have to open user sessions manually or by using third-party tools.

• Your project or project suite files must be available on these computers.

  You can store your project files in a source control repository and configure your CI system to take them from the repository to the computer where your tests will run.

  – or –

  You can store your project files in a shared network folder to which the agent machines have access.

• TestComplete or TestExecute must have access to all the resources, applications and files required for testing. Also, TestComplete (or TestExecute) must have appropriate access permissions for these files and resources.

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.

1. Install TestComplete or TestExecute on the computer where your automated tests will run.

2. Configure your CI system to prepare your testing environment. For instance, configure it to place your test project in a folder to which the agent machines have access.

3. Important: Open an interactive user session on the computer where your tests will run.

   (For TestComplete 14.10) Use the SessionCreator utility that is shipped with TestComplete and TestExecute to open an interactive user session on your test agents and to run your tests. See the utility description.

   As an alternative, you can open user sessions on remote machines manually or by using various third-party utilities.

4. Configure your CI system to start TestComplete or TestExecute on the needed computer and to run tests.

   (For TestComplete 14.10) Use the SessionCreator utility that is shipped with TestComplete and TestExecute to run tests. See the utility description.

   (For TestComplete versions prior to version 14.10) Use the TestComplete command line to run tests. See TestComplete Command Line.

5. If needed, configure your CI system to get TestComplete test logs.

   Note:

   By default, TestComplete stores test results in the XML format. You can configure TestComplete to export results in the HTML and MHT formats or to pack them into an archive. To learn more, see Working With Test Results.

6. If needed, configure your CI system to clean your test environment after the test runs are over.