Tareas: General part - Revision history

Pedro at 09:52, 10 November 2011

2011-11-10T09:52:54Z

← Older revision		Revision as of 09:52, 10 November 2011
Line 102:		Line 102:
	'''7. Use case: '''Preview exercise.		'''7. Use case: '''Preview exercise.
	'''Main actor: '''User.		'''Main actor: '''User.
-	'''Preconditions: '''Tareas must be running and the exercise that is being edited must ~~have~~ all required information.	+	'''Preconditions: '''Tareas must be running and the exercise that is being edited must has all the required information.
	'''Main success scenario: '''		'''Main success scenario: '''
	1. The user clicks the "Preview" button located in the lower toolbar.		1. The user clicks the "Preview" button located in the lower toolbar.
-	2. Tareas loads the exercise that is being edited with the [[Aprendo]] module panel that allows the ~~exercises~~ reproduction.	+	2. Tareas loads the exercise that is being edited with the [[Aprendo]] module panel that allows the exercise reproduction.
-	3. [[Aprendo]] starts ~~executing~~ the exercise.	+	3. [[Aprendo]] starts the exercise reproduction.
	4. Tareas displays a new window with the reproduction of the exercise that is being edited.		4. Tareas displays a new window with the reproduction of the exercise that is being edited.
	4. The user presses the "Ok" button to finish.		4. The user presses the "Ok" button to finish.
-	5. Tareas ends the exercise reproduction at [[Aprendo]] and returns to the ~~exercises~~ editor in the state it had before the preview.	+	5. Tareas ends the exercise reproduction at [[Aprendo]] and returns to the exercise editor in the state it had before the preview.


Line 117:		Line 117:
	'''8. Use case: '''Save exercise.		'''8. Use case: '''Save exercise.
	'''Main actor: '''User.		'''Main actor: '''User.
-	'''Preconditions: '''Tareas must be running and the exercise that is being edited must ~~have~~ all required information.	+	'''Preconditions: '''Tareas must be running and the exercise that is being edited must has all required information.
	'''Main success scenario: '''		'''Main success scenario: '''
	1. The user clicks the "Save" button located in the lower toolbar.		1. The user clicks the "Save" button located in the lower toolbar.

Pedro at 09:47, 10 November 2011

2011-11-10T09:47:24Z

← Older revision		Revision as of 09:47, 10 November 2011
Line 1:		Line 1:
-	This section contains all the technical information relating to the part of the tool that is common to all the ~~exercises~~ editors that are part of [[Tareas]].	+	This section contains all the technical information relating to the part of the tool that is common to all the exercise editors that are part of [[Tareas]].

	= Class diagrams =		= Class diagrams =
Line 9:		Line 9:


-	As shown in the diagram above, there is a main class called "MainPanel" which represents the main panel of the tool. This class contains both the main toolbar ("mainToolBar") as the bottom toolbar ("previewSaveToolBar"). Between them stands the "exercisePanel" panel, where all the exercise editors will be shown. The main class is also responsible for storing any general information of the tool.	+	As shown in the diagram above, there is a main class called "MainPanel" which represents the main panel of the tool. This class contains both the main toolbar ("mainToolBar") and the bottom toolbar ("previewSaveToolBar"). Between them stands the "exercisePanel" panel, where all the exercise editors will be shown. The main class is also responsible for storing any general information of the tool.

-	The class "mainToolBar", which is the main toolbar, is responsible to perform operations like ~~create~~, ~~edit and delete exercises~~, ~~and is also used for~~ establishing the configuration ~~of the tool~~. To perform these operations, some panels like "ExerciseTypeSelectPanel" (~~for selecting~~ the exercise type) or "ButtonsConnectionPanel" (~~for the configuration of~~ the tool) can be shown to the user.	+	The class "mainToolBar", which is the main toolbar, is responsible to perform operations like creating, editing, deleting exercises or establishing the general tool configuration. To perform these operations, some panels like "ExerciseTypeSelectPanel" (to select the exercise type) or "ButtonsConnectionPanel" (to configure the tool) can be shown to the user.

