Differences

This shows you the differences between two versions of the page.

--- en:manual:integracion:links:items [2024/12/10 17:50] – created root
+++ en:manual:integracion:links:items [2024/12/11 13:31] (current) – root
@@ Line 1: / Line 1: @@
-FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//
+===== Question integration =====
-===== Integración de preguntas =====
+This integration mode allows another external system to independently present one (and only one) specific Siette question. In this case, only [[en:manual:items:independientes|the question is presented independently]], The question appears directly, without the need to identify the user (the call must include the "anon" parameter, as shown described in the section [[en:manual:integracion:links|Integration through links]])
-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]])
+The call to Siette in this case includes a new parameter ''idpreg'' that identifies the question to be presented, and a parameter ''idtest'', whose value is fixed and links to a [[en:manual:test:virtual| virtual test]]. If it is a compound question, the complete question will be presented, with its multiple sections. If it is a generative question, a specific instance will be generated.
-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=848698&idpreg=91794&anon]]
-[[ https://www.siette.org/siette?idtest=847858&idpreg=91794&anon|https://www.siette.org/siette?idtest=847858&idpreg=91794&anon ]]
+If the external system includes the ''urlreport'' and ''urlback'' parameters in the call (see description in the section [[en:manual:integration:links:report|Integration with results]]) after presenting the Siette question It will report the result by invoking the address specified in ''urlreport'' and after displaying the solution it will return navigation control to the address indicated through ''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''.
+=== Internal functioning and composition of links ===
-=== Funcionamiento interno y composición de los enlaces ===
+Technically, what happens in Siette is that a special test called [[en:manual:test:virtual|virtual test]] is executed that supports this type of questions. This test must be previously created in Siette if you want this functionality to be available. To do this, it is enough to declare in the subject that [[en:help_subjects_data#Allow the use of questions as independent content|allows the use of questions independently]]. If you try to access a question that does not allow direct access, or is restricted by the subject, an error will occur.
-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.
+Questions that can be used in this way directly generate a link and a corresponding QR code in the [[en:help_items_information|Informacion]] tab of the [[en:help_items|Questions]] section. To this link you only have to add the parameters ''urlreport'' and ''urlback'' if necessary, in the same way as is done in the [[en:manual:integracion:links:report|integration with results]] described previously. For example:
-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]]
-[[https://www.siette.org/siette?idtest=847858&idpreg=91794&anon|https://www.siette.org/siette?idtest=847858&idpreg=91794&anon&urlback=https://www.siette.org/siette?idtest=19127]]
+presents the question corresponding to "Alpha" and at the end invokes the Siette test that includes questions about the Greek alphabet.
-presenta la pregunta correspondiente a "Alpha" y al terminar invoca al test de Siette que incluye preguntas sobre el alfabeto griego.
+The internal functioning of this integration mechanism includes the so-called [[en:manual:test:virtual|virtual test]]. The questions displayed independently are actually questions included in a session of this [[en:manual:test:virtual|virtual test]]. If the same student requests a question through one of these links and then another and another, each question will be presented independently, and probably returning control to the external system once resolved. However, from Siette's point of view, the student has started a session of the [[en:manual:test:virtual|virtual test]], has left the session, has returned to recover the session continuing with a second question chosen from deterministically, he has left the session again, he has recovered it again, etc.
-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.
+In this operation there are several particular cases:
-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]].
+  * If the student has allowed too much time to pass between one question and another (12 hours by default), the [[en:manual:test:virtual|virtual test]] will have expired and the previous session will not be resumed, in this case simply a new session will be created.((Note that although access to Siette is anonymous, Siette is capable of differentiating anonymous users through the IP address from which they connect, and even maintaining anonymity, it can identify the same user whenever this maintain the same address. In the future cookies could be used for this same function))
+  * If a link is required to a question that has already been asked and answered previously, two things can happen (1) in case it is a generative question there will be no problem, since a new instance will be generated and included in the [[en:manual:test:virtual|virtual test]] session; (2) if the question was asked previously in the same session, and the same question is requested again through a link, Siette interprets that this question is not a new question but rather an already answered question and allows and stores a new answer, just as it does with the tests that allow going back and forth, in fact, by default the [[en:manual:test:virtual|virtual test]] allows [[en:manual:test:criterios_presentacion#reverse|reverse] ].