Documento de descripción de...

Framework unificado para desarrollo de interfaces J2EE Documento de Descripción de pantallas

Versión 1.1

CASO DE PRUEBA:

Sistema para el alquiler, control de películas y clientes en una videotienda

Documento de descripción de

pantallas

Versión <1.1>

Historia de Revisión Fecha Versión Descripción Responsable

1/04/2005 <0.1> Creación. Alejandro Báez,

Cristian Castañeda,

Diego Castañeda.

15/04/2005 <1.0> Se agrego el mapa de Navegabilidad y las conclusiones del documento

Alejandro Báez,

Cristian Castañeda,

Diego Castañeda

2/05/2005 <1.1> Se agrego la pantalla de administración de Constantes.

Alejandro Báez.

INVESTIGADORES:

ALEJANDRO BAEZ CRISTIAN CASTAÑEDA

DIEGO CASTAÑEDA

DIRECTOR:

JAVIER SANCHEZ


Versión 1.1

2

TABLA DE CONTENIDO 1. Introducción......................................................................................................... 3 2. Descripción de Pantallas ..................................................................................... 4 2.1 Pantalla de Ingreso (A) ................................................................................. 4 2.2 Pantalla Principal o de 3 Frames: (B) ........................................................... 5 2.2.0 Pantalla de Ingreso a Menú Clientes (C) .................................................... 6 2.2.1. Pantalla Menú Clientes (D) ........................................................................ 7 2.2.1.1.1 Pantalla de Alquiler (E) ......................................................................... 7 2.2.1.1.3 Pantalla de Autorizados (F) .................................................................. 8 2.2.1.1.3 Pantalla de Películas Actualmente Alquiladas (G) ................................ 9 2.2.1.1.4 Pantalla de Multas Actuales (H).......................................................... 10 2.2.2 Pantalla de Devolver Película (I)............................................................... 11 2.2.3 Pantalla de Facturas (J)............................................................................ 12 2.2.3.1 Pantalla Detalles Facturas (K) ............................................................... 13 2.2.4 Pantalla de Películas (L) ........................................................................... 13 2.2.4.1 Pantalla Crear Películas: (M) ................................................................ 14 2.2.4.2 Pantalla de Buscar Películas es: (N)..................................................... 15 2.2.4.2.1 Pantalla de Eliminar y actualizar Películas (Ñ) .................................. 16 2.2.5 Pantalla de Afiliaciones: (O)..................................................................... 17 2.2.5.1 Pantalla Crear Contratos: (P)................................................................ 18 2.2.5.1.1 Pantalla de Referencias y Autorizados: (Q) ....................................... 19 2.2.5.2 Pantalla de Buscar Afiliaciones: (R)...................................................... 20 2.2.5.2.1 Pantalla de Eliminar y actualizar Afiliaciones (S) ............................... 21 2.2.6 Pantalla de Reportes: (T)......................................................................... 22 2.2.7 Pantalla de Constantes: (U)..................................................................... 23

3. Mapa de Navegabilidad..................................................................................... 24 4. conclusiones...................................................................................................... 25


Versión 1.1

3

1. Introducción Para la verificación de los resultados del proyecto titulado: “Framework unificado para desarrollo de interfaces J2EE con soporte a objetos persistentes en bases de datos relaciónales”, se ha decidido el desarrollo de una aplicación que nos sirva para probar los resultados de este. Luego de analizar varias opciones, decidimos desarrollar una aplicación para una videotienda, debido que al desarrollar esta aplicación se podrán verificar muchos elementos que serán manejados dentro del desarrollo de este proyecto, tales como manejo de interfaces y manejo de objetos persistentes entre otros. Con el desarrollo de los documentos de requerimientos y casos de uso, hemos podido identificar algunos elementos que se deben tener en cuenta en la interfaz de usuario de esta aplicación. El presente documento busca definir esta interfaz describiendo las pantallas con todas sus características y la relaciones entre ellas.


Versión 1.1

4

2. Descripción de Pantallas En esta sección se define una versión preliminar del diseño de las pantallas que deberá tener la aplicación. Así mismo se da una descripción de las funcionalidades que debe presentar cada una. Esto sirve para definir la información que debe tener cada una de las pantallas cuando se vaya a desarrollar la aplicación.

2.1 Pantalla de Ingreso (A) Pantalla que valida con un Login y Password el usuario con el fin de permitir el ingreso al sistema. Validaciones: * La Validación se hace en el Evento de “Onclick” de el Botón Aceptar, con las siguientes reglas:

- Login: Es una cadena de máximo 20 Caracteres y mínimo de 4. (Obligatorio)

