GUÍA PARA LA TRAZABILIDAD DE REQUISITOS EN EL VISUAL PARADIGM 8.0

GUÍA PARA LA TRAZABILIDAD DE REQUISITOS EN EL VISUAL PARADIGM 8.0 Daileny Caridad Arias Pupo 1*, Ing. Tamara Rodríguez Sánchez 2, Ing. Efraín García Díaz 3 Facultad 3, Universidad de las Ciencias Informáticas, Carretera a San Antonio de los Baños, km 2 ½, Boyeros, Ciudad de La Habana, Cuba. *Autor para la correspondencia: dcarias@uci.cu RESUMEN La trazabilidad de requisitos de software es un proceso clave para su exitosa gestión en el desarrollo de un sistema. Hoy en día existen un conjunto de herramientas para la realización de la trazabilidad de requisitos entre las que se encuentra el OSRMT 1. Los proyectos del Centro de Informatización de la Gestión de Entidades utilizan el Visual Paradigm como herramienta para el modelado, luego que se modela se pasa la información para la herramienta OSRMT donde se realiza la trazabilidad de requisitos de software. Esto significa que hoy se utilizan dos herramientas, una para el modelado y otra para la gestión de requisitos. El objetivo del trabajo es la realización de una guía que explique cómo realizar la trazabilidad de requisitos en el Visual Paradigm 8.0, de forma tal que los proyectos cuenten con una única herramienta estandarizada para la realización del modelado del sistema y la administración de requisitos. Palabras claves: Gestión de requisitos, Trazabilidad de requisitos, Visual Paradigm HANDBOOK FOR TRACEABILITY OF REQUIREMENTS IN THE VISUAL PARADIGM 8.0 ABSTRACT The traceability of software requirements is a key process for successful management in the development of a system. Today there are a set of tools to perform requirements traceability among which is the OSRMT. Projects of the Center of Informatization Management Entities using Visual Paradigm as a tool for modeling, which is modeled after the information is passed to the tool performs OSRMT where traceability of software requirements. This means that now two tools are used, one for modeling and one for requirements management. The objective of this work is the realization of a handbook explaining how to perform requirements traceability in Visual Paradigm 8.0, so that the projects have a unique standardized tool for the realization of system modeling and requirements management. Keywords: Requirements management, Requirements traceability, Visual Paradigm 1 OSRMT: Open Source Requirements Management Tool

INTRODUCCIÓN La trazabilidad de requisitos es clave para conseguir una exitosa gestión de requisitos. La misma se define como la habilidad para describir y seguir la vida de un requisito en ambos sentidos, hacia sus orígenes o hacia su implementación, a través de todas las especificaciones generadas durante el proceso de desarrollo de software. Para ello el proceso de trazabilidad ha de considerar dos subprocesos: a) configuración de la trazabilidad de acuerdo con las necesidades concretas del proyecto, para así conseguir un resultado positivo respecto del costo-beneficio asociado, b) especificación de la trazabilidad en el proyecto y la posterior explotación de dicha información (Dömges R. y Pohl K., 1998). Para llevar la trazabilidad de requisitos, hoy en día los proyectos hacen uso de herramientas que les permiten gestionar dicho proceso durante el desarrollo del software. En el Centro de Informatización de la Gestión de Entidades (CEIGE), los proyectos hacen uso de la herramienta Open Source Requirements Management Tool (OSRMT) para la realización de la trazabilidad de requisitos; dicha herramienta es Open Source y fue desarrollada entre los años 2006 y 2007. Además, facilita la obtención de información respecto a los elementos de trazabilidad de los requisitos registrados y sus dependencias. A pesar de que el OSRMT es una herramienta que permite la trazabilidad de requisitos, tiene también inconvenientes que dificultan el trabajo en el proyecto, ejemplo de ello es que no permite realizar modelación de los procesos por lo tanto hoy en los proyectos se modela por el Visual Paradigm y luego se trasladan uno a uno los conceptos al OSRMT, realizándose de esta forma trabajo doble en los proyectos. Además, para eliminar un proyecto o cualquier elemento del mismo en el OSRMT, se debe eliminar en la Base de Datos central, ya que la herramienta no permite eliminarlo desde ella. Es importante destacar además, que para el trabajo con dicha herramienta se necesita tener instalada la máquina virtual de java, consumiéndose así más recursos de la máquina en la cual se trabaja. El objetivo del presente trabajo es propiciar una guía para los proyectos del centro, en el cual se explique cómo llevar la trazabilidad de los requisitos a través del Visual Paradigm 8.0. DESARROLLO MATERIALES Y METODOS Como fundamentos principales para el presente trabajo se siguieron, en la investigación, un conjunto de definiciones entre los que se encuentran los requisitos de software y la trazabilidad de requisitos. Además se realizó un estudio de las principales características y ventajas de la herramienta Visual Paradigm 8.0

