Page 1

Especificaci´ on La Biblioteca en Cifras

1 de septiembre de 2010 Revision 4

Javier Santacruz L´opez-Cepero


´INDICE

Especificaci´ on La Biblioteca en Cifras

2

´Indice 1. Cambios

3

2. Glosario

3

3. Descripci´ on

3

4. Datos 4.1. Comprobaciones y errores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4 4

5. Interfaz 5.1. Vista 5.2. Vista 5.2.1. 5.2.2.

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

5 5 5 6 8

6. Casos de Uso 6.1. Diagrama de Casos de Uso . . . . . . . . 6.2. Caso de Uso: Validar Administrador . . . 6.2.1. Descripci´ on . . . . . . . . . . . . . 6.2.2. Escenario Principal . . . . . . . . . 6.2.3. Escenarios Alternativos . . . . . . 6.2.4. Escenarios de Error . . . . . . . . 6.3. Caso de Uso: Gestionar Marcadores . . . 6.3.1. Descripci´ on . . . . . . . . . . . . . 6.3.2. Precondiciones . . . . . . . . . . . 6.3.3. Escenario Principal . . . . . . . . . 6.3.4. Escenarios Alternativos . . . . . . 6.3.5. Escenarios de Error . . . . . . . . 6.4. Caso de Uso: Importaci´ on Masiva . . . . . 6.4.1. Descripci´ on . . . . . . . . . . . . . 6.4.2. Precondiciones . . . . . . . . . . . 6.4.3. Escenario Principal . . . . . . . . . 6.4.4. Escenarios Alternativos . . . . . . 6.4.5. Escenarios de Error . . . . . . . . 6.4.6. Escenario de Excepci´ on . . . . . . 6.5. Caso de Uso: Gesti´ on de Administradores 6.5.1. Descripci´ on . . . . . . . . . . . . . 6.5.2. Precondiciones . . . . . . . . . . . 6.5.3. Escenario Principal . . . . . . . . . 6.5.4. Escenarios Alternativos . . . . . . 6.5.5. Escenarios de Error . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

8 8 8 8 8 9 9 10 10 10 10 10 11 11 11 11 11 11 11 11 11 11 12 12 12 12

de Administraci´ on . . . . . . . . . de Visualizaci´ on . . . . . . . . . . Visualizaci´ on de Marcadores . . Visualizaci´ on de Documentaci´on

2

2


Especificaci´ on La Biblioteca en Cifras

1.

3

Cambios

Cambios con respecto a versiones anteriores del documento. Revisi´ on 1 • A˜ nadidos errores a detectar en la importaci´on en 4.1 en la p´agina 4. • A˜ nadidos los errores a la interfaz en 5.1 en la p´agina 5. Revisi´ on 2 • A˜ nadida descripci´ on de los Casos de Uso en secci´on 6 en la p´agina 8. • A˜ nadido diagrama de Casos de Uso en la secci´on 6.1 en la p´agina 8. • Actualizada la interfaz con las actualizaciones en los datos. Revisi´ on 3 • A˜ nadida descripci´ on de la interfaz de visualizaci´on gr´afica de marcadores en la secci´on 5.2 en la p´ agina 5. • A˜ nadido esbozo gr´ afico de la interfaz en la figura 3 en la p´agina 9. Revisi´ on 4 • Cambio en el formato del CSV de importaci´on, a˜ nadiendo m´ ultiples marcadores en la secci´on 3 en la p´ agina 3. • Cambio en los datos aceptados en la importaci´on, reestricciones nuevas en la secci´on 4 en la p´ agina 4. • Cambio en las comprobaciones a realizar durante la importaci´on en la secci´on 4.1 en la p´agina 4. • Cambio en la descripci´ on de la organizaci´on de la interfaz de visualizaci´on de datos en la secci´ on 5.2 en la p´ agina 5. • A˜ nadida descripci´ on de la interacci´on del usuario con la interfaz en la visualizaci´on de datos en la secci´ on 5.2 en la p´ agina 5.

2.

Glosario

Marcador Un Marcador es un conjunto de valores correspondientes a m´ ultiples a˜ nos recogidos bajo el mismo nombre. Dato Un Dato es el valor de un Marcador en un a˜ no concreto.

3.

Descripci´ on

La aplicaci´ on La Biblioteca en Cifras debe reunir y presentar los varios conjuntos de marcadores estad´ısticos que se emplean en Biblioteca de manera que pueda accederse a ellos y visualizarlos de manera sencilla de forma p´ ublica. La informaci´ on de estos marcadores ser´ a de caracter anual, y ser´an introducidos en la aplicaci´on y editados por el Administrador de Biblioteca cada a˜ no. Los datos introducidos para cada a˜ no deben poder visualizarse en forma de gr´aficas y deben ser accesibles p´ ublicamente.

3

3


Especificaci´ on La Biblioteca en Cifras

4.

4

Datos

Las distintas procedencias de los datos son: REBIUN Procesos Clave Biblioteca Resultados Clave Biblioteca Estad´ısticas BAU Carta de Servicios Los marcadores estad´ısticos consistir´ an en una descripci´on textual del indicador, una cadena identificativa, su procedencia, el a˜ no y la cifra del marcador. ej:

identificador

| categor´ ıa | descripci´ on

rebiun.metro.alumno rebiun.metro.alumno bau.quejas.infraestructuras

rebiun rebiun bau

Metros cuadrados por alumno Metros cuadrados por alumno Quejas recibidas sobre las infraestructuras

| a~ no | valor | 2010 2009 2010

0.8345 0.8567 15321

El Administrador de Biblioteca deber´ıa poder acceder y subir los datos una vez al a˜ no, as´ı como editar los datos existentes, a˜ nadir nuevos marcadores o borrarlos.

4.1.

Comprobaciones y errores

Los datos tienen los siguientes requisitos para que sean consistentes y puedan emplearse. Todos tienen la com´ un condici´ on de que no empleen comillas ni ; . Identificadores • Deben ser cadenas alfanum´ericas a excepci´on del espacio en blanco. • Deben tener 50 caracteres de longitud como m´aximo. • Deben ser u ´nicos por a˜ no. (No puede haber dos datos con el mismo identificador para el mismo a˜ no). • El campo no puede estar vac´ıo. Categor´ıas • Deben ser cadenas alfanum´ericas a excepci´on del espacio en blanco. • Deben tener 50 caracteres de longitud como m´aximo. • Debe no estar vac´ıo. Si se deja en blanco se le asignar´a la categor´ıa “General”. Descripci´ on • Deben ser cadenas alfanum´ericas admitiendo blancos. • Deben tener 80 caracteres de longitud como m´aximo. A˜ no del dato • Solo n´ umeros enteros. 2009, 2010. . . . Valor del dato • Solo n´ umeros. Enteros (12), Decimales (12,5) Decimales Ingleses (12.5).

4

4


Especificaci´ on La Biblioteca en Cifras

5.

5

Interfaz

La aplicaci´ on tendr´ a dos partes diferenciadas. La Vista de Administraci´ on , desde la que el Administrador de Biblioteca introducir´ a y editar´ a los datos y la de usuario, en la que el Usuario An´ onimo podr´a visualizar los datos.

5.1.

Vista de Administraci´ on

Desde la Vista de Administraci´ on se mostrar´an todos los datos disponibles para todos los a˜ nos, que podr´ an ser borrados y rectificados. Se podr´ an a˜ nadir datos nuevos individualmente y a trav´es de importaciones masivas. Los datos a editar se marcar´ an al modificarse y al pulsar el bot´on guardar, los datos ser´an guardados. Tambi´en debe poderse eliminar datos y a˜ nadir otros nuevos. El bot´ on N uevo abrir´ a una ventana emergente donde se pedir´a introducir el dato junto con su descripci´ on. Desde la Vista de Administraci´ on tambi´en podr´an importarse los datos de forma masiva a trav´es de un csv. Este csv contendr´ a los datos de uno o varios a˜ nos en formato csv separado por ; Al realizar la importaci´ on se mostrar´ a una pantalla intermedia que puede verse en la Imagen 2 en la p´ agina 7, donde se visualizar´ an los datos a importar. En esta pantalla, podr´an editarse y seleccionarse los datos antes de que sean introducidos en la base de datos. Avisos sobre los datos A la hora de realizar una importaci´ on, las comprobaciones sobre los datos introducidos descritas en la secci´ on 4 en la p´ agina 4 se visualizar´ an de la siguiente manera: Los identificadores que previamente ya existiesen en ese a˜ no y que vayan a sobreescribirse, por defecto est´en no seleccionados y resaltados en rojo. Los identificadores que sean nuevos es decir, cuyo identificador no existiese antes en la base de datos y sea la primera vez que se introducen, aparecer´an marcados pero resaltados en verde. Los identificadores vac´ıos se mostrar´ an pero no seleccionadas y resaltados en amarillo. Las descripciones vac´ıas se mostrar´ an pero no seleccionadas y resaltadas en amarillo. Las categor´ıas vac´ıas se mostrar´ an pero no seleccionadas y resaltadas en amarillo. Si un marcador tiene dos valores para el mismo a˜ no en la importaci´on, se mostrar´an no seleccionados y resaltados en naranja junto con una referencia al otro dato repetido. Si en un mismo marcador m´ as de un campo est´a vac´ıo, se mostrar´a un error de importaci´on para esa l´ınea y se descartar´ a. En el caso de que una l´ınea del fichero estuviese defectuosa, el contenido de esta no ser´a tenido en cuenta y la l´ınea se mostrar´ a en un cuadro aparte indicada como un error. La u ´nica manera de corregir esto ser´a actualizar el fichero y comenzar de nuevo el proceso de importaci´on.

5.2.

Vista de Visualizaci´ on

La vista de visualizaci´ on ser´ a accesible an´ onimamente y su funci´on es la de proveer acceso a la visualizaci´ on de marcadores estad´ısticos y a documentaci´ on asociada a ellos.

5

5


5.2

Vista de Visualizaci´ on

Especificaci´ on La Biblioteca en Cifras

6

Figura 1: Boceto de la Vista de Administraci´ on 5.2.1.

Visualizaci´ on de Marcadores

Los datos deber´ıan poder visualizarse de forma p´ ublica tanto como listado como en forma de gr´aficas. Estas gr´ aficas ser´ an: Descripci´ on de gr´ aficas a emplear

De barras Se mostrar´ an los datos d e uno/dos marcadores juntos a lo largo de los a˜ nos en un gr´afico de barras. De puntos Se mostrar´ an los datos d e uno o m´as marcadores juntos a lo largo de los a˜ nos en un gr´afico de puntos. De l´ıneas Se mostrar´ an los datos d e uno o m´as marcadores juntos a lo largo de los a˜ nos en un gr´afico de l´ıneas. 6

6


5.2

Vista de Visualizaci´ on

Especificaci´ on La Biblioteca en Cifras

7

Figura 2: Boceto de la importaci´on De l´ıneas Se mostrar´ an los datos d e uno o m´as marcadores juntos a lo largo de los a˜ nos en un gr´afico de ´ areas. En ambos tipos de gr´ afica podr´ an visualizarse m´as de un marcador solapadamente empleando distintos colores para cada uno, de manera que pueda realizarse comparaciones entre valores. Se omiten los gr´ aficos de tarta y de caja por no adaptarse adecuadamente a la representaci´on de la evoluci´ on de variables a lo largo del tiempo.

7

7


Especificaci´ on La Biblioteca en Cifras

8

La visualizaci´ on de las gr´ aficas consistir´ a en una p´agina con los siguientes elementos principales: Listado completo de marcadores seleccionables. Listado de marcadores seleccionados. Visualizaci´ on de gr´ afica. Selector de tipo de gr´ afica. Tabla inferior con los valores de los marcadores seleccionados.