- Password: Cadena de Caracteres Máximo de 20 Caracteres y mínimo de 5. (Obligatorio)

* Si la validación no tuvo éxito saldrá el mensaje “Login o Password Incorrecto” en la Zona de errores Zona de Errores:

•••• Estará Ubicada en la Parte inferior de la Pantalla debajo de le recuadro de Ingreso.


Versión 1.1

5

2.2 Pantalla Principal o de 3 Frames: (B)

Esta pagina es la principal del sistema y se divide en tres Frames: Titulo, Menú, Logotipo e Información y se distribuyen de la siguiente manera: Invocada por: A. Destinos:

- B-> Inicio - C-> Clientes - I -> Devolver Películas - J -> Facturas - L -> Películas - O-> Afiliaciones - T -> Reportes - U -> Constantes - A -> Salir

Esta Pagina tiene la característica que dos de sus frames (Titulo y Menú) son estáticos , es decir una vez ingresado al sistema siempre van a estar en todas las demás pantallas del sistema; Mientras que el frame del Logotipo y de información general si puede cambiar por el resto de las paginas del sistema dependiendo del caso. Frames: Menú: El frame de Menú tiene las opciones generales para el usuario asociado, estas son:

INICIO CLIENTES

DEVOLVER PELICULAS FACTURAS PELICULAS

AFILIACIONES REPORTES

CONSTANTES

SALIR


Versión 1.1

6

Este Menú siempre estará Activo, por lo tanto en cualquier momento y sitio de la aplicación se podrá acceder. Ver Mapa de Navegabilidad para ver a donde llevan sus Links - Titulo: Nombre de la videotienda - Logotipo e Información: Información general de la Videotienda, dibujo del logo

de la tienda o cualquier otro dibujo.

2.2.0 Pantalla de Ingreso a Menú Clientes (C) Esta Pantalla el Usuario permite digitar un número de Contrato o Afiliación para dirigirse al menú del cliente dueño del contrato . Invocada por: B. Destinos: D-> Botón Aceptar. Validaciones: * La Validación se hace en el Evento de “Onclick” de el Botón Aceptar, con las siguientes reglas:

- NoContrato: Es un numero entero menor que 100000 y mayor que 0. (Obligatorio)

* Si la validación no tuvo éxito saldrá el mensaje “No Contrato incorrecto” en la Zona de errores Zona de Errores:


Versión 1.1

7

•••• Estará Ubicada en la Parte inferior de la Pantalla debajo de le recuadro de Clientes.

2.2.1. Pantalla Menú Clientes (D) Muestra los diferentes ítems que se puede hacer sobre un Cliente especifico.

Invocada por: C. Destinos: E-> Radio Button Autorizados. F-> Radio Button Alquilar Películas. G-> Radio Button Alquileres Actuales. H-> Radio Button Multas Actuales. B-> Botón Salir Validaciones:

•••• Para evitar la validación los RadioButtons son excluyentes y al iniciar la pantalla siempre estará seleccionado el primero.

2.2.1.1.1 Pantalla de Alquiler (E) En esta pantalla se realizaran los alquileres de las películas. Se deberá ingresar el código o nombre de la película que se quiera alquilar. El sistema mostrara las películas que se van a alquilar e indica el precio de cada una de estas. Además se vera la información de las multas que se cargaran a la factura.


Versión 1.1

8

Invocada por: D. Destinos: D-> Botones: Alquilar, Alquilar sin Pagar Multas, y Cancelar Validaciones: * El Campo de Película es un numero entero positivo el cual identifica al video en la tienda. Si la validación no tuvo éxito saldrá el mensaje “No de Película Incorrecto” en la Zona de errores * En el evento de los dos botones de Alquilar Saldar un mensaje de éxito o de error según sea el caso en la Zona de Errores. Zona de Errores y de Éxitos:

•••• Saldar un MessageBox con el mensaje Indicado según el caso.

2.2.1.1.3 Pantalla de Autorizados (F) En esta pantalla se puede ver la información de todos los beneficiarios asociados a un contrato. De cada uno de ellos se podrá ver la información de cedula, nombre, apellido, dirección, teléfono, parentesco.


Versión 1.1

9

Invocada por: D. Destinos: D-> Botón de Regresar

2.2.1.1.3 Pantalla de Películas Actualmente Alquiladas (G) En esta pantalla se podrá ver el reporte de todas las películas que hay alquiladas. Se informara el nombre, caja, formato y fecha de entrega de cada una de las películas.

Invocada por: D. Destinos: D-> Botón de Regresar


Versión 1.1

10