Requisitos de Software: Un requisito es simplemente una declaración abstracta de alto nivel de un servicio que debe proporcionar el sistema o una restricción de éste. En el otro extremo, es una definición detallada y formal de una función del sistema (Sommerville, 2005). Trazabilidad de requisitos: Es la capacidad de describir y de seguir la vida de un requisito, tanto en dirección hacia adelante y hacia atrás, es decir, desde sus orígenes, a través de su desarrollo y especificación, a su despliegue y uso subsecuentes, y a través de períodos de refinamiento y de la iteración en curso en cualesquiera de estas fases. Esto implica que un requerimiento debe de ser rastreable desde que se define y durante todo el desarrollo del software, lo cual garantiza una adecuada administración del cambio con el fin de evaluar el impacto en el resto del sistema. Visual Paradigm: Es una herramienta UML profesional que soporta el ciclo de vida completo del desarrollo de software: análisis y diseño orientados a objetos, construcción, pruebas y despliegue. Además de permitir el modelado UML, permite el modelado de requisitos en el cual se capturan los requisitos con el Diagrama de Requerimientos SysML, Modelado de Casos de Uso, Análisis Textual, tarjetas CRC, y crear pantalla maqueta con el Diseñador de la Interfaz de Usuario. RESULTADOS Y DISCUSIÓN RESULTADOS Como resultado se obtiene una guía a modo de manual de uso, con el fin de facilitar la comprensión de cómo realizar a través de la herramienta Visual Paradigm 8.0 la trazabilidad de requisitos. Por lo cual se indican sistemáticamente los pasos a seguir al momento de querer realizar una acción determinada. Es importante antes de comenzar a realizar la trazabilidad de requisito en cualquier proyecto, el usuario conozca los pasos a seguir para realizar dicho proceso, los cuales se recogen en la Guía de Trazabilidad definida por Calisoft. Además dicha guía define cuáles son los elementos de seguimiento para los proyectos y las relaciones entre los elementos de trazabilidad de los requisitos, por lo tanto antes de poder realizar la trazabilidad de los requisitos, se tiene que tener diagramado todos estos elementos en el Visual Paradigm. 1 Diagrama de requisitos El diagrama de requisitos está diseñado específicamente para el Lenguaje de Modelado de Sistemas (SysML). Se crea en contenedores de requisitos para presentar la relación entre los requisitos y otros elementos del modelo. Creación de diagrama de requisitos:

Haga clic en la barra de herramientas Captura de requerimientos y seleccione Diagrama de Requerimientos del menú desplegable. Haga clic derecho sobre Diagrama de Requerimientos en el Navegador de Diagramas y seleccione Nuevas Diagrama de Requerimientos en el menú emergente o Seleccione Archivo > Nuevo diagrama > Captura de requerimientos > Diagrama de requerimientos desde el menú principal. Nota: Los requisitos en este diagrama serán agrupados por procesos. 1.1 Creación requisitos Para crear un requisito, haga clic en el botón de la paleta de componentes Requisito y, a continuación, haga clic en el diagrama. Figura 1 Requisito creado. 1.2 Relación de trazabilidad entre requisitos Para realizar la trazabilidad entre requisitos, haga clic en Trace -> Requirement y arrastre. Mueva el puntero del ratón sobre el requisito con el cual quiere realizar la trazabilidad y luego suelte el botón del ratón, un requisito junto con una relación de trazabilidad será creado. Figura 2 Requisitos y Trazabilidad creada.