-	Using the "previewSaveToolBar" toolbar, you can make operations of the last phase of creating an exercise like preview or save an exercise.	+	Using the "previewSaveToolBar" toolbar, you can make operations in the last phase of creating an exercise, like preview or save an exercise.

-	~~When loading an exercises editor at the "exercisePanel" panel, the top toolbar (~~"mainToolBar"~~) does not change and, therefore,~~ will be the same for all editors types. However, the bottom toolbar may vary depending on the exercise type and the editing mode you are using.	+	The "mainToolBar" will be the same for all editors types. However, the bottom toolbar ("previewSaveToolBar") may vary depending on the exercise type and the editing mode you are using.


Line 26:		Line 26:


-	Next there is a textual description of the general use cases of [[Tareas]].	+	Next, there is a textual description of the general use cases of [[Tareas]].


Line 33:		Line 33:
	'''Preconditions: '''Tareas must be running and the connection configuration parameters must be properly configured.		'''Preconditions: '''Tareas must be running and the connection configuration parameters must be properly configured.
	'''Main success scenario: '''		'''Main success scenario: '''
-	1. The user clicks on the select connection type panel located in the toolbar.	+	1. The user clicks on the select connection type panel located in the main toolbar.
	2. Tareas shows all the available connection types.		2. Tareas shows all the available connection types.
	3. The user selects the connection type.		3. The user selects the connection type.
-	4. ~~Tasks~~ attempts a connection to the selected database.	+	4. Tareas attempts a connection to the selected database.
-	5. The connection to the dabase is ~~completed~~ succesfully.	+	5. The connection to the dabase is succesfully completed.
-	6. Tareas updates all its components according to data obtained from the database.	+	6. Tareas updates all its components according to the data obtained from the database.


Line 48:		Line 48:
	'''Preconditions: '''Tareas must be running and the connection configuration parameters must be properly configured.		'''Preconditions: '''Tareas must be running and the connection configuration parameters must be properly configured.
	'''Main success scenario: '''		'''Main success scenario: '''
-	1. The user clicks the "Refresh" button located in the toolbar.	+	1. The user clicks the "Refresh" button located in the main toolbar.
	2. Tareas attempts to reconnect to the selected database.		2. Tareas attempts to reconnect to the selected database.
-	3. The reconnection to the dabase is ~~completed~~ succesfully.	+	3. The reconnection to the dabase is succesfully completed.
-	4. Tareas updates all its components according to data obtained from the database.	+	4. Tareas updates all its components according to the data obtained from the database.

	'''3. Use case: '''Configure the tool.		'''3. Use case: '''Configure the tool.
Line 57:		Line 57:
	'''Preconditions: '''Tareas must be running.		'''Preconditions: '''Tareas must be running.
	'''Main success scenario: '''		'''Main success scenario: '''
-	1. The user clicks the "Configure" button located in the toolbar.	+	1. The user clicks the "Configure" button located in the main toolbar.
-	2. Tareas shows the window that ~~allow~~ to set the configuration parameters of the tool.	+	2. Tareas shows the window that allows to set the configuration parameters of the tool.

	'''4. Use case: '''Create new exercise.		'''4. Use case: '''Create new exercise.
Line 64:		Line 64:
	'''Preconditions: '''Tareas must be running.		'''Preconditions: '''Tareas must be running.
	'''Main success scenario: '''		'''Main success scenario: '''
-	1. The user clicks the "New" button located in the toolbar.	+	1. The user clicks the "New" button located in the main toolbar.
-	2. Tareas shows ~~the window for the selection of~~ the exercise type ~~that will be created~~.	+	2. Tareas shows the exercise type selection window.
-	3. The user selects the exercise type and presses the "Ok" button.	+	3. The user selects the exercise type that he wants to create and presses the "Ok" button.
-	4. Tareas shows the window ~~for the selection of~~ the edition mode.	+	4. Tareas shows the window that allows to select the edition mode.
	5. The user selects the edition mode and presses the "Ok" button.		5. The user selects the edition mode and presses the "Ok" button.
	6. Tareas creates a new exercise of the selected type, loads it into the appropiate manual editor and shows it to the user.		6. Tareas creates a new exercise of the selected type, loads it into the appropiate manual editor and shows it to the user.
