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.

• If you are planning to run TestComplete tests in Windows-based testing environments provided by CrossBrowserTesting.com, you must have an active CrossBrowserTesting account with TestComplete support. You must also provide valid account information so that TestComplete can connect to the CrossBrowserTesting cloud from your computers.

  This approach to running tests in CrossBrowserTesting.com environments is obsolete starting with TestComplete 14.40. We recommend using the Device Cloud add-on instead. See About Cross-Platform Web Tests for details.

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.