tutor_message_v2.dtd

Standardized Format for Data Shop Logging

Version 2

This version works with • DataShop v1.0.9• CTAT v1.3

Released February 2005

oli_log_1.1.dtdlog_action element

To explain how the tutor_message.dtd fits into the big picture, its first important to get an introduction to the OLI log DTD. To log student actions to OLI, the data must be in this oli_log_1.1.dtd xml format. The info field of each action, when coming from a tutor, should be filled in with XML in the format of the tutor_message.dtd. Its XML within XML.

Here’s part of the oli_log_1.1.dtd with just the log_action element:

<!--auth_token: provided by JCourse, used to authenticate a sessionsession_id: optionally provided by JCourse, used to group actions within a sessionuser_guid: optionally provided by Jcourse, used to identify the userdate_time: timestamp for actiontimezone: timezone of the timestampaction_id: identifes the type of action (e.g. START_ATTEMPT)source_id: source of the action, the application creating the log entry (e.g. WORKBOOK_ACTIVITY)external_object_id: id of the object effected by the action within the application (e.g. window1/frame1/textbox1)NOTE: external_object_id does not neccessarily correspond to a content file identifier, it is more like a 'container' in Ken's usage of the terminfo_type: type of data stored in the info field (e.g. xml)info: all relevant data associated with the action (most likely in XML format)

--><!ATTLIST LOG_ACTION

auth_token CDATA #IMPLIEDsession_id CDATA #REQUIREDuser_guid CDATA #REQUIREDdate_time CDATA #IMPLIEDtimezone CDATA #IMPLIEDaction CDATA #REQUIREDsource_id #REQUIREDexternal_object_id CDATA #IMPLIEDinfo_type CDATA #IMPLIED

>

log_action auth_token session_id user_guid date_time timezone action_id source_id external_obj_id info_type

tutor_message_sequence

tutor_related_message_sequence version_number=“2”

tool_message

tutor_message

curriculum_message

message

tool_message attempt_id

meta (0 or 1) user_id session_id time time_zone

problem_name (0 or 1)

event_descriptor (0+) event_id

selection (0+) id type

input (0+) id

action (0+) idsemantic_event

id semantic_event_id name trigger

ui_event id

(1+)

tutor_message attempt_id

action_evaluation (0+) current_hint_number total_hints_available

tutor_advice (0+)

skill (0+) probability

production (0+)

meta (0 or 1) user_id session_id time time_zone

problem_name (0 or 1)

event_descriptor (0+) event_id

selection (0+) id type

input (0+) id

action (0+) idsemantic_event

id semantic_event_id name trigger

ui_event id

(1+)

curriculum_message attempt_id name

meta (0 or 1) user_id session_id time time_zone

school_name (0 or 1)

course_name (0 or 1)

unit_name (0 or 1)

section_name (0 or 1)

problem_name (0 or 1)

dfa (0+)

skill (0+) probability

production (0+)

message attempt_id

property (0+) name

entry (0 or 1)

tutor_message_v2.xml

Sample XML Filefrom Chemistry Stoichiometry

Flash Tutor Demoof Winter Workshop 2005

log_action auth_token session_id user_guid=“student1” date_time=“2005/02/22 06:43:47.00284” timezone=“US/Eastern” action_id=“START_TUTOR” source_id=“PACT_CTAT” external_obj_id info_type=“tutor_message.dtd”

tutor_message_sequence

tool_message attempt_id=“0CEF2E07”

event_descriptor

selection../../../../webcontent/flash/ChemPT1.brd

actionSTART_TUTOR

problem_nameChemPT1

semantic_event id=“5B86A043“ name =“START_TUTOR”

curriculum_message attempt_id=“0CEF2E07” name=“START_PROBLEM”

school_nameCMU

course_nameWinter_Workshop01

unit_nameChemistry_Stoichiometry

section_nameProblem_Set_1

problem_nameChemPT1

tool_message attempt_id=“0CEF2E07”

semantic_event id=“0FB7AE5D” name=“ATTEMPT”

problem_nameChemPT1

event_descriptor

selectionNumerator1Value

input (0+)1000

action (0+)UpdateTextField

event_descriptor

tutor_message attempt_id=“0CEF2E07”

action_evaluationINCORRECT

tutor_advice“1000” should be in this term's ratio, but look at the units you need to cancel in the first term. Will placing 1000 mg in the numerator cancel in the first term?

