Requerimientos (Como Redactar) PDF

Procesos del Desarrollo de Software – 3º Grado en Ingeniería Informática
Cómo redactar requisitos
Curso 2010-2011
José Miguel Fuentes
Cómo redactar requisitos 1
Índice
• La importancia del requisito en el ciclo de vida de desarrollo de software
• Cómo debería ser una especificación de requisitos
• Estructura de la especificación
• Especificaciones completas
• Especificaciones consistentes
• Una especificación de requisitos no es una novela
• Redacción del requisito
• Ejemplos
• Referencias

La importancia del requisito
Current situation in sw. development
Factores de éxito % de respuestas Basados en requisitos

1. User Involvement 15.9%
15.9%
2. Executive Management Support 13.9%
3. Clear Statement of Requirements 13.0%
13.0%
4. Proper Planning 9.6%
5. Realistic Expectations 8.2%
8.2 %
6. Smaller Project Milestones 7.7%
7. Competent Staff 7.2%
8. Ownership 5.3%
9. Clear Vision & Objectives 2.9 %
2.9%
10. Hard-Working, Focused Staff 2.4%
Other 13.9%
40% relacionados
con requisitos
La importancia del requisito
• Cuanto antes… mejor!!
– No hay que esperar hasta las pruebas de aceptación para determinar si
hemos omitido algo o hemos entendido mal a un interesado
– Aplicar revisiones y técnicas para detectar requisitos de baja calidad lo
antes posible
Cómo debería ser una especificación de requisitos

• Completa: describe todas las necesidades relevantes para los
stakeholders
• Consistente: carece de conflictos entre requisitos
• Correcta: todo es pertinente y no contiene errores
• Modificable: facilidad para efectuar cambios de forma sencilla,
completa y consistente
• Verificable: existencia de un proceso acotado que determine si
el sistema final satisface el requisito
• Trazable: el origen del requisito está marcado de forma clara; y
se puede seguir el impacto del requisito a lo largo del SDLC
• Clara y no ambigua: una única interpretación
IEEE 830, 1998

Cómo debería ser una especificación de requisitos
Sigla Concepto Descripción

S eSpecífico Claros y simples: qué, por qué…
M Medible Se puede cuantificar y evaluar
A Alineado Con la estrategia o con el fin del sistema
R Realista Puede conseguirse con un número de recursos lógico
T limitado en Establece un periodo de tiempo claro
Tiempo
"I believe that this nation should

commit itself to achieving the goal,
before this decade is out, of landing
a man on the Moon and returning
him safely to Earth"
Estructura de la especificación
• Un proyecto mediano puede tener centenares de requisitos
• Estos requisitos no se escriben y se olvidan:
– Pueden ser firmados, con lo que son pieza clave en contratos
– Son la fuente del diseño
– Se verificará el software contra ellos
• La correcta organización de los mismos es vital
• Claves:
– Utiliza estándares de estructuración de especificaciones de requisitos
– Aclara el objetivo global a cumplir por el sistema
– Emplea descripciones textuales y gráficas
– Ordena y agrupa tus requisitos de forma lógica
– Relaciona unos requisitos con otros para facilitar su entendimiento
– Relaciona los requisitos con otros activos

Especificaciones completas
• ¿Qué podemos hacer para no olvidar nada…
– Revisión por pares: junto con compañeros más experimentados, expertos
en la materia, cliente y otros interesados
– Emplear check-lists
– Comparar la especificación contra taxonomías propias de la materia
– Reutilizar requisitos de proyectos previos
• Reutilización de grano grueso: componentes reutilizables
• Reutilización de grano fino: buscadores avanzados
Especificaciones consistentes
• El primer paso hacia la consistencia es evitar redundancia…
• … y las inconsistencias provocan retrabajo
• Las revisiones en grupo permiten detectar parte de estas
redundancias
• Técnicas automáticas para su apoyo:
– Comparación de grafos semánticos
– Detección de unidades inconsistentes

