Diferencias

Muestra las diferencias entre dos versiones de la página.

--- es:manual:items:interactivos:evaluacion [2021/06/13 19:32] – root
+++ es:manual:items:interactivos:evaluacion [2023/02/19 10:02] (actual) – root
@@ Línea 3: / Línea 3: @@
 Actualmente la manera mas habitual de que una pagina web tenga cierta interacción con el usuario es mediante la incorporación de programas escritos en el lenguaje [[wp>javascript]] que permite controlar, crear, editar y borrar los elementos que se muestran en la pagina que se carga en el navegador, así como interactuar con el servidor en caso necesario.
-Para crear un item interactivo es necesario definir como base un ítem de respuesta libre. Pueden utilizarse también los ítem de multiple opción, ya sean de respuesta única o múltiple, pero por lo general como se verá mas adelante, los item de respuesta libre se adaptan mejor en la mayoría de las situaciones. El siguiente es un ejemplo simple de un ítem interactivo:
+Para crear un item interactivo es necesario definir como base un [[es:manual:items:tiposbasicos:respuesta_libre|ítem de respuesta libre]]. Pueden utilizarse también los ítem de multiple opción, ya sean de respuesta [[es:manual:items:tiposbasicos:respuesta_unica|única]] o [[es:manual:items:tiposbasicos:respuesta_multiple|múltiple]], pero por lo general como se verá mas adelante, los item de respuesta libre se adaptan mejor en la mayoría de las situaciones. El siguiente es un ejemplo simple de un ítem interactivo:
 {{ es:manual:items:interactiva-ejemplo1-1.png?400 |}}
@@ Línea 32: / Línea 32: @@
 </code>
-==== Función evaluacion() ====
+==== Función evaluación ====
 Para que este ítem funcione, el profesor (diseñador del ítem) debe proporcionar una función que tras la interacción del usuario responda como si lo hiciera el alumno en un campo de texto, es decir, debe concatenar el nombre y el apellido y devolverlo como respuesta. Para ello debe incluir en el enunciado la función ''evaluacion()'' y devolver este valor.
@@ Línea 51: / Línea 51: @@
 {{ es:manual:items:interactiva-ejemplo1-2.png?400 |}}
-==== Función resolver() ====
+==== Función resolver ====
 Dependiendo del tipo de ítem interactivo, puede que la respuesta del alumno, que desde el punto de vista de Siette  siempre es una cadena de texto, al contrario de lo que sucede en el ejemplo anterior, no sea legible, por ejemplo en el caso de que la cadena de respuesta sea una secuencia de acciones, unos indicdores numéricos, un fichero xml o cualquier otra circunstancia.
@@ Línea 84: / Línea 84: @@
 {{ es:manual:items:interactiva-ejemplo1-3b.png?400 |}}
-==== Función solucion() ====
+==== Función solucion ====
 Otra función similar a la anterior es la función ''solucion'', que es llamada por Siette cuando es necesario mostrar la respuesta correcta al alumno.
@@ Línea 112: / Línea 112: @@
 Una práctica frecuente es dejar inicialmente ''false'' y una vez que ya se ha probado y depurado el  ítem cambiar el valor devuelto a ''true''.