Line 73:		Line 73:
	'''5. Use case: '''Edit exercise.		'''5. Use case: '''Edit exercise.
	'''Main actor: '''User.		'''Main actor: '''User.
-	'''Preconditions: '''Tareas must be running and the exercise must ~~exist~~.	+	'''Preconditions: '''Tareas must be running and the exercise must exists.
	'''Main success scenario: '''		'''Main success scenario: '''
-	1. The user clicks the "Open" button located in the toolbar.	+	1. The user clicks the "Open" button located in the main toolbar.
-	2. Tareas shows ~~the window for the selection of~~ the exercise type ~~that will be edited~~.	+	2. Tareas shows the exercise type selection window.
-	3. The user selects the exercise type to edit.	+	3. The user selects the exercise type that he wants to edit and presses the "Ok" button.
	4. Tareas shows the available exercises of the selected type.		4. Tareas shows the available exercises of the selected type.
	5. The user selects the exercise and presses the "Ok" button.		5. The user selects the exercise and presses the "Ok" button.
-	6. Tareas opens the selected exercise ~~with~~ the ~~exercises~~ editor of the selected type ready for ~~his~~ edition.	+	6. Tareas opens the selected exercise using the manual exercise editor for the selected type, ready for its edition.

	'''6. Use case: '''Delete exercise.		'''6. Use case: '''Delete exercise.
	'''Main actor: '''User.		'''Main actor: '''User.
-	'''Preconditions: '''Tareas must be running and the exercise must ~~exist~~.	+	'''Preconditions: '''Tareas must be running and the exercise must exists.
	'''Main success scenario: '''		'''Main success scenario: '''
-	1. The user clicks the "Delete" button located in the toolbar.	+	1. The user clicks the "Delete" button located in the main toolbar.
-	2. Tareas shows ~~the window for the selection of~~ the exercise type ~~that will be removed~~.	+	2. Tareas shows the exercise type selection window.
-	3. The user selects the exercise type to remove.	+	3. The user selects the exercise type that he wants to remove and presses the "Ok" button.
	4. Tareas shows the available exercises of the selected type.		4. Tareas shows the available exercises of the selected type.
-	5. The user selects the exercise ~~or exercises~~ and presses the "Ok" button.	+	5. The user selects the exercise/s and presses the "Ok" button.
	6. Tareas shows a confirm message before continuing the process.		6. Tareas shows a confirm message before continuing the process.
-	7. The user presses the "Ok" button and the process continues.	+	7. The user presses the "Ok" button to confirm and the process continues.
	8. Tareas removes the selected exercises from the database.		8. Tareas removes the selected exercises from the database.
-	9. Tareas shows a success message to the user .	+	9. Tareas shows a success message to the user.

Pedro at 11:59, 13 October 2011

2011-10-13T11:59:49Z

← Older revision		Revision as of 11:59, 13 October 2011
Line 41:		Line 41:


-	[[File:~~Tareas_diagrama_secuencias_cambiar_tipo_conexion_es~~.png‎\|450px\|~~Diagrama de secuencias de Tareas~~: ~~Cambiar tipo de conexión~~.]]	+	[[File:Tareas_general_sequence_diagram_change_connection_type_en.png‎\|450px\|Sequence diagram: Change connection type.]]


Line 97:		Line 97:


-	[[~~Archivo~~:~~Tareas_diagrama_secuencias_borrar_ejercicios_es~~.~~png‎~~\|550px\|~~Diagrama de secuencias de Tareas~~: ~~Borrar ejercicios~~.]]	+	[[File:Tareas_general_sequence_diagram_delete_exercises_en.png‎‎\|550px\|Sequence diagram: Delete exercises.]]


Line 112:		Line 112:


-	[[~~Archivo~~:~~Tareas_diagrama_secuencias_previsualizar_ejercicio_es~~.png‎\|500px\|~~Diagrama de secuencias de Tareas~~: ~~Previsualizar ejercicio~~.]]	+	[[File:Tareas_general_sequence_diagram_preview_exercise_en.png‎ ‎\|500px\|Sequence diagram: Preview exercise.]]


Line 126:		Line 126:


-	[[~~Archivo~~:~~Tareas_diagrama_secuencias_guardar_ejercicio_es~~.png\|500px\|~~Diagrama de secuencias de Tareas~~: ~~Guardar ejercicio~~.]]	+	[[File:Tareas_general_sequence_diagram_save_exercise_en.png\|500px\|Sequence diagram: Save exercise.]]


	[[Category: Tareas]]		[[Category: Tareas]]

Pedro at 11:24, 13 October 2011

2011-10-13T11:24:12Z

← Older revision		Revision as of 11:24, 13 October 2011
Line 23:		Line 23:


-	[[~~Archivo~~:~~Tareas_diagrama_casos_de_uso_general_es~~.~~png~~\|600px\|~~Diagrama general de casos de uso de~~ Tareas.]]	+	[[File:Tareas_general_use_cases_diagram_en.png‎ \|600px\|General use case diagram of Tareas.]]


Line 41:		Line 41:


-	[[~~Archivo~~:Tareas_diagrama_secuencias_cambiar_tipo_conexion_es.png‎\|450px\|Diagrama de secuencias de Tareas: Cambiar tipo de conexión.]]	+	[[File:Tareas_diagrama_secuencias_cambiar_tipo_conexion_es.png‎\|450px\|Diagrama de secuencias de Tareas: Cambiar tipo de conexión.]]

Pedro at 11:12, 13 October 2011

2011-10-13T11:12:56Z

← Older revision		Revision as of 11:12, 13 October 2011
Line 6:		Line 6:


-	[[~~Archivo~~:~~Tareas_diagrama_de_clases_general_es~~.png\|700px\|~~Diagrama de clases~~ general.]]	+	[[File:Tareas_general_class_diagram_en.png\|700px\|Tareas general class diagram.]]

Pedro at 11:42, 11 October 2011

2011-10-11T11:42:30Z

← Older revision		Revision as of 11:42, 11 October 2011
Line 26:		Line 26:


-	Next there is a textual description of the general use cases of [[Tareas]]..	+	Next there is a textual description of the general use cases of [[Tareas]].

Pedro at 11:15, 11 October 2011

2011-10-11T11:15:12Z

← Older revision		Revision as of 11:15, 11 October 2011
Line 91:		Line 91:
	4. Tareas shows the available exercises of the selected type.		4. Tareas shows the available exercises of the selected type.
	5. The user selects the exercise or exercises and presses the "Ok" button.		5. The user selects the exercise or exercises and presses the "Ok" button.
-	6. Tareas removes the selected exercises from the database.	+	6. Tareas shows a confirm message before continuing the process.
-	7. Tareas shows a success message to the user .	+	7. The user presses the "Ok" button and the process continues.
		+	8. Tareas removes the selected exercises from the database.
		+	9. Tareas shows a success message to the user .


Line 107:		Line 109:
	4. Tareas displays a new window with the reproduction of the exercise that is being edited.		4. Tareas displays a new window with the reproduction of the exercise that is being edited.
	4. The user presses the "Ok" button to finish.		4. The user presses the "Ok" button to finish.
-	5. Tareas ends the exercise reproduction at [[Aprendo]] and returns to the exercises editor in the state before the preview.	+	5. Tareas ends the exercise reproduction at [[Aprendo]] and returns to the exercises editor in the state it had before the preview.


Line 113:		Line 115:


-	'''8. ~~Caso de uso~~: '''~~Guardar ejercicio~~.	+	'''8. Use case: '''Save exercise.
-	'''~~Actor principal~~: '''~~Usuario~~.	+	'''Main actor: '''User.
-	'''~~Precondiciones~~: '''Tareas ~~debe estar en ejecución y el ejercicio que se está editando debe tener toda la información necesaria~~.	+	'''Preconditions: '''Tareas must be running and the exercise that is being edited must have all required information.
-	'''~~Escenario de éxito principal~~: '''	+	'''Main success scenario: '''
-	1. ~~El usuario pulsa sobre el botón “Guardar” de la barra de herramientas inferior~~.	+	1. The user clicks the "Save" button located in the lower toolbar.
-	2. Tareas ~~almacena el ejercicio en la base de datos seleccionada~~	+	2. Tareas shows a confirm message before continuing the process.
-	3. Tareas ~~muestra un mensaje de éxito al usuario~~.	+	3. The user presses the "Ok" button and the save process continues.
		+	4. Tareas saves the exercise in the selected database.
		+	5. Tareas shows a success message to the user.

Pedro at 11:04, 11 October 2011

2011-10-11T11:04:13Z

← Older revision		Revision as of 11:04, 11 October 2011
Line 98:		Line 98:


-	'''7. ~~Caso de uso~~: '''~~Previsualizar ejercicio~~.	+	'''7. Use case: '''Preview exercise.
-	'''~~Actor principal~~: '''~~Usuario~~.	+	'''Main actor: '''User.
-	'''~~Precondiciones~~: '''Tareas ~~debe estar en ejecución y el ejercicio que se está editando debe tener toda la información necesaria~~.	+	'''Preconditions: '''Tareas must be running and the exercise that is being edited must have all required information.
-	'''~~Escenario de éxito principal~~: '''	+	'''Main success scenario: '''
-	1. ~~El usuario pulsa sobre el botón “Previsualizar” de la barra de herramientas inferior~~.	+	1. The user clicks the "Preview" button located in the lower toolbar.
-	2. Tareas ~~carga el ejercicio que se está editando con el panel del módulo~~ [[Aprendo]] ~~dedicado a la reproducción de ejercicios~~.	+	2. Tareas loads the exercise that is being edited with the [[Aprendo]] module panel that allows the exercises reproduction.
-	3. [[Aprendo]] ~~comienza la ejecución del ejercicio~~.	+	3. [[Aprendo]] starts executing the exercise.
-	4. Tareas ~~muestra al usuario una nueva ventana con la ejecución del ejercicio que se está editando~~.	+	4. Tareas displays a new window with the reproduction of the exercise that is being edited.
-	4. ~~El usuario pulsa el botón~~ "~~Aceptar~~" ~~para terminar~~.	+	4. The user presses the "Ok" button to finish.
-	5. Tareas ~~finaliza la reproducción del ejercicio en~~ [[Aprendo]] ~~y vuelve a mostrar al usuario el~~ editor ~~de ejercicios en el estado previo a la previsualización~~.	+	5. Tareas ends the exercise reproduction at [[Aprendo]] and returns to the exercises editor in the state before the preview.

-

	[[Archivo:Tareas_diagrama_secuencias_previsualizar_ejercicio_es.png‎\|500px\|Diagrama de secuencias de Tareas: Previsualizar ejercicio.]]		[[Archivo:Tareas_diagrama_secuencias_previsualizar_ejercicio_es.png‎\|500px\|Diagrama de secuencias de Tareas: Previsualizar ejercicio.]]

Pedro at 10:44, 11 October 2011

2011-10-11T10:44:43Z

← Older revision		Revision as of 10:44, 11 October 2011
Line 77:		Line 77:
	1. The user clicks the "Open" button located in the toolbar.		1. The user clicks the "Open" button located in the toolbar.
	2. Tareas shows the window for the selection of the exercise type that will be edited.		2. Tareas shows the window for the selection of the exercise type that will be edited.
