Especificación de Requisitos según el estándar
de IEEE 830
IEEE Std. 830-1998
22 de Octubre de 2008
Resumen
Este documento presenta, en castellano, el formato de Especifica-
ción de Requisitos Software (ERS) según la última versión del estándar
IEEE 830. Según IEEE, un buen Documento de Requisitos, pese a no
ser obligatorio que siga estrictamente la organización y el formato da-
dos en el estándar 830, sı deberá incluir, de una forma o de otra, toda
la información presentada en dicho estándar. El estándar de IEEE
830 no está libre de defectos ni de prejuicios, y por ello ha sido jus-
tamente criticado por múltiples autores y desde múltiples puntos de
vista, llegándose a cuestionar incluso si es realmente un estándar en el
sentido habitual que tiene el término en otras ingenierıas. El presente
documento no pretende pronunciarse ni a favor ni en contra de unos u
otros: tan sólo reproduce, con propósitos fundamentalmente docentes,
cómo se organizarıa un Documento de Requisitos según el estándar
IEEE 830.
ÍNDICE
2
Índice
1. Introducción
3
1.1. Propósito . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2. ´Ambito del Sistema . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3. Definiciones, Acrónimos y Abreviaturas . . . . . . . . . . . . . 3
1.4. Referencias . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.5. Visión General del Documento . . . . . . . . . . . . . . . . . . 4
2. Descripción General
4
2.1. Perspectiva del Producto . . . . . . . . . . . . . . . . . . . . . 4
2.2. Funciones del Producto . . . . . . . . . . . . . . . . . . . . . . 4
2.3. Caracterısticas de los Usuarios . . . . . . . . . . . . . . . . . . 5
2.4. Restricciones . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.5. Suposiciones y Dependencias . . . . . . . . . . . . . . . . . . . 5
2.6. Requisitos Futuros . . . . . . . . . . . . . . . . . . . . . . . . 6
3. Requisitos Espec´ıficos
6
3.1. Interfaces Externas . . . . . . . . . . . . . . . . . . . . . . . . 7
3.2. Funciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.3. Requisitos de Rendimiento . . . . . . . . . . . . . . . . . . . . 9
3.4. Restricciones de Dise˜no . . . . . . . . . . . . . . . . . . . . . . 9
3.5. Atributos del Sistema . . . . . . . . . . . . . . . . . . . . . . . 9
3.6. Otros Requisitos . . . . . . . . . . . . . . . . . . . . . . . . . 9
4. Apéndices
9
1 INTRODUCCI ´ON
3
1. Introducción
En esta sección se proporcionará una introducción a todo el documento de
Especificación de Requisitos Software(ERS). Consta de varias subsecciones:
propósito, ambito del sistema, definiciones, referencias y visión general del
documento.
1.1. Propósito
En esta subsección se definirá el propósito del documento ERS y se espe-
cificará a quién va dirigido el documento.
1.2.´Ambito del Sistema
En esta subsección:
Se podrá dar un nombre al futuro sistema (p.ej. MiSistema)
Se explicará lo que el sistema hará y lo que no hará.
Se describirán los beneficios, objetivos y metas que se espera alcanzar
con el futuro sistema.
Se referenciarán todos aquellos documentos de nivel superior (p.e. en In-
genierıa de Sistemas, que incluyen Hardware y Software, deberıa man-
tenerse la consistencia con el documento de especificación de requisitos
globales del sistema, si existe).
1.3. Definiciones, Acrónimos y Abreviaturas
En esta subsección se definirán todos los términos, acrónimos y abrevia-
turas utilizadas en la ERS.
1.4. Referencias
En esta subsección se mostrará una lista completa de todos los documen-
tos referenciados en la ERS.
2 DESCRIPCI ´ON GENERAL
4
1.5. Visión General del Documento
Esta subsección describe brevemente los contenidos y la organización del
resto de la ERS.
2. Descripción General
En esta sección se describen todos aquellos factores que afectan al pro-
ducto y a sus requisitos. No se describen los requisitos, sino su contexto. Esto
permitirá definir con detalle los requisitos en la sección 3, haciendo que sean
más fáciles de entender.
Normalmente, esta sección consta de las siguientes subsecciones: Pers-
pectiva del producto, funciones del producto, caracterısticas de los usuarios,
restricciones, factores que se asumen y futuros requisitos.
2.1. Perspectiva del Producto
Esta subsección debe relacionar el futuro sistema (producto software) con
otros productos. Si el producto es totalemente independiente de otros pro-
ductos, también debe especificarse aquı. Si la ERS define un producto que
es parte de un sistema mayor, esta subsección relacionará los requisitos del
sistema mayor con la funcionalidad del producto descrito en la ERS, y se
identificarán las interfaces entre el producto mayor y el producto aquı des-
crito. Se recomienda utilizar diagramas de bloques.
2.2. Funciones del Producto
En esta subsección de la ERS se mostrará un resumen, a grandes rasgos,
de las funciones del futuro sistema. Por ejemplo, en una ERS para un pro-
grama de contabilidad, esta subsección mostrará que el sistema soportará el
mantenimiento de cuentas, mostrará el estado de las cuentas y facilitará la
facturación, sin mencionar el enorme detalle que cada una de estas funciones
requiere.
Las funciones deberán mostrarse de forma organizada, y pueden utili-
zarse gráficos, siempre y cuando dichos gráficos reflejen las relaciones entre
funciones y no el dise˜no del sistema.
2 DESCRIPCI ´ON GENERAL
5
2.3. Caracter´ısticas de los Usuarios
Esta subsección describirá las caracterısticas generales de los usuarios del
producto, incluyendo nivel educacional, experiencia y experiencia técnica.
2.4. Restricciones
Esta subsección describirá aquellas limitaciones que se imponen sobre los
desarrolladores del producto
Polıticas de la empresa
Limitaciones del hardware
Interfaces con otras aplicaciones
Operaciones paralelas
Funciones de auditorıa
Funciones de control
Lenguaje(s) de programacion
Protocolos de comunicación
Requisitos de habilidad
Criticalidad de la aplicación
Consideraciones acerca de la seguridad
2.5. Suposiciones y Dependencias
Esta subsección de la ERS describirá aquellos factores que, si cambian,
pueden afectar a los requisitos. Por ejemplo, los requisitos pueden presu-
poner una cierta organización de ciertas unidades de la empresa, o pueden
presuponer que el sistema correrá sobre cierto sistema operativo. Si cambian
dichos detalles en la organización de la empresa, o si cambian ciertos detalles
técnicos, como el sistema operativo, puede ser necesario revisar y cambiar los
requisitos.
3 REQUISITOS ESPECÍFICOS
6
2.6. Requisitos Futuros
Esta subsección esbozará futuras mejoras al sistema, que podrán anali-
zarse e implementarse en un futuro.
3. Requisitos Espec´ıficos
Esta sección contiene los requisitos a un nivel de detalle suficiente como
para permitir a los dise˜nadores dise˜nar un sistema que satisfaga estos requi-
sitos, y que permita al equipo de pruebas planificar y realizar las pruebas que
demuestren si el sistema satisface, o no, los requisitos. Todo requisito aquı es-
pecificado describirá comportamientos externos del sistema, perceptibles por
parte de los usuarios, operadores y otros sistemas. Esta es la sección más
larga e importante de la ERS. Deberán aplicarse los siguientes principios:
El documento deberıa ser perfectamente legible por personas de muy
distintas formaciones e intereses.
Deberán referenciarse aquellos documentos relevantes que poseen algu-
na influencia sobre los requisitos.
Todo requisito deberá ser unıvocamente identificable mediante algún
código o sistema de numeración adecuado.
Lo ideal, aunque en la práctica no siempre realizable, es que los requi-
sitos posean las siguientes caracterısticas:
• Correccion: La ERS es correcta si y sólo si todo requisito que
figura aquı (y que será implementado en el sistema) refleja alguna
necesidad real. La corrección de la ERS implica que el sistema
implementado será el sistema deseado.
• No ambiguos: Cada requisito tiene una sola interpretación. Para
eliminar la ambigüedad inherente a los requisitos expresados en
lenguaje natural, se deberán utilizar gráficos o notaciones forma-
les. En el caso de utilizar términos que, habitualmente, poseen más
de una interpretación, se definirán con precisión en el glosario.
• Completos: Todos los requisitos relevantes han sido incluidos en
la ERS. Conviene incluir todas las posibles respuestas del sistema
a los datos de entrada, tanto válidos como no válidos.
3 REQUISITOS ESPECÍFICOS
7
• Consistentes: Los requisitos no pueden ser contradictorios. Un con-
junto de requisitos contradictorio no es implementable.
• Clasificados: Normalmente, no todos los requisitos son igual de
importantes. Los requisitos pueden clasificarse por importancia
(esenciales, condicionales u opcionales) o por estabilidad (cam-
bios que se espera que afecten al requisito). Esto sirve, ante todo,
para no emplear excesivos recursos en implementar requisitos no
esenciales.
• Verificables: La ERS es verificable si y sólo si todos sus requisitos
son verificables. Un requisito es verificable (testeable) si existe un
proceso finito y no costoso para demostrar que el sistema cumple
con el requisito. Un requisito ambiguo no es, en general, verifi-
cable. Expresiones como a veces, bien, adecuado, etc. introducen
ambigüedad en los requisitos. Requisitos como “en caso de acci-
dente la nube tóxica no se extenderá más allá de 25Km” no es
verificable por el alto costo que conlleva.
• Modificables: La ERS es modificable si y sólo si se encuentra es-
tructurada de forma que los cambios a los requisitos pueden rea-
lizarse de forma fácil, completa y consistente. La utilización de
herramientas automáticas de gestión de requisitos (por ejemplo
RequisitePro o Doors) facilitan enormemente esta tarea.
• Trazables: La ERS es trazable si se conoce el origen de cada requi-
sito y se facilita la referencia de cada requisito a los componentes
del dise˜no y de la implementación. La trazabilidad hacia atrás
indica el origen (documento, persona, etc.) de cada requisito. La
trazabilidad hacia delante de un requisito R indica qué compo-
nentes del sistema son los que realizan el requisito R.
3.1. Interfaces Externas
Se describirán los requisitos que afecten a la interfaz de usuario, interfaz
con otros sistemas (hardware y software) e interfaces de comunicaciones.
3.2. Funciones
Esta subsección (quizá la más larga del documento) deberá especificar
todas aquellas acciones (funciones) que deberá llevar a cabo el software. Nor-
3 REQUISITOS ESPECÍFICOS
8
malmente (aunque no siempre), son aquellas acciones expresables como “el
sistema deberá ...”. Si se considera necesario, podrán utilizarse notaciones
gráficas y tablas, pero siempre supeditadas al lenguaje natural, y no al revés.
Es importante tener en cuenta que, en 1983, el Estándar de IEEE 830
establecıa que las funciones deberıan expresarse como una jerarquıa funcional
(en paralelo con los DFDs propuestos por el análisis estructurado). Pero el
Estándar de IEEE 830, en sus últimas versiones, ya permite organizar esta
subsección de múltiples formas, y sugiere, entre otras, las siguientes:
Por tipos de usuario: Distintos usuarios poseen distintos requisitos. Pa-
ra cada clase de usuario que exista en la organización, se especificarán
los requisitos funcionales que le afecten o tengan mayor relación con
sus tareas.
Por objetos: Los objetos son entidades del mundo real que serán refle-
jadas en el sistema. Para cada objeto, se detallarán sus atributos y sus
funciones. Los objetos pueden agruparse en clases. Esta organización
de la ERS no quiere decir que el dise˜no del sistema siga el paradigma
de Orientación a Objetos.
Por objetivos: Un objetivo es un servicio que se desea que ofrezca el
sistema y que requiere una determinada entrada para obtener su resul-
tado. Para cada objetivo o subobjetivo que se persiga con el sistema,
se detallarán las funciones que permitan llevarlo a cabo.
Por estımulos: Se especificarán los posibles estımulos que recibe el sis-
tema y las funciones relacionadas con dicho estımulo.
Por jerarquıa funcional: Si ninguna de las anteriores alternativas resulta
de ayuda, la funcionalidad del sistema se especificará como una jerar-
quıa de funciones que comparten entradas, salidas o datos internos. Se
detallarán las funciones (entrada, proceso, salida) y las subfunciones
del sistema. Esto no implica que el dise˜no del sistema deba realizarse
según el paradigma de Dise˜no Estructurado.
Para organizar esta subsección de la ERS se elegirá alguna de las ante-
riores alternativas, o incluso alguna otra que se considere más conveniente.
Deberá, eso sı, justificarse el porqué de tal elección.
4 AP ´ENDICES
9
3.3. Requisitos de Rendimiento
Se detallarán los requisitos relacionados con la carga que se espera tenga
que soportar el sistema. Por ejemplo, el número de terminales, el número
esperado de usuarios simultaneamente conectados, número de transacciones
por segundo que deberá soportar el sistema, etc.
También, si es necesario, se especificarán lo requisitos de datos, es decir,
aquellos requisitos que afecten a la información que se guardará en la base
de datos. Por ejemplo, la frecuencia de uso, las capacidades de acceso y
la cantidad de registros que se espera almacenar (decenas, cientos, miles o
millones).
3.4. Restricciones de Dise˜no
Todo aquello que restrinja las decisiones relativas al dise˜no de la aplica-
ción: Restricciones de otros estándares, limitaciones del hardware, etc.
3.5. Atributos del Sistema
Se detallarán los atributos de calidad (las “ilities”) del sistema: Fiabilidad,
mantenibilidad, portabilidad, y, muy importante, la seguridad. Deberá espe-
cificarse qué tipos de usuario están autorizados, o no, a realizar ciertas tareas,
y cómo se implementarán los mecanismos de seguridad (por ejemplo, por me-
dio de un login y una password).
3.6. Otros Requisitos
Cualquier otro requisito que no encaje en otra sección.
4. Apéndices
Pueden contener todo tipo de información relevante para la ERS pero
que, propiamente, no forme parte de la ERS. Por ejemplo:
1. Formatos de entrada/salida de datos, por pantalla o en listados.
2. Resultados de análisis de costes.
3. Restricciones acerca del lenguaje de programación.