Join Wintertainment 2021 to share your stories, have fun, earn community badges, and more!

Prepare TestComplete Project for Integration

Applies to TestComplete 15.10, last modified on December 07, 2021

Before you can run your TestComplete tests as part of your pipeline or of a test plan managed by Azure DevOps or Team Foundation Server, prepare your TestComplete project:

1. Specify tests you want to run

  1. In TestComplete, open the project that contains tests you want to run.

  2. Add tests you want to run to the Execution Plan of the project.

    Supported tests
    • Separate keyword tests and script routines. These tests must be marked as test cases. Select the check box in the Test case column of the appropriate test item in the Execution Plan.

    • Separate BDD scenarios.

    • Scenario outlines. The Treat each example in Scenario Outline as a separate test case option of the project must be disabled.

    Unsupported tests

    The following items will be ignored by the TestComplete test adapter:

    Make sure that added tests can run independently of each other. When you run them as part of a pipeline or test plan, they may be distributed among multiple agents and executed in an arbitrary order.

    TestComplete integration with Azure DevOps: Creating test cases

    Click the image to enlarge it.

    For detailed instructions on how to manage tests in the Execution Plan, see the Execution Plan editor description.

  3. Make sure that the created test items run correctly. For example, by running them on your local computer.

  4. Add your TestComplete project suite to the repository of your team project.

    TestComplete integration with Azure DevOps: TestComplete project in a team project repository

    Click the image to enlarge it.

    We recommend that you do it directly from TestComplete IDE. This way, only the necessary files will be added. How to add the project suite depends on the type of the repository you use to store team files. To learn how to add TestComplete projects to various source control systems, see the Integration With Source Control Systems section.

  5. If you are going to use TestComplete tests to automate Azure DevOps or Team Foundation Server test cases, link TestComplete cases to your team project’s test cases. To learn how to do it, see:

    Link TestComplete Test Cases to Azure DevOps Test Cases

    Otherwise, skip this step.

2. Make sure that your tests can access your tested application and all files and resources required for testing

  • If your projects use the Tested Applications collection to run your applications under test, make sure that the application launch parameters that the collection items specify will remain valid after your project is placed to Azure DevOps test agents.

  • If your tests launch your tested applications by using hard-coded launch parameters, make sure that those parameters will remain valid after your project is placed to Azure DevOps test agents.

  • If your tests use external files, for example, files that store input test data, make sure that they will be able to access them when running on your Azure DevOps test agents.

You may want to configure your pipeline to place all the needed files to your Azure DevOps test agents before you run your TestComplete tests. If the files are stored in your source control repository, configure your pipeline to place them to the needed target location on the test agent. You can also use various pipeline tasks to do this.

See Also

Integration With Azure DevOps and Team Foundation Server via TestComplete Test Adapter
Integration With Azure DevOps and Team Foundation Server - Requirements
Prepare Test Agents to Run TestComplete Tests
Tests, Test Items, and Test Cases
Integration With Source Control Systems

Highlight search results