-	3. The user selects the exercise type to edit ~~and presses the "Ok" button~~.	+	3. The user selects the exercise type to edit.
	4. Tareas shows the available exercises of the selected type.		4. Tareas shows the available exercises of the selected type.
	5. The user selects the exercise and presses the "Ok" button.		5. The user selects the exercise and presses the "Ok" button.
	6. Tareas opens the selected exercise with the exercises editor of the selected type ready for his edition.		6. Tareas opens the selected exercise with the exercises editor of the selected type ready for his edition.

-	'''6. ~~Caso de uso~~: '''~~Borrar ejercicio~~.	+	'''6. Use case: '''Delete exercise.
-	'''~~Actor principal~~: '''~~Usuario~~.	+	'''Main actor: '''User.
-	'''~~Precondiciones~~: '''Tareas ~~debe estar en ejecución y el ejercicio debe existir~~.	+	'''Preconditions: '''Tareas must be running and the exercise must exist.
-	'''~~Escenario de éxito principal~~: '''	+	'''Main success scenario: '''
-	1. ~~El usuario pulsa sobre el botón “Borrar” de la barra de herramientas~~.	+	1. The user clicks the "Delete" button located in the toolbar.
-	2. Tareas ~~muestra la ventana de selección del tipo de ejercicio que se quiere borrar~~	+	2. Tareas shows the window for the selection of the exercise type that will be removed.
-	3. ~~El usuario selecciona el tipo de ejercicio a borrar~~.	+	3. The user selects the exercise type to remove.
-	4. Tareas ~~muestra a su derecha la lista de ejercicios disponibles del tipo seleccionado~~.	+	4. Tareas shows the available exercises of the selected type.
-	5. ~~El usuario selecciona el ejercicio o ejercicios a borrar y pulsa sobre el botón “Aceptar”~~.	+	5. The user selects the exercise or exercises and presses the "Ok" button.
-	6. Tareas ~~borra de la base de datos los ejercicios seleccionados~~.	+	6. Tareas removes the selected exercises from the database.
-	7. Tareas ~~muestra un mensaje de éxito al usuario~~.	+	7. Tareas shows a success message to the user .

Pedro at 10:32, 11 October 2011

2011-10-11T10:32:46Z

← Older revision		Revision as of 10:32, 11 October 2011
Line 71:		Line 71:
	6. Tareas creates a new exercise of the selected type, loads it into the appropiate manual editor and shows it to the user.		6. Tareas creates a new exercise of the selected type, loads it into the appropiate manual editor and shows it to the user.

-	'''5. ~~Caso de uso~~: '''~~Editar ejercicio~~.	+	'''5. Use case: '''Edit exercise.
-	'''~~Actor principal~~: '''~~Usuario~~.	+	'''Main actor: '''User.
-	'''~~Precondiciones~~: '''Tareas ~~debe estar en ejecución y el ejercicio debe existir~~.	+	'''Preconditions: '''Tareas must be running and the exercise must exist.
-	'''~~Escenario de éxito principal~~: '''	+	'''Main success scenario: '''
-	1. ~~El usuario pulsa sobre el botón “Abrir” de la barra de herramientas~~.	+	1. The user clicks the "Open" button located in the toolbar.
-	2. Tareas ~~muestra la ventana de selección del tipo de ejercicio que se quiere abrir~~.	+	2. Tareas shows the window for the selection of the exercise type that will be edited.
-	3. ~~El usuario selecciona el tipo de ejercicio a abrir~~.	+	3. The user selects the exercise type to edit and presses the "Ok" button.
-	4. Tareas ~~muestra a su derecha la lista de ejercicios disponibles del tipo seleccionado~~.	+	4. Tareas shows the available exercises of the selected type.
-	5. ~~El usuario selecciona el ejercicio a editar y pulsa sobre el botón “Aceptar”~~.	+	5. The user selects the exercise and presses the "Ok" button.
-	6. Tareas ~~abre el ejercicio seleccionado con el~~ editor ~~de ejercicios de ese tipo listo para su edición~~.	+	6. Tareas opens the selected exercise with the exercises editor of the selected type ready for his edition.

	'''6. Caso de uso: '''Borrar ejercicio.		'''6. Caso de uso: '''Borrar ejercicio.