Desarrollo ágil: Historias de usuario y criterios de aceptación
Enunciado de la historia Criterios de aceptación
Identificador
Característica / Número (#) de Criterio de aceptación
(ID) de la Rol Razón / Resultado Contexto Evento Resultado / Comportamiento esperado
Funcionalidad escenario (Título)
historia
XX-XXXX-XXXX Como un Necesito Crear Con la finalidad de 1 Crear requisito En caso que requiera crear un requisito Al registrar un el sistema solicita:
administra Requisitos definir los documental requisito nuevo -NombreRequisito
dor documentales documentos -Descripción
requeridos para -Nombre control
cada tipo de
trámite. 2 Listar requisitos En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
documentales existentes
3 Editar requisito En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
documental
4 Eliminar requisito En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
documental
XX-XXXX-XXXX Como un Necesito Con la finalidad de 1 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
[Rol] [Descripción de la [Descripción razón o 2 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
funcionalidad] resultado]
3 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
4 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
XX-XXXX-XXXX Como un Necesito Con la finalidad de 1 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
[Rol] [Descripción de la [Descripción razón o 2 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
funcionalidad] resultado]
3 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
4 [Titulo del escenario] En caso que [contexto] y/ o [contexto] cuando [evento] el sistema [resultado / comportamiento]
Nota:
- Reemplazar las etiquetas [Rol], [Descripción de la funcionalidad], [Descripción de razón o resultado] por el contenido del enunciado de la historia.
- Reemplazar las etiquetas [Título del escenario], [contexto], [evento] y [resultado / comportamiento] por el contenido de los criterios de aceptación.
Historias de usuario y criterios de aceptación: Instructivo
Columna Instrucciones
Identificador (ID) de la historia Código que identifica unívocamente a la historia en el proyecto que se esté desarrollando. El formato
debe ser elegido por el equipo.
Rol Es el rol que está desempeñando el usuario cuando utiliza la funcionalidad que se está describiendo. Debe
ser lo más especifico posible, describiendo el rol o actor que se está desempeñando. El enunciado puede
escribirse como se sigue: Yo como un [Rol], desempeñando el rol de [Rol], como un [Rol], entre otros. Por
ejemplo:
Yo como cliente registrado.
Desempeñando el rol de cliente registrado.
Como un cliente registrado.
Característica / Funcionalidad Representa la función que el rol quiere o necesita hacer en el sistema que se está desarrollando. Puede
diferenciarse entre acciones obligatorias u opcionales, utilizando la palabra puede o necesita para
describir la acción. Por ejemplo:
Necesito realizar búsquedas de productos por categorías.
Puedo seleccionar una categoría para ver el número de productos que tiene asociado.
Razón / Resultado Lo que el rol necesita lograr al ejecutar la acción. Este es el resultado de ejecutar la acción desde el punto
de vista del rol. Este punto puede ser opcional, pues la historia puede documentarse sólo con la definición
del rol y la acción (sin definir la consecuencia).
Número (#) de escenario Número (ejemplo 1, 2, 3 ó 4), que identifica al escenario asociado a la historia.
Criterio de aceptación (título) Describe el contexto del escenario que define un comportamiento. Por ejemplo, si se toma el ejemplo de
búsquedas de productos por categoría, un posible ejemplo pudiera ser: Categoría sin productos
asociados.
Contexto Proporciona mayor descripción sobre las condiciones que desencadenan el escenario.
Evento Representa la acción que el usuario ejecuta, en el contexto definido para el escenario.
Resultado / Comportamiento Dado el contexto y la acción ejecutada por el usuario, la consecuencia es el comportamiento del sistema
esperado en esa situación.
Historias de usuario y criterios de aceptación: Ejemplo
Enunciado de la historia Criterios de aceptación
Identificador (ID) Característica / Número (#) de Criterio de Resultado / Comportamiento
Rol Razón / Resultado Contexto Evento
de la historia Funcionalidad escenario aceptación (Título) esperado
XX-XXXX-XXXX Como un Necesito ver un listado Con la finalidad de 1 Categoría con al En caso que una Cuando se despliegue el A continuación del nombre de
cliente. de categorías de realizar menos un producto. categoría tenga al listado de categorías a la categoría, se mostrará entre
productos y poder busquedas de menos un producto seleccionar. paréntesis el número de
seleccionar una productos por asociado. productos asociados.
categoría. categorías.
2 Categoría sin En caso que una Cuando se despliegue el A continuación del nombre de
productos. categoría no tenga listado de categorías a la categoría, se mostrará entre
productos asociados. seleccionar. paréntesis el siguiente texto
"Sin Productos asociados".
3 Ordenamiento de las N/A Cuando se despliegue el El sistema mostrará las
categorías listado de categorías a categorías en orden alfabetico.
seleccionar.