2.2.1.1.4 Pantalla de Multas Actuales (H) En esta pantalla se listara el detalle de las multas que tenga en ese momento el contrato asociado, con toda la información de sus detalles de multa y su valor total. Invocada por: D. Destinos: D-> Botones: Pagar Multas, y Cancelar Validaciones: * El Campo de Película es un numero entero positivo el cual identifica al video en la tienda. Si la validación no tuvo éxito saldrá el mensaje “No de Película Incorrecto” en la Zona de errores * En el evento de los dos botones de Paga Multas Saldar un mensaje de éxito o de error según sea el caso en la Zona de Errores. Zona de Errores y de Éxitos: * Saldar un MessageBox con el mensaje Indicado según el caso.


Versión 1.1

11

2.2.2 Pantalla de Devolver Película (I) Esta pantalla es donde el usuario ingresa el código de una de las películas alquiladas anteriormente para que su estado cambie. Invocada por: D. Destinos: B-> Botón Cancelar. Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Aceptar, con las siguientes reglas:

- No. Película: Es un numero entero menor que 100000 y mayor que 0. (Obligatorio)

* Si la validación no tuvo éxito saldrá el mensaje “No. De Película Incorrecto” en la Zona de errores. Zona de Errores:

•••• Estará Ubicada en la Parte inferior de la Pantalla debajo de le recuadro Central.


Versión 1.1

12

2.2.3 Pantalla de Facturas (J) En esta pantalla se podrán buscar Facturas que se hallan generado en la historia del sistema. Para realizar esta búsqueda se deberá definir el criterio de la búsqueda (Numero, Rango de Fechas, Clientes, y tipo de Factura). El sistema deberá mostrar una lista abreviada de las facturas que cumplen con las criterios que se dieron. Invocada por: D. Destinos: B-> Botón Cancelar. K-> Detalle Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Aceptar, con las siguientes reglas:

- No. Película: Es un numero entero menor que 100000 y mayor que 0.

- Combo de Fechas: La fecha de Inicio debe ser menor que la de final.

- Cedula Cliente: Es un numero entero menor que 100000 y mayor que 0.

- En el Combo de Tipo tiene que escoger una de las dos opciones Multas o Alquileres.

* Si la validación no tuvo éxito saldrá el mensaje que explica como debe ir el campo al lado derecho de cada uno de estos. Zona de Errores:


Versión 1.1

13

•••• Estará Ubicada al lado derecho de cada campo y se activara la que no pase en la Validación, únicamente.

2.2.3.1 Pantalla Detalles Facturas (K) En esta pantalla se podrá ver el reporte de la Factura escogida en la Pantalla que la Invoca. Se informara todo el detalle de la factura con su costo Total y por cada una de las Películas asociadas.

Invocada por: J. Destinos: J-> Botón de Regresar

2.2.4 Pantalla de Películas (L) En esta pantalla el usuario tiene la posibilidad de elegir el tipo de operación que va a realizar con las Películas. El usuario deberá seleccionar la opción y validar, el sistema deberá desplegar otra pantalla para ejecutar la funcionalidad seleccionada.


Versión 1.1

14

Invocada por: D. Destinos: M-> Radio Button Crear. N-> Radio Button Eliminar o Actualizar. N-> Radio Button Consultar. Validaciones: Para evitar la validación los RadioButtons son excluyentes y al iniciar la pantalla siempre estará seleccionado el primero.

2.2.4.1 Pantalla Crear Películas: (M)

En esta pantalla se podrán crear nuevas películas. Se deberá digitar el nombre, director, actores, descripción, año, formato, audio y subtítulos de la película.


Versión 1.1

15

Invocada por: L. Destinos: L-> Botón Cancelar. L-> Botón Ingresar (Después del Mensaje de Éxito) Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Ingresar, con las siguientes reglas:

- Nombre: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres. (Obligatorio)

- Director: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres. (Obligatorio)

- Actores: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres.

- Descripción: Cadena de Caracteres de tamaño 0 o menor que 5000 caracteres.

- Duración: Un numero entero positivos que representa la cantidad de minutos de la película.

- En la Caja de Audio y Subtítulos debe Haber por lo menos Uno. * Si la validación no tuvo éxito saldrá el mensaje que explica como debe ir el campo al lado derecho de cada uno de estos. Zona de Errores: * Estará Ubicada al lado derecho de cada campo y se activara únicamente en el campo que no pase en la Validación

2.2.4.2 Pantalla de Buscar Películas es: (N)

En esta pantalla se podrán hacer búsquedas de las películas que hay. Se deberá escoger el criterio de búsqueda y valor, el sistema mostrara la información de las películas que concuerden con el criterio.


