Guide to the Tutor Message format (v4) > XML Examples

A. XML Examples

Example A.1. Tool message

<tool_message context_message_id="C1f3b4f3a:111c34b00ed:-7fff">
   <meta>
      <user_id>joe_cool</user_id>
      <session_id>JUNK1f3b4f3a:111c34b00ed:-8000</session_id>
      <time>2006-08-30 13:22:33</time>
      <time_zone>EST</time_zone>
   </meta>
   <problem_name>ChemPT1</problem_name>
   <semantic_event transaction_id="T1f3b4f3a:111c34b00ed:-7ffe" name="ATTEMPT"/>
   <event_descriptor>
      <selection>ButtonOne</selection>
      <action>PressButton</action>
      <input>box</input>
   </event_descriptor>
   <custom_field>
      <name>Equation</name>
      <value>y=x+ab</value>
   </custom_field>
</tool_message>

Example A.2. Media logging: Logging the load video event (media not in a tutor)

In this example, a context message is logged when the video media is first loaded (signified with name="LOAD_VIDEO"). Then when the user first interacts with the video, a tool message is logged. For comparison, see the alternative logging approach in the next example.

<context_message 
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C" 
   name="LOAD_VIDEO">
   <dataset>
      <name>Example Media Dataset</name> 
      <level type="unit">
         <name>Stoichiometry</name>
         <level type="section">
            <name>What are moles?</name>
            <problem>
               <name>mymovie.flv</name>
            </problem>
         </level>
      </level>
   </dataset>
</context_message>

<tool_message
    context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C" 
    <semantic_event 
        transaction_id="1F3A9B23-9164-DD83-EBB2-1589FD38D4B3" 
        name="VIDEO_ACTION" />
    <event_descriptor>
        <selection>
        _level0.VideoPlayerInstance1.sliderButtonName    
        </selection>
        <selection type="media_file">mymovie.flv</selection>
        <selection type="clip_length">00:08:00.0</input>
        <action>play</action>
        <input type="time">00:02:34.2</input>
    </event_descriptor>
</tool_message>

Example A.3. Media logging: Logging the start video event (no load event) (media not in a tutor)

In this example, a context message is logged when the the user first interacts with the video (signified with name="START_VIDEO"). At approximately the same time, a tool message is also logged to capture the details of the interaction. For comparison, see the alternative logging approach in the preceding example.

<context_message 
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C" 
   name="START_VIDEO">
   <dataset>
      <name>Example Media Dataset</name> 
      <level type="unit">
         <name>Stoichiometry</name>
         <level type="section">
            <name>What are moles?</name>
            <problem>
               <name>mymovie.flv</name>
            </problem>
         </level>
      </level>
   </dataset>
</context_message>

<tool_message
    context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C" 
    <semantic_event 
        transaction_id="1F3A9B23-9164-DD83-EBB2-1589FD38D4B3" 
        name="VIDEO_ACTION" />
    <event_descriptor>
        <selection>
        _level0.VideoPlayerInstance1.sliderButtonName    
        </selection>
        <selection type="media_file">mymovie.flv</selection>
        <selection type="clip_length">00:08:00.0</input>
        <action>play</action>
        <input type="time">00:02:34.2</input>
    </event_descriptor>
</tool_message>

Example A.4. Media logging: tutored event

The following message sequence is an example of tutored media event.

<context_message 
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C" 
   name="START_PROBLEM">
   <dataset>
      <name>Learn a Language Fall 2007</name> 
      <level type="unit">
         <name>Learning Logging</name>
         <problem><name>Translating Tech Talk</name></problem>
      </level>
   </dataset>
</context_message>

<tool_message 
   context_message_id ="02CE3AE5-F6D5-9177-913F-C34730F1096C">
   <semantic_event 
      transaction_id="B503948-9164-DD83-EBB2-1589FD38D435" 
      name="ATTEMPT" />
   <event_descriptor>
      <selection>_level0.VideoPlayerInstance1.sliderButtonName</selection>
      <selection type="media_file">mymovie.flv</selection>
      <selection type="clip_length">00:08:00.0</input>
      <action>cue</action>
      <input type="start_cue">00:04:34.8</input>
      <input type="stop_cue">00:05:42.2</input>
   </event_descriptor>