• Comparación de grafos semánticos:
UR001: ….
UR023: El sistema deberá enviar notificaciones semanales de nuestras
ofertas a todos los clientes
URxxx: …
UR842: La aplicación debe ser capaz de notificar periódicamente a sus
clientes sobre nuestras ofertas
UR999: …
• Detección de unidades inconsistentes:
• “NASA y ESA reconoces la pérdida de una sonda marciana por haber
diseñado dos módulos empleando diferentes sistemas de medida”
• Revisiones globales de la especificación
• Detección automática de unidades inconsistentes

Comparativa: Novela vs. Requisito
Múltiples estilos narrativos:

Ficción
Histórica
Científica
Cómica
…
Múltiples estilos narrativos
Nos deben contar una historia real

Creíble por todos los interesados
El autor no debe expresar su punto de vista, sino

la situación real
Capaz de ser diseñada, implementada, probada,
implantada, mantenida…

Abiertas a todo tipo de licencias poéticas y

adornos:
“Generalmente se viste de manera victoriana,
incluyendo un traje, botas de montar, y una ostentosa
corbata de moño intrincadamente atada, …”
Abiertas a todo tipo de licencias poéticas y adornos
Licencias poéticas las mínimas

Textos simples y claros para facilitar su lectura y
entendimiento
Siguiendo un conjunto de gramáticas fijas y simples
Usando la voz activa en lugar del pasivo
Evitando terminología técnica, abreviaturas …
Utilizando un vocabulario controlado, donde los términos

estén bien consensuados
Prescindiendo de especulaciones

Intentan contarnos la totalidad de la historia:

Qué ocurre

Por qué ocurre

Cómo se desenlaza la trama
Intentan contarnos la totalidad de la historia
Sólo nos deben contar parte de la historia

Centrándose en el qué, e incluso, en el por
qué
Nunca debe tratar el cómo
Debe evitarse terminología propia de diseño,

pseudocódigo…

Suelen jugar con nuestra imaginación:

“…la verdad es que Robert parecía mayor, no
aparentaba los 32 años que tenía.”
“Podía verse el fuego desde la distancia…”
“… triangular, a veces largamente triangular, reticulado,

con largos dientes en el margen y con un tejido grueso
…”
Suelen jugar con nuestra imaginación
No pueden jugar con nuestra imaginación

Todos los requisitos, además de simples, deben
ser fáciles de medir
Ambigüedad cero, para que todos los
interesados interpretemos cada requisito de una
única forma

A menudo, pueden hacer referencias a otros textos:

Otros tomos de la novela
Situaciones de otras novelas del autor, o personajes de otras

novelas
Al conocimiento general que se supone a nuestros lectores
…
A menudo, hacen referencias a otros textos
No deben dar ningún conocimiento por sentado

Deben ser autocontenidos
En el mejor de los casos, acompañados incluso de

glosarios

Pueden mezclar diferentes hilos de argumento
Pueden mezclar diferentes hilos de argumento
Cada requisito debe ser atómico

Una única necesidad por requisito
Orden lógico de interpretación

Se redactan con maravillosos procesadores de

texto
Se redactan con maravillosos procesadores de

texto
Deben escribirse con herramientas

especializadas en estos fines
Con ello conseguimos:
Identificarlos unívocamente
Atomizarlos
Organizarlos, categorizarlos y relacionarlos
Reutilizarlos por separado o en conjunto
Medir su calidad individual o global

Redacción del requisito
• Claridad y ambigüedad:
– ¿Puede medirse de forma clara y no ambigua la claridad y ambigüedad
de un requisito?
– “En casa del herrero… cuchillo de palo”

• Emplear la estructura correcta:
Usuario El operador del Call Center…

Acción … deberá ser capaz de ver…
Objeto … detalles de cada compañía contactada…
Cualificador … en menos de dos segundos.

• Tamaño del requisito:
– El justo, ni muy breve ni muy largo
– Tamaño medido en caracteres, palabras, párrafos
• Legibilidad:
– La máxima posible
– Procesadores como MS Word miden la legibilidad de los textos
• Tiempo verbal:
– Imperativo en lugar de condicional
• Modo verbal:
– Activa en lugar de pasiva
• Sentencias opcionales y especulativas:
– Evitar sentencias del estilo “quizá…” , “posiblemente…”, “usualmente…”, “casi siempre…”
• Expresiones ambiguas:
– Evitar expresiones del estilo: “rápido”, “amigable”…