1.3 Edición de propiedades requisitos Para editar la característica de un requisito (por ejemplo, ID), haga doble clic en la propiedad, escriba el nuevo valor y pulse Enter para confirmar. 1.4 Edición de las propiedades de los requisitos con la caja de diálogo de especificación 1.4.1 Pestaña General Otra vía para editar las propiedades de un requisito es en la caja de diálogo de especificación (dar clic en Abrir Especificación) y en la pestaña General se editan dichas propiedades. Figura 3 Abrir Especificación de un Requisito. 1.4.2 Pestaña Attributes / Atributos Figura 4 Especificación de requisitos (General).

Además si se desea agregar otros atributos aparte de los que aparecen por defecto en el requisito, seleccionando la pestaña Attributes, clic en el botón Añadir. 1.4.3 Pestaña Project Management / Administración de Proyecto Seleccione la pestaña Project Management y ahí podrá especificar la iteración, la fase, la disciplina, entre otros elementos del requisito. Estos elementos son configurables, por lo tanto se pueden ajustar a lo que se define hoy en el Modelo de Desarrollo del CEIGE. Para realizar estos ajustes, se selecciona el botón Configure Look-ups 1.4.4 Pestaña Traceability / Trazabilidad Para definir la trazabilidad del requisito se selecciona la pestaña Traceability, es importante señalar que tienen que estar diagramados los elementos de trazabilidad en el Visual Paradigm. Se selecciona el botón Añadir y de las dos opciones desplegadas, se escoge la opción Tránsito A Figura 5 Especificación de requisitos (Traceability). Se selecciona el / los concepto (s) asociados al / los elemento (s) con los que se realizará la trazabilidad. Ejemplo: Del elemento MC (Entidad del Negocio), selecciono los conceptos Cierre, Conciliación bancaria y Diferencia con banco, luego se da clic en el botón OK.

Figura 6 Selección de los conceptos asociados al elemento de seguimiento. 1.5 La creación de casos de prueba y enlace a los requisitos Para crear un caso de prueba, haga clic en el botón de caso de prueba (Test Case) en la Paleta de componentes y haga clic en el diagrama. Haga clic en el recurso Verify -> Requirement del caso de prueba y arrastre. Figura 7 Vinculación del Requisito con el caso de prueba. Mueva el puntero del ratón sobre un requisito y luego suelte el botón del ratón, una relación Verify se crea a partir del caso de prueba con el requisito. 2 Personalización de los tipos de requisitos Figura 8 Relación creada Verify.

Los usuarios pueden registrar y presentar los requisitos como cuadros visualmente a través del modelado requisito. El nombre de los requisitos resume el requisito mientras que un conjunto de atributos define el requisito. El cuadro de requisitos predeterminado permite a los usuarios especificar los atributos generales, tales como ID, origen, tipo, método verify, el riesgo y el estado. Además, puedes personalizar tus propios tipos de requisitos para que contengan atributos relacionadas con su dominio. Es importante especificar que esta personalización de tipos de requisitos, permite diagramar algunos elementos que no tienen definido un diagrama en el Visual Paradigm, ejemplo: Plan de Desarrollo de Software, Proveedores de requisitos, etc. 2.1 Creación de un nuevo tipo de requisito Antes de crear un nuevo tipo de Requisito cree un nuevo diagrama de requisitos o abra su diagrama de requisitos destino en el que desea personalizar sus propios tipos de requisitos. Seleccione Herramientas > Configurar Requerimientos desde la Barra de menú. Se le muestra la ventana Configurar Requerimientos. Haga clic en Añadir para agregar un nuevo tipo requisito. Figura 9 Cuadro de diálogo Configurar Requerimiento. Ingrese el nombre del tipo de Requisito en el campo Nombre. Para añadir atributos para el nuevo tipo de requisito se da clic en el botón Añadir que se encuentra debajo de la tabla de atributos y seleccione un atributo.

