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.

Image Removed

Image Added

Step 2: Select

the Project. On Issue Type, select 

Precondition.

Step 3: Type a Summary for the

Precondition and complete all appropriate fields — at least, the required ones which are marked

with an asterisk.

Image Removed

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

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

        Image Added

Step 4: When you are satisfied with the content of your

Precondition, 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

Precondition details, while leaving the Summary field blank.

Editing a Pre-Condition

To Edit an existing

Pre-Condition

Precondition issue using

the

inline edit

page

:

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

Image Removed

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.

Image Removed

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

Click the Update button to save your changes.

Step 1: On the Precondition page view, hover your mouse over a field and click it to Edit Inline.

Examples:
- You can hover on the actual Precondition Type, click it to enter the edit mode, and choose other available option on the selected field.
- You can hover on the Definition field, click it to enter the edit mode, and modify the contents.

Step 2: To save the changes, just click outside of the field area of click the save button located in the bottom right corner of the editing field. 

Image Added

Cloning a Pre-Condition

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

To clone a Precondition issue, select the "Clone" action in the issue page:

Image AddedImage Removed

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

After this, an additional dialog will be shown.

Image Added

And after the issue is created, its page will be opened.

On some occasions the cloned issue page may open before the Xray information is actually cloned and as a result the new Precondition will appear empty.

When this happens the following information will be shown:

Image Added

Change Precondition Type

When the Type of a Precondition is changed, both the previous Info details and the associated Tests will be lost.

Image Added

Manage Tests and Pre-Conditions

Create Tests from a Pre-Condition

To create a Test directly associated with the current Precondition from the Precondition issue view screen:

Step 1: Open the Precondition issue view screen you want to create a Test with.

Step 2: Click Create Test (under the Tests section on the view page) to open the Create Issue dialog box.

Image Added

Step 3: Type a Summary for the Precondition and complete all appropriate fields — at least, the required ones marked by an asterisk.

Image Added

Associate Tests

To associate Tests with a

Precondition from the

Precondition issue view screen:

Step 1: Open the

Precondition you

want to associate a Test with.

Step 2: Click Add Tests (under the Tests tab on the view page) to open the Add Tests dialog box.

Image Added

Step 3: Select or search the Test issues to be associated with the Precondition:

Select Test Issues: 

Image Removed

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.

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".

Image Removed

Under the Select tab:

- Input the desired Test Issue Key on the Tests field
- Click on the Down Arrow on the Tests field and select the Test from its History Search list
- Click on the Search tab to use the Find Jira issues browser (more details here)

Image Added

Search Test Issues: Under the Search tab:

- Select the desired Project and any other desired field such as Test Type, Contains, Label, Fix Version, Component, Covering, Covering Fix Version, Saved Filters and Workflow Status

- Click on the Search button after filling the browse fields to get a list of matching entries

Image Added

Search Test Issues using JQL: Under the JQL tab:

- Write the desired JQL search
- Click on the Search button perform the JQL search and to get a list of the matching entries (more details about JQL here)

Image Added

Step 4: Click Add Selected to add the tests you have selected or Add All to add all the tests that were filtered by the search parameters.

Note: Only Tests that have the same kind as the Precondition will be associated.

Remove Tests

To remove Tests from a

Precondition using the

Precondition issue view screen:

Step 1: Open the

Precondition from which you want to remove a Test.

Step 2: On the Tests table,

 click on the ... in desired Test row and

then click Delete in the drop down menu. You will be prompted with a confirmation dialog

.

Bulk Operations

Xray provides the following bulk operations on the Tests table. 

• Remove - Deletes all the selected Tests associations with a Precondition.

To execute these bulk actions:

Step 1: Open the Precondition issue.

Step 2: A checkbox should be displayed on each Test row and also the bulk actions button in the actions column header should appear after a test is selected.

Step 3: Selected the desired Test issues.

Step 4: Click the bulk actions button located in the Actions column and choose one of the available actions.

Image Added

Image Removed