Versions Compared

Key

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

Table of Contents

Introduction

This page has all enumerates the options available in General Preferences configuration section.

Table of Contents

Test Run Options

Options related to the execution of test issues.

Global Settings available in the Miscellaneous Configuration screen (Figure 1).

Figure 1 - MiscellaneousImage Added

Figure 1 - Miscellaneous


Info

Global Settings access

Options

Miscellaneous

General Options

Usage Tracking

When this option is enabled (Figure 1 - 1), you will opt out of all data collection and guides.

Test Run Options

Display Manual Test Steps Table in Short View

...

When this option is enabled (Figure 1 - 2), the cells of the Manual Test Steps table will be displayed in short-view mode, i.e., the rows will have a limited height to allow for better page navigation. There is an expand option within each cell to view the complete content.

Can Edit Test Run Dates

When this option is enabled (Figure 1 - 3), you can edit the Started On date in the Test Execution Details screen. 

Fail All Steps

When this option is enabled (Figure 1 - 4), all the Test Steps/Examples Statuses will be updated to FAIL whenever the status of a Test Run is changed to FAIL overall Test Run status can be set directly, without depending on the status of manual Test steps or, in the case of Cucumber Scenario Outlines, Test examples.

Inline Execute Tests

When this option is enabled (Figure 1 - 5), Test Runs can be executed inline, directly from the Test Execution issue Issue view pagescreen. This option is only available if the final Test Run Status (above) can be manually set.

...

Send Email Notifications to Test Run Assignees

When this option is enabled , all the Test Steps/Examples Statuses will be updated to FAIL whenever the status of (Figure 1 - 6), its assignee will receive an email notification whenever a Test Run is changed to FAILcreated or assigned.

...

When this option is enabled , the status of automated Test Runs can't be set manually. It can only be modified through the import of automated test results action.

Can Edit TestRun Dates

(Figure 1 - 7), the Time Tracker module is displayed.

Set the value of the Time Tracker

When this option is enabled , the user can edit the Started On date in the Test Execution Details page. 

Defect Issue Links

(Figure 1 - 8), you can set the timer value of the Time Tracker.

Defect Links Options

...

Link Defects with Test

When this option is enabled (Figure 1 - 9), the defects created in the context of a test run Test Run are automatically linked to the respective Test being executedIssue.

Link Defects with Test Execution

When this option is enabled (Figure 1 - 10), the defects created in the context of a test run Test Run are automatically linked to the respective Test Execution issueIssue.

Link Defects with

...

Covered Issues

When this option is enabled (Figure 1 - 11), the defects created in the context of a test run Test Run are automatically linked to the Requirement Covered Issues being tested.

Workflow

...

Statuses

Info

Statuses Available: In Progress, To Do, Done.

Disallow

...

Executions of Tests with

...

Workflow Statuses (Figure 1 - 12)

Prevent Disallow Tests within certain workflow statuses from being executed or even added to Test Executions. Sometimes, a Test is still being written and should not be added to a Test Execution. In those cases, just indicate which Test workflow statuses are considered " not ready to be executed".

Disallow

...

Executions with Workflow Statuses (Figure 1 - 13)

Choose the workflow statuses in which the Test Execution issues Issues will not allow the execution of Tests. For example, if suppose you configure this list with the "Closed" status, then users are no longer Done status. In that case, you will no longer be able to execute Test Runs in this Test Execution issue Issue when a Test Execution issue Issue transitions to "Closed" Done

In progress Test Execution workflow status

Choose what workflow status the test execution will transition to when a test run is executed.

Resolved Test Execution workflow status

Choose what workflow status the test execution will transition to when all the test runs are in a final status.

Resolution for Resolved Test Execution

Choose what resolution will be applied to the test execution. This option is only available if the Resolved Test Execution workflow status is not none. The resolution is only changed for status of type done.

Notifications

User Groups allowed to add/remove Xray Notifications

User Groups which are allowed to add/remove Xray notifications to the Notification Scheme in the project settings page, since it can affect other projects using the sameNotification Scheme.

Final Test Run statuses that may trigger notifications

Final Test Run statuses that may trigger the 'Test Run Status set to Final' or 'Precedent Test Run Status set to Final' events.

Hierarchical Test Organization

Enable Hierarchical Test Organization

When this option is enabled, the Test Repository and the Test Plan Board will be enabled and accessible from the top menu and the project sidebar.

Project Roles allowed to edit the Test Repository information

The project roles that are allowed to edit the Test Repository. If no role is specified, then every user is able to modify the Test Repository.

Defect Default Values

Environment

The defects created in the context of a test run are populated with the "Environment" value from the Issue Type selected in this field

Include Steps Table in Description

When this option is enabled, the description field of the defects created in the context of a manual test step result, will default to a table containing the steps of the test until the step where the defect is being created.

Include Version

When this option is enabled, the Affect Version field of the defects created in the context of a test run will be populated by the FixVersion value of the Test Execution.

Label

The defects created in the context of a test run are populated with the Label value from the Issue Type selected in this field

Miscellaneous

Display Pre-Condition section before Test Details

When this option is enabled, the Pre-Condition web panel on the Test issue view screen will be displayed above the Test Details panel.

Display Manual Test Steps table in short view

When this option is enabled, the cells of the Manual Test Steps table will be displayed in short-view mode. If this mode is enabled, the rows will have a limited height to allow for better page navigation. There is an expand option within each cell to view the complete content.

Delete test definition when changing Test type

When this option is enabled, the test definition will be deleted when changing Test Type. If this option is disabled, the test definition won't be deleted and it'll be possible to undo the Test Type change operation and keep the information.

User Groups allowed to add Xray Issue Types

...

Defect Default Values

Label

Select the source from which the label field will be inherited (Figure 1 - 14). The options are:

  • None.

  • Test - the system will copy the labels from the Test into the created defect.

  • Test Execution - the system will copy the labels from the Test Execution into the created defect.

  • Both - the system will copy the labels from the Test and the Test Execution into the created defect.

Component

Select the source from which the component field will be inherited (Figure 1 - 15). The options are:

  • None.
  • Test - the system will populate the component from the Test into the created defect.
  • Test Execution - The system will populate the component from the Test Execution into the created defect.
  • Both - the system will populate the component from the Test and the Test Execution into the created defect.

Caching Options

These settings allow you to control how long specific data is stored in the cache, reducing load times, which improves Xray's performance and responsiveness:

  • Faster page loads: longer cache durations minimize the need to reload data, speeding up navigation and operations.
  • Customizable: choose from flexible caching durations to balance performance and data freshness.

Figure 2 - CachingImage Added

Figure 2 - Caching

Cache Duration for Test Repository Folders (Figure 2 - 1)

Sets how long the Test Repository folder structure is cached. Longer durations help pages load faster.

The options are: No cache, 1 minute, 10 minutes, 1 hour, 10 hours, 1 day. By default, it’s set to 1 hour.

Cache Duration for Issue Types (Figure 2 - 2)

Sets how long Issue Types are cached (all Issue Types). Longer durations make pages load faster. 

The options are: No cache, 10 minutes, 1 hour, 10 hours, 1 day. By default, it’s set to 10 hours.

Info

A mechanism bypasses the cache for folders. When the system detects changes in data (folder creation, renaming, movement, or removal), the cache is cleared and the system will fetch the new data.

Testing Board

When the enable icon to open test dataset directly option (Figure 2 - 1) is disabled, the Issues listed on the Testing Board do not show the dataset icon.

Once you're finished configuring, click Save (Figure 3 - 2) to make the changes effective.

Figure 3 - Testing boardImage Added

Figure 3 - Testing board


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.