Figura 10 Añadir atributos. Además de definir los atributos, puede formatear el tipo de requisito con relleno, línea y fuente. Haga clic en el botón de relleno si desea personalizar un color para el tipo de requisito. Una vez que haya terminado de configurar los tipos de requisitos, haga clic en el botón Aceptar para volver al Diagrama de requerimientos. Por último, se puede ver el tipo de requisito personalizado que está disponible en la Paleta de componentes. Puede seleccionar y hacer clic en el diagrama para crear la figura. Figura 11 El tipo de requisito personalizado. 3 Creación de la matriz de trazabilidad Una matriz es una tabla, que muestra la existencia de relaciones entre los elementos del modelo de tipos particulares. Mediante la lectura de una matriz, se puede decir fácilmente si dos elementos del modelo están relacionados o no, y qué tipo de relación tienen. Haga clic derecho en Matrix Diagram, bajo la categoría Otros en el Navegador de Diagrama y seleccione New Matrix Diagram en el menú emergente. Nota: Otra vía es seleccionar en la Barra de herramientas > Impact > Matrix Diagram.

3.1 Configuración de la matriz Al configurar la matriz se especifica el nombre del diagrama. En el diagrama aparece una lista de Modelos Disponibles / Available Models, donde se selecciona un modelo para añadirlo en el destino Models on Row y / o Models en Column. Se pueden seleccionar varios modelos para que sean mostrados ya se en las filas o en las columnas. Ejemplo: Si se quiere crear una matriz de trazabilidad entre requisitos y componentes, se selecciona de la Lista de Modelos Disponibles el modelo Requirement y se añade en los Models on Row, se selecciona, además, el modelo Component y se añade en Models en Column. Una vez realizadas estas operaciones, se selecciona del combo By la opción Transitor, y se da clic en el botón OK. Figura 12 Configurar matriz. Ya una vez creada la matriz se da doble clic sobre la matriz creada en el Navegador de Diagramas. Esta matriz se puede exportar a Excel. Figura 13 Visión general de un diagrama de matriz.

4 Requirement grid / Cuadrícula de requisitos Requirement grid es una tabla con los requisitos recogidos en el mismo. Le permite acceder a todos los requisitos en un proyecto o un diagrama, búsqueda de requisitos por criterios y crear requisitos. 4.1 Creando una cuadrícula de requisitos Haga clic en la Barra de herramientas > Requisito y seleccione Requirement grid desde el menú desplegable. En el Requirement Grid se especifica el nombre y se selecciona en el combo Elemento Modelo, el elemento del que se quiere ver todos los datos. En este caso se dejará la opción que sale por defecto Requirement. Debajo aparece una tabla con las propiedades de todos los requisitos definidos en los Diagramas de Requerimientos. En esta tabla se pueden configurar las propiedades que se quieran consultar, se va a la opción Configure columns Figura 14 Requirement grid. Si entre las propiedades que se quieran visualizar, se encuentra la trazabilidad de los requisitos, se selecciona la opción Tránsito A dentro de la carpeta Otros, se añade en la lista Selected Columns. Clic en el botón Aplicar y luego en el botón Aceptar. Figura 15 Configuración de columnas.

Si se desea visualizar un requisito, se selecciona el requisito a visualizar y se da clic en la opción Visualizar Figura 16 Visualizar propiedades de requisito. 5 Exportando información del proyecto Haga clic derecho sobre la Cuadrícula creada en el Navegador de Diagramas y seleccione la opción de la lista desplegable Exportar XML o Exportar a Excel Luego se selecciona que se desea exportar; si es el proyecto completo, se selecciona el checkbox con el nombre del proyecto y se especifica el lugar donde se quiera guardar. 6 Subir el proyecto.vpp al repositorio Con el objetivo de que todos los miembros del proyecto trabajen sobre el mismo proyecto.vpp, se hace necesario que una persona suba el proyecto inicial al repositorio. Para ello, se enumeran el conjunto de pasos a seguir: Paso 1: Se selecciona de la Barra de herramientas > Team y de la lista desplegable, seleccionar la opción Abrir Cliente de Equipo de Trabajo Paso 2: En la ventana que se muestra, se selecciona la opción Inicio de Sesión. Figura 17 Seleccionar Inicio de Sesión. Paso 3: Se registra el usuario y la contraseña con permisos en el repositorio, se indica la dirección del repositorio en la cual se subirá el proyecto y la dirección dónde

