The Test Repository concept enables the hierarchical organization of Tests at the project level by allowing you to organize Tests in folders.

Multiple folders can be created and Tests can be added to them. Similar to traditional operating systems (e.g., Windows, OSX, Linux), Tests can only be part of one folder.

How to access it?

Go to Project side bar > Xray Test Repository



A: Folders section

    • A1: "All" and "Orphans" metafolders
    • A2: the Test Repository itself, composed of folders and sub-folders with Tests organized within them
    • A3: CRUD actions for the current selected folder (e.g., create, rename, delete)
    • A4: information about the number of Tests within the current folder and the total Tests, including sub-folders

B: Tests section

    • B1: path of the folder
    • B2: filter for Tests 
    • B3: additional information about the shown Tests versus the actual total number of Tests within the current folder 
    • B4: ranked list of Tests within the current folder (only direct children)

C: Switch between "flat view" and "folders view." 

Create Folder

Before adding Tests to the Test Repository, you may start to create folders and build the hierarchy needed to organize your Tests.


To create a new folder, go to Project side bar > Xray Test Repository

Step 1: Click on the parent folder.

Step 2: Click on the proper add icon at the bottom of folders section (+)


Step 3: Type the name for the folder.

Step 4: Press Enter or click outside of the selected folder.


In a given parent folder, folders must not have similar names. For this, Xray does a case-insensitive check of the trimmed folder name whenever you create or rename folder. This means that these folder names would all be considered the same: "  phanTom", "phantom", "PHANTOM". Moreover, folder names must not use the following characters: "/", "\", apostrophe, "*".

Move and Order Folders


A folder, including its descendants, can be moved to another folder just by dragging-and-dropping to the destination folder.

To change the position in the hierarchy simply drag-and-drop the folder in the interim space between two existing folders.

  

If you wish to rank it as the last one (i.e., move it to the last position) within some parent folder, you just need to drag it to the parent folder. By default, the folder will be placed in the last position.

  • Carefully structure the hierarchy of your folders, keeping in mind that a Test may only be in a single folder. How would you organize them in your laptop if you were dealing with documents? Start by identifying the folders that you want to place at the root, and then try to drill down and create sub-folders that are relevant to you.
  • If you're already using Test Sets, don't try to replicate the Test Sets model in the Test Repository because, most likely, it won't work. Again, a Test can only be part of one folder in the Test Repository; with Test Sets, a Test can belong to several Test Sets.  
  • Avoid semantics when it comes to the execution phase or else, your Test Repository will get messed up. Use the proper entities, such as Test Plans (and corresponding Boards) to make planning/execution-related organization.