Instalacin de la aplicacin

La aplicacin REM la podemos obtener desde la pgina de los profesores Amador

Durn y Beatriz Bernrdez en la universidad de Sevilla (Espaa)
http://www.lsi.us.es/docencia/pagina_asignatura.php?id=48
Nos descargamos el instalador y su manual. Ejecutamos el programa instalador, en
nuestro caso el setup.exe del REM_1_2_2

Pulsamos Next

NOTA IMPORTANTE: Este software es de uso libre dentro del mundo acadmico.
Para su uso fuera de este entorno, por ejemplo en el entorno empresarial, hay que
solicitar permiso al autor, el doctor Amador Durn, tal y como indica su licencia.
Pulsamos Yes

Pulsamos Next

Pulsamos Next

>Nos indica que debido a un fallo en el programa de instalacin se debe editar a

mano un fichero de texto. Pulsamos Aceptar

Pulsamos Finish para finalizar la instalacin. Abrimos el fichero C:\Archivos de

programa\REM_1_2\xml\default\REM_TraceImage.xsl

y quitamos el ltimo carcter (el que aparece marcado), guardando de nuevo el

fichero.

Arranque de la aplicacin
Iniciamos REM

Tras arrancar la aplicacin nos aparece un proyecto en blanco.

Con el panel izquierdo podemos seleccionar cuatro posibles tipos de documentos:

Documento de requisitos del sistema

Documento de anlisis del sistema

Registro de conflictos y defectos

Registro de peticiones de cambio

Lo primero que vamos a hacer es asignarle unas propiedades al proyecto. Pulsamos

con el botn derecho sobre el icono rojo titulado Documento de requerimientos del
sistema

Ahora damos nombre al proyecto y lo guardamos pulsando en Archivo\Guardar

como

Nos quedar una ventana principal como esta:

Un primer vistazo a REM

La herramienta REM trabaja aadiendo nodos a nuestro documento. Basta pulsar
con el botn derecho sobre el icono del libro rojo para obtener un listado de los
elementos que podemos aadir a nuestro documento. Una lista de los elementos
que podemos aadir sera:

secciones y apndices al documento.

Prrafos y elementos de glosario

ficheros grficos. Nos permitir incluir imgenes en nuestro documento

organizacin

participante

reunin

objetivo

actor

requisitos de almacenamiento, funcionales, no funcionales, de restriccin

caso de uso

matriz de rastreabilidad

tipo de objeto, valor, asociacin, operacin de sistema

conflicto, defecto y peticin de cambio

El mtodo de trabajo de la herramienta REM consiste en ir aadiendo estos

elementos a un rbol como nodos del rbol. Una vez aadido un elemento, podemos
editarlo, moverlo a otra posicin, clonarlo o eliminarlo.
Segn vamos aadiendo elementos el panel derecho se va actualizando, para
reflejar el nuevo elemento. Este panel es en realidad una pgina html que queda
guardada junto al fichero del proyecto REM.

El objetivo de REM
La herramienta REM est diseada para facilitar la captura de requisitos utilizando
la metodologa propuesta por los doctores Amador Durn y Beatriz Bernrdez DB01.
Esta metodologa est enfocada a recoger los requisitos de un sistema y construir
un documento, el Documento de anlisis del sistema, que es el documento que se
entrega al cliente para su validacin y posterior desarrollo como producto.
En este tutorial nos vamos a centrar en el mdulo de captura de requisitos de REM,
siendo nuestro objetivo generar el documento de requisitos del sistema.

Tipos de requisitos en REM

En esta herramienta se distinguen los siguientes tipos de requisitos:

Objetivo. No es un requisito en s mismo, pero nos guiar a la hora de fijar los

requisitos

Actor. Cada una de los usuarios que interactan con el sistema

Requisito de almacenamiento de informacin

Requisito de restriccin

Requisito de caso de uso

Requisito funcional

Requisito no funcional

Matriz de rastreabilidad. En estas matrices se puede colocar en filas y columnas

los diferentes requisitos, casos de uso, tipos (clases del modelo), valores (atributos)
y asociaciones, permitiendo por ejemplo relacionar requisitos funcionales con tipos,
para ver qu requisitos funcionales afectan a cada tipo concreto.

Un ejemplo ilustrativo: una librera virtual

