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
.
Internal functioning and composition of links
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:
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] ].