En esa p´ agina el Usuario An´ onimo podr´ a seleccionar los marcadores que desee visualizar en listado completo de marcadores seleccionables pas´ andolos al listado de marcadores seleccionados, mostrandose estos todos juntos en la gr´ afica con el tipo elegido por el usuario y a˜ nadi´endose los datos a la tabla inferior con el resumen de los datos. Los listados de selecci´ on de marcadores que el usuario ver´a estar´an separados por categor´ıa. Es posible la existencia de m´ as de una p´ agina con el mismo sistema pero con listados de marcadores separados por categor´ıas diferentes. Adicionalmente el Usuario An´ onimo podr´a realizar la exportaci´on de los datos que se encuentran seleccionados ´ en un momento dado en formato csv pulsando en el enlace Exportar CSV’. 5.2.2.

Visualizaci´ on de Documentaci´ on

Debe existir una p´ agina de acceso an´ onimo en la que se pueda acceder a ficheros de documentaci´on subidos desde la interfaz de administraci´ on junto a una descripci´on breve de los mismos y a un texto fijo en la p´agina. La administraci´ on de estas p´ aginas y de los ficheros de documentaci´on asociados podr´ıa hacerse desde el panel de administraci´ on pero no es prioritario. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

6.

Casos de Uso

A continuaci´ on se describir´ an los distintos casos de uso de la aplicaci´on.

6.1.

Diagrama de Casos de Uso

Figura 4 en p´ agina 10.

6.2. 6.2.1.

Caso de Uso: Validar Administrador Descripci´ on

El Administrador de Biblioteca valida su pertenencia a la universidad y sus permisos para editar los datos. 6.2.2.

Escenario Principal

1. El Administrador de Biblioteca desea introducirse en el sistema. 2. El Administrador de Biblioteca introduce su identificaci´on y contrase˜ na universitaria. 3. El Sistema comprueba que el usuario pertenece a la universidad y est´a en la lista de administradores autorizados. 4. El Administrador de Biblioteca queda validado y dentro del sistema.

8

8


6.2

Caso de Uso: Validar AdministradorEspecificaci´on La Biblioteca en Cifras

9

Figura 3: Visualizaci´on Gr´afica de Marcadores 6.2.3.

Escenarios Alternativos

*.a En cualquier momento el Administrador de Biblioteca puede cancelar la identificaci´on o salir de ella una vez realizada. 6.2.4.

Escenarios de Error

3.a Si el usuario o la contrase˜ na introducidas no son v´alidas, el sistema muestra el mensaje de error. 3.b Si el usuario y la contrase˜ na son v´ alidos pero el administrador no se encuentra autorizado en la lista de 9

9


6.3

Caso de Uso: Gestionar MarcadoresEspecificaci´on La Biblioteca en Cifras

10

Figura 4: Diagrama de Casos de Uso administradores autorizados, el sistema muestra el mensaje de error.

6.3. 6.3.1.

Caso de Uso: Gestionar Marcadores Descripci´ on

El Administrador de Biblioteca Modifica, Elimina o A˜ nade nuevos marcadores o a˜ nade nuevos datos a marcadores estad´ısticos. 6.3.2.

Precondiciones

El Administrador de Biblioteca se encuentra validado por el sistema. Include caso de uso Validar Usuario Secci´ on 6.2 en la p´ agina 8. 6.3.3.

Escenario Principal

1. El Administrador de Biblioteca desea realizar una modificaci´on sobre un marcador estad´ıstico. 2. El Administrador de Biblioteca selecciona el marcador y realiza la modificaci´on sobre uno de los campos. 3. El Sistema comprueba que la modificaci´on es v´alida con respecto a las restricciones del dato. 4. El marcador queda modificado. 6.3.4. 1.a

Escenarios Alternativos 1. El Administrador de Biblioteca desea eliminar un marcador estad´ıstico. 2. El Administrador de Biblioteca selecciona el marcador a eliminar. 3. El Sistema pide confirmaci´ on. 4. El Sistema elimina el marcador seleccionado.

