Guía para la especificación de los Casos de Uso

        Guía para la especificación de los Casos de Uso

[pic 1]Guía para la Especificación de los Casos de Uso

Banamex BR-Tarjetas y Adquirentes        

Tabla de Contenido

1.        Introducción        3

1.1.        Propósito del Documento        3

1.2.        Alcance        3

1.3.        Acrónimos        3

1.4.        Referencias        3

2.        Definiciones        3

2.1.        ¿Qué es un Caso de Uso?        3

2.2.        ¿Qué es un Flujo?        4

3.        Secciones del Caso de Uso        4

3.1.        Nombre del Caso de Uso        4

3.2.        Autor y Fecha de creación        4

3.3.        Autor y Fecha de la última modificación        4

3.4.        Objetivo        4

3.5.        Nivel del Caso de Uso        5

3.6.        Actores Involucrados        5

3.7.        Evento Disparador        5

3.8.        Precondiciones        5

3.9.        Post Condiciones        5

3.10.        Flujos        4

3.11.        Reglas de Negocio        8

3.12.        Requerimientos No-Funcionales        8

3.13.        Notas de Implementación        11

4.        Revisión por Pares        10

1. Introducción

1. Propósito del Documento

El propósito de los siguientes lineamientos es la consecución de especificaciones de CCUU (CU) de calidad: entendibles, concisas, concretas, realizables; evitando errores como la asignación de nombres de CU ambiguos, el uso de un estilo pobre en la descripción de los flujos, el uso inconsistente de la terminología, la definición de una estructura inadecuada o la posible mezcla de niveles de detalle que se manifiesten en una pobre o deficiente comunicación (confusión, mala interpretación, etc.) con los interesados, y que se manifiesten en unas decisiones de diseño inapropiadas.

1. Alcance

Este documento se propone para todos aquellos proyectos que sean realizados utilizando UML.

1. Acrónimos

CU.- Caso de Uso

CCUU.- Casos de Uso

1. Referencias

Propuesta de Lista de chequeo para realizar la revisión por pares en (Lista de Chequeo de Caso de Uso.xls)

1. Definiciones

1. ¿Qué es un Caso de Uso?

Describe cómo una entidad (persona, sistema, etc.) deberá interactuar con un proceso para alcanzar un objetivo predeterminado (requisito o requerimiento).

Un CU es un contrato entre los interesados de un sistema acerca de su comportamiento; y lo describe bajo ciertas condiciones como respuesta a la solicitud de un actor principal. Un CU describe paso a paso un flujo en donde se muestra cómo se realiza la interacción de un conjunto de actores con un sistema propuesto. Un actor regularmente es un usuario, pero también puede ser cualquier otro sistema o entidad.

Las especificaciones de los CCUU son de gran ayuda ya que cuentan una historia coherente de cómo el sistema se comporta al ser usado. Los CCUU permiten a personas no técnicas entender la funcionalidad propuesta y por lo tanto el alcance del proyecto.

Los CCUU muestran una visión de contexto, o sea del entorno en que se ubica el sistema. Los actores están fuera del sistema, los CCUU dentro, lo integran. Los diagramas de CU no son diagramas de flujo y se vinculan a través de los actores. Permiten determinar el impacto que tendrán sobre otros sistemas o entidades con las que se vinculan (actores).

Un CU puede ser usado por varias personas y en varios momentos. Primeramente para lograr un entendimiento de los requerimientos del sistema con los interesados (usuarios, clientes, etc.) en el proyecto. También son usados por los diseñadores del sistema para instrumentar una solución; por los Ingenieros de Pruebas para generar el conjunto de Casos de Prueba y por quien genera los manuales del uso del sistema y materiales de entrenamiento. También para el control de todas las etapas de desarrollo técnico (Ciclo de Vida) y para elaborar los planes de desarrollo, así como determinar su costo (o precio).

1. ¿Qué es un guión?

Un CU puede tener muchas variantes de solución. Estas posibles soluciones pueden entenderse como guiones o libretos sobre los que se puede desarrollar un CU. Un guión está compuesto de un Flujo Principal (Happy Path), y puede tener además uno o varios Flujos Alternos y también por una o varias Excepciones.

Cada Paso dentro de un Guión debe llevar a hacerse las siguientes preguntas:

• ¿Este paso está en el lugar correcto?
• ¿Hay algún paso que falte?
• ¿Qué puede salir mal aquí?
• ¿Esta flujo esta completo?
• ¿Este paso ayuda a alcanzar el objetivo?
• ¿Puede este actor llevar acabo esta acción?
• ¿Este paso implica algún riesgo?
• etc.

1. Secciones de la especificación de un Caso de Uso

1. Nombre del Caso de Uso

El nombre del CU debe comenzar con un verbo en infinitivo y debe estar relacionado con el  actor con el que se vincula (preferiblemente con el que lo inicia). Este nombre debe ser único en todo el proyecto. También se debe asignar una clave única como referencia a este CU (identificador).

Por ejemplo, si el actor que lo inicia es el comprador de un boleto de avión, el nombre del CU deberá ser “Comprar Boleto”; si por el contrario, el vendedor es quien inicia el caso de uso, deberá ser “Vender Boleto”.

1. Autor y Fecha de creación

Indicar el nombre completo del autor del CU; así como la fecha en que fue creado (en formato dd/mm/aaaa).

1. Autor y Fecha de la última modificación

Si el CU ha sufrido cambios, indicar el nombre completo de quien lo modificó; así como la fecha en que fue cambiado (en formato dd/mm/aaaa).

1. Objetivo

Describir qué es lo que se quiere lograr después de ejecutar todos los pasos descritos en el flujo principal. Este resultado debe ser observable y de valor desde la perspectiva del actor que lo solicitó. Todo actor inicia un CU con un objetivo en mente, aquí se debe describir cuál es este objetivo.

1. Nivel del Caso de Uso

Las posibles opciones son las siguientes:

• Caso de Uso de Contexto. Este nivel establece la secuencia en que son empleados los CCUU para cumplir un objetivo de más alto nivel. Este nivel de CU puede verse como el orquestador de los CCUU de Usuario.
• Caso de Uso de Usuario. Este nivel corresponde a los procesos elementales del negocio y representa los objetivos principales (de mayor valor).
• Sub-Caso de Uso. Este nivel es el más bajo de la jerarquía y representa a aquellos CCUU que cumplen un sub-objetivo y que cooperan con el cumplimiento del objetivo principal (objetivo del CU de Usuario).

1. Actores Involucrados

Los actores son las entidades (personas, sistemas, etc.) que interactúan directamente con los CCUU. Usualmente un actor es el que dispara el CU (actor principal), y uno o varios más se relacionan o involucran con él (actores secundarios).

Cada actor debe tener un nombre único que represente el rol que juega en la interacción con el sistema. Este rol no necesariamente corresponde con su puesto y nunca debe ser el nombre de una persona.

El actor principal debe estar como primer actor en la lista de actores involucrados con la marca (principal), y los actores secundarios después de él, por ejemplo:

...