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 (master)
- A1: the Test Repository root folder, composed of folders and sub-folders with Tests organized within them
- A2: a given folder; CRUD actions for the selected folder (e.g., create, rename, delete) can be accessed by right-clicking on the folder
- A3: information about the number of Tests within the current folder and the total Tests, including sub-folders
- A4: context actions for the currently selected folder; these actions are also accessible by right clicking on a folder.
B: Tests section (detail)
- B1: the complete path of the folder
- B2: filter for Tests
- B3: additional information about the shown (filtered) Tests versus the actual total number of Tests within the current folder
- B4: a 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:
Step 1: Click on the parent folder.
Step 2: Click on the add icon at the top of the folders section.
Step 3: Type the name for the folder on the create folder dialog.
Step 4: Press "Create" to create the folder.
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.