Versión 1.1

16

Invocada por: L. Destinos: L-> Botón Cancelar. Ñ-> Ver Detalles Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Buscar, con las siguientes reglas:

- No. Película: Es un numero entero menor que 100000 y mayor que 0.

- Nombre: La fecha de Inicio debe ser menor que la de final. - Director: Cadena de Caracteres de tamaño mayor que 0 y menor

que 200 Caracteres. - Actores: Cadena de Caracteres de tamaño mayor que 0 y menor

que 200 Caracteres. * Si la validación no tuvo éxito saldrá el mensaje que explica como debe ir el campo al lado derecho de cada uno de estos. Zona de Errores: * Estará Ubicada al lado derecho de cada campo y se activara únicamente en el campo que no pase en la Validación

2.2.4.2.1 Pantalla de Eliminar y actualizar Películas (Ñ)

Esta pantalla es igual a ala de Crear Película a diferencia que los campos salen llenos con la película que fue escogida en la pantalla que la invoca. Invocada por: L. Destinos: L-> Botón Cancelar. L-> Botón Actualizar (Después del Mensaje de Éxito)

L-> Botón Eliminar (Después del Mensaje de Éxito) Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Ingresar, con las siguientes reglas:

- Nombre: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres. (Obligatorio)

- Director: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres. (Obligatorio)

- Actores: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres.

- Descripción: Cadena de Caracteres de tamaño 0 o menor que 5000 caracteres.


Versión 1.1

17

- Duración: Un numero entero positivos que representa la cantidad de minutos de la película.

- En la Caja de Audio y Subtítulos debe Haber por lo menos Uno. * Si la validación no tuvo éxito saldrá el mensaje que explica como debe ir el campo al lado derecho de cada uno de estos. Zona de Errores: * Estará Ubicada al lado derecho de cada campo y se activara únicamente en el campo que no pase en la Validación

2.2.5 Pantalla de Afiliaciones: (O) En esta pantalla el usuario tiene la posibilidad de elegir el tipo de operación que va a realizar con una afiliación. El usuario deberá seleccionar la opción y validar, el sistema deberá desplegar otra pantalla para ejecutar la funcionalidad seleccionada. Invocada por: D. Destinos: P-> Radio Button Crear. R-> Radio Button Eliminar o Actualizar. R-> Radio Button Buscar. Validaciones: Para evitar la validación los RadioButtons son excluyentes y al iniciar la pantalla siempre estará seleccionado el primero.


Versión 1.1

18

2.2.5.1 Pantalla Crear Contratos: (P) En esta pantalla se podrá crear o modificar una afiliación. El sistema debe recibir la información de los nombres, apellidos, dirección, teléfono, e-mail. Además de esto, también se recibirá la información de las referencias y de los beneficiarios asociados a una afiliación.

Invocada por: O. Destinos: O-> Botón Cancelar. P-> Cualquiera de los Botones Nuevo O-> Botón Ingresar (Después del Mensaje de Éxito) Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Ingresar, con las siguientes reglas:


Versión 1.1

19

- Nombre1 y 2: Cadena de Caracteres de tamaño mayor que 0 y menor que 100 Caracteres. (Obligatorio)

- Apellido1 y 2: Cadena de Caracteres de tamaño mayor que 0 y menor que 100 Caracteres. (Obligatorio)

- Dirección: Cadena de Caracteres de tamaño mayor que 10 y menor que 200 Caracteres. (Obligatorio)

- Teléfono: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres. (Obligatorio)

- Email: Cadena de Caracteres de tamaño mayor que 10 y menor que 200 Caracteres.

- Nombre Oficina: Cadena de Caracteres de tamaño mayor que 0 y menor que 100 Caracteres.

- Dirección Oficina: Cadena de Caracteres de tamaño mayor que 10 y menor que 200 Caracteres.

- Teléfono Oficina: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres.

- En la Caja de Referencias debe haber por lo menos dos personas.

* Si la validación no tuvo éxito saldrá el mensaje que explica como debe ir el campo al lado derecho de cada uno de estos. Zona de Errores: * Estará Ubicada al lado derecho de cada campo y se activara únicamente en el campo que no pase en la Validación

2.2.5.1.1 Pantalla de Referencias y Autorizados: (Q) En esta pantalla se podrán crear beneficiarios a una afiliación. Antes de entrar a esta pantalla se deberá haber escogido la afiliación para la que se va a agregar el beneficiario. La información que se deberá ingresar son los nombres, apellidos, dirección, teléfono, e-mail.


Versión 1.1

20

