diff --git a/src/content/docs/project/import-export/import/images/att2_436_testmo.png b/src/content/docs/project/import-export/import/images/att2_436_testmo.png new file mode 100644 index 00000000..98d255e8 Binary files /dev/null and b/src/content/docs/project/import-export/import/images/att2_436_testmo.png differ diff --git a/src/content/docs/project/import-export/import/images/att2_436_zephyr.png b/src/content/docs/project/import-export/import/images/att2_436_zephyr.png new file mode 100644 index 00000000..73af8c96 Binary files /dev/null and b/src/content/docs/project/import-export/import/images/att2_436_zephyr.png differ diff --git a/src/content/docs/project/import-export/import/images/zephyr-import-flow.png b/src/content/docs/project/import-export/import/images/zephyr-import-flow.png new file mode 100644 index 00000000..9146099b Binary files /dev/null and b/src/content/docs/project/import-export/import/images/zephyr-import-flow.png differ diff --git a/src/content/docs/project/import-export/import/import-tests-from-Zephyr.md b/src/content/docs/project/import-export/import/import-tests-from-Zephyr.md index 3a452493..051473de 100644 --- a/src/content/docs/project/import-export/import/import-tests-from-Zephyr.md +++ b/src/content/docs/project/import-export/import/import-tests-from-Zephyr.md @@ -10,28 +10,62 @@ head: content: Testomat.io, CSV, Zephyr, test import, Zephyr migration, manual tests, automated tests, test management, custom XLS --- -> If you have existing tests in Zephyr and want to migrate to Testomat.io, you can easily import them using the CSV Import feature. +Export your tests in Zephyr to a file and import that file into Testomat.io. -## How to Import Tests from Zephyr to Testomat.io +![Export from Zephyr, then import the file through the Imports window](./images/zephyr-import-flow.png) -1. If you're creating a brand new project, the **Import from Spreadsheet** button will be available under the Test tab. +## Export Zephyr file -![image Import from Spreadsheet button](./images/import_from_spreadsheet_button.png) +1. Open your Zephyr project. +2. Export your test cases as a **CSV** file. +3. Save it on your computer. -2. If you're working in an existing project, open it in Testomat.io. -3. Click on the **Imports** tab. -4. Click the Import from CSV button. +## Import your Zephyr file -5. From the dropdown menu, choose **Zephyr**. -6. Select the XLS file containing your exported Zephyr tests. -7. Click the **Create** button to complete the import. +Start importing your tests to Testomat.io: -![image Import from Zephyr XLS](./images/zephyr_xls.png) +1. Open your project and go to the **Tests** tab. +2. Click the (`…`) menu. +3. Choose **Import from other TMS**. -## Example Files For Import +![Tests tab with the extra menu](./images/att1_436.png) -Below is a sample of the supported format: +In the **Imports** window: -[Zephyr](https://testomatio-artifacts.ams3.cdn.digitaloceanspaces.com/documentation/Zephyr.xls) +1. Click **Import**. +2. Choose **Import from CSV**. A sidebar opens on the right. +3. Choose **Zephyr** from the dropdown. +4. Click **Choose file**, select your exported CSV. +5. Click **Create**. -![image Import from Zephyr XLS](./images/zephyr_xls_sample.png) +![image Import from Spreadsheet button](./images/att2_436_zephyr.png) + +Testomat.io reads the file, and your tests appear on the **Tests** page. + +## Turn your tests into BDD scenarios + +You can also import your BDD projects into Testomat.io. Follow the import steps in your BDD project and every row of the CSV file becomes a scenario: + +- Precondition becomes **Given** +- Step becomes **When** +- Expected Result becomes **Then** + +Your tests are saved as feature files. Leave the checkbox clear and they arrive as classic test cases instead. Full details are in [Import from CSV/XLSX](https://docs.testomat.io/project/import-export/import/import-tests-from-csv-xlsx). + +:::note + +Not sure your export looks right? Download the sample and compare the first row with yours [Zephyr](https://testomatio-artifacts.ams3.cdn.digitaloceanspaces.com/documentation/Zephyr.xls). + +::: + +## If this doesn't work + +* **The import fails.** Check that the first row of your file holds column names. +* **Your folders are flat.** Make sure you picked **Zephyr** in the dropdown, not another format. +* **Something is still off.** Contact [support](https://docs.testomat.io/support) with your file attached. + +## Next steps + +* [Import from CSV/XLSX](https://docs.testomat.io/project/import-export/import/import-tests-from-csv-xlsx) - the column reference and every other supported format. +* [Running Tests Manually](https://docs.testomat.io/project/runs/running-tests-manually) - run the tests you just imported and record the results. +* [Labels and Custom Fields](https://docs.testomat.io/advanced/tags-labels/labels-and-custom-fields) - organize your imported tests by priority, type, or any Zephyr field. \ No newline at end of file diff --git a/src/content/docs/project/import-export/import/import-tests-from-testmo.md b/src/content/docs/project/import-export/import/import-tests-from-testmo.md index 50a90ece..1165cc5f 100644 --- a/src/content/docs/project/import-export/import/import-tests-from-testmo.md +++ b/src/content/docs/project/import-export/import/import-tests-from-testmo.md @@ -1,47 +1,74 @@ --- title: Import Tests From Testmo -description: Learn how to import tests from Testmo using two flexible methods - the built-in CSV import and a customizable migration script. This guide walks you through importing your test cases into Testomat.io, whether you’re using the native CSV feature for quick setup or the migration script for more advanced, tailored imports. Choose the method that best fits your workflow for a smooth transition from Testmo. +description: Import your Testmo test cases into Testomat.io two ways - upload the exported CSV directly, or run a migration script first when you need to reshape the file. This guide covers both. type: article url: https://docs.testomat.io/project/import-export/import-tests-from-testmo head: - tag: meta attrs: name: keywords - content: Testomat.io, CSV, Testmo, test import, Testmo migration, manual tests, automated tests, test management + content: Testomat.io, Testmo, test import, Testmo migration, CSV import, migration script, import from other TMS, manual tests, automated tests, test management --- -> If you have existing tests in Testmo and wish to migrate to Testomat.io, this guide will walk you through the process of importing your tests into Testomat.io. +Export your tests in Testmo as a CSV file and bring them into Testomat.io. There are two ways to do it. -Currently, Testomat.io supports two methods for importing tests from Testmo +| Method | Use it when | +| --- | --- | +| **CSV import** | Your Testmo export goes straight in | +| **Migration script** | You need to reshape the file first - rename columns or restructure your cases| -- Import via CSV -- Customizable migration script +## Export Testmo file -## How to Import Tests via CSV +1. Open your Testmo project. +2. Export your test cases to **CSV** file. +3. Save it on your computer. -1. Open your project in Testomat.io. -2. Click the **Imports** tab. -3. Click the **Import from CSV** button. +## Import your Testmo file -![image Import from CSV button](./images/import_fromcsv_button.png) +Start importing your tests to Testomat.io: -4. From the dropdown menu, choose **Testmo**. -5. Select the CSV file containing your exported Testmo tests. -6. Click the **Create** button to complete the import. +1. Open your project and go to the **Tests** tab. +2. Click the (`…`) menu. +3. Choose **Import from other TMS**. -![image Import from Testmo CSV](./images/testmo_csv.png) +![Tests tab with the extra menu](./images/att1_436.png) +In the **Imports** window: -## Convert Testmo Project Using the Migration Script +1. Click **Import**. +2. Choose **Import from CSV**. A sidebar opens on the right. +3. Choose **Testmo** from the dropdown. +4. Click **Choose file**, select your exported CSV. +5. Click **Create**. -Use the custom migration script to convert a Testmo CSV file into Testomat.io’s CSV format. -This method is recommended if you need customization or want to adjust the structure of your test cases during the migration process. +![image Import from Spreadsheet button](./images/att2_436_testmo.png) -Click [migration script instructions](https://github.com/testomatio/migrate-testmo) to access the script and get started. +Testomat.io reads the file, and your tests appear on the **Tests** page. +## Reshape with migration script +Use the custom migration script to convert a Testmo CSV file into Testomat.io’s CSV format. This method is recommended if you need customization or want to adjust the structure of your test cases during the migration process. +Click [migration script instructions](https://github.com/testomatio/migrate-testmo) to access the script and get started. +## Turn your tests into BDD scenarios +You can also import your BDD projects into Testomat.io. Follow the import steps in your BDD project. Every row of CSV file becomes a scenario: +- Precondition becomes **Given** +- Step becomes **When** +- Expected Result becomes **Then** +Your tests are saved as feature files. Leave the checkbox clear and they arrive as classic test cases instead. Full details are in [Import from CSV/XLSX](https://docs.testomat.io/project/import-export/import/import-tests-from-csv-xlsx). + +## If this doesn't work + +* **The import fails.** Check that the first row of your file holds column names. +* **Your folders are flat.** Make sure you picked **Testmo** in the dropdown, not another format. +* **Something is still off.** Contact [support](https://docs.testomat.io/support) with your file attached. + +## Next steps + +* [Import from CSV/XLSX](https://docs.testomat.io/project/import-export/import/import-tests-from-csv-xlsx) - the column reference and every other supported format. +* [Running Tests Manually](https://docs.testomat.io/project/runs/running-tests-manually) - run the tests you just imported and record the results. +* [Labels and Custom Fields](https://docs.testomat.io/advanced/tags-labels/labels-and-custom-fields) - organize your imported tests by priority, type, or any Testmo field.