Create New Project Wizard - Add BDD Files Page

Applies to TestComplete 14.20, last modified on September 11, 2019

With TestComplete, you can create and automate BDD tests. On the Add BDD files page of the New Project wizard, you can specify the feature files to be imported to your new test project. You can then automate their test steps in the project.

To view the page, select the BDD files check box on the first page of the wizard, and then click Next there.

The 'Add BDD files' page

Click the image to enlarge it.

You can add feature files stored on your hard drive (you can import, for example, the feature files you created for Cucumber), import BDD scenarios from HipTest, or create new feature files.

Import a project from HipTest

HipTest is a cloud-based testing platform by SmartBear. You can import BDD tests from HipTest into your test project and automate them with TestComplete. For more information on this, see HipTest Integration.

To import feature files:

  1. Select Import a project from HipTest.

  2. Specify the credentials you use to connect to HipTest.

    If you are not a HipTest client, click Create a new HipTest account and follow subsequent instructions. You will get a free HipTest account. Specify the email and password then on the page.

    If you log in to HipTest by using your GitHub or Google account, generate API credentials in HipTest, and then specify them in the wizard. See Login With GitHub or Google Credentials for details.

    Select the Remember login credentials check box to command TestComplete to save the credentials on your computer. TestComplete will use them for your further operations with HipTest. If you keep the check box clear, you will have to enter the credentials every time TestCompletesynchronizes feature files with HipTest, or posts test results to HipTest.

    Click Next.

  3. On the next page, the wizard will ask you to specify a HipTest project from which BDD scenarios should be imported:

    The 'Import feature files from a HipTest project' page

    Click the image to enlarge it.

    Note: HipTest supports both BDD and non-BDD test projects. You need to select a BDD HipTest project. To make the choice easier, the wizard hides non-BDD projects from the page.

    Select the desired project and click Finish.

What happens next

TestComplete will import feature files from the specified HipTest project and create project items for them in the new test project. If HipTest feature files are organized into folders and subfolders, TestComplete will clone the folder structure in its project. TestComplete will also generate script functions for all the test steps in the imported feature files and will link the test steps to these functions (so, you will not have to do this manually later). To automate BDD tests, you will have to create code for these script functions.

By default, your TestComplete project becomes bound to the HipTest project. This means that TestComplete will automatically update its feature files from HipTest every time you open your project in TestComplete, or before you run BDD tests in TestComplete. TestComplete will also store results of automated test runs to HipTest.

For more information on this, see HipTest Integration. Note that you can import feature files from HipTest at any time by binding your existing TestComplete project to a HipTest project.

Add local BDD feature files

You can append existing feature files to your new TestComplete project. These files should have the .feature extension and should be written in Gherkin.

  1. Select Add local BDD feature files.

  2. Click the ellipsis button and browse for the folder that contains the feature files you want to add to your TestComplete project.

    BDD adepts typically have multiple feature files stored in some folder and subfolders. With TestComplete, you can import all these files at a time.

  3. Click Finish.

What happens next

TestComplete will scan the specified folder and its subfolders for the .feature files and will include these files in the new TestComplete project you are creating. Also, it will automatically generate script functions for test steps in the imported feature files, so you will not have to do this manually. To automate BDD scenarios, you then need to create or record code for these functions.

Create a new feature file

You can create a new feature file and add it to your TestComplete project:

  1. Select Create a new feature file.

  2. Click Finish.

What happens next

TestComplete will create a new project and add a stub feature file to it.

See Also

Create New Project Wizard
Create BDD Scenarios

Highlight search results