• Sentencias subjetivas:
– Evitar sentencias del tipo: “yo creo…”, “en mi opinión…”
• Sentencias implícitas (empleo de pronombres):
– Evitar el abuso de los pronombres
– A la hora de la lectura, podríamos dudar en qué nombre sustituye cada nombre
• Conectores:
– El abuso de conectores puede indicar que se está incluyendo más de una necesidad en el
mismo requisito
– También puede indicar un exceso de detalle
• Negaciones:
– Más de una palabra negativa en la misma frase podría hacerla difícil de entender
• Sentencias incompletas:
– Evitar sentencias del tipo “etcétera…”, “…entre otros…”, “…”
• Términos propios de diseño o de flujo:
– Evitar términos que denotan diseño como por ejemplo “clave ajena”, “tabla hash”…

• Número de términos del dominio:
– Un exceso de términos del dominio puede indicar que se están mezclando diferentes
necesidades en el mismo requisito
– También puede indicar que se está dando un excesivo detalle
• Número de verbos principales (del dominio):
– Un exceso de verbos del dominio puede indicar que se están mezclando diferentes
necesidades en el mismo requisito
– También puede indicar que se está dando un excesivo detalle
• Acrónimos y abreviaturas:
– Sólo permitidos si están definidos en alguna sección del documento de requisitos
Ejemplo 1
• La información sobre los metadatos de los usuarios debería
almacenarse en memoria dentro de una tabla hash, o bien en
una tabla de base de datos, con una clave ajena a la tabla de
Usuarios

Ejemplo 1
• La información sobre los metadatos de los usuarios debería
Usuarios
– Evite el uso del tiempo condicional
– Sustitúyalo por el imperativo
• La información sobre los metadatos de los usuarios deberá
Usuarios
Ejemplo 1

Ejemplo 2
• El administrador deberá ser capaz de insertar, borrar, mostrar y
actualizar la información sobre los usuarios. Opcionalmente,
deberá también ser capaz de generar un informe y enviarlo por
e-mail al cliente
Ejemplo 2
actualizar la información sobre los usuarios. Opcionalmente,
deberá también ser capaz de generar un informe y enviarlo por
e-mail al cliente
– La opcionalidad debe expresarse mediante un atributo, y nunca como

texto dentro del requisito

Ejemplo 2

actualizar la información sobre los usuarios. Opcionalmente, deberá
también ser capaz de generar un informe y enviarlo por e-mail al
cliente
– La opcionalidad debe expresarse mediante un atributo, y nunca como texto

dentro del requisito
– Deberá usar un requisito individual para cada necesidad. Muchos verbos
concentrados en un requisito pueden implicar la mezcla de diferentes
necesidades
• El Administrador deberá ser capaz de añadir usuarios

• El Administrador deberá ser capaz de borrar usuarios
• El Administrador deberá ser capaz de mostrar usuarios
• El Administrador deberá ser capaz de actualizar usuarios
• El Administrador podrá generar un informe para enviarlo por e-mail al
cliente
Ejemplo 3
• El sistema debe ser capaz de importar ficheros ABC. El proceso
debe ser amigable y rápido para el usuario

Ejemplo 3
– Términos como ‘amigable’ y ‘rápido’ son difíciles de medir y, por lo tanto,

imposible de probar de forma correcta
– Utilice unidades físicas para medir cómo de rápido debe rendir un
requisito
– Utilice otros medios (p.e. WAI AA) claramente definidos para indicar cómo
de amigable o accesible debe ser un sistema
Ejemplo 3
– Términos como ‘amigable’ y ‘rápido’ son difíciles de medir y, por lo tanto,

imposible de probar de forma correcta
– Utilice unidades físicas para medir cómo de rápido debe rendir un
requisito
– Utilice otros medios (p.e. WAI AA) claramente definidos para indicar cómo
de amigable o accesible debe ser un sistema
– Utilice acrónimos sólo cuando estén comúnmente aceptados por todos los
interesados

