Import QA test cases from a spreadsheet
This guide turns an existing manual test suite into Agentic QA journeys. It uses the dashboard’s
import, which reads a .csv or .xlsx export from a test-management tool such as Xray, TestRail or
Zephyr. To write journeys as JSON instead, use
b8e qa journeys import.
Export one row per step
Section titled “Export one row per step”Export the test cases with one row per test step. A test case’s rows must sit together: the import starts a new journey each time the ID column changes, and refuses a file where an ID comes back after other test cases.
The import reads these columns:
| Column | Required | Holds |
|---|---|---|
| ID | yes | The test case key. Rows that share it become one journey. |
| Step | yes | What the tester does. A row with no step adds nothing. |
| Journey name | no | The name in Journeys and in the run command. Defaults to the ID. |
| Data | no | Values the step types or picks. Added to the step as Data: …. |
| Expected result | no | What the page is checked for after the step. |
| Start page | no | A path such as /cart, or a URL on the project’s site. |
| Language | no | A language tag such as en-US or tr-TR. |
The journey name comes from the row that starts the test case. The start page and the language come from the first of its rows that fills them in.
A URL on the project’s site written in one of a test case’s first three steps, in the step or its data, is used as the start page ahead of the Start page column.
An expected result of -, n/a, none or empty counts as no expected result.
A file holds at most 1000 test cases.
Import it
Section titled “Import it”- In the dashboard, open the project’s Agentic QA → Journeys and choose Import journeys.
- Choose the export file.
- Under Columns, check the column picked for each field. The import matches them from the headers; change any that are wrong, or pick Not in this file.
- Under Start pages, pick a page for each journey listed there. A journey is listed when neither a URL in its first three steps nor its Start page column names a page on the project’s site.
- Under Language, enter a language tag if the field is shown. It applies to every journey with no language of its own.
- Read Changes, then choose Import N journeys, where N is the number of journeys in the file.
The whole file is imported or none of it is. When a journey is refused, fix the file or the mapping and choose the file again.
Update journeys you imported before
Section titled “Update journeys you imported before”Import the new export the same way. A test case whose ID the project already has updates that journey instead of adding a second one. Changes lists what will change on each one: its name, steps, start page or language. A test case with a new ID is added.
Check the result
Section titled “Check the result”The journeys are in Agentic QA → Journeys. From a terminal:
b8e qa journeys listb8e qa journeys show "Checkout as a guest"Steps written for a person to read sometimes rely on what the tester already knows. Read a few imported journeys before you run them all, and rewrite them by the rules in Write steps the agent can check.