Paso 4: Una vez que se esté logueado, se procede a importar el proyecto al repositorio, para ello se selecciona la opción Importar Proyecto a Repositorio. Figura 18 Importar Proyecto a Repositorio. Paso 5: En la ventana que se muestra, aparecerá la dirección que se indicó anteriormente, la misma se selecciona y se da clic en el botó OK. Figura 19 Seleccionar dirección del Repositorio. Paso 6: El proyecto se subirá al repositorio y luego se puede abrir el proyecto para comprobar que se haya subido correctamente. 7 Trabajar con el proyecto.vpp que se encuentra en el repositorio Para que todos los miembros del proyecto trabajen sobre el mismo proyecto.vpp que se encuentra en el repositorio, a continuación se detallan los pasos a seguir para este trabajo: Paso 1: Se realizan los Pasos 1, 2 y 3 del epígrafe 9. En el caso del Paso 3 la dirección que se especifica es donde se encuentra el proyecto.vpp con el que se trabajará y que se encuentra en el repositorio. Paso 2: Seleccione el proyecto en el listado de Proyectos y de clic sobre el botón Abrir Proyecto y trabaje sobre él.

Paso 3: Las actualizaciones y las acciones realizadas sobre el proyecto se actualizan en el repositorio por la opción Barra de herramientas > Team. Figura 20 Subir cambios al repositorio. DISCUSIÓN A partir del estudio realizado se pudo comprobar la factibilidad de utilizar una única herramienta para realizar tanto la modelación como la gestión de los requisitos de software en un proyecto. Con la utilización de Visual Paradigm 8.0 para registrar la trazabilidad de requisitos se logró erradicar las deficiencias que hasta el momento se venían detectando con el OSRMT. Además con el uso del VP se minimiza el tiempo en la disciplina de modelado de negocio y requerimientos ya que todo el desarrollo que antes se dividía entre dos herramientas ahora queda en una sola. La contribución real de esta investigación radica en estandarizar una herramienta que sea capaz de llevar a la par el desarrollo y gestión de los requisitos de software en un proyecto. De esta forma, además se logra que el equipo de trabajo se organice de forma centralizada a partir de un.vpp que estará siempre en el repositorio de su proyecto. Se pretende que esta investigación no quede en el marco de CEIGE y pueda ser utilizada por el resto de los proyectos de la Universidad que trabajen por procesos. De esta forma se estaría logrando una uniformidad en el uso de herramienta en las disciplinas de modelado de negocio y requerimientos definidas por el Programa de Mejora. A partir de la investigación realizada se obtuvo una guía que ayudará a los analistas y demás roles implicados de un proyecto a realizar la administración de requisitos, específicamente el proceso de trazabilidad. Aunque la herramienta ya es conocida y utilizada en los proyectos, hasta el momento no se utilizaba para esta gestión, lo cual implica que se defina un período de capacitación a fin de lograr un buen uso de la misma.

CONCLUSIONES Una vez culminado el trabajo y como resultado del mismo se logró alcanzar el objetivo general propuesto, para ello se realizaron un conjunto de acciones: A partir de un estudio minucioso de la herramienta Visual Paradigm 8.0 se logró identificar los pasos a seguir para realizar la trazabilidad de requisitos por el mismo, lo cual facilitó la realización de la guía. Se logra que los proyectos hoy usen una sola herramienta que será capaz de llevar a la par el desarrollo y gestión de los requisitos de software del proyecto. Los analistas del proyecto y demás roles podrán trabajar sobre un mismo proyecto.vpp que se encontrará en el repositorio, posibilitando de esta forma centralizar el trabajo y apoyar el trabajo colaborativo. RECOMENDACIONES Se recomienda realizar una guía de adaptación para los proyectos que en la Universidad trabajan con caso de uso. REFERENCIAS BIBLIOGRÁFICAS Dömges, Ralf y Pohl, Klaus. Adapting traceability environments to project-specific needs, Communications of the ACM, 1998, Volume 41 Issue 12: págs. 54-62. CALISOFT. 2009. Guía de trazabilidad. La Habana : Universidad de las Ciencias Informáticas, 2009. págs. 1-19. Sitio oficial Visual Paradigm. VP-UML_Users_Guide. [En línea] http://www.visualparadigm.com/support/documents/. Sommerville, Ian. Ingeniería del Software. s.l. : Pearson Educación, 2005. pág. 687 páginas.