From PatioWiki

Revision as of 07:29, 13 October 2011

Class diagrams

The following image shows the summarized class diagram of the manual editor of To match sound-image exercises that is part of Tareas.

1000px|Diagrama de clases del editor Emparejar Sonido-imagen manual.

In the diagram above we can see that the information of the exercise that is being edited will be stored in the "CurrentEmparejarExercise" class, that has all static fields. This class also stores the information of all image-sound pairs that the exercise has and each of them is represented by an instance of the "PairInfo" class.

The main panel is an object of class "EmparejarMainPanel" which contains three subpanels: "Image-sound pairs", "Images" and "Sounds".

The image-sound pairs panel ("leftPanel") is a "PreviewPanel" object and contains a toolbar and the panel that contains all exercise pairs ("PairsPanel"). The exercise configuration panel is an "ExerciseConfigPanel" object and it is instantiated each time the user clicks on the corresponding button located in the image-sound pairs panel toolbar.

An object of type "MultimediaResourcesFilterPanel" ("rightPanel") creates two instances of the class "MultimediaFilterPanel". Each of these instances represents a panel that filters all the available multimedia resources by type (images, sounds, videos...) and in this case are "Images" and "Sounds" panels.

Use cases

800px|Diagrama de casos de uso del editor manual de ejercicios Emparejar sonido-imagen.

Next there is a textual description of the use cases of the "To match sound-image pairs" exercises manual editor.

1. Use case: Initial configuration.

     Main actor: User. 
     Preconditions: It has just started this exercises editor to create a new exercise.
     Main success scenario: 
             1. The tool shows the user the initial configuration window.
             2. The user selects the exercise language, the number of empty pairs to be added to it and presses the "OK button". The tool shows this editor with a new exercise with the initial configuration.

2. Use case: Add a new pair.

     Main actor: User. 
     Preconditions: This editor must be running.
     Main success scenario: 
             1. The user presses the "Add" button located at the "Image-sound pairs" panel.
             2. The tool adds a new empty pair at the end of the image-sound pairs list. 

3. Use case: Eliminar el par seleccionado.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y tener un par imagen-sonido seleccionado.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Eliminar” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta elimina el par seleccionado en la lista de pares imagen-sonido. 

4. Caso de uso: Subir una posición el par seleccionado.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución, tener un par imagen-sonido seleccionado y 	debe tener al menos un par situado por encima de él.
     Escenario de éxito principal:  
             1. El usuario pulsa el botón “Subir” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta sube una posición al par seleccionado en la lista de pares imagen-sonido. 

5. Caso de uso: Bajar una posición el par seleccionado.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución, tener un par imagen-sonido seleccionado y 	debe tener al menos un par situado por debajo de él.
     Escenario de éxito principal:  
             1. El usuario pulsa el botón “Bajar” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta baja una posición al par seleccionado en la lista de pares imagen-sonido. 

6. Caso de uso: Cambiar el estado correcto/incorrecto de un par.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de 	pares imagen-sonido.
     Escenario de éxito principal:  
             1. El usuario pulsa sobre la columna "Correcto" de un par determinado.
             2. La herramienta cambia el estado del par de correcto a incorrecto o viceversa. 

7. Caso de uso: Asociar un sonido a un par.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de 	pares imagen-sonido.
     Escenario de éxito principal: 
             1. El usuario buscará el sonido deseado en el panel "Sonidos". Una vez localizado el sonido, pulsará sobre él para seleccionarlo y, sin soltarlo, lo arrastrará y soltará sobre la columna "Sonido" del par situado 
                en el panel de pares imagen-sonido al que se le quiera asociar. 
             2. La herramienta asocia el sonido al par sobre el que fue soltado. 

8. Caso de uso: Quitar un sonido de un par.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de 	pares imagen-sonido.
     Escenario de éxito principal:  
             1. El usuario pulsa con el botón derecho del ratón sobre el par al que quiere quitarle el sonido que tiene asociado.
             2. La herramienta muestra al usuario un pequeño menú de opciones.
             3. El usuario selecciona la opción "Quitar sonido". 
             4. La herramienta quita el sonido que tenía asociado el par. 