10

10


6.4

Caso de Uso: Importaci´ on Masiva Especificaci´on La Biblioteca en Cifras

1.b

11

1. El Administrador de Biblioteca desea a˜ nadir un nuevo marcador estad´ıstico. 2. El Administrador de Biblioteca indica el Identificador, Descripci´on, A˜ no y el Valor. 3. El Sistema comprueba los datos con respecto a sus restricciones.

6.3.5.

Escenarios de Error

3.a La modificaci´ on no es v´ alida y el Sistema indica el error y no realiza la modificaci´on.

6.4. 6.4.1.

Caso de Uso: Importaci´ on Masiva Descripci´ on

El Administrador de Biblioteca puede realizar una importaci´on masiva de marcadores para un a˜ no espec´ıfico a partir de un fichero csv. 6.4.2.

Precondiciones

El Administrador de Biblioteca se encuentra validado por el sistema. Include caso de uso Validar Usuario Secci´ on 6.2 en la p´ agina 8. 6.4.3.

Escenario Principal

1. El Administrador de Biblioteca desea realizar una importaci´on masiva. 2. El Administrador de Biblioteca indica el fichero csv desde el que realizar la importaci´on y el a˜ no al que pertenecen los datos. 3. El Sistema analiza el fichero csv existe y muestra los datos que van a ser importados. 4. El Administrador de Biblioteca verifica los datos que van a ser importados y confirma la importaci´ on. 5. Los datos quedan introducidos en el sistema. 6.4.4.

Escenarios Alternativos

6.4.5.

Escenarios de Error

3.a Existe alg´ un marcador con errores en sus campos. 1. El Sistema indica que campos son err´oneos al mostrar los datos. 3.b Alg´ un marcador ya tiene valor para ese a˜ no y va a ser sobreescrito. 1. El Sistema indica que marcador va a ser sobreescrito y pide confirmaci´on. 3.c Alguna l´ınea del fichero csv no sigue el formato correcto y no puede ser leida. 1. El Sistema muestra un error e indica las l´ıneas que no pueden ser leidas. 6.4.6.

Escenario de Excepci´ on

*.a En cualquier momento el Administrador de Biblioteca puede cancelar la importaci´on. 1. El Administrador de Biblioteca indica que la importaci´on debe ser cancelada. 2. El Sistema cancela la importaci´ on.

6.5. 6.5.1.

Caso de Uso: Gesti´ on de Administradores Descripci´ on

El Administrador de Biblioteca puede autorizar/denegar la entrada a otros administradores. 11

11


6.5

Caso de Uso: Gesti´ on de Administradores Especificaci´ on La Biblioteca en Cifras

6.5.2.

12

Precondiciones

El Administrador de Biblioteca se encuentra validado por el sistema. Include caso de uso Validar Usuario Secci´ on 6.2 en la p´ agina 8. 6.5.3.

Escenario Principal

1. El Administrador de Biblioteca desea a˜ nadir un administrador nuevo. 2. El Administrador de Biblioteca introduce el identificador UCA del otro administrador. 3. El Sistema comprueba que el identificador es correcto, que el usuario existe y que no est´a ya como administrador. 4. El nuevo administrador queda registrado como Administrador de Biblioteca y tendr´a acceso a los datos. 6.5.4.

Escenarios Alternativos

1.a El Administrador de Biblioteca desea eliminar un administrador. El Administrador de Biblioteca selecciona el identificador UCA de la lista e indica que desea eliminarlo. El Sistema comprueba que el administrador a eliminar no es el mismo Administrador de Biblioteca . El administrador queda eliminado. 6.5.5.

Escenarios de Error

3.a El identificador UCA no es correcto y el Sistema indica el error. 3.b No existe ninguna persona con ese identificador UCA y el Sistema indica el error. 3.c Si la persona con ese identificador UCA ya existe como administrador el Sistema indica el error.

12

12

sssssssssssss  

sssssssssssss

Read more
Read more
Similar to
Popular now
Just for you