Para proceder a la toma de requisitos vamos a imaginar que estamos con un cliente
y que nos encarga desarrollar un sistema informtico para gestionar la librera virtual
que va a lanzar en Internet.
Primero comenzamos analizando su negocio normal, en el que se dedica a la venta
de libros. En sus oficinas tiene el siguiente personal:

vendedores. Son con los que contactan los clientes para realizar los pedidos y

para resolver dudas

despachadores. Son los empleados que preparan los envos para los clientes,

que les han enviado los vendedores

compradores. Son los encargados de realizar las compras a los distribuidores

y editoriales. Tambin mantienen el catlogo de libros en venta.

la direccin, que tiene visibilidad sobre todo el negocio

El proceso general del negocio es el siguiente:

Primero los compradores seleccionan un conjunto de libros y los aaden al catlogo
de libros.
Los clientes visitan el establecimiento y solicitan libros del catlogo. Si el libro no
est en catlogo, el comprador le dir si es posible encargarlo.
Una vez seleccionados los libros, los clientes realizan la compra. Si la entrega no es
inmediata, el cliente se pondr en contacto peridicamente para consultar el estado
de su encargo al vendedor.
Por ltimo la direccin evaluar mensualmente el estado del negocio sacando
estadsticas de compras y ventas.

Captura inicial de requisitos

Ahora nos ponemos manos a la obra. Vamos a empezar a capturar requisitos en
REM.

Lo primero que vamos a hacer es aadir una seccin de introduccin. Para ello
seleccionamos el botn de nueva seccin y le ponemos como nombre Introduccin

Le hemos aadido un prrafo en el que incluimos el texto de lo hablado con el cliente.

Aadiendo organizaciones y participantes

Ahora vamos a aadir dos organizaciones, la organizacin cliente (Libros MN) y un
desarrollador (Autentia). Vamos a aadir un participante a cada organizacin, que
sern el representante del cliente y el desarrollador
Aadimos la organizacin pulsando el botn de aadir organizacin que desarrollar
el proyecto

Cuando hemos aadido las organizaciones podemos en las propiedades del

proyecto aadir la organizacin que prepara el documento y la organizacin cliente

Aadimos el participante desarrollador

y lo marcamos como desarrollador

Repetimos lo mismo con la organizacin del cliente. Al final nos queda:

Aadiendo el objetivo
Ahora le aadimos un objetivo a nuestros requisitos: el sistema deber gestionar
una librera virtual, en la que los clientes pueden realizar y consultar pedidos,
consultar el catlogo de la aplicacin.
Seleccionamos el botn de aadir objetivo y se abre el siguiente dilogo:

Como vemos el sistema lo identifica como OBJ-00001, Le aadimos como nombre

librera virtual y le ponemos la descripcin siguiente:

Ahora la ventana principal ya muestra el objetivo:

Por cada nodo que aadimos al proyecto REM, en el panel de la derecha aparece
una tabla con los campos del nodo.
Examinando los requisitos distinguimos los siguientes actores:

cliente. Es el usuario que va a acceder a la librera desde Internet, para realizar

la consulta del catlogo y comprar libros

vendedor. Son los responsables de hacer el seguimiento de las ventas. Son los

encargados de comunicarse con el cliente

comprador. Son los responsables de hacer las compras de libros y de

confeccionar el catlogo. Tambin son los encargados de hablar con los

distribuidores

despachador. Accede a los pedidos pendientes, los prepara y los enva.

gerente. Solicita informes del sistema, para comprobar la marcha del negocio.

Veamos como hacemos esto con REM. Pulsando con el botn de aadir requisito
funcional vamos aadiendo el primer actor:

Le hemos puesto como nombre cliente. Ahora le aadimos la descripcin.

Al pulsar Aceptar se actualiza el documento REM.

Procedemos a dar de alta el resto de actores.

Con esto nuestro documento ya contiene los actores de nuestra aplicacin

Aadiendo casos de uso

Ahora vamos a buscar los casos de uso. Examinando la descripcin de la aplicacin
vemos los siguientes casos de uso:

Consulta del catlogo de libros. Todos pueden acceder al catlogo

Creacin de un pedido. Lo hace el cliente y el vendedor (en nombre de un

cliente)

Creacin de una solicitud de libro o de informacin. Lo hace el cliente

Consulta de solicitudes de informacin, Lo puede hacer el cliente (las suyas) y

