administracion de requerimientos en requisitepro

La gestión de los requerimientos en RequisitePro

1

LAGESTIÓNDELOSREQUERIMIENTOSENREQUISITEPROUSO DEL REQUISITEPRO PARA ADMINISTRAR LOS REQUERIMIENTOS DEL SOFTWARE.

MBA Pilar Stronguiló Leturia02/05/2011


2

CONTENIDO

La Gestión de los requisitos ................................................................................................................ 5

Espacio de la gestión de requisitos ................................................................................................. 5

RequisitePro ........................................................................................................................................ 7

Acceso a la aplicación ...................................................................................................................... 7

Funciones y elementos básicos ....................................................................................................... 7

Creación del proyecto ................................................................................................................. 7

Ingreso al proyecto y pantalla inicial ......................................................................................... 10

Elementos creados por la plantilla ............................................................................................ 11

Barra de herramientas .............................................................................................................. 12

Elementos del RequisitePro ...................................................................................................... 13

Administración de las propiedades del proyecto .......................................................................... 14

Creación de tipos de requerimientos ........................................................................................ 15

Creación de tipos de documentos............................................................................................. 16

Creación y edición de atributos ................................................................................................ 18

Parámetros de tratamiento de los documentos ....................................................................... 20

Historia de modificaciones al proyecto ..................................................................................... 21

Creación de los diferentes elementos del RequisitePro ............................................................... 21

Creación de paquetes ................................................................................................................ 21

Creación de documentos .......................................................................................................... 22

Creación de requerimiento ....................................................................................................... 25

Creación de una vista ................................................................................................................ 28

El documento Vision y las facilidades ........................................................................................... 32

La Visión .................................................................................................................................... 32

Facilidades ................................................................................................................................. 34

Especificaciones suplementarias ................................................................................................... 40

Creación de una jerarquía de requerimientos .......................................................................... 41

Especificaciones de Casos de Uso ................................................................................................. 43

Creación de un documento propio ............................................................................................... 48

Personalización de contenidos .................................................................................................. 49

Trazabilidad ................................................................................................................................... 52


3

ILUSTRACIONES

Ilustración 1: Espacio de la gestión de requisitos ........................................................................................ 5 Ilustración 2: Acceso al RequisitePro ......................................................................................................... 7 Ilustración 3: Templates proporcionados por el RequisitePro ..................................................................... 8 Ilustración 4: Creación de un proyecto (1) .................................................................................................. 8 Ilustración 5: Creación de un proyecto (2) .................................................................................................. 9 Ilustración 6: Creación de un proyecto (3) .................................................................................................. 9 Ilustración 7: Creación de un proyecto (4) ................................................................................................ 10 Ilustración 8: Pantalla de Logon ............................................................................................................... 10 Ilustración 9: Pantalla principal del RequisitePro ..................................................................................... 11 Ilustración 10: Elementos de la plantilla UseCase de organización de requisitos ....................................... 12 Ilustración 11: Barra de herramientas del RequisitePro ............................................................................ 12 Ilustración 12: Artefactos del RequisitePro .............................................................................................. 13 Ilustración 13: Acceso a la pantalla de propiedades ................................................................................. 14 Ilustración 14: Propiedades‐Vista general ................................................................................................ 15 Ilustración 15: Propiedades ‐ Tipos de Requerimientos ............................................................................ 15 Ilustración 16: Creación de un Tipo de Requerimiento ............................................................................. 16 Ilustración 17: Propiedades ‐ Tipos de Documentos ................................................................................. 16 Ilustración 18: Creación de un Tipo de Documento (1) ............................................................................. 17 Ilustración 19: Creación de un Tipo de Documento (2) ............................................................................. 18 Ilustración 20: Propiedades ‐ Atributos de Tipos de Requerimientos ........................................................ 18 Ilustración 21: Atributos‐Cambio del valor por defecto (1) ....................................................................... 19 Ilustración 22: Atributos‐Cambio del valor por defecto (2) ....................................................................... 19 Ilustración 23: Atributos‐Creación de un nuevo atributo .......................................................................... 20 Ilustración 24: Propiedades ‐ Parámetros de los documentos ................................................................... 20 Ilustración 25: Propiedades ‐ Revisión ..................................................................................................... 21 Ilustración 26: Creación de un paquete (1) ............................................................................................... 21 Ilustración 27: Creación de un paquete (2) ............................................................................................... 22 Ilustración 28: Creación de un paquete (3) ............................................................................................... 22 Ilustración 29: Creación de un documento ............................................................................................... 23 Ilustración 30: Ambiente Word del RequisitePro ...................................................................................... 23 Ilustración 31: Propiedades del archivo Word (1) ..................................................................................... 24 Ilustración 32: Propiedades del archivo Word (2) ..................................................................................... 24 Ilustración 33: Adición de un requerimiento (1) ....................................................................................... 25 Ilustración 34: Adición de un requerimiento (2) ....................................................................................... 26 Ilustración 35: Adición de un requerimiento (3) ....................................................................................... 26 Ilustración 36: Adición de un requerimiento (4) ....................................................................................... 26 Ilustración 37: Adición de un requerimiento (5) ....................................................................................... 26 Ilustración 38: Actualización de requerimientos ....................................................................................... 27 Ilustración 39: Cambio de los atributos de un requerimiento (1) .............................................................. 27 Ilustración 40: Cambio de los atributos de un requerimiento (2) .............................................................. 27 Ilustración 41: Creación de una vista (1) .................................................................................................. 28 Ilustración 42: Creación de una vista (2) .................................................................................................. 29 Ilustración 43. Creación de una vista (3)................................................................................................... 29 Ilustración 44: Creación de una vista (4) .................................................................................................. 30 Ilustración 45: Actualización de un requerimiento desde una vista (1) ..................................................... 30 Ilustración 46: Actualización de un requerimiento desde una vista (2) ..................................................... 31 Ilustración 47: Personalización de una vista ............................................................................................. 31 Ilustración 48: Exportar datos de una vista a Word (1) ............................................................................. 31 Ilustración 49: Exportar datos de una vista a Word (2) ............................................................................. 32


4

