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"
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, "*".
UI Step
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.
Note
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, "*".
UI Step
Move & Order Folder
A folder, including its descendants, can be moved to another folder just by dragging-and-dropping to the destination folder.
Also you can change the position in the hierarchy by simply drag-and-drop the folder in the interim space between two existing folders.
Tip
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.
Tip
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.