This guide walks end-users — QA analysts who just need to document and export test results — through downloading and running the pre-built Valoraclick QA Tool executable. There is no Python to install, no dependencies to manage, and no configuration required before your first launch. From download to your first exported PDF takes under two minutes.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Beliagal/qa-report-automation/llms.txt
Use this file to discover all available pages before exploring further.
Generate Your First Report
Download the Executable
Go to the Latest Release page on GitHub and download
QA_Tool_v2.7.exe. Save it anywhere on your Windows machine — your Desktop or Downloads folder works fine. No installer or setup wizard is involved.Launch the Application
Double-click
QA_Tool_v2.7.exe to open the tool. The application will launch in a maximized window titled QA Tool v1.0.0 Secure. Windows Defender SmartScreen may show a prompt on first run — click More info → Run anyway to proceed. No administrator privileges are required.Fill in the Report Metadata
Complete the fields in the top metadata grid before adding any test steps. These values appear in the header of your final PDF report:
The Fecha field enforces a
| Field | What to Enter |
|---|---|
| Aplicación | The name of the application under test |
| Tester | Your name or tester identifier |
| Fecha | Test date in DD/MM/YYYY format (pre-filled with today’s date) |
| Historia de Usuario | The user story or ticket reference being tested |
| Requisitos | Requirement IDs or acceptance criteria references |
| Versión | The build or version number under test |
| Dependencias | Any external systems or services the test depends on |
| Resumen Ejecutivo | A short executive summary describing the scope and outcome of the test session |
DD/MM/YYYY format — only digits and forward-slashes are accepted, and a date format warning is shown at export time if the value does not match.Log Your Test Steps
Use the step entry form below the metadata grid to record each test action:
- Acción — Type what action you are performing (e.g., “Click the Login button with valid credentials”).
- Esperado — Describe the expected result.
- Obtenido — Describe the actual result observed.
- 📸 Imagen — Optionally click the image button to attach a PNG or JPEG screenshot. The button changes to ✅ Imagen Ok when a file is selected.
- Pass / Fail — Use the dropdown to set the step verdict.
- Click AÑADIR PASO to commit the step.
Export the PDF and Back Up to Google Drive
When all steps are logged, click the EXPORTAR PDF button in the top-right toolbar. A save dialog will appear — choose a filename and location for your PDF. Once you confirm:
- The PDF report is generated with all metadata, step details, Pass/Fail color coding, and embedded screenshots.
- A CSV backup of the session data is automatically written to your Google Drive sync folder via your Windows shortcut — no extra action needed.
Session data is saved automatically to
sesion_testing.json in the same folder as the executable every time you add a test step. If the application closes unexpectedly — or you simply close it mid-session — all your metadata, step log, and image paths will be fully restored the next time you launch the tool. Your work is never lost.Next Steps
Fill in Report Metadata
Learn how each metadata field maps to sections of the final PDF report and how to structure your entries for consistent, professional output.
Log Test Steps
Discover best practices for writing clear Action, Expected, and Obtained entries, attaching screenshot evidence, and managing multi-step test cases.