Guia d’Ús del Testing Board de X-RAY a Jira
Rols amb permisos que poden fer ús de la guia explicativa: Qui pot fer ús de la guia?
| Administrador | Project Leader | Responsable de qualitat | Desenvolupadors | Usuaris | Lectors |
|---|---|---|---|---|---|
| Executar test, Crear , Editar i esborrar tots els tipus de issue | Executar test, Crear , Editar i esborrar tots els tipus de issue | Executar test, Crear , Editar i esborrar tots els tipus de issue | Executar test, Crear , Editar i esborrar tots els tipus de issue | Executar test | Només visibilitat |
1.🧾Què és el testing board de X-RAY?
El Testing Board és un panell integrat dins de Jira/Xray que proporciona una visió centralitzada de l’estat de les activitats en l’apartat de test. És especialment útil per fer seguiment del progrés, la cobertura dels requisits, i l’execució de proves.
2.🔍Identificacio issue type X-RAY
Informació important per entendre com funcionen les fases i com s’identifquen els issues types dels tests en el Testing Board.
Planificació: S’utilitzen issues de tipus [Test Plan] per estructurar i coordinar les activitats de prova, associades a una release o sprint.
Fase de disseny: En aquesta etapa es creen issues de tipus [Pre-Condition] i [Test] per definir els escenaris de prova. Aquests es poden organitzar mitjançant [Test Sets] o a través de l’estructura del Test Repository (explicat més endavant a l’apartat 4.2 🗂️ Test Repository (Repositori de Tests)).
Execució: Per a la realització de les proves, s’utilitzen issues de tipus Test Execution i Sub-Test Execution.
Com a bona pràctica, és recomanable associar cada Test Execution a un Test Plan, per tal de facilitar el seguiment i l’anàlisi global del progrés, ja que els Test Plan ajuda a agrupar Test Sets en la mateixa execució.
Gestió de defectes: Els defectes detectats es gestionen amb issues de tipus Bug o Defecte segons el tipus de model de desenvolupament. Aquest s’han de vincular amb la Test Execution ja que així es conserva la traçabilitat.
Fase d’informes: Per a l’anàlisi i el seguiment, s’utilitzen els issues de Test Execution, els informes integrats de cobertura de requisits, així com els gadgets disponibles a Jira.
3.🔐Com accedir-hi Testing Board?
Opció A:
- Entra a Jira
- Ves al projecte corresponent
- Al menú lateral, a l’apartat d’aplicacions seleccióna > Testing Board > Icona ☰ ️
Opció B:
- Entra a Jira
- Ves al projecte corresponent
- Al menú superior, selecciona More > Apps > Xray > Testing Board > Icona ☰ ️
4.🧩Components del Testing Board
4.1 Gestió X-RAY
4.1.1 💡 Getting Started
És la secció introductòria utilitzada com a punt de partida per entendre les funcionalitats principals del Testing Board.
Ofereix enllaços ràpids a la documentació oficial i guia els usuaris nous pels conceptes bàsics de testing amb Xray.
4.1.2 🗂️ Test Repository
És el repositori de tests. En aquest apartat es gestionen tots els tests creats dins del projecte.
- Des d’aqui pots crear el test cases i directoris.
- Permet accedir ràpidament a l’edició de qualsevol test.
- Pots visualitzar, cercar i filtrar els test cases fàcilment.
- Els tests es poden organitzar per carpetes o etiquetes, facilitant-ne la classificació.
Aquest repositori s’estructura en dos blocs principals:
📁 Folders: És l’espai on es poden organitzar tots els tests del projecte en carpetes, segons mòdul, funcionalitat, equip, etc. Això facilita la navegació i el manteniment dels casos de prova.
👉 Es recomana seguir una estructura de carpetes coherent, basada en la proposta de lliurables tècnics (ANNEX B), seguint el model utilitzat a Value Edge. Consulta la proposta aquí: ANNEX B – Nomenclatura i estructura dels lliurables de proves
Exemples d’organització:
Requisits Funcionals: Organitzats per mòduls (ex.: Gestió d’Usuaris, Revisions).
Requisits No Funcionals: Dividits segons característiques de qualitat (ex.: Rendiment, Usabilitat), excloent ‘Funcionalitat’.
Des de l’apartat específic de folders pots fer el següent:
Crear carpetes: Pots crear estructures jeràrquiques (subcarpetes) per organitzar els tests per mòdul, sprint, funcionalitat, etc.
Moure tests entre carpetes: Arrossega i deixa anar (drag & drop) per reorganitzar els tests fàcilment dins del directori.
Filtrar i cercar: Busca test cases dins de carpetes concretes per nom, tipus, estat o paraules clau.
Crear nous tests: És possible crear test cases directament dins d’una carpeta específica perquè quedin classificats automàticament.
Tenir ordenat els casos de proves permet reutilitzar el màxim possible aquests casos, i poder accedir-hi més ràpidament.
🧪 Test Sets (Grupos de tests): És l’espai on es poden crear i consultar els Test Sets, agrupacions de tests que poden ser reutilitzades en diferents execucions o plans de testing.
Funcionalitats:
- Crear Test Sets per agrupar tests segons criteris com la funcionalitat, criticitat o fase del projecte.
- Consultar i editar Test Sets ja existents.
- Reutilitzar Test Sets (grups de tests) en execucions o plans, mantenint coherència en l’estratègia de testing.
Informació addicional on podreu entendre l’organització de Tests a XRAY: Guia per a l’Organització de Tests a XRAY
4.1.3🧩 BDD Step Library
Aquesta secció conté la llibreria de passos Gherkin (Given/When/Then) utilitzats en els tests de tipus Cucumber o BDD (Behavior Driven Development).
- Permet reutilitzar passos BDD entre diferents tests
- Ajuda a mantenir coherència i estandardització.
- Pots editar, eliminar o crear nous passos fàcilment.
📌 Exemple d’ús pràctic: Vols crear un test de login? Cerca si existeix el pas “Given the user is on the login page” i reutilitza’l.
4.1.4 🗓️ Test Plans
Des d’’aqui pots gestiona els plans de test per funcionalitat, sprint o release.
- Agrupa múltiples test executions sota un mateix pla.
- Permet fer seguiment global del testing d’una entrega.
- Molt útil per a equips que treballen en iteracions o versions.
📌 Exemple d’ús pràctic: Pots crear un “Pla de Testing Sprint 5” i afegir-hi totes les execucions previstes per aquell sprint.
4.1.5 ▶️ Test Executions
Mostra totes les execucions de test fetes o planificades.
- Permet veure resultats, estat (PASS/FAIL), responsable, i data d’execució.
- Es poden editar els resultats manualment o sincronitzar-los amb eines externes (com Jenkins).
📌 Exemple d’ús pràctic: Vols veure què va fallar ahir? Filtra les execucions per data i revisa el detall dels resultats.
4.2 📈 Fase d’informes (Reports)
⚠️ Els següents elements de l’apartat Reports: Test Coverage, Traceability, Test Plans Metrics, Test List, Test Sets List, Test Plans List, Test Executions List i Test Runs List
requereixen que t’asseguris que tens aplicat el filtre del projecte desitjat, ja que des d’aquest mateix apartat pots consultar informació d’altres projectes que tinguis disponibles.
4.2.1 📈 Test Coverage
Aquest informe mostra quines entitats (com ara històries d’usuari, requisits, defectes, etc.) estan cobertes per proves.
Funcionalitats:
- Permet filtrar per Last Test Environment, Version o Test Plan.
- Mostra visualment el grau de cobertura de requisits o històries d’usuari.
- Identifica els elements que no tenen cap test associat.
- Ajuda a detectar àrees crítiques sense cobertura.
📌 Exemple d’ús pràctic: Vols assegurar-te que totes les User Stories del Sprint 12 tenen com a mínim un test associat? Aquest informe t’ho mostra de manera visual i clara.
4.2.2 🔗 Traceability
Aquest informe mostra la traçabilitat bidireccional entre requisits, tests, execucions i defectes.
Funcionalitats:
- Comprova si els requisits tenen tests vinculats.
- Rastreja què s’ha testejat, com i amb quin resultat.
- Ajuda a complir amb estàndards de qualitat i auditories.
📌Exemple d’ús: Vols veure si la incidència DEMOAGILE-381 està coberta per algun test fallit recent? Aquí ho pots consultar.
4.2.3 📊 Test Plans Metrics
Proporciona mètriques mes completes i detallades sobre l’execució dels Test Plans.
Funcionalitats:
- Percentatges de tests passats, fallats, pendents o en execució.
- Evolució temporal del progrés del pla.
- Possibilitat d’aplicar filtres per components, versions o etiquetes.
📌 Exemple d’ús: Estàs en el darrer dia de l’sprint i vols saber quants tests del Test Plan del Sprint 10 encara estan pendents? Aquest informe t’ho mostra al moment.
4.2.4 🧪 Tests List
Mostra un llistat de tots els test cases del projecte.
- Permet aplicar filtres per estat, prioritat, tipus de test, component, etc.
- Pots ordenar les columnes i personalitzar les dades visibles (accedint a la dreta, a “columns”)
- Accés ràpid a l’edició de cada test.
- Ideal per obtenir una visió global de la base de tests.
📌 Exemple: Vols veure tots els tests del projecte que han fallat? Filtra per etiqueta i estat.
4.2.5 🧪 Tests Sets List
- Mostra tots els Test Sets creats en el projecte.
- Visualitza la quantitat de tests que inclou cada Test Set.
- Pots veure quan es va crear o modificar, i per qui.
- Pots ordenar les columnes i personalitzar les dades visibles (accedint a la dreta, a “columns”)
📌 Exemple d’us: Consulta el status del Test Set “Test Set – US 003: Canviar contrasenya”
4.2.6 🗂️ Test Plans List
Llista tots els Test Plans amb una visualització més breu, a més:
- Pots visualitzar l’estat general del pla (percentatge de passats, fallits…).
- Ordenar les columnes i personalitzar les dades visibles (accedint a la dreta, a “columns”)
- Consulta ràpidament les execucions associades
- Ideal per seguiment de sprints o entregues.
📌 Exemple: Vols saber com va el progrés el Test Plan de la versió V4.3? Accedeix aquí i consulta l’evolució.
4.2.7 ▶️ Test Executions List
Mostra totes les execucions de tests realitzades
- Permet accedir al detall de cada test run executat.
- Informa sobre la data d’inici i de finalització, l’estat i el resultat de cada execució.
- Útil per revisar execucions antigues o en curs.
- Es poden ordenar les columnes i personalitzar les dades visibles (accedint a la dreta, a “columns”).
📌 Exemple: Comprova quines execucions han fallat en l’última semana.
4.2.8🧾 Test Runs List
Llista tots els Test Runs individuals (cada instància d’un test executat)
- Permet veure el resultat de cada test concret dins d’una execució.
- Pots revisar evidències, comentaris i defectes associats.
- Ideal per fer anàlisi detallada d’errors o regressions.
- Es poden ordenar les columnes i personalitzar les dades visibles (accedint a la dreta, a “columns”).
📌 Exemple: Accedeix als detalls del run d’un test fallit per veure la captura de pantalla i el log de l’error.
4.3.⚙️Altres Utilitats del Testing Board
4.3.1 🔧 Configure Project
Accés a la configuració del projecte Xray: permet definir paràmetres generals com tipus de test, workflows, i permisos específics.
4.3.2 ☁️ Test Case Importer
Eina per importar casos de prova des de fitxers CSV o Excel, útil per migracions o càrregues massives.
Guia d’ús de l’importació de proves en Xray: Importació de proves en Xray
4.3.3 📄 Documentation
Enllaç directe a la documentació oficial de Xray, amb guies, exemples i detalls tècnics actualitzats.
4.4.4🎓 Xray Academy
Accés a la plataforma de formació online oficial de Xray: cursos, tutorials i vídeos explicatius per millorar el coneixement funcional de l’eina.
🔗Més informació