Ilustración 50: Documento Visión ............................................................................................................ 33 Ilustración 51: Documento Visión‐Declaración del problema y el posicionamiento ................................... 33 Ilustración 52: Documento Visión – Facilidades ........................................................................................ 34 Ilustración 53: Creación de un requerimiento a partir de un texto (1) ....................................................... 35 Ilustración 54: Creación de un requerimiento a partir de un texto (2) ....................................................... 35 Ilustración 55: Actualización del requerimiento luego de la adición (1)..................................................... 35 Ilustración 56: Actualización de un requerimiento luego de la adición (2) ................................................. 36 Ilustración 57: Actualización del tipo de Facilidad .................................................................................... 36 Ilustración 58: Actualización del número de la iteración ........................................................................... 37 Ilustración 59: Organización de requerimientos en paquetes ................................................................... 37 Ilustración 60: Reorganización de requerimientos (1)............................................................................... 38 Ilustración 61: Reorganización de requerimientos (2)............................................................................... 38 Ilustración 62: Reorganización de requerimientos (3)............................................................................... 39 Ilustración 63: Reorganización de requerimientos (4)............................................................................... 39 Ilustración 64: Reorganización de requerimientos (5)............................................................................... 40 Ilustración 65: Creación de la Especificaciones Suplementarias (1) ........................................................... 40 Ilustración 66: Creación de la Especificaciones Suplementarias (2) ........................................................... 40 Ilustración 67: Jerarquización de requerimientos (1) ................................................................................ 41 Ilustración 68: Jerarquización de requerimientos (2) ................................................................................ 42 Ilustración 69: Jerarquización de requerimientos (3) ................................................................................ 42 Ilustración 70: Jerarquización de requerimientos (4) ................................................................................ 43 Ilustración 71: Paquete Use Cases ........................................................................................................... 43 Ilustración 72: Creación de un paquete para cada caso de uso (1) ............................................................ 44 Ilustración 73: Creación de un paquete para cada caso de uso (2) ............................................................ 44 Ilustración 74: Creación de una especificación de caso de uso (1) ............................................................. 44 Ilustración 75: Creación de una especificación de caso de uso (2) ............................................................. 45 Ilustración 76: Creación de una especificación de caso de uso (3) ............................................................. 45 Ilustración 77: Creación de una especificación de caso de uso (4) ............................................................. 46 Ilustración 78: Creación de una especificación de caso de uso (5) ............................................................. 47 Ilustración 79: Creación de una especificación de caso de uso (6) ............................................................. 47 Ilustración 80: Creación de una especificación de caso de uso (7) ............................................................. 47 Ilustración 81: Creación de una especificación de caso de uso (8) ............................................................. 48 Ilustración 82: Creación de una especificación de caso de uso (9) ............................................................. 48 Ilustración 83: Creación de una historia de usuario (1) ............................................................................. 48 Ilustración 84: Creación de una historia de usuario (2) ............................................................................. 49 Ilustración 85: Personalización de campos en un documento (1) .............................................................. 49 Ilustración 86: Personalización de campos en un documento (2) .............................................................. 50 Ilustración 87: Personalización de campos en un documento (3) .............................................................. 50 Ilustración 88: Personalización de campos en un documento (4) .............................................................. 51 Ilustración 89: Personalización de campos en un documento (5) .............................................................. 52 Ilustración 90: Trazabilidad (1) ................................................................................................................ 53 Ilustración 91: Trazabilidad (2) ................................................................................................................ 54

TABLAS

Tabla 1: Tipos de requerimientos administrados ........................................................................................ 6 Tabla 2: Elementos de la plantilla de Casos de Uso................................................................................... 12 Tabla 3: Opciones de la barra de herramientas ........................................................................................ 13 Tabla 4: Elementos del RequisitePro ........................................................................................................ 14 Tabla 5: Formas de trazabilidad ............................................................................................................... 53


5

LA GESTIÓN DE LOS REQUISITOS

Es el proceso de administrar los cambios a los requerimientos del sistema. Este proceso incluye actividades para mantener la integridad, exactitud y vigencia de los requerimientos “acordados” a medida que el proyecto vaya progresando. Como maneja una gran cantidad de información y debe asegurarse de que ésta llegue a las personas correctas en el momento adecuado, es imprescindible contar con una herramienta CASE que permita:

Reconocer los requerimientos de manera única y clasificarlos de acuerdo a su tipo.

Almacenarlos en una base de datos.

El análisis y generación de documentos.

Manejar cambios y ayudar a que éstos se establezcan y costeen apropiadamente.

Efectuar la trazabilidad; la cual ayudará a que los ingenieros de requerimientos establezcan las dependencias entre los distintos requisitos del sistema.

Administrar versiones

ESPACIO DE LA GESTIÓN DE REQUISITOS

Ilustración 1: Espacio de la gestión de requisitos

La gestión de requisitos envuelve la traducción de las solicitudes de los involucrados en un conjunto de necesidades y facilidades del sistema. Estos a su vez son detallados en especificaciones de requisitos funcionales (casos de uso) y no funcionales (especificaciones suplementarias). Más adelante las especificaciones son traducidas en procedimientos de prueba, diseño y la documentación de usuario La traceabilidad nos permite:

Evaluar el impacto en el proyecto de un cambio en un requisito.


6

Evaluar el impacto de un fallo de una prueba sobre un requisito (Por ejemplo si el test falla el requisito puede no estar satisfecho) .

Administrar el alcance del proyecto.

Verificar que todos los requisitos del sistema son cubiertos por la implementación.

Verificar que la aplicación hace solamente lo que se solicitó que hiciera.

Administrar los cambios. La tabla siguiente resume los tipos de requerimientos mostrados en el gráfico:

Tabla 1: Tipos de requerimientos administrados

Tipo de Requerimiento

Descripción Documento(s) asociado(s)

Necesidades Las necesidades de los stakeholders (stakeholders requests) son los requerimientos expresados en su propio lenguaje. Es trabajo del analista clasificar estas necesidades en funcionales y no funcionales y traducirlas a un lenguaje que sea interpretado por los desarrolladores.

Stakeholder RequestVision Product Backlog

