Un caso de uso puede proporcionar a los desarrolladores de software conocimientos críticos sobre el funcionamiento de un sistema. Cuando se desarrolla un sistema, los directores de proyecto y los analistas suelen escribir escenarios para conocer mejor sus capacidades y asegurarse de que los futuros usuarios queden satisfechos. Es fundamental comprender los fundamentos de los casos de uso si quiere incluirlos en su práctica.
En este artículo, definimos qué es un caso de uso, enumeramos algunas de sus ventajas, describimos sus elementos, hablamos de cómo escribir uno y proporcionamos un ejemplo de caso de uso para guiar tus esfuerzos de escritura.
¿Qué es un caso de uso?
Los casos de uso son una descripción basada en texto de cómo un individuo interactúa con un sistema para lograr un objetivo concreto. Los casos de uso suelen estar compuestos por una lista de pasos que describen este proceso desde la perspectiva del individuo. Los casos de uso pueden crearse por diversas razones, como la comprobación de las características del software o la elaboración de manuales de instrucciones para los clientes.
Los profesionales técnicos suelen escribir casos de uso sobre las diferentes formas en que una persona puede interactuar con el software. Por ejemplo, un director de proyecto puede idear dos casos de uso para un nuevo software de cámara. El primero detalla la interacción entre una persona que hace una foto y su uso del nuevo software de cámara, mientras que el otro detalla un proceso para crear secuencias de vídeo con el software. Algunos casos de uso pueden tener una descripción de los requisitos del sistema que resuma las características básicas del software.
Relacionado: Desarrollar un caso de uso: cómo y por qué es importante
¿Cuáles son las ventajas de un caso de uso?
Estas son algunas de las ventajas de crear un caso de uso:
-
Crea un entendimiento compartido: Un documento que detalla el propósito de la función de un producto puede ayudar a los diferentes equipos a comunicarse más eficazmente sobre los objetivos del proyecto.
-
Identifica las áreas de mejora: Al analizar un proceso individual de principio a fin, los equipos pueden encontrar y resolver los problemas que puedan surgir.
-
Determina las necesidades de los usuarios: La descripción del proceso puede permitir a los miembros del equipo conocer los componentes que puede necesitar el diseño de un sistema para ser operativo.
-
Optimiza un presupuesto: Disponer de más datos sobre las funciones de un producto puede ayudar a reducir el número de revisiones adicionales que requiere, lo que permite utilizar fondos para otros proyectos.
4. ¿Cuáles son los elementos de un caso de uso?
Estos son los elementos básicos de un caso de uso común:
El sistema
El sistema puede describir el software o el hardware que una persona maneja para completar una tarea. Los equipos de proyecto definen el sistema a partir de los objetivos de un proyecto y del comportamiento esperado de un usuario. Un sistema también tiene límites y requisitos claros, lo que ayuda a acotar el propósito general de cada caso de uso.
Por ejemplo, considere un caso de uso sobre un cliente que opera un software de escritura con el objetivo de guardar un archivo. El sistema de este caso de uso podría abarcar tanto el software como el hardware del ordenador, ya que el comportamiento esperado del cliente implica estos componentes. Cuando el cliente utiliza otro programa, el equipo omite esta acción porque existe fuera de los límites del sistema.
Relacionado: Pensamiento sistémico
Los actores
Los actores, o usuarios del sistema, suelen representar a las personas que interactúan con un sistema. Para definir su propósito, se les asigna un nombre de rol, como cliente o técnico. Cada caso de uso tiene un número designado de actores y una persona puede tener varios nombres de rol dependiendo del proceso. Los actores también pueden representar un programa automatizado. Por ejemplo, cada componente de software de un sistema podría convertirse en un actor en función de un proceso.
Las partes interesadas
Las partes interesadas son personas que controlan algunos aspectos de proyectos más grandes sin aparecer en un caso de uso concreto. Pueden ser la empresa que encarga un caso de uso para un producto concreto o inversores que pueden beneficiarse del éxito del producto. Algunas entidades pueden desempeñar un papel de actor en una situación pero funcionar como parte interesada en otra. Por ejemplo, es posible que sólo un caso de uso describa la interacción de un cliente con el software, pero como sigue siendo relevante para el proyecto, puede ser útil hablar de él.
Las condiciones previas
Las precondiciones son eventos que deben producirse antes de que pueda comenzar el proceso de un caso de uso. Por ejemplo, una precondición para un caso de uso puede ser que el cliente haya pagado la cuenta asociada a este programa de software o que el administrador haya iniciado sesión en una cuenta. Es importante incluir las precondiciones para que los lectores puedan entender los parámetros del proceso.
El disparador
Un desencadenante es un evento que inicia el escenario del proceso de uso, y ocurre antes del primer paso. Por ejemplo, consideremos un caso de uso sobre una interacción entre un profesor y un software de calificación, con el objetivo de registrar la nota de un estudiante. El desencadenante de este caso de uso puede ser que el profesor identifique las calificaciones para introducirlas en el sistema. Entonces, el primer paso podría ser, «El profesor se registra en el software de calificación.»
El flujo normal de los acontecimientos
Este elemento describe el escenario principal del proceso de un caso de uso, incluyendo las tareas esperadas de un usuario. Los pasos de un flujo normal muestran una relación de causa y efecto, lo que significa que las acciones de un usuario provocan una serie de respuestas en un sistema. Por ejemplo, en un caso de uso en el que un actor opera un software para abrir un archivo, el flujo normal de eventos detalla cada interacción que ocurre antes de que el actor complete el objetivo.
El flujo alternativo de eventos
Un flujo de eventos alternativo describe cualquier comportamiento o situación que haga que el flujo básico varíe en su estructura con respecto a los resultados esperados. Una vez que el actor completa estos pasos adicionales, vuelve al flujo de eventos básico. Por ejemplo, un cliente-actor puede elegir una función de voz a texto en lugar de un teclado en un caso de uso sobre el funcionamiento de un software de escritura, pero sigue completando el proceso previsto.
Los flujos de excepción
Los flujos de excepción representan cualquier comportamiento o situación que provoca acciones incompletas en un caso de uso, lo que significa que interrumpe el flujo normal. Los actores a veces pueden resolver los flujos de excepción, pero a menudo hacen que un caso de uso termine con un estado incompleto. La gente suele incluir información sobre el flujo de excepción en un caso de uso para que los desarrolladores puedan resolver los problemas pendientes en el futuro. Por ejemplo, un administrador puede recibir un mensaje de error si introduce una contraseña incorrecta en un sistema de red.
Las postcondiciones
Las postcondiciones hablan de los requisitos para un caso de uso completado y con éxito, incluyendo sus últimos pasos. Normalmente se incluyen las postcondiciones para los resultados finales de un flujo de eventos normal o alternativo. Si el caso de uso tiene un flujo de excepción, puedes omitirlo en la sección de post-condiciones e incluirlo en otra parte.
Cómo escribir un caso de uso
Estos son los pasos para escribir un caso de uso eficaz:
1. Utilice un formato y un estilo de escritura accesibles
Cuando cree un caso de uso, separe la información en secciones definidas con una progresión lógica de la historia. Además, identifique el lector al que va dirigido su documento, ya que esto puede guiar el estilo de su caso de uso. Por ejemplo, si el lector previsto son los clientes, puede ser útil utilizar un lenguaje activo y directo y una terminología más genérica, en lugar de vocabulario técnico. Los miembros de una empresa técnica pueden beneficiarse del uso del Lenguaje Unificado de Modelado (UML), que es un conjunto estándar de términos utilizados por los desarrolladores de software.
Relacionado: Voz activa frente a voz pasiva: ¿Cuál es la diferencia? (Con ejemplos)
2. Identificar el sistema y los actores
Para establecer el sistema, examine primero todo el proyecto para saber qué componentes son necesarios para un caso de uso concreto. A continuación, determine un actor, o varios, que interactúen con el sistema. Es importante elegir los elementos antes de empezar el documento, ya que cada caso de uso suele describir un proceso diferente. También puede decidir cuál es la función general de un caso de uso durante esta etapa, como demostrar una determinada característica a una parte interesada externa.
3. Crear un título y una descripción
Indique el objetivo específico de un caso de uso en un título distinto y una breve descripción. Puede ser útil utilizar un verbo seguido de un sustantivo en el título, como «Imprimir un documento» o «Iniciar sesión en un sistema..; Para la descripción, considere la posibilidad de escribir dos o tres frases que definan cuándo empieza y termina un proceso. Incluir una descripción clara al principio del documento puede ayudarle a enmarcar los pasos del proceso de forma más eficaz.
4. Enumerar el desencadenante y las precondiciones
Determina las condiciones previas y el desencadenante de un proceso concreto, y luego condénsalas en unas pocas frases directas. Ten en cuenta que debes incluir un resumen de estas condiciones previas en lugar de una explicación más detallada. Si hay varias precondiciones en un caso de uso, puede ser útil utilizar viñetas o una lista numerada en estas secciones para proporcionar más claridad.
5. Crear el flujo normal de eventos
Escriba una lista numerada de los pasos del flujo normal, incluyendo las especificaciones de cada evento desde el escenario de activación hasta el resultado esperado. Asegúrese de revisar los requisitos del sistema para poder escribir descripciones detalladas de causa y efecto. Según tus preferencias y las necesidades del proyecto, puedes escribir las descripciones como respuestas a una pregunta invisible. Por ejemplo, si esa pregunta se refiere a cómo un cliente carga un videojuego, el paso de flujo normal correspondiente podría ser que el usuario haga clic en el botón azul del lado del paseo de la consola.
6. Describir los flujos alternativos y de excepción
Incluya los flujos alternativos y de excepción en otra lista numerada y adjunte estos elementos a su paso correspondiente en el flujo normal. Por ejemplo, puede etiquetar el flujo alternativo de un segundo paso como 2.1 o 2a. Los flujos alternativos suelen proporcionar los pasos necesarios para reanudar los eventos normales del proceso. Las descripciones de flujos de excepción pueden incluir información sobre cómo responde el sistema a un resultado inesperado.
7. Explicar las condiciones posteriores y los detalles adicionales
Incluye una sección sobre las postcondiciones hacia el final de un caso de uso. Al igual que la sección de precondiciones, puede ser útil escribirlas en una lista numerada o con viñetas. Después de la lista, puedes incluir información adicional que tus lectores puedan encontrar relevante y útil. Por ejemplo, puedes hablar de los pasos comunes entre un caso de uso y otro, del historial de revisiones de un caso de uso o de los requisitos empresariales que afectan al proceso.
8. Proporcionar un diagrama
En función de tus preferencias, puedes incluir una representación visual de un caso de uso para aportar más claridad. Por ejemplo, puede crear un diagrama de flujo que conecte las figuras que representan a los actores con sus procesos objetivo dentro de un sistema. Un diagrama puede ser especialmente útil para designar los límites de un sistema.
Relacionado: Diagrama de casos de uso: Definición y ejemplos
Ejemplo de caso de uso
Aquí tienes un ejemplo de caso de uso para consultar mientras escribes:
Campo de datos de entrada
Equipo de análisis técnico
Versión 7.3
Descripción: El usuario añade un campo de datos a una hoja de cálculo. Comienza cuando el usuario abre el software de la hoja de cálculo y termina cuando añade un nuevo campo de datos.
Actores: Administrador
Activación: El administrador identifica nueva información para introducirla en una hoja de cálculo.
Condiciones previas: El actor entra en la cuenta del software.
Flujo normal:
- Paso 1: El administrador hace clic en la barra de menú. El sistema muestra pestañas de funciones de la base de datos etiquetadas como «Diseño» y «Formato.»
- Paso 2: El administrador hace clic en la pestaña denominada «Formato» El sistema muestra las características de la pestaña «Diseño».
- Paso 3: El administrador hace clic en la función «Líneas» de la pestaña «Formato». El sistema muestra un icono para una línea de serie.
- Paso 4: El administrador hace clic en el icono de la línea de serie. El sistema añade un nuevo campo de datos al documento de la hoja de cálculo.
Flujo alternativo (paso 1a): El administrador hace clic con el botón derecho en un campo de datos anterior. El sistema muestra las características de la pestaña «Formato».
Fluidez excepcional (paso 3): El administrador hace clic con el botón derecho en la función «Líneas» de la pestaña «Formato». El sistema no muestra el icono de una línea de serie.
Condiciones posteriores: El administrador teclea palabras en el campo de datos.
Historial de revisiones: 14 de abril de 2020,incorporó más lenguaje sobre la pestaña «Formato» en los pasos tres y cuatro.