CourseLab CourseLab 3.5. User's Guide Previous topic Next topic
Objects > Complex objects > Test > Choice interaction

Choice interaction

Choice Interaction is a virtual Object, which intended to construct complex interaction using other Objects on the Frame. Type of interaction could be:

Note, that this Object is "virtual", hidden, therefore you can see such placeholder in editor.

Since this Object manages displaying of other Objects, it is recommended that managed Objects were hidden by default. When the Frame starts all required Objects will be displayed automatically.

Object Parameters

Select interaction type.

If needed, allow displaying of question text – specify the Object (or Group of Objects), which contains text of question. You can also specify the Object (or Group), which contains question instruction.

Select what will be displayed at the end of interaction:

  • Display disabled variants - disabled states of variants will be displayed (if defined).

    • Define number of attempts and method of submitting the answer:

    If button click is selected for sumbitting the answer then you need define one Object with predefined States, for example Universal shape, or different Objects to emulate States. In last case only Object for default State is mandatory.

    Define variants – add as many as you need pressing + button.

    In the variant dialog window select the Object, which will be counted as variant button. The best Object for this purpose is Universal shape with predefined States. If you have selected other Object the you need create the States for this Object. Alternatively you can use the Objects to emulate States - in this case check Use objects instead states marker. The only mandatory State except for default is Selected, all other States (or Objects) are optional.

    States usage:

    You can specify the weight for each variant - it can be used in some score calculation methods.

    In case Credited question checkbox is not marked, all other scoring parameters are disabled, therefore they will be ignored when presenting question to the user. Such questions are referred as not credited questions.

    In case of the credited question the following options are available:

    1. Scoring type
    2. Base weight – base number of points for the question (or attempt for regression method).
    3. Objectives. List of Objectives where user score will be stored.     Only "total" Objective is defined in the Module by default – it will store scores for all credited questions. If you plan to store question score in additional Objectives – make sure that these Objectives are defined in the Module.

    On the Limitations you can define the rules for restoring question state and recurring approaches.

    Use Feedback tab to specify feedback options, which define what shall be displayed upon another attempt to respond (correct or incorrect) and after completing the question.

    You may permit the display of correct answer upon question completion by marking corresponding checkbox. There are few modes for full or partial display:

    You may permit or restrict the display of feedback. If displaying of feedback is permitted, select Object (or Group of Objects), which will be displayed for correct and incorrect answer. In case more than one attempt is allowed, you may want to define feedback messages for each attempt.

    On the Sound tab you can switch sounds on and off, or change it to custom sounds

    IMPORTANT! Sounds must be short and have no starting lag. Otherwise it may lead to undesirable delays in course playing.

    Object Events

    Object is capable generating events with regards to the user's actions and interpretation of the actions by the object. When combined with actions events can be employed for building up intellectual behavior models for other objects depending on the current state of the Object. Events are available using CourseLab built-in events manipulation mechanism.

    Event Triggered Upon
    on Attempt At the moment of answer acceptance, but before answer evaluation
    on Success At the moment of answer evaluation, in case the answer is correct.
    on Failure At the moment of answer evaluation, in case the answer is incorrect.
    on Last Attempt Start After previous attempt is evaluated, when last attempt starts.
    on Attempts Limit After answer evaluated, in case the number of attempts decreased to zero.
    on Question Completed After answer is evaluated and no more attempts left (on timeout or on attempts limit)
    on Question Restored Question state is restored.

    Object Specific Properties

    Along with common object properties, this object has some specific properties, that can be used in actions and in text substitutions (OBJ_ID below means current object ID):

    Property Returns Syntax
    questionMode Returns current Object mode (tokens: "normal", "review"). $OBJ_ID.questionMode
    questionType "choice" or "select" $OBJ_ID.questionType
    itemQuantity Returns total variants quantity. $OBJ_ID.itemQuantity
    questionValue Returns current question value (spot values divided by "~": for example, "0~1~0~0" - 0 corresponds to empty spot, 1 - to checked spot). Note, that the order of spots is always as it was defined in object - no matter shuffled or not. $OBJ_ID.questionValue
    attemptsLast Returns current number of attempts. $OBJ_ID.attemptsLast
    attemptsTotal Returns allowed number of attempts. $OBJ_ID.attemptsTotal
    © Websoft Ltd. All rights reserved.