Differences

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

--- en:manual:integracion:links:items [2024/12/11 13:24] – 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 =====
 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]])
-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 [[es: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.
+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.
-[[ https://www.siette.org/siette?idtest=847858&idpreg=91794&anon|https://www.siette.org/siette?idtest=847858&idpreg=91794&anon ]]
+[[https://www.siette.org/siette?idtest=848698&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''.
@@ Line 13: / Line 11: @@
 === Internal functioning and composition of links ===
-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 [[es: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.
+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.
 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:
-[[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]]
+[[https://www.siette.org/siette?idtest=848698&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.
-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 [[es: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.
+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.
 In this operation there are several particular cases:
   * 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 [[es:manual:test:virtual|virtual test]] allows [[en:manual:test:criterios_presentacion#reverse|reverse] ].
+  * 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] ].