Creating a Run
A run is composed where the cases are. New run takes you to the test case repository in compose mode, where you tick the cases you want and name the run in a band across the top.
There is no Create Run modal
Runs used to be created from a modal in the Test Runs module, with an Include All Cases toggle and a separate case-picker. That is gone. A run is now built from the cases you are looking at, using the repository’s own folders, filters, search, and saved views — so you never have to rebuild a filter you already had.
The composer opens on the repository at ?compose=fixed, with a band pinned across the top of the list and a selection bar along the bottom.
Step by step
- Click New run in the Test Runs toolbar. You land on the test case repository with the compose band open and the run name focused.
- Type a run name, or leave it blank — see Naming below.
- Optionally pick a Cycle and an Env from the pills beside the name.
- Tick the cases you want in the list below. Use folders, filters, search, and saved views to narrow it down first.
- To take everything matching your current filter, use Tick all N in the bottom bar. The server resolves that set, so it is not limited to the rows currently loaded on screen.
- Missing a case? New case stays live while you compose — see Writing a case without leaving the composer.
- Click Create run in the bottom bar, or press Enter from the name field.
Writing a case without leaving the composer
If you notice a gap while picking cases, you do not have to abandon the run and start again. The composer is the test case repository, so its New case button keeps working mid-compose (it needs the Create test cases permission, like anywhere else). Write the case in the panel and save it, and:
- It lands in the list already ticked, so it is part of the run you are composing — you do not have to go and find it.
- The tick appears the moment you save, before the server has finished; if the save fails, the case and its tick are both rolled back together.
- Create run is briefly unavailable while a brand-new case is still saving — one round trip — so a run can never be created naming a case the server has not stored yet.
The same applies in Edit cases… on an existing run — it opens the same composer.
Esc from the name field cancels the composer. Cancel returns you to wherever you came from — the button is labelled with that origin, for example Back to Test Runs.
What the composer asks for
The band is deliberately short. There are four decisions:
| Control | Required | Description |
|---|---|---|
| Run name | No | The run’s title. Leave it blank and the suggestion shown as placeholder is stored instead — the name is never what blocks you from creating a run. |
| Cycle | No | Groups the run under a sprint, release, or iteration. Defaults to No cycle. See Cycles. |
| Env | No | The platform combination under test. Defaults to No environment. See Environments. |
| Fixed / Dynamic | — | Fixed keeps the exact cases you tick, and is the only option today. Dynamic — a run that tracks a filter rather than a fixed list — is visible but disabled, marked coming soon. |
Lifecycle state, tags, and notes are not set at creation. None of them are part of the composer. Set the lifecycle state on the run’s About card afterwards, notes on the run’s Notes card, and tags in the Edit run modal — see Managing Runs.
Naming
The name field shows a suggestion as its placeholder, built from what you are composing from:
- Composing from a narrower scope such as a folder gives <that scope> — <cycle>, or <that scope> — run when no cycle is set.
- With a cycle picked and no narrower scope: Regression — <cycle>.
- With neither: New test run.
Creating with the field left blank stores that suggestion as the run’s real title.
Choosing the cases
Membership is the tick list — there is no “all cases” toggle. The band tells you what you are about to create, for example A frozen snapshot of the 128 ticked cases, and says so when some ticked cases are filtered out of the current view but still included.
Tick all N escalates your current filter into a server-resolved selection. It is unavailable for a few filters the run selector cannot express — the button names them, and you tick the rows you want instead.
A run cannot exceed 5,000 cases, and a run with no cases cannot be created. Create run stays disabled in both cases.
Other ways in
- Plan a run in this cycle on a cycle detail page opens the same composer with that cycle already selected.
- Edit cases… in an open run’s breadcrumb menu reopens the composer against that run, so you can change which cases it contains. See Run Detail.
What happens on create
The run appears immediately — the row is written to the list before the server answers, so there is no spinner. You land on the Test Runs list with the new run in it, not on the run’s detail page.
Snapshot at creation time. A Fixed run captures the ticked cases as they exist at that moment. Adding, editing, or deleting cases in the repository afterwards does not change an existing run. To change which cases a run contains, use Edit cases… from the run’s breadcrumb menu.
Removing a case from a run keeps its results. If you take out a case that already has recorded results, the composer says so first, and those results come back if you add the case again.