Taula de continguts

X-ray es una eina complementària instal·lada a Jira que ens permet gestionar tota la part de proves, en aquesta pàgina trobareu alguns guies bàsiques sobre aquesta eina.

Visualitzar X-RAY

Per poder veure les proves associades a una Història d’Usuari a Jira haurem d’assegurar-nos de que tenim habilitat “Test Coverage” al apartat “Apps”, es pot habilitar desde qualsevol Història d’Usuari : xray_view

Crear una prova manual

1.En l’apartat Test Coverage escollim l’opció “Add Test”:

  • New test : Permet crear una nova prova
  • Existing tests : Permet associar a aquesta Història d’Usuari una prova existent
  • Existing test sets : Permet associar a aquesta Història d’Usuari un conjunt de proves ( Test Set )
  • xray_add_test

    2.En aquesta finestra no cal editar res, només escollim “Create” xray_create_test

    3.L’apartat “Test Coverage” s’actualitzarà amb la prova, per entrar en aquesta fem click al seu enllaç. xray_enter_test

    Establir els pre-requisits

    Un pre-requisit es l’estat inicial en el que l’usuari que fa la prova s’ha de trobar. Com per exemple:

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

    1.Per establir un pre-requisit, a dins de la nostra prova ( reviseu com entrar al pas 3 de l’apartat anterior ) , escollim la pestanya “Preconditions” xray_add_precondition

    2.Un cop a “Precondition”s escollim “Add Preconditions” i “New Precondition” . Es poden reutilitzar precondicions ja existents en altres test amb “Existing preconditions”. xray_add_precondition_2

    3.En aquesta pantalla posem el nom del nostre conjunt de pre-requisits en “Summary” i fem click a “Create” xray_create_precondition

    4.L’apartat “Test Details” s’actualitzarà amb el conjunt de pre-requisits, per entrar fem click al seu enllaç. xray_enter_precondition

    5.En l’apartat “Precondition details” fem click a “Click to add a manual definition” i escribim els nostres pre-requisits, per desar-ho clickem fora del quadre de text o al ✓ xray_write_precondition xray_save_precondition

    Afegir passos a una prova manual

    En X-RAY un pas en una prova s’anomena “Step” . Un pas representa un punt que l’usuari que fa la prova ha d’acomplir. Aquest serien un conjunt de passos d’exemple, que poden estar escrits amb Gherkin: Quan es troba 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

    1.Per afegir un pas ens hem de trobar a dins de la nostra prova ( reviseu com entrar al pas 3 “Crear prova manual” ) . En “Test Details” escollim “Add Step” i “New” xray_add_step

    2.Emplenem els continguts del pas i guardem amb “Create”.

  • Action : Acció que l’usuari ha de fer
  • Data : Dades relevants sobre el test, com per exemple un enllaç a la pàgina o un conjunt de dades a introduïr
  • Expected Result : El resultat esperat
  • Attachments : Podem afegir arxius adjunts
  • xray_write_step

    3.Per afegir més passos fem click a “New Step” xray_new_step_1 xray_new_step_2

    Executar una prova manual

    1.Per executar una prova haurem d’anar a la nostra Història d’Usuari i a l’apartat “Test Coverage” i escollir “with Test Execution” xray_execute_test

    2.S’obrirà una finestra amb un formulari i després d’emplenar fem click a “Create”

  • Summary: Obligatori, nom de l’execució
  • Fix Version/s : Opcional, release a la que pertany l’execució
  • Test environment : Opcional, entorn de proves
  • Revision : Opciona, revisió
  • xray_execution_create

    3.S’obrirà un tipus de issue “Test Execution”. En l’apartat “Tests” veurem el llistat d’execucions i farem click a “▶“ xray_execution_enter

    4.Una petita introducció a la pantalla de la prova. En el primer bloc trobem la informació relevant sobre la prova:

  • Execution Status : Estatus de la prova, podem fer click als colors per canviar-lo
  • Timer : Un temporitzador per comptar el temps que es triga en completar la prova, al moment de selccionar el color groc a “Execution Status” comença
  • Started On : Deixa establir la data d’inici de la prova
  • Finished On: No editable, guardarà la data i hora de fi
  • Assignee : Persona assignada , el camp permet guardar una persona que pot ser l’encarregat de gestionar la prova
  • Executed By : Persona executant la prova, no assignable, X-RAY assigna automàticament a la persona que ho executa
  • Versions : No editable, versió establerta al moment de crear la execució
  • Revision : No editable, informació de la revisió establerta al moment de crear la execució
  • Test version : No editable, versió de la prova
  • Test Environment : No editable, entorn de la execució establert al crear-la
  • xray_execution_panel_1

    5.El desplegable “Findings” conté:

  • Defects : Defectes creats a partir d’aquesta execució.
  • Evidence : En cas de que hi hagi, captures o evidències
  • Comment : Comentaris
  • xray_execution_panel_2

    6.En la pestanya Test details:

  • Test Description : Descripció heredada del test, no cal emplenar res.
  • Test Issue Links: Enllaç a la prova
  • Preconditions : Pre-requisits si té
  • Steps: Passos
  • xray_execution_details

    7.Executar els passos, a cada pas trobem :

  • Actual Result: En fer click ens permet escriure com ha resultat
  • Comment : Caixa de comentaris adicional
  • Defects : Permet crear un defecte i associar-ho a aquest pas. Els defectes son un tipus de issue que té el seu propi ticket.
  • Evidence : Si cal, evidència
  • Step State : Estat del pas, es pot canviar amb els colors
  • xray_execution_panel_3

    8.En fer click al canvis de Step State l’estat de l’execució s’actualitza automàticament. A la Història d’Usuari podem veure el resum de les execucions: xray_execution_panel_4

    Informes i Quadres de comandament X-RAY

    X-RAY ens permet crear informes desde l’opció “Testing Board” al menú esquerre del projecte. Hi ha un llistat d’opcions d’informes del que podem escollir per exemple “Test Coverage” , que es la cobertura xray_informe_1

    Per generar l’informe escollim :

  • Analysis & Scope : Permet escollir límits com la versió, plans inclosos, o entorn de proves
  • Group By: Definir agrupacions de les dades dels informes si cal
  • View: Tipus de vista jeràrquica o plana
  • Filters: Filtres adicionals de Jira, permet per exemple, incloure més d’un projecte
  • xray_informe_2

    Podem exportar els nostres informes en “Share” xray_informe_3

    En generar l’informe també es possible veure l’estat de les proves si fem click als colors del quadre de comandament generat: xray_informe_4

    Documentació més extensa

  • Guia d’usuari - Xray