Diferencias

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

--- es:manual:integracion:links:items [2024/12/05 09:52] – root
+++ es:manual:integracion:links:items [2024/12/11 13:31] (actual) – root
@@ Línea 1: / Línea 1: @@
 ===== Integración de preguntas =====
-Esta modo de integración permite que otro sistema externo presente de forma independiente una (y solo una) pregunta de Siette en concreto. En este caso Siette solo se presenta la pregunta de forma independiente, La pregunta aparece directamente, sin necesidad de identificar al usuario (la llamada debe incluir el parámetro "anon", tal como se describe en la sección [[es:manual:integracion:links|Integracion mediante enlaces]])
+Esta modo de integración permite que otro sistema externo presente de forma independiente una (y solo una) pregunta de Siette en concreto. En este caso Siette solo [[es:manual:items:independientes|se presenta la pregunta de forma independiente]], La pregunta aparece directamente, sin necesidad de identificar al usuario (la llamada debe incluir el parámetro "anon", tal como se describe en la sección [[es:manual:integracion:links|Integracion mediante enlaces]])
-La llamada a Siette en este caso incluye un nuevo parametro '''idpreg''' que identifica la pregunta a presentar, y un parámetro '''idtest''', cuyo valor es fijo y enlaza a un test virtual. Si se trata de una pregunta compuesta se presentara la pregunta completa, con sus múltiples apartados. Si se trata de una pregunta generativa se generará una instancia concreta.
+La llamada a Siette en este caso incluye un nuevo parámetro ''idpreg'' que identifica la pregunta a presentar, y un parámetro ''idtest'', cuyo valor es fijo y enlaza a un [[es:manual:test:virtual|test virtual]]. Si se trata de una pregunta compuesta se presentara la pregunta completa, con sus múltiples apartados. Si se trata de una pregunta generativa se generará una instancia concreta.
-[[ https://www.siette.org/siette?idtest=19127&idpreg=91794&anon|https://www.siette.org/siette?idtest=19127&idpreg=91794&anon ]]
+[[https://www.siette.org/siette?idtest=848698&idpreg=91794&anon]]
-Si el sistema externo incluye en la llamada los parámetros '''urlreport''' y '''urlback''' (ver descripcion en el aparatado [[es:manual:integracion:links:report|Integracion con resultados]]) tras presentar la pregunta Siette informará del resultado invocando a la dirección especificada en '''urlreport''' y tras mostrar la solución devolvera el control de navegación a la dirección indicada mediante '''urlback'''.
+Si el sistema externo incluye en la llamada los parámetros ''urlreport'' y ''urlback'' (ver descripcion en el aparatado [[es:manual:integracion:links:report|Integracion con resultados]]) tras presentar la pregunta Siette informará del resultado invocando a la dirección especificada en ''urlreport'' y tras mostrar la solución devolvera el control de navegación a la dirección indicada mediante ''urlback''.
 === Funcionamiento interno y composición de los enlaces ===
-Técnicamente, lo que ocurre en Siette es que se ejecuta un test especial denominado "test virtual" que sirve de soporte a este tipo de preguntas. Dicho test debe crearse previamente en Siette si se quiere que esta funcionalidad este disponible. Para ello basta declarar en la asignatura que se [[es:help_subjects_data#Permitir el uso de preguntas como contenido independiente|permite el uso de preguntas de forma independiente]]. Si se intenta acceder a una pregunta que no permite el acceso directo, o bien éste está restringido por la asignatura, ocurrirá un error.
+Técnicamente, lo que ocurre en Siette es que se ejecuta un test especial denominado [[es:manual:test:virtual|test virtual]] que sirve de soporte a este tipo de preguntas. Dicho test debe crearse previamente en Siette si se quiere que esta funcionalidad este disponible. Para ello basta declarar en la asignatura que se [[es:help_subjects_data#Permitir el uso de preguntas como contenido independiente|permite el uso de preguntas de forma independiente]]. Si se intenta acceder a una pregunta que no permite el acceso directo, o bien éste está restringido por la asignatura, ocurrirá un error.
+Las preguntas que pueden usarse de este modo generan directamente un enlace y un código QR correspondiente en la pestaña [[es:help_items_information|Informacion]] de la sección de [[es:help_items|Preguntas]]. A este enlace solo hay que añadirle los parámetros ''urlreport'' y ''urlback'' en caso necesario, del mismo modo que se hace en la [[es:manual:integracion:links:report|integración con resultados]] descrita anteriormente. Por ejemplo:
+[[https://www.siette.org/siette?idtest=848698&idpreg=91794&anon&urlback=https://www.siette.org/siette?idtest=19127]]
+presenta la pregunta correspondiente a "Alpha" y al terminar invoca al test de Siette que incluye preguntas sobre el alfabeto griego.
+El funcionamiento interno de este mecanismo de integración incluye el denominado [[es:manual:test:virtual|test virtual]]. Las preguntas que se muestran de forma independiente en realidad son preguntas incluidas en una sesión de este [[es:manual:test:virtual|test virtual]]. Si un mismo alumno requiere mediante uno de estos enlaces una pregunta y después otra y otra, cada pregunta se presentará de forma independiente, y probablemente devolviendo el control al sistema externo una vez resuelta. Sin embargo, desde el punto de vista de Siette dicho alumno ha iniciado una sesión del [[es:manual:test:virtual|test virtual]], ha abandonado la sesión, ha vuelto a recuperar la sesión continuando con una segunda pregunta elegida de forma determinista, ha vuelto a abandonar la sesión, la ha vuelto a recuperar, etc.
+En este funcionamiento hay varios casos particulares:
+  * Si el alumno ha dejado pasar demasiado tiempo entre una pregunta y otra (12 horas por defecto), el [[es:manual:test:virtual|test virtual]] habrá caducado y no se reanudara la sesión anterior, en este caso simplemente se creara una nueva sesión.(( Nótese que aunque el acceso a Siette es anónimo, Siette es capaz de diferenciar los usuarios anónimos a través de la dirección IP desde la que se conectan, y aun manteniendo el anonimato, puede identificar a un mismo usuario siempre que éste mantenga una misma dirección. En el futuro podrían usarse cookies para esta misma función))
+  * Si se requiere un enlace a una pregunta que ya ha sido planteada y respondida anteriormente, pueden pasar dos cosas (1) en caso de que se trate de una pregunta generativa no habrá ningún problema, ya que se generará una nueva instancia que se incluirá en la sesión del [[es:manual:test:virtual|test virtual]]; (2) si la pregunta se planteo anteriormente en la misma sesión, y se vuelve a solicitar mediante un enlace la misma pregunta, Siette interpreta que esta pregunta no es una nueva pregunta sino una pregunta ya respondida y permite y almacena una nueva respuesta, al igual que hace con los test que permiten la marcha atrás, de hecho, por defecto el [[es:manual:test:virtual|test virtual]] permite la [[es:manual:test:criterios_presentacion#marcha atrás|marcha atrás]].
-Las preguntas que pueden usarse de este modo generan directamente un enlace y un código QR correspondiente en la pestaña [[es:help_items_info|Informacion]] de la sección de [[es:help_items|Preguntas]]