Facilidades Son los requerimientos de alto nivel capturados por el analista sobre la base de las necesidades de los usuarios y stakeholders. Las facilidades serán traducidas luego en especificaciones de casos de uso y requerimientos suplementarios

Vision

Casos de uso Los casos de uso son requerimientos que describen la interacción hombre‐máquina. Describen un proceso desde el punto de vista del usuario y los resultados puntuales que obtiene. Especifican los comportamientos de entradas y salidas del sistema.

Use case specificationUser stories

Requerimientos suplementarios

Describen atributos del sistema o del ambiente en donde éste se desarrolla. Están asociados con tácticas o mecanismos de análisis, diseño e implementación.

Supplementary Specification


7

REQUISITEPRO

IBM Rational RequisitePro es una herramienta que ayuda a los equipos de proyectos a administrar sus requerimientos, documentarlos, mejorar la trazabilidad, fortalecer la colaboración, reducir el re‐trabajo e incrementar la calidad.

ACCESO A LA APLICACIÓN

Se puede acceder a la aplicación a través del acceso directo o como una opción de la carpeta IBM Rational tal como lo muestra la ilustración 2.

Ilustración 2: Acceso al RequisitePro

FUNCIONES Y ELEMENTOS BÁSICOS

Una vez activada la aplicación mostrará una venta con dos pestañas: New para crear un proyecto nuevo y Existing para abrir un proyecto que ya existe.

CREACIÓN DEL PROYECTO Comenzaremos creando un proyecto a partir de una de las plantillas proporcionadas por RequisitePro. Usaremos dentro de esta guía rápida, la plantilla de casos de uso (Use case template) tal y como se muestra en la ilustración 3.


8

Esta es la plantilla recomendada por RUP para los sistemas con fuerte interacción hombre/máquina, que corresponde con las características de la mayoría de las aplicaciones de gestión empresarial.

Ilustración 3: Templates proporcionados por el RequisitePro

Para crear un proyecto (ver ilustración 4) hace falta:

Nombrarlo (para esta guía se ha elegido el nombre HealthTeeth)

Ubicarlo en un directorio

Indicar en qué Base de Datos se almacenarán los requerimientos (MS Access es la más común)

Describirlo brevemente

Ilustración 4: Creación de un proyecto (1)


9

Las ilustraciones 5, 6 y 7 muestran los pasos para:

Ubicar una ruta donde crear las librerías y la base de datos del proyecto, de acuerdo a la plantilla seleccionada.

Crear el directorio del proyecto si no existe.

Terminar la creación cerrando la pantalla de aviso de finalización del proceso.




10


INGRESO AL PROYECTO Y PANTALLA INICIAL Una vez creado el proyecto se puede usar los usuarios creados por defecto (admin y Unknown) o crear un usuario nuevo para que más de una persona pueda usar y participar en el Proyecto. La pantalla de Logon se muestra en la siguiente ilustración.

Ilustración 8: Pantalla de Logon

Al ingresar aparecerá la pantalla principal del RequisitePro. En la siguiente ilustración se muestran la partes más importantes de dicha pantalla.


11

Ilustración 9: Pantalla principal del RequisitePro

ELEMENTOS CREADOS POR LA PLANTILLA Una vez que el usuario ha ingresado se mostrarán los elementos creados automáticamente al seleccionar la plantilla de Casos de Uso para el proyecto HealthTeeth (ver ilustración 10). Estos elementos son:


12

Tabla 2: Elementos de la plantilla de Casos de Uso

Elemento Descripción

Paquete Coverage Analysis Para analizar el cubrimiento acorde a la pirámide de los requisitos (ver ilustración 1)

Paquete Features and Vision

Para documentar las facilidades (requerimientos de alto nivel) y la Visión del sistema.

Paquete Glossary Para documentar el glosario de los términos relacionados con el negocio y el sistema.

Paquete Impact Analysis Permite visualizar que requerimientos se afectan dado un cambio.

Paquete Supplementary Requirements

Para documentar los requerimientos de calidad y las funciones que no se puede expresar a través de un solo caso de uso.

Paquete Use Case: Para agrupar y documentar los requisitos que se constituirán en los procesos del sistema.

Documento Requirements Management Plan

Documento creado a partir de una de las plantillas administrativas del RUP. No lo usaremos para efecto de esta guía.

Ilustración 10: Elementos de la plantilla UseCase de organización de requisitos

BARRA DE HERRAMIENTAS A continuación describiremos cada una de las opciones de la barra de herramientas.

Ilustración 11: Barra de herramientas del RequisitePro

En esta guía estudiaremos las más importantes y necesarias para administrar los distintos tipos de requerimientos de la pirámide.


13

Tabla 3: Opciones de la barra de herramientas

Opción Descripción

Para crear un proyecto nuevo o cualquier ítem del RequisitePro: paquete, documento, vista o requerimiento.

Para abrir un proyecto existente.

Para salvar la vista activa o seleccionada.

Para imprimir la vista activa o seleccionada.

Para adicionar un requerimiento nuevo (es conveniente hacerlo en un documento).

Para mostrar y actualizar las propiedades de un requerimiento.

Para buscar y encontrar un requerimiento en una vista o en el explorador

Para ir a un documento seleccionado en el explorador

Para efectuar un query sobre una vista, filtrando u ordenando los requerimientos de acuerdo a uno de sus atributos.

Para seleccionar que atributos se mostrarán en una vista en particular.

Para refrescar la vista activa o seleccionada.

Para establecer un valor de atributo para un requerimiento concreto.

Para ir al ambiente Word de edición del documento.

Para mostrar las discusiones establecidas entre los diferentes usuarios con derechos de uso del proyecto.

Para genera métricas en Excel conforme los valores de alguno de los atributos.

Para acceder al manual de ayuda en línea del RequisitePro.

ELEMENTOS DEL REQUISITEPRO Son cuatro los elementos o ítems que administra el RequisitePro. Estos se muestran en la ilustración 12 y se describen en la tabla 4.

Ilustración 12: Artefactos del RequisitePro


14

Tabla 4: Elementos del RequisitePro

Elemento DescripciónPackage Un paquete es el elemento que agrupa a los demás items.

Document Un documento sirve para capturar y documentar requerimientos. RequisitePro trabaja con el MS Word adicionando una barra especial.

