Taula de continguts

X-Ray és un plugin complementàri a Jira que facilita la gestió de proves associades a les Històries d’Usuari i altres tipus d’issues. A continuació, es mostren els passos bàsics per utilitzar X-Ray per a la creació, execució i gestió de proves.

Visualitzar X-RAY

Per veure les proves associades a una Història d’Usuari a Jira, cal habilitar l’opció “Test Coverage” al menú “Apps”. Aquesta opció es pot activar directament des de qualsevol Història d’Usuari.

  1. Accedeix a la Història d’Usuari desitjada.
  2. Activa “Test Coverage”. xray_view

Crear una prova manual

  1. A l’apartat “Test Coverage”, fes clic a “Add Test” i selecciona una de les següents opcions:

    • New test: Crear una nova prova.
    • Existing tests: Associar una prova existent.
    • Existing test sets: Associar un conjunt de proves. xray_add_test

  2. Després de seleccionar l’opció, fes clic a “Create” per crear la prova. xray_create_test

  3. Un cop creada, l’apartat “Test Coverage” s’actualitzarà amb la prova creada. Fes clic a l’enllaç per accedir-hi. xray_enter_test

Establir els pre-requisits

Els pre-requisits defineixen l’estat inicial necessari per executar una prova, com per exemple:

L’usuari ha de tenir conexió
L’usuari ha d’estar enregistrat i dins del seu compte

Passos per afegir un pre-requisit:

  1. A dins de la prova, ves a la pestanya “Preconditions” i selecciona “Add Preconditions”. xray_add_precondition

  2. Escull “New Precondition” per crear un nou conjunt de pre-requisits, o “Existing Preconditions” per reutilitzar pre-requisits existents. xray_add_precondition_2

  3. Omple el “Summary” amb el nom del conjunt de pre-requisits i fes clic a “Create”. xray_create_precondition

  4. L’apartat “Test Details” s’actualitzarà. Fes clic a l’enllaç del conjunt de pre-requisits per editar els detalls. xray_enter_precondition

  5. A la pestanya “Precondition details”, afegeix els pre-requisits manuals utilitzant el “Click to add a manual definition” i fes clic fora del quadre o al símbol de “✓” per desar-los. xray_write_precondition xray_save_precondition

Afegir passos a una prova manual

Cada pas dins d’una prova es denomina “Step”. Els passos es poden escriure seguint el format Gherkin o de forma manual.

Exemple de pasos:

El usuari accedeix a la pàgina d’un punt d’interès i ha passat una hora desde la finalització de la seva visita.
Ha de poder emplenar una ressenya i seleccionar entre 5 estrelles de puntuació
Quan prem el botó de enviar, el comentari s’ha de sumar al llistat I la puntuació s’ha d’afegir al promig calculat per el punt d’interès.

Passos per afegir un pas a una prova:

  1. A la secció “Test Details” de la prova, selecciona “Add Step” i després “New”. xray_add_step

  2. Omple els següents camps:

    • Action: L’acció que l’usuari ha de realitzar.
    • Data: Dades rellevants per al test (per exemple, un enllaç o conjunt de dades).
    • Expected Result: El resultat esperat.
    • Attachments: Arxius adjunts, si escau.

    Fes clic a “Create” per desar el pas. xray_write_step

  3. Per afegir més passos, fes clic a “New Step”. xray_new_step_1 xray_new_step_2

Executar una prova manual

  1. Per executar una prova, ves a la Història d’Usuari i a l’apartat “Test Coverage”, selecciona “with Test Execution”. xray_execute_test

  2. S’obrirà una finestra on podràs emplenar els següents camps abans de crear l’execució:

    • Summary : Nom de l’execució (obligatori).
    • Fix Version/s : Versió (opcional).
    • Test environment : Entorn de proves (opcional).
    • Revision : Revisió (opcional). Fes clic a “Create” per generar l’execució de la prova xray_execution_create

  3. Un cop creada, es generarà una “Test Execution” com a tipus d’issue. Fes clic a *“▶” per començar l’execució del test. xray_execution_enter

  4. A la pantalla de Test Execution , es mostraran els següents camps:

    • Execution Status: Estat de la prova (pot canviar-se amb un clic).
    • Timer: Temporitzador per comptar el temps de l’execució.
    • Started On i Finished On: Dates d’inici i fi (l’última no és editable).
    • Assignee: Persona assignada per gestionar la prova.
    • Executed By: Persona que executa la prova (assignat automàticament)
    • Versions: Mostra la versió establerta en crear l’execució (assignat automàticament).
    • Revision: Informació de la revisió en el moment de la creació (assignat automàticament).
    • Test version: Versió de la prova (assignat automàticament).
    • Test Environment: Entorn de la prova (assignat automàticament). xray_execution_panel_1

  5. Apartat “Findings”

    • Defects: Defectes creats a partir de l’execució.
    • Evidence: Captures de pantalla o evidències associades.
    • Comment: Comentaris afegits durant l’execució. xray_execution_panel_2

  6. Apartat “Test details”

    • Test Description: Descripció heretada del test.
    • Test Issue Links: Enllaç a la prova original.
    • Preconditions: Pre-requisits associats a la prova.
    • Steps: Llistat dels passos de la prova. xray_execution_details

  7. Cada pas conté:

    • Actual Result: Permet registrar el resultat real del pas.
    • Comment: Afegir comentaris addicionals.
    • Defects: Crear defectes i associar-los a aquest pas.
    • Evidence: Afegir captures o altra evidència.
    • Step State: Canviar l’estat del pas amb els colors disponibles xray_execution_panel_3

  8. Quan es canvia l’estat d’un Step State, l’estat global de l’execució s’actualitza automàticament.

  9. Un cop completada l’execució, a la Història d’Usuari es podrà veure un resum de les execucions realitzades. xray_execution_panel_4

Informes i Quadres de comandament X-RAY

X-Ray permet generar informes personalitzats des de l’opció “Testing Board” al menú esquerre del projecte. Entre les opcions disponibles, es pot triar “Test Coverage” per generar informes detallats sobre la cobertura de proves. xray_informe_1

Per generar un informe:

  1. Selecciona Analysis & Scope per definir els límits, com la versió, entorns de proves, etc.
  2. Usa Group By per agrupar les dades, si escau.
  3. View: Tipus de vista jeràrquica o plana
  4. Aplica Filters per afegir filtres personalitzats.

xray_informe_2

Els informes es poden exportar i compartir utilitzant l’opció “Share”. xray_informe_3

Com visualitzar l’estat de les proves en un informe:

Un cop generat l’informe des de “Testing Board”, veuràs un quadre de comandament amb diferents colors.

  • Fes clic a cada color per veure el detall de les proves en aquell estat.
    • Verd → Proves superades amb èxit.
    • Groc → Proves en progrés.
    • Vermell → Proves fallides.
    • Blau → Proves que no és poden realitzar
    • Blanc → Proves pendents d’executar.

xray_informe_4

Documentació més extensa

  • Guia d’usuari - Xray