-==== Función uploadFile() ====
+==== Función uploadFile ====
-En ocasiones, el ítem extendido requiere guardar una representación de la interacción con el alumno para poder volver a mostrarla. Normalmente basta con almacenar la respuesta devuelta por la [[#funcion evaluacion()]], pero en algunos casos es interesante para el profesor conocer cuales han sido las acciones del alumno. De hecho, esto es imprescindible si se quiere tener la posibilidad de cambiar los criterios de evaluación, reproducir las respuestas del alumno y volver a corregir la sessión, siendo esta una de las caractarísticas mas interesantes de Siette.
+En ocasiones, el ítem extendido requiere guardar una representación de la interacción con el alumno para poder volver a mostrarla. Normalmente basta con almacenar la respuesta devuelta por la [[#funcion evaluacion()]], pero en algunos casos es interesante para el profesor conocer cuales han sido las acciones del alumno. De hecho, esto es imprescindible si se quiere tener la posibilidad de cambiar los criterios de evaluación, reproducir las respuestas del alumno y [[es:help_test_sessions#Acciones|volver a corregir]] la sessión, siendo esta una de las caractarísticas mas interesantes de Siette.
 La representación de las interaciones depende del tipo de pregunta, por lo que el formato del fichero a guardar no se especifica, simplemente basta con que sea legible y reproducible por el mismo programa que lo generó.
@@ Línea 138: / Línea 138: @@
 </code>
-La función ''uploadFile(str)'' recibe como argumento una cadena de caracteres y la almacena en un fichero, cuyo nombre viene determinado en la pestaña [[Avanzado]] de la sección de [[Preguntas]]. La [#función evaluación()]] recopilará la información necesaria e incluirá una llamada a esta función.
+La función ''uploadFile(str)'' recibe como argumento una cadena de caracteres y la almacena en un fichero, cuyo nombre viene determinado en la pestaña [[es:help_items_advanced|Avanzado]] de la sección de [[es:help_items
+|Preguntas]]. La [[#función evaluación()]] recopilará la información necesaria e incluirá una llamada a esta función.
-==== Función downloadFile() ====
+==== Función downloadFile ====
-Cuando el ítem ha enviado un fichero medainte la [[#funcion uploadFile()]] el fichero se almacena en el directorio auxiliar de la asignatura, asociada a la instancia de la pregunta que lo generó. Cuando es necesario reproducir la pregunta, por ejemplo para mostrar la corrección o la solución se hace necesario llamar a la funcion ''downloadFile(elemento)'' que hará que Siette recupere en el ''elemento'' HTML que se le pase como parámetro el contenido del fichero en formato cadena de caracteres. Para evitar posibles confusiones al programar, opcionalmente puede pasarse como parámetro de esta función el elemento o el ''id'' del elemento, que se recupera mediante ''document.getElementByIId(id)''. La llamada a la funcion ''downloadFile'' se incluirá normalmente en la [[#funcion resolver()]].
+Cuando el ítem ha enviado un fichero mediante la [[#función uploadFile()]] el fichero se almacena en el [[es:manual:temas#directorio auxiliar]] de la asignatura, asociada a la instancia de la pregunta que lo generó. Cuando es necesario reproducir la pregunta, por ejemplo para mostrar la corrección o la solución se hace necesario llamar a la funcion ''downloadFile()'' que devuelve el contenido del fichero en formato cadena de caracteres. La llamada a la funcion ''downloadFile'' se incluirá normalmente en la [[#función resolver()]] para poder mostrar activamente la respuesta del alumno.
+==== Función RespuestaActiva ====
+La función ''RespuestaActiva(respuesta)'' es una alternativa a la [[#funcion evaluacion()]]. Es una función ya implementada en Siette que recibe un único parámetro con la respuesta del alumno. Esta función fuerza la terminación de la pregunta interactiva y manda la respuesta a Siette. Esta pensada para que el código de la pregunta interactiva pueda decidir por si mismo terminar la interacción, bien sea or que se han alcanzado los objetivos, porque ya no queda nada más que hacer, o por que ha transcurrido un tiempo suficiente. El caso es que si la aplicación javascript llama a esta función, debe pasarle como parámetro la ''respuesta'' del alumno.
+==== Función RespuestaPasiva ====
+Esta función es en realidad la función a la que Siete llama cuando el alumno pulsa el botón ''Siguiente'' o cuando por ejemplo ha transcurrido el tiempo asignado a la pregunta en los [[test temporizados]]. La llamada a esta función provoca la llamada a la [[#funcion evaluacion()]]  que comunica con la aplicación y devuelve la respuesta. Es decir, cesta función entra en juego cuando la aplicación no decide terminar por si misma, sino cuando la decisión se toma fuera de la aplicación interactiva.
+Normalmente esta función no debe usarse directamente. Use la [[#funcion evaluacion()]].