View Las vistas son matrices que muestran requerimientos y que permiten manejar sus propiedades. NOTA: No es conveniente crear un requisito en una vista porque no se reflejaría en el documento correspondiente.

Requirement Un requerimiento o requisito es la unidad básica de documentación en el RequisitePro. NOTA: Se pueden crear nuevos tipos fuera de los establecidos por la Plantilla escogida.

ADMINISTRACIÓN DE LAS PROPIEDADES DEL PROYECTO

Muchas veces se deseará administrar nuevos requerimientos que no fueron creados por la plantilla seleccionada. Para lograr esto, es necesario trabajar con la pantalla de propiedades del proyecto que se muestra en la siguiente ilustración.

Ilustración 13: Acceso a la pantalla de propiedades

La primera pestaña de las propiedades muestra la información general del proyecto. Se pueden efectuar cambios en el nombre, prefijo y la descripción (ver ilustración 14).


15

Ilustración 14: Propiedades‐Vista general

CREACIÓN DE TIPOS DE REQUERIMIENTOS Para crear un nuevo tipo de requerimiento es preciso ir a la pestaña Requirements Type de la ventana de propiedades del Proyecto y hacer click en el botón Add… (Ver ilustración 15). En esta guía adicionaremos el tipo de requerimiento regla de negocio al que vamos a llamar Business Rule.

Ilustración 15: Propiedades ‐ Tipos de Requerimientos

Los campos más importantes (ver ilustración 16), que deben ser llenados son:

Name: Nombre del tipo de requisito. En este caso es Business Rule.

Description: Poner un texto breve que agregue información al tipo de requerimiento creado.

Initial Requirement #: Entero a partir del cual que se numerarán los requisitos del tipo creado.

Requirement Tag Prefix: Prefijo con el que reconocerá a los requerimientos de dicho tipo. Para el caso de las reglas de negocio se ha escogido BRUL.

Requierement Color: Color con el que un requerimiento del tipo se va a ver en un documento determinado.

Requirement Style: Estilo de documentación del requerimiento en un documento determinado.


16

Ilustración 16: Creación de un Tipo de Requerimiento

CREACIÓN DE TIPOS DE DOCUMENTOS A continuación se observará la creación de dos tipos de documentos:

CREACIÓN DE DOCUMENTOS CON UNA PLANTILLA DEL RUP Luego de crear el tipo de requerimiento es preciso crear el tipo de documento que lo va a contener. Esto es posible en la pestaña Document Types de la pantalla de propiedades del Proyecto (Ver ilustración 17).

Ilustración 17: Propiedades ‐ Tipos de Documentos


17

Los campos más importantes (Ver ilustración 18), que deben ser llenados son:

Name: Nombre del tipo de documento. En este caso es Business Rules Specification.

Description: Poner un texto breve que agregue información al tipo de documento creado.

File Extension: Sufijo con el que reconocerán a los documentos concretos pertenecientes al tipo creado. En este caso un documento concreto de especificación de reglas de negocio tendrá la extensión .BRD

Default Requirement Type: Es el tipo de requerimiento creado por defecto en un documento concreto del tipo. En este caso seleccionaremos el tipo Business Rule que acabamos de crear.

Outline: El recuadro Outline permite asociar una plantilla del RUP al tipo de documento. Para este caso hemos seleccionado el RUP Business Rules template.

Ilustración 18: Creación de un Tipo de Documento (1)

CREACIÓN DE UN TIPO DE DOCUMENTO SIN PLANTILLA En este otro caso (Ver ilustración 19) estamos creando un tipo de documento User Story Specification al que le estamos poniendo la extensión USS y que servirá para documentar casos de uso con otro formato. La diferencia está que en el campo Outline se ha seleccionado None que es igual a decir que no se tomará ninguna plantilla del RUP como base. Esto implicará que al momento de crear un documento User Story concreto el Word no tendrá ninguna indicación y aparecerá con una hoja en blanco. Esto se verá más adelante.


18

Ilustración 19: Creación de un Tipo de Documento (2)

CREACIÓN Y EDICIÓN DE ATRIBUTOS Un aspecto importante de la administración de requerimientos es la definición y seguimiento de sus atributos de gestión. Al crear un nuevo tipo de requerimiento, RequisitePro asociará algunos atributos característicos. No obstante un usuario puede hacer las modificaciones que crea pertinentes. En la siguiente ilustración estamos viendo los atributos creados para el tipo de requerimiento Business Rule.

Ilustración 20: Propiedades ‐ Atributos de Tipos de Requerimientos


19

En la siguientes ilustraciones 21 y 22 vemos como podemos cambiar el valor por defecto de un atributo. Este valor será adoptado por un requerimiento automáticamente al momento de ser creado.

Ilustración 21: Atributos‐Cambio del valor por defecto (1)

Ilustración 22: Atributos‐Cambio del valor por defecto (2)

El usuario del RequisitePro puede crear sus propios atributos. En la ilustración 23 se muestra la creación de un atributo con los campos:

Label: En este caso hemos elegido el nombre de Category

Type: Determina la estructura física del atributo. En este caso se ha elegido una lista de múltiples valores.

List Values: En el ejemplo se han puesto las categorías de las reglas de negocio. Este campo aparece en función al tipo de estructura elegido anteriormente.

Hidden for display: Marcando este campo, el atributo se ocultará.

Change affects suspect: Especifica que los cambios de valor del atributo en un requerimiento afecta a otros relacionados y debe ser resaltado.


20

Ilustración 23: Atributos‐Creación de un nuevo atributo

PARÁMETROS DE TRATAMIENTO DE LOS DOCUMENTOS Los parámetros de tratamientos de los documentos mostrados en la ilustración 24, son:

Save documents in RequisitePro Format: Está marcado por defecto y significa que los documentos estarán guardados en un formato conocido sólo por RequisitePro y por lo tanto no podrán ser abiertos ni editados en otro formato. Si no se marca podrá ser abierto en Word con el riesgo de que puedan ser manipulados fuera del ambiente de la aplicación.