9. Caso de uso: Asociar una imagen a un par.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de 	pares imagen-sonido.
     Escenario de éxito principal:  
             1. El usuario buscará la imagen deseada en el panel "Imágenes". Una vez localizada la imagen, pulsará sobre ella para seleccionarla y, sin soltarla, la arrastrará y soltará sobre la columna "Imagen" del par situado
                en el panel de pares imagen-sonido al que se le quiera asociar. 
             2.La herramienta asocia la imagen al par sobre el que fue soltado. 

10. Caso de uso: Quitar una imagen a un par.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de 	pares imagen-sonido.
     Escenario de éxito principal:  
             1.El usuario pulsa con el botón derecho del ratón sobre el par al que quiere quitarle la imagen que tiene asociada.
             2.La herramienta muestra al usuario un pequeño menú de opciones.
             3.El usuario selecciona la opción "Quitar imagen". 
             4.La herramienta quita la imagen que tenía asociada el par. 

11. Caso de uso: Reproducir un sonido de un par.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de 	pares imagen-sonido que tenga un sonido asociado.
     Escenario de éxito principal: 
             1. El usuario pulsa sobre el contenido de la columna "Sonido" de un par determinado.
             2. La herramienta reproduce el sonido asociado a dicho par. 

12. Caso de uso: Obtener información.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario sitúa el cursor del ratón sobre cualquier componente del editor.
             2. La herramienta muestra información emergente de dicho componente. 

13. Caso de uso: Editar el nombre del ejercicio.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario introduce el nombre del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
             4. La herramienta asocia el nuevo nombre al ejercicio que se está editando.

14. Caso de uso: Editar enunciado del ejercicio.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario introduce el enunciado del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
             4. La herramienta asocia el nuevo enunciado al ejercicio que se está editando.

15. Caso de uso: Cambiar el tiempo mostrando imagen.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario introduce el tiempo mostrando imagen  (en milisegundos) en su campo correspondiente y pulsa el botón “Aceptar”.
             4. La herramienta asocia el nuevo tiempo mostrando imagen al ejercicio que se está editando.

16. Caso de uso: Cambiar tiempo entre imagen y sonido.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario introduce el tiempo entre imagen y sonido (en milisegundos) del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
             4. La herramienta asocia el nuevo tiempo entre imagen y sonido al ejercicio que se está editando.

17. Caso de uso: Cambiar tiempo entre sonido e imagen.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario introduce el tiempo entre sonido e imagen (en milisegundos) del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
             4. La herramienta asocia el nuevo tiempo entre sonido e imagen al ejercicio que se está editando.

18. Caso de uso: Cambiar orden de aparición de los pares.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario pulsa sobre la casilla “Orden de imágenes aleatorio” y pulsa el botón “Aceptar”.
             4. La herramienta cambia el orden de aparición que tendrán los pares durante la ejecución del ejercicio de normal a aleatorio o viceversa.

19. Caso de uso: Cambiar modo del ejercicio.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario selecciona el modo (Aprendizaje o Evaluación) en el campo “Modo” y pulsa el botón “Aceptar”.
             4. La herramienta establece el modo seleccionado para el ejercicio que se está editando.

20. Caso de uso: Asignar un sonido general.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario busca el sonido deseado en la parte inferior del panel “Sonidos generales del ejercicio”.  
             4. Una vez localizado el sonido, el usuario pulsa sobre él para seleccionarlo y, sin soltarlo, lo arrastrará y soltará sobre uno de los sonidos generales (Enunciado, Correcto, Incorrecto y Despedida) 
                situados encima de este panel para asignárselo. 
             5. La herramienta asocia el sonido seleccionado al sonido general sobre el que fue soltado. 

21. Caso de uso: Quitar un sonido general.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario pulsa el botón "Quitar sonido" (representado por una cruz roja) que estará situado a la derecha de sonido general al que se le quiere quitar el sonido. 
             4. La herramienta quita el sonido general del ejercicio.

22. Caso de uso: Reproducir un sonido general.

     Actor principal: Usuario. 
     Precondiciones: Este editor debe estar en ejecución y el sonido general debe haber sido 	asignado previamente.
     Escenario de éxito principal: 
             1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
             2. La herramienta muestra el panel de configuración del ejercicio.
             3. El usuario pulsa sobre el sonido general a reproducir (representado por la imagen de un altavoz) . 
             4. La herramienta reproduce el sonido general.