What is a Pre-Condition

Pre-Conditions specify the conditions that need to be fulfilled in order to execute a test.

A Pre-Condition is like defining step "0" for your tests. This is very useful in many use cases where you have to start by doing exactly the same thing. For example, if you are going to do something on a system, you most likely have to authenticate it first, right? But sometimes, you have to do several things  (e.g., restore DB, authenticate) before going through your Test steps. Each of those things may be done and used independently, i.e., some Tests may require just restoring the DB, another may require just to authentication, and others may require both things or more.  





Creating a Pre-Condition

To create a new Pre-Condition issue:

Click the Create Issue at the top of the screen to open the Create Issue dialog box.

Select the relevant Project and on Issue Type select Pre-Condition.

Type a Summary for the Pre-Condition and complete all appropriate fields — at least, the required ones which are marked by an asterisk.

On the Pre-Condition Details tab, select the Pre-Condition Type and complete all appropriate fields.


Optional:
- Click on the Tests tab to associate the current issue with Tests.

When you are satisfied with the content of your Pre-Condition, click the Create button. If you selected the Create another check box (above), a new Create Issue dialog appears. This issue is automatically pre-populated with your previous Pre-Condition details, while leaving the Summary field blank.


Editing a Pre-Condition

Using the Edit Issue dialog box

To Edit an existing Pre-Condition issue using the edit page:

Click the Edit button (at the top-left of the 'view issue' page) to open the Edit Issue dialog / page.

Modify your Pre-Condition details in the appropriate fields of the Edit Issue General tab.

Modify your Pre-Condition's Details under the identically named tab on the Edit Issue page.

Optional:
- Click on the Tests tab to edit Test associations.

Click the Update button to save your changes.



Cloning a Pre-Condition


Cloning a Test issue creates a new Test with all the information of the cloned Test, except its executions. Therefore, the cloned issue will not be associated with any Test Execution issue.


Select More > Clone. The Clone Issue screen will appear.



You can edit the clone Test's Summary if you wish.

  - If the test contains links to other issue(s), you can select whether or not to include the links in the new clone test.

  - If the test contains sub-tasks, you can select whether or not to create the sub-tasks in the new clone test.

  - If the test contains attachments, you can select whether or not to include the attachments in the new clone test.

Click Create.


Change Pre-Condition Type

If the Pre-Condition type is changed, and the Pre-Condition is already associated with tests, a validation process will take place to check if there are any conflicts between Test types and the new Pre-Condition type. If there are conflicts, a confirmation popup dialog will appear showing the Test issue keys with different types. If the operation is confirmed, the association between the Pre-Condition and the conflicted Test issues will be removed. 

Screenshot: Example Delete Pre-Condition Association? dialog box

Manage Tests and Pre-Conditions


To associate Tests with a Pre-Condition from the Pre-Condition issue view screen:

Open the Pre-Condition you wish to associate a Test with.

Click the Associate Tests button (under the Tests tab on the view page) to open the Issue Picker Dialog.


Open the Search tab.

Configure the search.

-Use the Filters dropdown button to include extra fields in the search criteria.

-Fill in the filters values.

-Press the search button.


How to use de Issue Picker Dialog

Below it is an example of how to add tests, using some of the features available in the Search tab.

For more information, please visit the Issue Picker Dialog detailed overview.


Select and Add tests.

- Once the results are obtained you can order, add/remove columns to the results list (the columns selection is saved as a preference).

- Check the tests you wish to add from the listed results.

Add tests by pressing "Add selected".

Remove Tests

To remove Tests from a Pre-Condition using the Pre-Condition issue view screen:

Open the Pre-Condition you wish to remove a Test.

On the Tests table, hover over the desired Test row and click on the Trash button that appears at the end of the row. You will be prompted with a confirmation dialog.