Enable Extended Editing of documents: También está marcado por defecto y significa que las propiedades de los requerimientos podrán ser modificadas fuera del documento, a través de las vistas, por ejemplo.

Ilustración 24: Propiedades ‐ Parámetros de los documentos


21

HISTORIA DE MODIFICACIONES AL PROYECTO En la ilustración 25 se muestra la pestaña de Revisión de la pantalla de propiedades del proyecto. Aquí se podrá llevar y consultar la historia de modificaciones establecidas para todo el proyecto.

Ilustración 25: Propiedades ‐ Revisión

CREACIÓN DE LOS DIFERENTES ELEMENTOS DEL REQUISITEPRO

A continuación mostraremos ejemplos de creación de los diferentes elementos del RequisitePro.

CREACIÓN DE PAQUETES Para adicionar un paquete primero debemos elegir en el explorador donde crearlo. Cómo acabamos de incorporar un nuevo tipo de requerimiento denominado Business Rules, crearemos el nuevo paquete en la raíz del proyecto. Primero marcaremos el ícono del proyecto (HealthTeeth) y haciendo click con el botón derecho del mouse aparecerá el menú emergente de la ilustración 26.

Ilustración 26: Creación de un paquete (1)

Haciendo click en la opción Package con el botón izquierdo del mouse comenzará la definición del nuevo paquete. En la ilustración 27 se muestran los campos que deben llenarse. Para finalizar la operación presionar OK.


22


Al instante aparecerá en el explorador la nueva carpeta (paquete) creada, tal y como se muestra en la ilustración a continuación.


CREACIÓN DE DOCUMENTOS El siguiente paso es crear un documento en la carpeta creada. Procederemos de manera similar a la creación del paquete.

Seleccionamos primero el paquete Business Rules

Con el botón derecho del mouse activamos el menú emergente de la figura 26

Seleccionamos la opción Document.. con el botón izquierdo y a continuación aparecerá una pantalla como la de la ilustración 29.

Los campos a llenar aquí son:

Name: Nombre lógico del documento

Description: Texto a manera de resumen de los contenidos del documento.

Package: Al haber iniciado la creación desde un paquete (Business Rules) aparecerá su nombre. Esto se puede alterar utilizando el botón Browse y seleccionando un paquete nuevo.

Filename: Nombre físico del archivo con el que podrá ser identificado en la librerías. Asume el nombre lógico por defecto.

Directory: Ruta física donde estará ubicado el documento. También puede ser alterado pero no es conveniente.

Document Type: Aquí se escoge el tipo de documento apropiado. Estamos escogiendo el tipo de documento que fue creado anteriormente.

Una vez llenado presionar el botón OK.


23

Ilustración 29: Creación de un documento

Al crear el documento aparecerá el ambiente de procesamiento de texto. RequisitePro trabaja con la aplicación MS Word, tal y como se muestra en la siguiente ilustración:

Ilustración 30: Ambiente Word del RequisitePro

Nótese que el Word tiene una barra de herramientas adicional que permitirá la incorporación de requerimientos en el Documento. Uno de los pasos importantes en la creación del mismo es la personalización de los campos: Nombre de Proyecto, Nombre de Documento, Compañía, Autor, etc., útiles para la organización y el control. Estos campos pueden ser actualizados en el propio Word en la subopción Propiedades (Properties) de la opción Archivo (File) del procesador de texto, tal y como se muestra en las ilustraciones 31 y 32.


24

Ilustración 31: Propiedades del archivo Word (1)

Ilustración 32: Propiedades del archivo Word (2)

Finalmente para hacer efectivos los cambios bastará con seleccionar el campo que se desea modificar y presionar la tecla F9.


25

CREACIÓN DE REQUERIMIENTO Luego de llenar los textos de la plantilla con contenidos apropiados para la aplicación a desarrollar se pueden incorporar los requerimientos. Siguiendo el ejemplo de las reglas de negocio en la ilustración 33 vemos como se ha organizado el documento de acuerdo a las categorías de: Operación Simple, Estímulo Respuesta, etc. Para iniciar la creación de un documento es preciso ubicar primero donde va a figurar (como lo señala la flecha roja) y a continuación hacer click en el ícono new Requirement que aparece enmarcado en rojo).

Ilustración 33: Adición de un requerimiento (1)

A continuación aparecerá la pantalla de propiedades del requerimiento (Ver ilustración 34) y en la pestaña general se podrá definir los siguientes datos

Type: Se podrá elegir aquí el tipo de requerimiento que se quiere adicionar. Por defecto aparecerá el tipo de requerimiento asociado al tipo de documento. (Ve ilustración 18)

Name: En este campo se podrá definir un nombre corto, representativo del requerimiento.

Text: Aquí se pondrá el texto descriptivo del requerimiento. Para el caso de una regla de negocio es su definición completa.

Con esto basta para crear un requerimiento nuevo, presionando el botón OK


26


Luego de completar la adición del requerimiento aparecerá en el documento como pendiente, tal y como se puede apreciar en la siguiente ilustración.


Para terminar la incorporación en la base de datos del RequisitePro es preciso “guardarlo”. Esto será posible haciendo click en el icóno de guardar resaltado en la ilustración 36. Inmediatamente el requerimiento dejará de estar “pending”.


Otra forma de verificar que se ha adicionado el requerimiento en el RequisitePro es verificando el explorador. En nuestro ejemplo se ha creado la regla BRUL1, tal y como se muestra a continuación.



27

ACTUALIZACIÓN DE LAS PROPIEDADES DE UN REQUERIMIENTO Para hacer un cambio en un requerimiento ya sea del texto o de otra de sus propiedades bastará con seleccionarlo en el documento y presionar el ícono resaltado en la siguiente ilustración:

Ilustración 38: Actualización de requerimientos

A continuación aparecerá nuevamente la ventana de las propiedades. En nuestro ejemplo queremos cambiar los atributos de una regla de negocio. Para lograrlo accedemos a la pestaña Attributes. Podemos por ejemplo cambiar la prioridad de Medium a High

Ilustración 39: Cambio de los atributos de un requerimiento (1)

O elegir la categoría apropiada para la regla de negocio, como se muestra en la ilustración 40.

Ilustración 40: Cambio de los atributos de un requerimiento (2)