Invocada por: P y S. Destinos: P / S-> Botón Cancelar. P / S-> Botón Ingresar o Actualizar ( Después del Mensaje de Éxito). Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Ingresar, con las siguientes reglas:



- Dirección: Cadena de Caracteres de tamaño mayor que 10 y menor que 200 Caracteres.



* Si la validación no tuvo éxito saldrá el mensaje que explica como debe ir el campo al lado derecho de cada uno de estos. Zona de Errores:* Estará Ubicada al lado derecho de cada campo y se activara únicamente en el campo que no pase en la Validación

2.2.5.2 Pantalla de Buscar Afiliaciones: (R) En esta pantalla se podrán buscar contratos que se tengan en la videotienda. Para realizar esta búsqueda se deberá definir el criterio de la búsqueda (nombre, ID o cedula). El sistema deberá mostrar los clientes que cumplen con las características que se dieron.


Versión 1.1

21

Invocada por: O. Destinos: O-> Botón Cancelar. S-> Ver Detalles Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Buscar, con las siguientes reglas:

- No. Contrato: Es un numero entero menor que 100000 y mayor que 0.

- Nombre o Apellido: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres.

- Rango de Fechas: La fecha de Inicio debe ser menor que la de final.


2.2.5.2.1 Pantalla de Eliminar y actualizar Afiliaciones (S)

Esta pantalla es igual a ala de Crear Afiliación a diferencia que los campos salen llenos con la Afiliación que fue escogida en la pantalla que la invoca. Invocada por: R. Destinos: O-> Botón Cancelar. R-> Botón Actualizar (Después del Mensaje de Éxito)

R-> Botón Eliminar (Después del Mensaje de Éxito) P-> Cualquiera de los Botones Nuevo

Validaciones: * La Validación se hace en el Evento de “Onclick” del Botón Ingresar, con las siguientes reglas:



- Dirección: Cadena de Caracteres de tamaño mayor que 10 y menor que 200 Caracteres. (Obligatorio)


Versión 1.1

22



- Nombre Oficina: Cadena de Caracteres de tamaño mayor que 0 y menor que 100 Caracteres.

- Dirección Oficina: Cadena de Caracteres de tamaño mayor que 10 y menor que 200 Caracteres.

- Teléfono Oficina: Cadena de Caracteres de tamaño mayor que 0 y menor que 200 Caracteres.

- En la Caja de Referencias debe haber por lo menos dos personas.


2.2.6 Pantalla de Reportes: (T) Esta pantalla permite al usuario escoger entre los diferentes reportes que tiene el sistema para proceder a generarlos. Invocada por: B. Validaciones: Para evitar la validación los RadioButtons son excluyentes y al iniciar la pantalla siempre estará seleccionado el primero.


Versión 1.1

23

2.2.7 Pantalla de Constantes: (U) Esta pantalla permite la administración de constantes en el sistema, es decir: crear, modificar, eliminar y buscar constantes con tres criterios: Id, Nombre, Padre. Invocada por: B. Validaciones: La validación en esta pantalla se hace en el momento de buscar una constante sobre los campos Id, Nombre, Padre que son los criterios de búsqueda.

- Id: Es un numero entero menor que 100000 y mayor que 0. (Obligatorio si esta seleccionado)

- Nombre: Cadena de Caracteres de tamaño mayor que 0 y menor que 100 Caracteres. (Obligatorio si esta seleccionado)

- Padre: Cadena de Caracteres de tamaño mayor que 0 y menor que 100 Caracteres. (Obligatorio si esta seleccionado)

* Si la validación no tuvo éxito saldrá el mensaje que explica como debe ir el campo al lado derecho de cada uno de estos.


Versión 1.1

24

3. Mapa de Navegabilidad Desde cualquier Página diferente a la A se puede acceder a la Página B, I, J, K, Ñ, T y A, a través del menú ubicado en el Frame de la Izquierda de las paginas; sin embargo esto no se Gráfica Para Saber con que acción una página llama a otra revísese el detalle de la descripción de las paginas, anteriormente descrito en este documento..


Versión 1.1

25

4. conclusiones Después de realizar el proceso de análisis, se pudieron establecer elementos importantes de cada una de las pantallas que se deben involucrar en el desarrollo del sistema; Así mismo se pudo establecer que la realización de este tipo de documentos es una buena práctica de ingeniería de software ya que se evitaran complicaciones en el desarrollo de estas interfaces dejando claro que y como deben ir todos los elementos de estas. Mediante la realización de este documento se ha podido establecer más claramente los elementos que deberán tener las diferentes pantallas del sistema, lo cual será de gran valor cuando se implementen estas.

Documento de descripción de...

Documents

Transcript of Documento de descripción de...