Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
UI Expand
titleTable of Contents

Table of Contents

Introduction

In Software EngineeringIn very simple terms, a Test is a sequence of steps coupled with conditions or variables, test inputs, and an expected result. It is intended to establish a piece of the system's quality, performance, or reliability of a piece of  system, i.e., test the Test target. Usually, every requirement or objective the test Test target is expected to achieve needs at least one Test. The success of the Test is determined by comparing expected predicted and actual results. Table of ContentsmaxLevel2In Xray, a Test is represented by a Test Issue.

Test Types

...

There are 3 four default Test Types:

...

  • kind.
  • Exploratory.
Info

You may add other values for the Test Type In Xray's Global or Project settings.

Actions

Table of Contents
maxLevel2
minLevel2

Create

In order to create a new Test Issue, 

Step 1: Click the Create Issue at the top of the screen to open the Create Issue dialog box / page.
Image Removed
And in the old UI, click the "+" on the left:

Image Removed

Step 2: Select the Project and on Issue Type,  select Test.

Step 3: Type a Summary for the test and fill all appropriate fields — at least, the mandatory ones marked with an asterisk.

Image Removed

Step 4: When you are satisfied with the content of your test, click the Create button.

...

Operations

Creating a Test Issue

UI Steps
UI Step

On your Jira Cloud instance, click the Create button (Figure 1 - 1). A modal will open (Figure 1).

Figure 1 - Create issueImage Added

Figure 1 - Create issue

UI Step

Select the Project (mandatory; Figure 1 - 2)

UI Step

On the Issue Type, select Test (mandatory; Figure 1 - 3).

UI Step

Type a Summary (mandatory; Figure 1 - 4). Complete all remaining fields if necessary.

UI Step

Once you're done, click the Create button (Figure 1 - 5). 

If you select the Create another issue option (Figure 1 - 6)), a new modal appears. This new Issue will be

...

automatically pre-populated with your previous

...

Test Issue details

...

while leaving the Summary

...

 field blank.

Edit

Editing a Test Issue

Info

...

Xray Test

...

Issue sections support inline editing similar to Jira native and custom fields inline

...

editing. This prevents full page reloads when modifying fields.

You can only inline-edit Xray fields if you have permission to edit the Test Issue.

Inline Edit Fields

UI Steps
UI Step

Go to the Test Issue you want to edit (Figure 2)

Figure 2 - EditImage Added

Figure 2 - Edit

UI Step

To inline edit a field,

...

hover over the field view area and click it.

The following Test fields support inline

...

editing:

  • Type:

...

  • the Test Issue Type (Figure 2 - 1).
  • Definition:

...

  • the automated generic

...

  • Test definition (only visible for Generic

...

  • Tests)

...

To inline edit automated Test issues:

...

  • .

Inline-editing Automated Test Issues - Cucumber Test

  • Hover over the Test Type, click it, and change it to another

...

  • available Type (Figure 2 - 1).
  • Hover over the Scenario field, click it, and edit its contents

...

  • (Figure 2 - 2).

Inline-editing Automated Test Issues - Generic Test

Image Removed

...

  • Hover over the 
  • Test Type, click it, and change it to another

...

  • available Type (Figure 3 - 1).
  • Hover over the Definition field, click it, and edit its contents (Figure 3 - 2).

...

Figure 3 - GenericImage Added

Figure 3 - Generic

...


Manual Test Steps

...

To edit the steps of a Manual Test, please check this page.

...

titleEdit Permissions

...

 page.

Changing the Type of a Test

UI Steps
UI Step

When the Type of a Test is changed, by clicking the desired option from the menu (Figure 3 - 1), the details of the previous

...

information along with the associated Preconditions will be lost.

UI Step

When changing the Test Type, you will see a warning message (Figure 4).

...

Click Confirm to proceed (Figure 4 - 1).

Image Added

Figure 4 - Confirm

...


This operation is permanent and not reversible.

...

Cloning a Test

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

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

Image Removed

After this, an additional dialog will be shown.

Image Removed

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

...

UI Steps
UI Step

Go to the Test Issue you want to clone.

UI Step

Click the ellipsis icon (Figure 5 - 1) and then Clone (Figure 5 - 2).

Figure 5 - CloningImage Added

Figure 5 - Cloning

UI Step

A modal will open for you to confirm the cloning of the Test Issue (Figure 6). Click Clone to proceed (Figure 6 - 1).

Figure 6 - ConfirmImage Added

Figure 6 - Confirm

UI Step

After the Issue is created, you will see a success message with the cloned Issue information and a link for you to open the Issue (Figure 7 - 1).

Figure 7 - SuccessImage Added

Figure 7 - Success

Info

On some occasions, the cloned Issue page may open before the Xray information is

...

cloned and, as a result, the new Test will appear empty.

...

When this happens

...

Image Removed

...

, you will see a warning message, with a Refresh issue button (Figure 8 - 1). By clicking that button, the Issue page will be reloaded and the cloned information will be visible.

Figure 8 - RefreshImage Added

Figure 8 - Refresh


Moving a Test Issue

UI Steps
UI Step

Go to the Test Issue you want to move.

UI Step

Click the ellipsis icon (Figure 9 - 1) and then Move (Figure 9 - 3).

Figure 9 - MovingImage Added

Figure 9 - Moving

UI Step

A new screen (Figure 10) will open for you to set these details: destination project and Issue type, map statuses, fields; and for you to confirm these changes.

Figure 10 - MovingImage Added

Figure 10 - Moving

Xray History

Any changes made to the Test data are recorded in the Xray History section. You can see them on the Issue by scrolling down and clicking the Xray History section. These option (Figure 11).

Figure 11 - HistoryImage Added

Figure 11 - History


These updates include:

  • Changing the Test Type.
  • Changing the Test Definition or Steps.
  • Linking the Test with other entities (Preconditions, Test Plans, Test Sets, etc.).
  • Moving the Test between folders on the Test Repository.

...

  • .
  • Attachment addition.
  • Test Execution.


Expand
titleSupport/Troubleshooting

If you have questions or technical issues, please contact the Support team via the Customer Portal (Jira service management) or send us a message using the in-app chat.