Test Repository

The Test Repository is a folder tree for your Test Cases. Each Testing Project has one repository with its own tree.

The Test Repository is often where testing starts. You plan tests by choosing Test Cases here and adding them to a Test Plan.

Folders are optional. A Test Case can be in one folder at most.

You set the folder of a Test Case in its ATM Repository field.

Open the Test Repository

1. Open the Jira space that holds your Test Cases.
2. In the space navigation, select the ATM Repository tab.

The Test Cases Repository page opens. The Testing Project: label above the tree shows the Testing Project of the repository. The folder tree is on the left, and the table of Test Cases is on the right. Select a folder to list its Test Cases.

Next to each folder name are two counters, for example 0 (5). The first is the number of Test Cases in that folder. The number in brackets also counts the Test Cases in all its subfolders.

The breadcrumb above the table shows the path of the selected folder, for example Testing Folder / UI. When you hover over the folder name, it becomes a link to a JQL search for the Test Cases of this folder. Click it to copy the JQL. In the flat view, the copied JQL uses the atmRepositoryFolders() function, so it also covers the subfolders.

Choose the table columns

Click Columns above the table to choose which columns it shows. The list has a Search columns box and a checkbox for each column.

By default, the table shows Work Key, Summary, ATM Test Type, Labels, Priority, Status, and ATM Repository.

When you turn a column back on, it moves to the end of the table. Your choice of columns stays when you open another folder.

ATM saves the selected columns and their order separately for each user and each Testing Project. They are still there after you refresh the page. Without a saved choice, the table shows the default columns.

In the Columns menu, the selected columns are listed first and the other columns follow in alphabetical order. The Search columns box ignores letter case.

If a field isn’t on the list, its field type isn’t supported. You can ask Appsvio support to add it.

Manage folders

The first item in the tree is All Test Cases. Click + next to it to add a top-level folder. You can’t rename, move, or delete All Test Cases.

When you hover over a folder, its counter changes to two buttons: + adds a subfolder, and … opens the folder menu. The menu has Add catalog, Rename, and Delete.

• A new folder is called New Catalog, and its name field is open. Type a name and click the check mark (✓) to confirm. Click the cross (✕) to cancel. To rename a folder later, choose Rename in its menu.
• To move a folder, drag it onto another folder in the tree. Its subfolders and Test Cases move with it.
• Deleting a folder asks you to confirm first. The Delete catalog window warns that the action can’t be undone. The Test Cases inside aren’t deleted, but they’re removed from the folder. After that, you’ll find them only under All Test Cases.

Put Test Cases into folders

Choose the folder when you create a Test Case

This works when the ATM Repository field is added to the Jira screen of the Test Case work type.

1. In Jira, click Create.
2. Select the space and the work type your Testing Project uses for Test Cases.
3. In the ATM Repository field, select the folder from the list. Type to search. If you don’t see the field, it can be hidden under More fields or turned off in Configure fields.
4. To choose from the folder tree instead, click the tree icon next to the field. In Select tree location, choose a folder and click Confirm selection.

Create a Test Case from inside a folder

Select a folder and click Create Test Case above the table. The Create dialog opens with the ATM Repository field already set to that folder. The summary is filled in too: “Test Case from Folder” followed by the folder name. An empty folder shows the message “No test cases in this folder”.

Set folders during import

When you import Test Cases from a file, the Repository Path column sets the folder of each Test Case. Separate the folder names in the path with a slash (/). Folders that don’t exist yet are created during the import. See Import.

Switch between tree view and flat view

When a folder is selected, two buttons above the table set which Test Cases you see.

• Tree view, Show Test Cases from this folder only: only the Test Cases in the selected folder.
• Flat view, Show Test Cases from this folder and all subfolders: the Test Cases of the folder and all its subfolders, in one list.

ATM remembers the view you choose, tree or flat, separately for each user and each Testing Project. The Test Repository opens in the view you left.

In the example below, the selected folder has no Test Cases of its own, so the tree view is empty. The flat view lists the Test Cases from its subfolder.

From the flat view, you can create one Test Plan or Test Execution for all Test Cases of a folder and its subfolders.

Act on selected Test Cases

1. Select a folder. Switch to the flat view if you also want Test Cases from its subfolders.
2. Select the Test Cases with the checkboxes.
3. A bar appears at the bottom of the screen. It shows how many Test Cases you selected and the actions Create Test Execution, Create Test Plan, and Link requirements.

Create a Test Plan or Test Execution

Click Create Test Plan or Create Test Execution. The Create dialog opens with your selected Test Cases. If the Test Cases come from one folder, the summary is “Test Plan from FOLDER_PATH” or “Test Execution from FOLDER_PATH”, for example “Test Plan from Folder A / Folder B” or “Test Execution from Folder A / Folder B”. If they come from several folders, the summary is “Test Plan from Repository” or “Test Execution from Repository”.

Link the Test Cases to requirements

1. Click Link requirements.
2. In the Link requirements window, search for the requirements and select them. The list shows each requirement’s key, summary, priority, status, and assignee.
3. Click Link.

Search Test Cases with JQL

You can find the Test Cases of a folder with JQL, with or without its subfolders. See Search Folders with JQL.

Example: folders that keep regression tests current

One customer uses folders as a lifecycle for Test Cases:

After a release, every Test Case goes to either Regression/ or Archived/. This keeps the regression set current.