28

CREACIÓN DE UNA VISTA Otro elemento importante para consultar los requerimientos almacenados en la BD del RequisitePro es la paisaje. Para adicionar una vista, es preciso seleccionar el paquete adecuado que en el caso del ejemplo de las reglas de negocio es el Business Rules y al hacer click al botón derecho del mouse aparecerá el menú emergente de la ilustración 41. Luego, marcando la opción New y seguidamente, con el botón izquierdo del mouse la opción View, se podrá iniciar la creación de una vista.

Ilustración 41: Creación de una vista (1)

A continuación aparecerá la ventana de propiedades de la vista en la que se podrán ingresar los siguientes campos:

Name: Aquí se pondrá el nombre de la vista

Description: En este campo se debe poner una breve descripción de los contenidos de la vista.

Package: Aquí aparecerá el paquete seleccionado para ubicar la vista. Este puede ser cambiado presionando el botón Browse y ubicando otro paquete.

View Type: El RequisitePro maneja dos tipos de Vista: o Attribute Matrix: Matriz en donde a nivel de columnas figuran los atributos y a nivel de

filas los requerimientos que se desean consultar. o Traceability Matrix: Matriz en donde tanto a nivel de filas como de columnas figuran

requerimientos vinculados entre sí. (Este tipo de matriz la veremos más adelante).

Row Requirement Type: Aquí se pondrá el tipo de requerimiento que se desea consultar.

Column Requirement Type: Este campo aparece en las matrices de trazabilidad para poner otro requerimiento a cruzar con el de la fila.

Para el ejemplo de las reglas de negocio estamos eligiendo el tipo Attibute Matrix y a nivel de fila el tipo de requerimiento Business Rule (Ver ilustración 42).


29


Al presionar el botón OK aparecerá la vista creada (Ver ilustración 43). Nótese que se muestran los nombres de los requerimientos resaltados en negrita y a nivel de columna los valores de sus atributos.

Ilustración 43. Creación de una vista (3)

Es posible ampliar el tamaño de la fila para poder consultar, además del nombre, el texto completo del requerimiento. Para lograrlo es preciso seleccionar el borde inferior de una fila y con el mouse arrastrarlo hacia abajo (Ver ilustración 44). De esta manera se podrá visualizar la definición completa del requisito.


30


ACTUALIZACIÓN DE REQUERIMIENTOS A PARTIR DE UNA VISTA Es posible modificar un requerimiento a partir de una vista. Para lograrlo es preciso seleccionarlo primero y luego con el botón derecho del mouse aparecerá un menú como el de la ilustración 45. Al seleccionar la opción Properties… se activará la pantalla de propiedades (Ver ilustración 34) del requerimiento en donde se podrá modificar el texto y cualquiera de sus atributos.

Ilustración 45: Actualización de un requerimiento desde una vista (1)

Otra forma de modificar los atributos de un requerimiento es en la matriz directamente. Basta con posicionar el mouse en el campo de cruce requerimiento/atributo y allí se podrán efectuar las actualizaciones deseadas. En la ilustración 46 vemos como se puede cambiar el valor de la categoría de la regla de negocio con código BRUL5.


31

Ilustración 46: Actualización de un requerimiento desde una vista (2)

CAMBIOS EN LA APARIENCIA DE UNA VISTA Es posible modificar la apariencia de una vista escondiendo atributos que no se desean ver, tal y como se muestra en la ilustración 47. En el ejemplo se seleccionó el campo Assigned To y con el botón derecho del mouse se activó un menú emergente y luego se activó la opción Hide from View

Ilustración 47: Personalización de una vista

También es posible reordenar las filas a partir de los valores de un atributo en forma ascendente (Sort Ascending) o descendente (Sort Descending).

EXPORTAR UNA VISTA A WORD O EXCEL Es posible exportar una vita completa a Word o Excel (formato CSV). La ilustración 48 muestra como se realiza la exportación a partir del menú del Requisite Pro: Opción File/Export/Export to Word o Opción File/Export/Export to CSV.

Ilustración 48: Exportar datos de una vista a Word (1)

En la ilustración 49 se ve como aparece la vista en Word como resultado de la exportación.


32

Ilustración 49: Exportar datos de una vista a Word (2)

EL DOCUMENTO VISION Y LAS FACILIDADES

En los acápites anteriores hemos aprendido como adicionar cada uno de los elementos básicos del RequisitePro. Ahora nos ocuparemos de tres documentos importantes, propuestos por el RUP para una correcta administración de los requerimientos de acuerdo a la pirámide de la Ilustración 1.

LA VISIÓN Este documento describe la aplicación en general incluyendo varias secciones importantes.

En la segunda sección se define el alcance y la declaración del posicionamiento que comprende el análisis del problema, las condiciones del mercado vinculado con el negocio y la propuesta de software a manera de posicionamiento frente a otras soluciones alternativas.

En la tercera sección se identifican, describen y analizan las necesidades de los usuarios y stakeholders del sistema.


33

En la quinta sección se define los requerimientos de alto nivel o rasgos de la aplicación (facilidades o características)

En otras palabras en la Visión se definen, en un nivel alto de abstracción, tanto el problema como la solución. La plantilla de casos de uso trae un documento Visión creado en el paquete Features and Vision y también una Vista denominada All Features.

Ilustración 50: Documento Visión

La siguiente ilustración muestra ejemplos de las declaraciones del problema y del posicionamiento que figuran en la sección 2, del documento visión.

Ilustración 51: Documento Visión‐Declaración del problema y el posicionamiento


34

FACILIDADES Las facilidades son los requerimientos de alto nivel que empiezan a definir el espacio de la solución. Se documentan en la sección 5 del documento Visión. Es posible adicionar el texto de las facilidades libremente y organizarlos en módulos, tal y como se muestra en la siguiente ilustración.

Ilustración 52: Documento Visión – Facilidades

A continuación se mostrará cómo a partir de un texto se puede adicionar un requerimiento (en este ejemplo una facilidad). Primero se debe marcar el contenido de la facilidad con el mouse y luego en la barra de herramientas seleccionar el ícono de creación de requerimientos: New Requirement, tal y como figura en la ilustración 53.