</tool_message>

<tutor_message 
   context_message_id ="02CE3AE5-F6D5-9177-913F-C34730F1096C">
   <semantic_event 
      transaction_id="B503948-9164-DD83-EBB2-1589FD38D435" 
      name="RESULT" />
   <event_descriptor>
      <selection>_level0.VideoPlayerInstance1.sliderButtonName</selection>
      <selection type="media_file">mymovie.flv</selection>
      <selection type="clip_length">00:08:00.0</input>
      <action>cue</action>
      <input type="start_cue">00:04:34.8</input>
      <input type="stop_cue">00:05:42.2</input>
   </event_descriptor>
   <action_evaluation>INCORRECT</action_evaluation>
   <tutor_advice>Your answer is not correct.  Select only the portion of the 
      video where the man it talking about his family.</tutor_advice>
   <skill>
      <name>family_words</name>
      <category>video_portion_selection</category>
   </skill>
</tutor_message>

Example A.5. Media logging: two untutored events followed by a single tutored event

The following message sequence is an example of two untutored media events followed by a single tutored media event.

<context_message
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C"
   name="START_PROBLEM">
   <dataset>
      <name>Learn a Language Fall 2007</name> 
      <level type="unit">
         <name>Learning Logging</name>
         <problem><name>Translating Tech Talk</name></problem>
      </level>
   </dataset>
</context_message>

<tool_message
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C"
   <semantic_event
      transaction_id="1F3A9B23-9164-DD83-EBB2-1589FD38D4B3"
      name="AUDIO_ACTION" />
   <event_descriptor>
      <selection>_level0.MS_component.item4</selection>
      <selection type="media_file">u1_m1_s5_ss3_nasvow_0268.mp3</selection>
      <selection type="clip_length">0.758</selection>          
      <action>play</action>
      <input type="time">0</input>
   </event_descriptor>
</tool_message>

<tool_message
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C" 
   <semantic_event 
      transaction_id="1F3A9B23-9164-DD83-EBB2-1589FD38D4B3" 
      name="AUDIO_ACTION" />
   <event_descriptor>
      <selection>_level0.MS_component.item4</selection>
      <selection type="media_file">u1_m1_s5_ss3_nasvow_0268.mp3</selection>
      <selection type="clip_length">0.758</selection>        
      <action>end</action>
      <input type="time">0.758</input>
   </event_descriptor>
</tool_message>

<tool_message
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C">
   <semantic_event 
      transaction_id="7775F27F-7AE4-0F70-8E62-76249B32DB06" name="ATTEMPT" />
   <event_descriptor>
      <selection>MS_component</selection>
      <action>MultipleSelectionButtonPressed</action>
      <input>Not checked for choice 1: Not checked for choice 2: 
         Not checked for choice 3: Not checked for choice 4: 
         Not checked for choice 5</input>
   </event_descriptor>
</tool_message>

<tutor_message
   context_message_id="02CE3AE5-F6D5-9177-913F-C34730F1096C">
   <semantic_event 
      transaction_id="7775F27F-7AE4-0F70-8E62-76249B32DB06" name="RESULT" />
   <event_descriptor>
      <selection>MS_component</selection>
      <action>MultipleSelectionButtonPressed</action>
      <input>Checked for choice 1: Not checked for choice 2: 
         Checked for choice 3: Not checked for choice 4: 
         Checked for choice 5</input>
   </event_descriptor>
   <action_evaluation>INCORRECT</action_evaluation>
   <tutor_advice>One or more answers are wrong.</tutor_advice>
   <skill>
       <name>multiple_selection</name>
      <category>multiple_selection</category>
   </skill>
   <skill>
      <name>audio_question</name>
      <category>multiple_selection</category>
   </skill>
</tutor_message>