Ejemplo 4
• El administrador deberá ser capaz de crear facturas asociadas
con las diferentes compañías que estén dadas de alta en el
sistema y éste también deberá estar al tanto de facturas
impagas para que puedan generar un mail y enviárselos a ellos
Ejemplo 4
impagas para que puedan generar un mail y enviárselos a ellos
– El uso apropiado de signos de puntuación hará los requisitos más fáciles
de leer
– El número de sílabas por palabra y palabras por frase es también un buen
indicador de la legibilidad del requisito

sistema. Éste también deberá estar al tanto de facturas impagas
para que puedan generar un mail in enviárselos a ellos

Ejemplo 4
impagas para que puedan generar un mail y enviárselo a ellos
– El exceso de pronombres puede hacer un requisito difícil de entender

– El último ‘ellos’, ¿se refiere al administrador o al cliente?
impagas para que puedan generar un mail in enviárselo a los
clientes
Ejemplo 4

sistema y éste también deberá estar al tanto de facturas impagas
para que puedan generar un mail y enviárselos a ellos.
El proceso para localizar impagados es el siguiente:
1. Iterar sobre todas las facturas
2. Si Fecha_Factura + CondicionesPago es mayor que la fecha actual,
entonces:
• Si la categoría del cliente es A, entonces se le deja un mes extra
• SI no, mientras la factura no esté pagada no se le permite generar nuevas facturas y se
le enviará un mail cada semana
– Evite el uso de pseudocódigo en sus requisitos

– Los requisitos extensos (en caracteres o párrafos) pueden indicar baja
calidad

Ejemplo 5
• Los clientes podrán remitir órdenes por Internet. Estas órdenes
deben incluir fecha de envío y cantidad de artículos.
Una vez que se recibe la orden, el equipo de empaquetado debe
recoger todos los artículos y enviar un mail al cliente.
Deben soportarse los protocolos http y https, así como los
navegadores Explorer y Firefox. La resolución mínima será de
1024x768
Ejemplo 5
• Los clientes podrán remitir órdenes por Internet. Estas órdenes

deben incluir fecha de envío y cantidad de artículos.
Una vez que se recibe la orden, el equipo de empaquetado debe
recoger todos los artículos y enviar un mail al cliente.
Deben soportarse los protocolos http y https, así como los
navegadores Explorer y Firefox. La resolución mínima será de
1024x768
– Un exceso de términos diferentes en el mismo requisito puede indicar:

• Que se están mezclando diferentes necesidades en un único requisito
• Que se está proporcionando demasiado detalle
– Igualmente, muchos verbos pueden involucrar diferentes necesidades
mezcladas en un único requisito
Ejemplo 6
• En mi opinión, ningún cliente debería poder nunca enviar
órdenes al equipo de empaquetado. Ya lo hicimos así en un
proyecto hace tres años y el resultado fue nefasto
Ejemplo 6
– No haga explícita su opinión, limítese a escribir lo que el sistema debe

hacer

Ejemplo 6

hacer
– No mezcle demasiados términos negativos, ya que a veces puede
dificultar la lectura del requisito/restricción
Ejemplo 6


hacer
– No mezcle demasiados términos negativos, ya que a veces puede dificultar
la lectura del requisito/restricción
– No divague al redactar el requisito. Limítese a indicar qué es lo que debe
hacer el sistema
• Un cliente no podrá enviar órdenes directamente al equipo de

empaquetado
Ejemplo 7
• Generalmente, el sistema debe ser capaz de terminar el proceso
de rastreo sin sobrecargar excesivamente el servidor
Ejemplo 7
– Evite expresiones vagas como: ‘generalmente’, ‘comúnmente’

Ejemplo 7
– Evite expresiones vagas como: ‘generalmente’, ‘comúnmente’

– Verifique si cada aserción puede ser medida de forma sencilla
• El sistema debe ser capaz de terminar el proceso de rastreo en

un tiempo inferior a 2 segundos y sin que el proceso sobrepase
los 250 MB de memoria
Referencias
• Writing better requirements:
– Ian F. Alexander & Richard Stevens
– Addison-Wesley, 2002

Requerimientos (Como Redactar) PDF

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Requerimientos (Como Redactar) PDF

Cargado por

