Creating a test deployment

This section describes how to create a deployment for your test suite. The examples are set within the context of the Test perspective. Specifically, we shall:

As we progress through the document we shall explain the various options and features available at each stage.

Creating a test deployment

  1. Right-click in the Test Navigator and select  New > TestElement... The New wizard opens:
  2. Open Test Assets and select Deployment then click on Next to open the New Deployment dialog:
  3. Select the parent folder and enter the deployment name (testDeployment). Click on Next and (optionally) enter a description for the deployment:
  4. Click on Finish. This will result in the Deployment editor opening:
  5. There are 2 main tabs: Overview and Pairs. The above screen capture shows the Overview tab information.

Overview Tab

The General Information section provides the deployment's name (testDeployment), Description ('An example deployment'), and its path within the workspace (/java_01/testDeployment.deploy).

The Artifacts and Locations sections are both empty at this stage; they will contain references to any artifacts and locations respectively which are subsequently associated with the deployment.

Pairs Tab

The Pairs tab is used to add Artifacts and Locations and to form Artifact/Location pairs:

We shall return to the Pairs tab later when we have created a sample Artifact and Location.

Creating an Artifact and a Location

Creating an Artifact

Repeat the same sequence of steps above as for deployment creation but this time create an artifact named testArtifact.

1

Right-click in the Test Navigator and select  New /TestElement...

2

Open Test Assets and select artifact.

3

Click on Next to open the New Artifact dialog.

4

Select the parent folder and enter the artifact name (testArtifact).

5

Click on Next and (optionally) enter a description for the artifact.

6

Click on Finish.

 

The Artifact editor will open:

There are (initially) 2 main tabs: Overview and Test Assets. The above screen capture shows the Overview tab information.

Overview Tab

The General Information section provides the artifact's name (testArtifact), Description ('An example artifact'), and its path within the workspace (/java_01/testArtifact.artifact).

The Test Assets section shows the test elements associated with the artifact; in this case none.

The Property Groups section includes General Properties, and, if either of these is selected, this will instantiate an additional tab named General Properties with content:

We shall look at this section later in the document.

Test Assets Tab

In the Overview tab, clicking on the More... button, or selecting the Test Assets tab, results in the Test Assets view being displayed:

To add a test asset, click on the Add... button to bring up the Select Resource dialog:

Navigate to a resource, select it, and click on OK. The resource (in this example SimpleTest.testsuite, a TPTP JUnit test) will be added to the Test Assets section:

You can add or remove test assets by using the Add... or Remove buttons respectively. As we have seen, invoking Add...  brings up the Select Resource dialog. To remove an asset, select it by clicking on it, then press the Remove button.

Where there is more than one asset in the Test Assets section, their relative ordering can be modified by selecting an item within the list and then pressing the Up or Down buttons to move the selected item up or down the list, respectively.

If we return to the Overview tab view, we see that SimpleTest has been added to the Test Assets section:

Apart from the JUnit testsuite, the test assets should include any other resources (e.g. datapools) required.

Creating a Location

Repeat the same sequence of steps above as for deployment or artifact creation but this time create a location named testLocation.

1

Right-click in the Test Navigator and select  New /TestElement...

2

Open Test Assets and select location.

3

Click on Next to open the New Location dialog.

4

Select the parent folder and enter the artifact name (testLocation).

5

Click on Next and (optionally) enter a description for the location.

6

Click on Finish.

 

The Location editor will open:

There are 3 tabs: Overview, General Properties, and Eclipse Workbench Properties. The above screen capture shows the Overview tab information.

Overview Tab

The General Information section provides the location's name (testLocation here), Description ('A sample location'), its path within the workspace (/java_01/testLocation.location), and the Host name (localhost).

The default host name for the location is localhost. If the intention is to run on another computer, enter the name of that computer in the Host name field.

Property Groups references General Properties and Eclipse Workbench Properties sections, which are also separately shown on the right-hand side of the Location editor overview tab view. Each  references respectively the General Properties and Eclipse Workbench Properties tabs. both reference the General Properties tab. Clicking on the More... button in either the General Properties or Eclipse Workbench Properties sections switches to their respective tab views.

Eclipse Workbench Properties

This is concerned with the setting of properties relating to the deployment of a TPTP JUnit Plug-in Test. It is covered in the help documentation describing TPTP JUnit Plug-in Test.

General Properties

This is relevant to TPTP JUnit tests particularly. We shall look at it in more detail later after we have formed an artifact/location pair.

Forming an artifact/location pairing

We return now to the Deployment editor (if it is not already open, open it by double-clicking on testDeployment.deploy). Select the Pairs tab:

Adding the Artifact

Click on the Add... button adjacent to the Artifacts section and select the Use an existing resource option and, in the Add Artifact Association dialog, either type in the path reference for testArtifact in the Existing resource field, or use the Browse... button to navigate to it and select it:

Click on Finish. The artifact will be added to the list in the Artifacts section:

 Adding the Location

This follows a similar process to that for adding an artifact. Click on the Add... button adjacent to the Locations section and, in the Add Location Association dialog, select the Use an existing resource option and either type in the path reference for testLocation in the Existing resource field, or use the Browse... button to navigate to it and select it:

Click on Finish. The artifact will be added to the list in the Artifacts section:

You can add or remove items from the Artifacts or Locations lists by using their respective  Add... or Remove buttons. To remove an item, select it in the appropriate list, by clicking on it, then press the Remove button.

Where there is more than one item in either list, their relative ordering can be modified by selecting an item within the list and then pressing the Up or Down buttons to move the selected item up or down the list, respectively.

Press the Open... button in either the Artifacts or Locations lists to open the Artifact or Location editor respectively for whichever list item is selected.

Forming the Artifact/Location Pairing

Now click on the down-arrow in the middle of the Pairs tab view to form the testArtifact/testLocation pairing:

To remove a pairing, select it, by clicking on it, then press the  Remove button. Where there is more than one pair in  list, their relative ordering can be modified by selecting an item within the list and then pressing the Up or Down buttons to move the selected item up or down the list, respectively.

General Properties Tab

Artifacts

We saw earlier that the Artifact editor posses a General properties section and tab. We now look at this feature. If it is not already open, open the Artifacts editor for testArtifact by double-clicking on it:

Notice that CLASSPATH has now been added to the General Properties section as a consequence of the artifact being associated with a JUnit test.

In the Overview tab, clicking on either CLASSPATH or the More... button in the General Properties section of the Overview tab, selecting General Properties in the Property Groups section, or selecting the General Properties tab, all result in the General Properties tab view being displayed:

Note that, while it is possible to add in further properties to the General Properties section, TPTP itself only utilizes the CLASSPATH property. It may be that other applications can make use of additional properties, so, for completeness, we describe how to add, remove and edit such properties.

To add a new property, click on the Add... button. This brings up the dialog:

Enter your property name in the Property Name field, or select it from the drop-down list:

Select the Operator from =, !=, >, <, >=, or <= (via the associated drop-down list) and insert the required value in the Property Value field.

To edit an existing property, double-click on it to bring up the Edit Property dialog:

Then change the Property Name, Operator, or Property Value fields as required.

To remove an existing property, select it then click on the Remove button.

Locations

The functionality available here is identical to that described above for the General Properties tab in the artifact editor.

Remote Deployment

If the intention is to run tests on another computer, the name of that computer must be entered  in the Host name field of the relevant location.

Where a TPTP JUnit Test is being deployed remotely, there are a number of other considerations to take into account. These are covered in the documentation relating to TPTP JUnit Test.