el vendedor (todas)

Consulta de pedidos. Lo puede hacer el cliente (sus pedidos) y el vendedor

(todos los pedidos)

Modificacin del catlogo: Lo hace el comprador

Modificacin de Pedidos, Lo hace el despachador

Consulta del almacn de libros. Lo pueden hacer el comprador y el

despachador.

Modificacin del almacn de libros. Lo puede hacer el despachador

Peticin de informe. Lo hace el gerente.

Veamos como aadimos un caso de uso en REM. Pulsamos en el botn de nuevo

caso de uso:

le ponemos como nombre consulta del catlogo y le aadimos la descripcin:

Y como antes, aadimos los dems casos de uso uno a uno. Finalmente tendremos
en el documento todos los casos de uso.

Aadiendo los requisitos funcionales

Los requisitos funcionales definen las acciones que debe realizar el sistema. Si
analizamos la aplicacin de librera podemos extraer los siguientes requisitos:

se presentar una pantalla inicial que servir de entrada a la aplicacin. Tendr

un cajetn al lado izquierdo para que el usuario pueda iniciar sesin.

La pantalla inicial mostrar informacin de los libros ms vendidos, de las

ofertas del mes y de noticias del sector.

La pantalla de consulta del catlogo mostrar el conjunto de criterios de

bsqueda (autor, ttulo, isbn, etc.), realizar una bsqueda exacta o por texto libre
en los campos del libro y devolver los resultados paginados

Cuando el usuario se seleccione un libro, se aadir al carrito de la compra

la pantalla carrito de la compra mostrar los libros seleccionados y permitir

formalizar el pedido (orden de pago, etc.)

la pantalla de solicitud de informacin permitir al usuario solicitar nuevos libros

no disponibles en el catlogo o preguntar sobre temas relacionados con los libros.

La pantalla de consulta de pedidos permitir al cliente visualizar el estado de

sus pedidos

Habr una pantalla de consulta de solicitudes de informacin, usada por el

vendedor para atender las peticiones del cliente

Habr una pantalla de despacho del pedido, para poder atender las labores de

despachado, como son indicar si se ha enviado el pedido, el modo de envo, etc.

La pantalla de modificacin del catlogo permitir aadir nuevos libros

disponibles al catlogo, eliminar los antiguos, etc.

La pantalla de modificacin del almacn permitir controlar el almacn de libros

(consultas, altas, bajas, modificaciones)

La pantalla de generacin de informes calcula el informe correspondiente al

ltimo mes.
Veamos como hacemos esto con REM. Pulsando con el botn de aadir requisito
funcional vamos aadiendo el primer requisito:

y le ponemos la descripcin

Aadimos el resto de requisitos funcionales. Nos quedar algo como:

Aadiendo requisitos no funcionales

Los requisitos no funcionales son otros requisitos que no forman parte de la
funcionalidad principal de la aplicacin, como requisitos del entorno de desarrollo o
ejecucin (sistema operativo, servidores en los que correr, lenguajes, etc),
restricciones que se aplicarn, prestaciones (tiempo de respuesta mnimo, alta
disponibilidad, etc.) y otros. Vamos a seleccionar algunos como ejemplo para
nuestra aplicacin:

La aplicacin correr en el entorno Linux Tomcat Struts Hybernate

MySql.

Se definir un libro de estilo y una hoja de estilo para la interfaz, basada

fundamentalmente en pginas HTML.

Se usar Flash para los anuncios destacados: el banner principal y los de

ofertas y promociones. El cdigo del flash sustituir la imagen flash por una fija si no
est disponible flash
Veamos como hacemos esto con REM. Pulsando con el botn de aadir requisito
funcional vamos aadiendo el primer requisito no funcional:

Aadiendo requisitos de almacenamiento de

informacin
Veamos como hacemos esto con REM. Pulsando con el botn de aadir requisito
funcional vamos aadiendo el primer requisito de informacin:

clientes dados de alta

libro del catlogo

pedido realizado

libro disponible

solicitud de informacin realizada por un cliente

Veamos como hacemos esto en REM. Creamos un nuevo requisito de informacin

y le aadimos los detalles

Rellenamos el resto de requisitos de informacin, obteniendo

Aadiendo requisitos de restriccin

Los requisitos de restriccin representarn las reglas de negocio que se deben
definir en la aplicacin. En nuestro caso podemos definir las siguientes:

no se pueden despachar pedidos cuyo pago no se haya formalizado

cuando se despacha un libro se debe actualizar el almacn. En este momento

se revisar el stock mnimo definido en el catlogo y se avisar a compras para su

reposicin (control de stock estndar).

si un pedido solicitado por un cliente no se despacha en menos de 15 das, el

vendedor debe investigar la causa e informar al cliente

Veamos cmo aadimos esto en REM. Aadimos un requisito de restriccin a
nuestro documento con el botn apropiado

y le aadimos los detalles

continuamos con el resto de restricciones. Nos quedar como sigue

Creando una matriz de rastreabilidad

Las matrices de rastreabilidad nos permitirn trazar las dependencias entre los
diferentes elementos del documento de requisitos. Pun ejemplo tpico es ver qu
requisitos funcionales tienen incidencia sobre los elementos de informacin
almacenados. Creamos una matriz de rastreabilidad con el correspondiente botn

le aadimos como filas los requisitos funcionales y como columnas los requisitos de
informacin que hay que guardar

nos aparece una matriz en blanco

Ahora nos vamos a un requisito de informacin y le aadimos una traza. Por ejemplo
la pantalla inicial consulta el catlogo. Abrimos el requisito de consulta de catlogo
y le aadimos la traza de destino siguiente

nos queda

y ahora la matriz se actualiza

Ahora slo falta completar el resto de las trazas de nuestro proyecto.

Organizando los requisitos: el modelo esttico y el

dinmico
Lo normal en la mayora de los proyectos es organizar el documento de requisitos
en varias partes diferentes, como puede ser los requisitos generales, el modelo
esttico y el modelo dinmico. Tambin si vamos a crear un prototipo conviene crear
un captulo especfico. Para nuestro ejemplo he creado las secciones 2. Modelo
esttico, 2.1 Actores, 2.2 Casos de uso, 2.3 Requisitos funcionales, 2.4
Requisitos no funcionales y 3 Modelo dinmico, y he reorganizado todos los
elementos en las nuevas secciones. Me queda algo como lo siguiente

Utilizando adecuadamente las secciones de REM nos puede quedar un documento

de proyecto bastante clarito.

El siguiente paso: el anlisis

Una vez que hemos terminado el anlisis de requisitos, al menos inicialmente, hay
que comenzar la etapa de anlisis del sistema. REM permite crear un documento de
anlisis del sistema, en el que reflejaremos los tipos de objetos, valores, operaciones
del sistema y otros. Incluso nos permite crear un documento de defectos y otro de
peticiones de cambio. Aunque es sencillo de utilizar, no ofrece la potencia de un
sistema de modelado de los disponibles en la actualidad. Pero nos puede servir de
ayuda para el comienzo del anlisis, sobre todo por la posibilidad de crear matrices
de trazabilidad para los tipos de objetos y operaciones del sistema.

Ampliando REM

Puede que REM no genere exactamente el documento de salida que nosotros

necesitamos. Ya que REM trabaja aplicando transformaciones XSLT sobre el rbol
XML que guarda en memoria. REM permite elegir otro juego de plantillas XSLT para
modificar el resultado final. Para ello debemos abrir el cuadro de dilogo en
Herramientas\Opciones y cambiar la opcin archivo externo XSLT

por defecto apunta a la plantilla en espaol que trae el propio REM, en la carpeta
donde lo hayamos instalado. All veremos un conjunto de ficheros XSL, uno por cada
tipo de nodo que procesa REM. En el manual de REM se dan ejemplos, aunque no
se proporcionan los ficheros de transformacin.

Bibliografa

DB01 Metodologa para el anlisis de requisitos para sistemas software.

Amador Durn, Beatriz Bernrdez. Departamento de lenguajes y sistemas

informticos. Escuela tcnica superior de ingeniera informtica. Universidad de
Sevilla (Espaa). 2001.

Conclusin
REM es una herramienta que nos facilitar la toma de requisitos en nuestra
aplicacin. Nos permitir de un modo sencillo generar un documento normalizado
en el que podremos incluir los requisitos necesarios para el desarrollo de un sistema
de informacin. Su uso es bastante sencillo, y la documentacin la genera en
formato HTML, por lo que lo podremos utilizar directamente como documentacin
de referencia en nuestro proyecto.