Copyright:

Formatos disponibles

Procesos del Desarrollo de Software – 3º Grado en Ingeniería Informática

Cómo redactar requisitos

José Miguel Fuentes

Cómo redactar requisitos 1

Cómo redactar requisitos 2

Cómo redactar requisitos 3

Current situation in sw. development

Factores de éxito % de respuestas Basados en requisitos

Cómo redactar requisitos 5

Cómo debería ser una especificación de requisitos

IEEE 830, 1998

Sigla Concepto Descripción

"I believe that this nation should

Cómo redactar requisitos 7

Cómo redactar requisitos 8

Cómo redactar requisitos 9

Cómo redactar requisitos 10

Cómo redactar requisitos 11

Cómo redactar requisitos 12

 Múltiples estilos narrativos:

Cómo redactar requisitos 13

Comparativa: Novela vs. Requisito

 Múltiples estilos narrativos

 Nos deben contar una historia real

 El autor no debe expresar su punto de vista, sino

Cómo redactar requisitos 14

 Abiertas a todo tipo de licencias poéticas y

Cómo redactar requisitos 15

Comparativa: Novela vs. Requisito

 Abiertas a todo tipo de licencias poéticas y adornos

 Licencias poéticas las mínimas

 Usando la voz activa en lugar del pasivo

 Evitando terminología técnica, abreviaturas …

 Utilizando un vocabulario controlado, donde los términos

Cómo redactar requisitos 16

 Intentan contarnos la totalidad de la historia:

 Por qué ocurre

Cómo redactar requisitos 17

Comparativa: Novela vs. Requisito

 Intentan contarnos la totalidad de la historia

Sólo nos deben contar parte de la historia

 Debe evitarse terminología propia de diseño,

Cómo redactar requisitos 18

 Suelen jugar con nuestra imaginación:

 “… triangular, a veces largamente triangular, reticulado,

Cómo redactar requisitos 19

Comparativa: Novela vs. Requisito

 Suelen jugar con nuestra imaginación

 No pueden jugar con nuestra imaginación

Cómo redactar requisitos 20

 A menudo, pueden hacer referencias a otros textos:

Situaciones de otras novelas del autor, o personajes de otras

Cómo redactar requisitos 21

Comparativa: Novela vs. Requisito

 A menudo, hacen referencias a otros textos

No deben dar ningún conocimiento por sentado

 En el mejor de los casos, acompañados incluso de

Cómo redactar requisitos 22

 Pueden mezclar diferentes hilos de argumento

Cómo redactar requisitos 23

Comparativa: Novela vs. Requisito

 Pueden mezclar diferentes hilos de argumento

 Cada requisito debe ser atómico

Múltiples estilos narrativos:

Múltiples estilos narrativos

Nos deben contar una historia real

El autor no debe expresar su punto de vista, sino

Abiertas a todo tipo de licencias poéticas y

Abiertas a todo tipo de licencias poéticas y adornos

Licencias poéticas las mínimas

Usando la voz activa en lugar del pasivo

Evitando terminología técnica, abreviaturas …

Utilizando un vocabulario controlado, donde los términos

Intentan contarnos la totalidad de la historia:

Por qué ocurre

Intentan contarnos la totalidad de la historia

Sólo nos deben contar parte de la historia

Debe evitarse terminología propia de diseño,

Suelen jugar con nuestra imaginación:

“… triangular, a veces largamente triangular, reticulado,

Suelen jugar con nuestra imaginación

No pueden jugar con nuestra imaginación

A menudo, pueden hacer referencias a otros textos:

Situaciones de otras novelas del autor, o personajes de otras

A menudo, hacen referencias a otros textos

No deben dar ningún conocimiento por sentado

En el mejor de los casos, acompañados incluso de

Pueden mezclar diferentes hilos de argumento

Pueden mezclar diferentes hilos de argumento

Cada requisito debe ser atómico

Orden lógico de interpretación

Se redactan con maravillosos procesadores de

Se redactan con maravillosos procesadores de

Deben escribirse con herramientas

Organizarlos, categorizarlos y relacionarlos

Reutilizarlos por separado o en conjunto

Medir su calidad individual o global