35

Ilustración 53: Creación de un requerimiento a partir de un texto (1)

Inmediatamente aparecerá la pantalla de propiedades de requerimientos con el texto inhibido. En esta pantalla se podrá adicionar el nombre de la Feature nada más. (Ver ilustración 54).

Ilustración 54: Creación de un requerimiento a partir de un texto (2)

Al presionar OK se habrá creado el requerimiento en el documento con estado pendiente. Si se desea modificar el texto, es posible hacerlo, seleccionando cualquier parte del requerimiento con el mouse y luego haciendo click al ícono de propiedades, tal y como se muestra en la ilustración siguiente.

Ilustración 55: Actualización del requerimiento luego de la adición (1)

La ventana de propiedades aparecerá con el campo de texto habilitado y se podrán efectuar los cambios deseados (Ver ilustración 56).


36

Ilustración 56: Actualización de un requerimiento luego de la adición (2)

Es importante señalar que las facilidades, al ser requerimientos de alto nivel, pueden ser tanto funcionales como no funcionales. Por tal motivo tienen un atributo denominado tipo (Type) que permitirá clasificarlos. (Ver ilustración 57).

Ilustración 57: Actualización del tipo de Facilidad

Otro atributo importante de las facilidades es la iteración (Planned Iteration). Como son parte de la solución es preciso planificar en que iteración serán realizadas (Ver ilustración 58).


37

Ilustración 58: Actualización del número de la iteración

REORGANIZACIÓN DE LAS FEATURES

Ilustración 59: Organización de requerimientos en paquetes


38

Es posible que al aumentar el número de facilidades, se desee reorganizarlas en el documento o en el explorador. La ilustración 59 muestra features que no han sido asignadas a sus paquetes. Es posible cambiarlas de lugar seleccionándolas con el mouse y arrastrándolas a la carpeta conveniente. La ilustración 60 muestra features que se han creado después y colocadas entre otras dos, dando un aspecto de que no han sido numeradas adecuadamente.

Ilustración 60: Reorganización de requerimientos (1)

Es posible renumerar requerimientos (en este caso facilidades) accediendo a la opción File/Project Administration/Renumber Requirements…, tal y como se muestra en la siguiente ilustración.



39

A continuación aparecerá un mensaje advirtiendo que los documentos serán alterados.


Al presionar el botón Yes aparecerá una ventana de renumeración de requerimientos con los siguientes campos:

Requirement Type: Tipo de requerimiento a numerar. En este caso son las Features.

Renumber Requirements of this type: Flag que confirma el pedido de renumeración.

Initial Requirement Number: Para indicar el número inicial de numeración del requerimiento. Es 1, por defecto.

Order of Processing: Como un mismo requerimiento podría estar en más un documento (Ver tabla 1) este pequeño formulario muestra él o los requerimientos implicados y su orden de procesamiento. El usuario podrá alterar el orden sugerido si así lo desea.


En la ilustración siguiente se muestra las facilidades luego de haberse ejecutado el proceso de renumeración.


40


ESPECIFICACIONES SUPLEMENTARIAS

Otro documento importante en el que se pueden especificar requerimientos funcionales de uso general (no casos de uso) y requerimientos no funcionales o de calidad es el de Especificación Suplementarias (Supplementary Specification) De igual forma a los documentos de Reglas de Negocio y de la Visión, es preferible crearlo en un paquete apropiado, que en este caso es Supplementary Requirements (creado por la plantilla Use Case del RequisitePro)

Ilustración 65: Creación de la Especificaciones Suplementarias (1)

Al crear el documento con la opción New/Document en el menú emergente activado con el botón derecho del mouse, aparecerá una pantalla como la siguiente: Aquí es importante asegurar que el tipo de Documento sea Supplementary Requirements Specification.

Ilustración 66: Creación de la Especificaciones Suplementarias (2)


41

CREACIÓN DE UNA JERARQUÍA DE REQUERIMIENTOS La naturaleza de los requerimientos no funcionales y de calidad, ameritan que sean documentados de acuerdo a una jerarquía. Para hacer esto aprenderemos a enlazar requerimientos hijos con sus padres en la pestaña Hierarchy de la pantalla de propiedades de requerimientos tal y como se muestra en la Ilustración 67.

Ilustración 67: Jerarquización de requerimientos (1)

Primero crearemos un requerimiento padre que en el ejemplo es el SUPL1 Funcionalidad. Luego crearemos un requerimiento hijo denominado Datos de Seguridad. La relación Padre‐Hijo quedará establecida cuando en la pestaña Hierarchy asociemos el nuevo requerimiento a su padre (SUPL1 Funcionalidad), tal y como se muestra en la ilustración 68. Al hacer esto se habrá creado un nuevo requisito suplementario con el código SUPL1.1 (Ver ilustración 69). Este mismo procedimiento lo podemos repetir para cada categoría de requerimiento no funcional: Usabilidad o Usability (SUPL2), Confiabilidad o Reliability (SUPL3), etc.


42


Ejemplos de una jerarquización se ven en el explorador de la ilustración 69.


De igual forma se puede crear una vista que mostrará la jerarquía tal y como se aprecia en la ilustración 70.


43


ESPECIFICACIONES DE CASOS DE USO

Para la creación de los requisitos de casos de uso se actúa igual que para otros requisitos. Como se ha efectuado antes se ubica primero la carpeta apropiada que corresponde con el paquete Use Cases creado por la plantilla Use Case template del RequisitePro.

Ilustración 71: Paquete Use Cases

Cómo vamos a asociar varios documentos a un caso de uso crearemos un paquete por caso de uso como lo muestran las ilustraciones 72 y73.


44

Ilustración 72: Creación de un paquete para cada caso de uso (1)

Ilustración 73: Creación de un paquete para cada caso de uso (2)

Luego de creada la carpeta UC01‐Registrar Paciente procederemos a crear un documento especificación de caso de uso en dicho paquete, tal y como figura en la ilustración 74. Nótese el nombre del paquete y el tipo de documento (Document Type) seleccionado.

Ilustración 74: Creación de una especificación de caso de uso (1)

