User Tools

Site Tools


en:manual:integracion:links:items

Question integration

This integration mode allows another external system to independently present one (and only one) specific Siette question. In this case, only 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 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 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=848698&idpreg=91794&anon

If the external system includes the urlreport and urlback parameters in the call (see description in the section 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.

Technically, what happens in Siette is that a special test called 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 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 Informacion tab of the 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 integration with results described previously. For example:

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 virtual test. The questions displayed independently are actually questions included in a session of this 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 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 virtual test will have expired and the previous session will not be resumed, in this case simply a new session will be created.1)
  • 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 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 virtual test allows [[en:manual:test:criterios_presentacion#reverse|reverse] ].
1)
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
en/manual/integracion/links/items.txt · Last modified: 2024/12/11 13:31 by root

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki