Taula de continguts

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
Sí Sí Sí Sí Sí No

Aquesta pàgina es una guia de com fer el procés de migració d’un espai de ValueEdge cap a Jira de forma manual. Entrarem en detall en els passos i les seves limitacions.

1. Exportació d’entitats a ValueEdge

1.1. Exportar Requeriments

  1. Anem a la pàgina on es troben totes les nostres entitats. Per exemple, Requeriment Document que es troba en Requirements. migracio_requeriments
  2. Seleccionem el nivell més alt de carpetes “Requirements” perque apareguin tots. migracio_requeriments_2
  3. Al menú dret superior trobem una icona amb tres rectangles que ens permeten seleccionar quins camps s’exportaràn migracio_requeriments_3
  4. Els camps a seleccionar per exportar Requeriments són:
  • Name
  • Description
  • Tipus de requeriment
  • Functional Complexity
  • Failure Probability
  • Risc
  • Business Criticality
  • Prioritat
  • Valoració Final
  • Codi Requisit
  • Codi Petició Origen
  • Parent:Subtype
  1. Escollim la icona “CSV” per exportar i guardem l’arxiu migracio_requeriments_4

6.Es descarregarà un arxiu Excel que després haurem de carregar en Jira.

1.2. Exportar històries d’usuari, feature i defectes

  1. Anem a la pàgina on es troben totes les nostres entitats. Es troben a Backlog migracio_backlog
  2. Seleccionem el nivell més alt de carpetes “Backlog” perque apareguin totes i ens assegurem de que la pestanya seleccionada sigui “Backlog Items” migracio_backlog_2
  3. Al menú dret superior trobem una icona amb tres rectangles que ens permeten seleccionar quins camps s’exportaran migracio_backlog_3
  4. Els camps a seleccionar són:
Feature Històries d’Usuari Defectes
  • Name
  • Description
  • Epic:Type
  • Name
  • Description
  • Linia estratègica
  • Priority
  • Story Points
  • Type
  • Name
  • Description
  • Motiu
  • Es UAT
  • Nivell de prova
  • Característica de qualitat
  • Tipus Incidència
  • Codi incidència origen
  • Reproducible
  • Priority
  • Severity
  • Type

  1. Filtrem per el tipus d’entitat que es, a la icona del embut posem Where Type is [Entitat]” on [Entitat] ha de ser el tipus que volem : Defect / User Story / Feature “ migracio_backlog_4

  2. Seleccionem la icona “CSV” per exportar i guardar migracio_backlog_5

  3. S’obrirà una finestra on ens pregunten el propòsit de l’exportació i seleccionarem “Import” i “Create New” migracio_backlog_6

1.3. Exportar Proves

  1. Anem a la pàgina on es troben totes les nostres entitats. Les proves es troben a Backlog migracio_proves
  2. Seleccionem el nivell més alt de carpetes “Backlog” perque apareguin totes i ens assegurem de que la pestanya seleccionada sigui “Tests” migracio_proves_2
  3. Al menú dret superior trobem una icona amb tres rectangles que ens permeten seleccionar quins camps s’exportaran migracio_proves_3

  4. Els camps a seleccionar són:

    • Name
    • Description

  5. Filtrem per el tipus d’entitat que es, a la icona de l’embut posem

“Where Type is (Entitat)” on (Entitat) ha de ser el tipus que volem : Manual Test“

( De moment, treballarem només amb proves manuals ) migracio_proves_4 6. Seleccionem la icona amb “CSV” per exportar i guardar migracio_proves_5 7. S’obrirà una finestra on ens pregunten el propòsit de l’exportació i seleccionarem “Import” , “Create New” i “Steps” migracio_proves_6

2. Importació d’entitats a JIRA

2.1. Importar Requeriments, Defectes, Històries d’Usuari i Features

  1. Al menú superior de pestanyes del projecte, anem a l’apartat “All work” import_issue_tab
  2. A l’opció de tres punts a dalt a la dreta , despleguem i trobem “Import Issues from CSV” import_find
  3. Seleccionarem el nostre arxiu de Requeriments i farem click a “Next” import_requeriments_4

  4. Emplenem els camps:

    • Import to project: Projecte on s’ha d’importar
    • File encoding: Deixem el que ja està seleccionat
    • Delimiter: Deixem el que ja està seleccionat
    • Date format: Deixem el que ja està seleccionat

  5. Fem el següent mapatge dels camps:

Requirement Document / Requeriment Document Defect / Defecte User Story / Història d’Usuari Feature
  • Business Criticality → Business Criticality (Marcar “Map field value”)
  • Codi Petició Origen → Codi petició origen
  • Codi Requisit → Codi requisit
  • Description → Description
  • Failure Probability → Failure Probability (Marcar “Map field value”)
  • Functional Complexity → Functional Complexity (Marcar “Map field value”)
  • ID → Don’t map this field
  • Name → Summary
  • Prioritat → Priority (Marcar “Map field value”)
  • Risc → Risc (Marcar “Map field value”)
  • Tipus de Requeriment → Tipus de requeriment
  • Valoració Final → Valoració Final
  • Característica de Qualitat → Característica de Qualitat (Marcar “Map field value”)
  • Codi Incidència Origen → Codi Incidència Origen
  • Description → Description
  • Es UAT → Es UAT (Marcar “Map field value”)
  • ID → Don’t map this field
  • Motiu → Motiu
  • Name → Summary
  • Nivell prova → Nivell prova (Marcar “Map field value”)
  • Priority → Priority (Marcar “Map field value”)
  • Reproducible → Reproducible (Marcar “Map field value”)
  • Severity → Severity (Marcar “Map field value”)
  • Tipus incidència → Tipus incidència (Marcar “Map field value”)
  • Type → Issue Type (Marcar “Map field value”)
  • Description → Description
  • ID → Don’t map this field
  • Línia estratègica → Línia estratègica (Marcar “Map field value”)
  • Name → Summary
  • Priority → Priority (Marcar “Map field value”)
  • Story Points → Story Points
  • Type → Issue Type (Marcar “Map field value”)
  • Description → Description
  • Epic:Type → Epic:Type (Marcar “Map field value”)
  • ID → Don’t map this field
  • Name → Summary

Requirement Document / Requeriment Document

import_requeriments_5 Defect / Defecte

import_requeriments_6 User Story / Història d’Usuari

import_requeriments_7 Feature

import_requeriments_8 6. En la pantalla de mapatge específic , en aquest cas per la prioritat , escollim a les opcions de la columna “Target value in JIRA” allò que sigui idèntic (espais inclosos) en “Value from importer”. En el cas de que no existeixi escollim el més similar , finalment si no hi ha res similar escollim “Map as is”. Podrem escollir si validem la importació ens informarà de si hi hauran possibles errors, o bé comencem directament a importar.

Requirement Document / Requeriment Document

import_requeriments_9 Defect / Defecte

import_requeriments_10 User Story / Història d’Usuari

import_requeriments_11 Feature

import_requeriments_12

2.2. Importar Proves en Xray

Seguiu l’apartat de preparació de CSV per ValueEdge desde el manual d’importació de proves a Xray

3. Possibles errors i preguntes freqüents

Error : Jira no llegeix caràcters especials

migracio_errors Solució Jira no llegeix caràcters especials : Assegureu-vos de que l’arxiu que pujeu es guarda CSV UTF-8. En aquest cas CSV és incorrecte, hauria de ser CSV UTF-8

migracio_errors_2 Error: Jira no separa correctament les columnes del Excel / CSV

migracio_errors_3 Solució Jira no separa correctament les columnes del Excel / CSV : Proveu canviar al delimitador de “,” a “;” i viceversa

migracio_errors_4 Error: Jira detecta errors en el procés de validació

migracio_errors_5 Solució Jira detecta errors en el procés de validació: Es disposa del log dels errors. Alguns errors poden ser: 1.NULL : Aquest error sorgeix quan es fa un mapatge al valor d’un camp que no existeix a Jira

  • Treure o posar accents
  • Treure o posar “s” al final
  • En els desplegables assegureu-vos de que hi hagin espais entre números i guions (com per exemple, enlloc de 3-High escolliu 3 - High )
  • Treure cometes en paraules que apareixen entre cometes, com per exemple ‘1-Bloquejant’ a 1-Bloquejant
  • Canvieu guions per punts per el camp “Línia estratègica” en les històries d’usuari. Per exemple enlloc de “10-Interoperabilitat” poseu “10. Interoperabilitat”
  • Vigilar els apòstrof, copieu i enganxeu aquest: ‘ . Per exemple “Defecte d’aplicació” a “Defecte d’aplicació”

migracio_errors_6 Error: Al fer el mapatge de Issue Type no trobo el tipus de issue

Solució al fer el mapatge de Issue Type no trobo el tipus de issue: és possible que el teu projecte no sigui el tipus de plantilla d’aquest issue type.

  • Històries d’Usuari / Feature: Només existeixen en projectes Agile
  • Requeriment document / Defecte : Només existeixen en projectes Waterfall ( per defecte existeix Bug)

4. Manuals d’interès / properes passes

Aquests manuals son relevants per la preparació del entorn un cop les dades es troben importades

5. Limitacions en la migració manual

  1. Les relacions entre les diferents entitats es fan manualment a Jira:

    • Requeriments a components (carpetes)
    • Històries d’Usuari a Èpiques
    • Qualsevol entitat a Release o Sprint
    • Qualsevol prova a qualsevol altra entitat

  2. No es recomana migrar les entitats Release , Epic ja que la seva gestió es diferent a Jira

  3. La migració manual no ha de ser perfecta i tots els detalls es poden corretgir manualment després

  4. No es poden extreure de ValueEdge més de 20 mil elements a la vegada

  5. El manual només cobreix la pujada CSV de proves manuals

6. Enllaços d’interès