How to Use QMPro Converter — Step-by-Step TutorialQMPro Converter is a tool designed to convert files created by QA/QC and test management systems into more portable, analyzable formats. Whether you’re migrating test artifacts, sharing reports with stakeholders, or preparing data for analysis, this step-by-step tutorial will walk you through installing QMPro Converter, preparing files, performing conversions, and troubleshooting common issues.
What QMPro Converter does (Quick overview)
QMPro Converter translates project files, test cases, test runs, and related artifacts from proprietary formats into standard formats like CSV, XML, JSON, and PDF. It supports batch conversions, maintains metadata, and offers options for filtering and mapping fields.
System requirements and installation
Recommended system requirements:
- Operating System: Windows 10 or later, macOS 10.14+, or Linux (Ubuntu 18.04+)
- CPU: Dual-core 2.5 GHz or better
- RAM: 4 GB minimum (8 GB recommended for large projects)
- Disk space: 200 MB for application; additional for converted files
- .NET runtime (Windows) or appropriate runtime for macOS/Linux (if packaged)
Installation steps:
- Download the appropriate installer for your OS from the official QMPro Converter website.
- On Windows, run the .exe and follow the installer prompts. On macOS, open the .dmg and drag the app to Applications. On Linux, extract the tarball and run the install script.
- Launch the application and complete any first-time setup prompts (license activation, default output folder).
Preparing your files for conversion
- Back up original project files.
- Ensure files are not corrupted — open them in the source application if possible.
- If converting from a test management system export, prefer raw export packages (ZIP/EXE) that include all artifacts.
- Decide on desired output formats (CSV for spreadsheets, JSON/XML for integrations, PDF for reports).
- If you need selective conversion, prepare a list of projects/test suites/cases to include.
Step-by-step conversion (GUI)
- Open QMPro Converter.
- Click “Add Files” or drag-and-drop your source files into the input area.
- Select one or multiple files; the app shows a preview of detected artifacts (projects, test cases, attachments).
- Choose output format from the dropdown (CSV, JSON, XML, PDF).
- Configure options:
- Field mapping: map proprietary fields to standard fields (e.g., “TC_Name” → “Title”).
- Filters: date range, test status (Passed/Failed), tags.
- Include attachments: toggle to extract embedded files.
- Choose output folder and naming convention (per project, combined).
- Click “Convert.” Progress is shown; large batches may take minutes to hours depending on size.
- When finished, open output folder to verify converted files.
Step-by-step conversion (Command-line)
QMPro Converter also provides a CLI for automation.
Example usage:
qmpro-converter convert --input /path/to/export.zip --format csv --output /path/to/output --filter-status failed --map TC_Name:Title Common flags:
- –input: source file or folder
- –format: csv | json | xml | pdf
- –output: destination folder
- –filter-status: passed | failed | blocked | all
- –map: field mapping pairs (repeatable)
Schedule automated conversions using cron (Linux/macOS) or Task Scheduler (Windows).
Field mapping and templates
- Use built-in templates for common mappings (e.g., “CSV for Jira import”).
- Create and save custom templates for repeated conversions.
- For complex mappings, use JSON mapping files:
{ "mappings": { "TC_ID": "ID", "TC_Name": "Title", "Steps": "Procedure", "Expected": "Expected Result" }, "defaults": { "Priority": "Medium" } }
Load with:
qmpro-converter convert --input export.zip --format csv --mapping /path/to/mapping.json Handling attachments and large files
- Enable “Include attachments” to extract embedded images, logs, and documents. Attachments are saved in a subfolder named after the test case or project.
- For very large archives, increase memory limits (GUI settings) or use the CLI with streaming options:
qmpro-converter convert --input large_export.zip --stream
Common problems & fixes
- Corrupt source file: re-export from the source application, or try the “Repair” option in QMPro Converter.
- Missing fields after conversion: confirm mappings and enable “Include all fields” if available.
- Slow performance: convert smaller batches, increase RAM, or use the CLI on a server.
- Permission errors writing output: choose an output folder with write permissions.
Verification and post-processing
- Open converted CSV/JSON/XML in your target tools (Excel, Jira import, custom scripts).
- Spot-check a sample of test cases and attachments.
- Use the built-in validator:
qmpro-converter validate --input /path/to/output --format csv - If needed, re-run conversion with adjusted mappings.
Tips & best practices
- Always keep backups of original files.
- Use templates for consistent exports.
- For integrations, prefer JSON/XML to preserve structure.
- Keep attachments in a separate archive if stakeholders only need test case metadata.
Alternatives and complementary tools
If QMPro Converter doesn’t meet a specific need, consider generic data converters, custom scripts using the source system’s API, or ETL tools like Pentaho or Talend for complex transformations.
If you want, I can tailor the tutorial to a specific OS, produce ready-to-run CLI scripts for automation, or create a mapping template for your source system — tell me which source format you’re converting from.
Leave a Reply