Issuu on Google+

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