skillSet-Numerator-Unit-of-Unit-Conversion Chemistry-Skills

semantic_event id=“0F957AB5” semantic_event_id =“0FB7AE5D” name=“RESULT”

problem_nameChemPT1

selectionNumerator1Value

input (0+)1

action (0+)UpdateTextField

event_descriptor

tool_message attempt_id=“0CEF2E07”

semantic_event id=“7BF61B95” name=“HINT”

problem_nameChemPT1

event_descriptor

selectionhint_button

actionButtonPressed

event_descriptor

tutor_message attempt_id=“0CEF2E07”

action_evaluationHINT

tutor_advice current_hint_number=“1” total_hints_available=“3”Your goal here is to convert the units of the first term.

skillSet-Numerator-Unit-of-Unit-Conversion Chemistry-Skills

semantic_event id=“6813D817” semantic_event_id =“7BF61B95” name=“HINT_MSG”

problem_nameChemPT1

selectionNumerator1Value

input1

actionUpdateTextField

event_descriptor

<?xml version="1.0" encoding="UTF-8"?><tutor_related_message_sequence version_number="2"> <tool_message attempt_id="0CEF2E07-24DE-BFDA-9BAB-957C3AE236CE"> <problem_name>ChemPT1</problem_name> <semantic_event id="5B86A043-5AA5-DED9-5EB5-416AF7FE8A95" name="START_TUTOR" /> <event_descriptor> <selection>../../../../webcontent/flash/ChemPT1.brd</selection> <action>START_TUTOR</action> <input> </input> </event_descriptor> </tool_message> <curriculum_message attempt_id="0CEF2E07-24DE-BFDA-9BAB-957C3AE236CE" name="START_PROBLEM"> <school_name>CMU</school_name> <course_name>Winter_Workshop01</course_name> <unit_name>Chemistry_Stoichiometry</unit_name> <section_name>Problem_Set_1</section_name> <problem_name>ChemPT1</problem_name> </curriculum_message> <tool_message attempt_id="0CEF2E07-24DE-BFDA-9BAB-957C3AE236CE"> <problem_name>ChemPT1</problem_name> <semantic_event id="0FB7AE5D-B8B9-3AAA-0B01-26CAA3302205" name="ATTEMPT" /> <event_descriptor> <selection>Numerator1Value</selection> <action>UpdateTextField</action> <input>1000</input> </event_descriptor> </tool_message> <tutor_message attempt_id="0CEF2E07-24DE-BFDA-9BAB-957C3AE236CE"> <problem_name>ChemPT1</problem_name> <semantic_event id="0F957AB5-B828-4FC5-515F-008876A7FB42" semantic_event_id="0FB7AE5D-B8B9-3AAA-0B01-26CAA3302205" name="RESULT" /> <event_descriptor> <selection>Numerator1Value</selection> <action>UpdateTextField</action> <input>1000</input> </event_descriptor> <action_evaluation>INCORRECT</action_evaluation> <tutor_advice>"1000" should be in this term's ratio, but look at the units you need to cancel in the first term. Will placing 1000 mg in the numerator cancel in the first term?

</tutor_advice> <skill>Set-Numerator-Unit-of-Unit-Conversion Chemistry-Skills</skill> </tutor_message> <tool_message attempt_id="0CEF2E07-24DE-BFDA-9BAB-957C3AE236CE"> <problem_name>ChemPT1</problem_name> <semantic_event id="7BF61B95-3477-0D20-1E8B-2F4A2FAC5FE0" name="HINT_REQUEST" /> <event_descriptor> <selection>hint_button</selection> <action>ButtonPressed</action> </event_descriptor> </tool_message> <tutor_message attempt_id="0CEF2E07-24DE-BFDA-9BAB-957C3AE236CE"> <problem_name>ChemPT1</problem_name> <semantic_event id="6813D817-C307-78DA-28FC-50857C633458" semantic_event_id="7BF61B95-3477-0D20-1E8B-2F4A2FAC5FE0" name="HINT_MSG" /> <event_descriptor> <selection>Numerator1Value</selection> <action>UpdateTextField</action> <input>1</input> </event_descriptor> <action_evaluation current_hint_number="1" total_hints_available="3">HINT</action_evaluation> <tutor_advice>Your goal here is to convert the units of the first term.</tutor_advice> <skill>Set-Numerator-Unit-of-Unit-Conversion Chemistry-Skills</skill> </tutor_message></tutor_related_message_sequence>