Running POM files from earlier versions of HCL OneTest™ API

POM files generated from earlier versions of HCL OneTest™ API cannot run with HCL OneTest™ API V9.2.1 or later. To use POM files generated from earlier versions of HCL OneTest™ API you must edit the existing POM file. POM files generated from HCL OneTest™ API V9.2.1.1 or later can run a Maven command to update the version property value. Alternatively, you can create a new POM file with the current release.

Running a Maven command

You must run the following Maven command if you want to update POM files generated from HCL OneTest™ API 9.2.1.1 or later.

mvn versions:update-property -Dproperty=it-plugin-version -f <name of pom file>

To back up the existing POM file, find the new version from HCL Quality Server and update the version in the existing POM file.

The following example shows the Maven command to update the existing POM file named pom_tp52776.xml.

mvn versions:update-property -Dproperty=it-plugin-version -f pom_tp52776.xml

This command creates a backup of the file and updates the version in the pom_tp52776.xml from 1.920.0 to 1.921.1

Editing the existing POM file

For POM files generated from earlier versions of HCL OneTest™ API edit the earlier POM file by replacing the version number in the old POM file (for example, 1.911.1 for HCL Quality Server version 9.1.1.1) with the version number from HCL Quality Server V9.2.1 (for example, 1.921.0).

Note: You can find the version for the current release by generating a POM file and by looking at the version property of that generated POM file.

The following example shows a section of a new POM file generated from HCL OneTest™ API V9.2.1:

    <dependencies>
        <dependency>
            <groupId>com.hcl.products.test.it</groupId>
            <artifactId>it-plugin-boot</artifactId>
            <version>1.921.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>com.hcl.products.test.it</groupId>
                <artifactId>it-plugin</artifactId>
                <version>1.921.0</version>

The following example shows a section of an existing POM file that was generated from HCL OneTest™ API V9.2.0:

    <dependencies>
        <dependency>
            <groupId>com.hcl.products.test.it</groupId>
            <artifactId>it-plugin-boot</artifactId>
            <version>1.920.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>com.hcl.products.test.it</groupId>
                <artifactId>it-plugin</artifactId>
                <version>1.920.0</version>

Note the value of the version property (<version></version> in each of the POM files. To run the existing POM file with HCL OneTest™ API V9.2.1, you must edit the version of the existing POM file and change it from 1.920.0 to 1.921.0.

Note: If you generated a Failsafe plug-in POM file from an earlier version of HCL OneTest™ API, you must change the version number in three places.

    <dependencies>
        <dependency>
            <groupId>com.hcl.products.test.it</groupId>
            <artifactId>it-plugin-boot</artifactId>
            <version>1.920.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>com.hcl.products.test.it</groupId>
                <artifactId>it-plugin</artifactId>
                <version>1.920.0</version>
...
            </plugin>
            <plugin>
...
                <dependencies>
                    <dependency>
                        <groupId>com.hcl.products.test.it</groupId>
                        <artifactId>it-surefire-provider</artifactId>
                        <version>1.920.0</version>
                    </dependency>
                </dependencies>