Al presionar el botón OK, aparecerá un documento Word con la plantilla de especificación de casos de uso propuesta por el RUP. (Ver ilustración 75).


45


Para personalizar el documento se debe tomar en cuenta la opción de Word: Archivo/Propiedades (File/Properties) y actualizar los campos. Un ejemplo de personalización figura en la ilustración 76.



46

Como ya se vio anteriormente, bastará con presionar la tecla F9 en cada campo para tener el documento personalizado. Ahora se procederá a crea un caso de uso en el documento y en la base de datos del RequisitePro. Se procederá de la siguiente manera:

1. Marcar el texto donde se adicionará el nuevo Caso de Uso 2. Seleccionar el ícono New Requirement para iniciar la creación (Ver ilustración 77). 3. Nombrar el caso de uso en la pantalla de propiedades de requerimientos (Ver ilustración 78) y

presionar OK. 4. Salvar el documento, con el ícono Save Requirement Document para que el caso de uso pase de un

estado pending a ser incorporado en la BD del Requisite Pro (ver ilustración 79). 5. Seleccionar el requerimiento creado con el mouse y presionar el ícono Requirement Properties (Ver

ilustración 80). 6. Actualizar el texto del caso de uso en la pantalla de propiedades de requerimientos (Ver ilustración

81) 7. Verificar el nuevo caso de uso en el explorados (Ver ilustración 82). 8. Activar la vista Use Case Survey, creada automáticamente por la plantilla Use‐Case Template del

RequisitePro y consultar el caso de uso creado (Ver ilustración 82).



47





48



CREACIÓN DE UN DOCUMENTO PROPIO

En la ilustración 19 vimos como se puede crear un tipo de documento que no tiene ninguna plantilla predefinida. En la misma carpeta UC01‐Registrar Paciente, crearemos un documento User Story Specification. Nótese que en el campo Document Type se ha seleccionado este tipo de documento.

Ilustración 83: Creación de una historia de usuario (1)


49

Una vez creado debe aparecer en el explorador como en la ilustración 84.

Ilustración 84: Creación de una historia de usuario (2)

PERSONALIZACIÓN DE CONTENIDOS El documento creado estará totalmente en blanco. No obstante es posible personalizarlo como se ha hecho anteriormente con otros documentos Word (Ver ilustración 85).

Ilustración 85: Personalización de campos en un documento (1)

Word permite adicionar campos predefinidos al documento usando la opción de Menú Insertar/Campos (Insert/Fields). Para establecer un campo como código, de tal manera que se pueda personalizar y usar es necesario presionar el botón Códigos de campo, tal y como se muestra en la ilustración 86.


50


En este ejemplo estamos usando el campo Asunto (Subject) para el nombre del proyecto, el mismo que figurará (previa selección) en la cabecera del documento (Ver ilustraciones 87 y 88).



51

De la misma manera podemos personalizar el nombre del documento utilizando el campo Título (Title) y los demás campos de la ilustración 85. Finalmente podremos tener un documento personalizado y con posibilidades de ser reusado en otros documentos con un copy/paste (Ver ilustraciones 88 y 89).



52


TRAZABILIDAD

Una facilidad importante al administrar los requerimientos en una herramienta de software es la posibilidad de efectuar cruces entre los distintos requerimientos que figuran en la pirámide de la ilustración 1. Esta facilidad es conocida con el nombre de Trazabilidad (Traceability). La trazabilidad permite:

Evaluar el impacto de un cambio en un requisito.

Evaluar el impacto de un fallo de una prueba sobre un requisito.

Administrar el alcance del proyecto.

Verificar que todos los requisitos del sistema son cubiertos por la implementación.

Verificar que la aplicación hace solamente lo que se pretendía que hiciese.

Administrar los cambios. La gestión de requisitos busca:

Trazar las facilidades en requisitos detallados: Features versus Use Cases y Features versus Supplementary Requirements.

Trazar requisitos en el diseño: Es posible que el RequisitePro interactúe con otras herramientas como el Rational Rose y el Microsoft Project.

Trazar requisitos en procedimientos de prueba: Es posible almacenar especificaciones de prueba en el RequisitePro administrando las unidades de prueba como requerimientos tal y como se procedió en el caso de las reglas de negocio.


53

Trazar requisitos en documentación de usuarios y materiales de entrenamiento: Un manual de usuario podría ser creado como un documento nuevo en el RequisitePro.

La plantilla Use‐Case Template del RequisitePro viene con dos carpetas de análisis y varias matrices de trazabilidad creadas que pueden ser actualizadas. Las carpetas de análisis son dos:

Coverage Analysis (Análisis de cubrimiento): En las matrices de esta carpeta se pueden apreciar que requerimientos no están enlazados con otros. Por ejemplo que facilidades no están vinculadas a ningún caso de uso.

Impact Analysis (Análisis de impacto): En estas matrices de trazabilidad se analiza el impacto que podría tener un cambio en un requerimiento sobre otros vinculados.

En la ilustración 90 estamos viendo el caso de la vista Supplementary Reqs Traced To Features, en donde en las filas figuran los diferentes requerimientos suplementarios y en las columnas las facilidades.

Ilustración 90: Trazabilidad (1)

Las formas de trazabilidad que existen están descritas en la Tabla 5:

Tabla 5: Formas de trazabilidad

Trazabilidad DescripciónBackward‐fromtraceability Enlaza los requerimientos con sus fuentes en otros documentos o

personas. Ejemplo: Features con Stakeholders Request

Forward‐fromtraceability

Enlaza los requerimientos con los componentes de diseño e implementación. Ejemplo: Use Case con Sequence Diagram.

Backward‐totraceability

Enlaza componentes de diseño e implementación con sus requerimientos iniciales. Ejemplo: Unit Test con Use Case Specification

Forward‐totraceability Enlaza documentos (especificaciones o SRS) con otros requerimientos importantes. Ejemplo: Use Case con Features en la Visión.

Al hacer click con el botón derecho en una celda de cruce entre dos requerimientos distintos, aparecerá un menú emergente con las opciones de trazabilidad. En este caso escogeremos la opción Trace To. (Ver ilustración 91)


54

Ilustración 91: Trazabilidad (2)

administracion de requerimientos en requisitepro

Documents