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.dtd log_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 session session_id: optionally provided by JCourse, used to group actions within a session user_guid: optionally provided by Jcourse, used to identify the user date_time: timestamp for action timezone: timezone of the timestamp action_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 term info_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 #IMPLIED session_id CDATA #REQUIRED user_guid CDATA #REQUIRED date_time CDATA #IMPLIED timezone CDATA #IMPLIED action CDATA #REQUIRED source_id #REQUIRED external_object_id CDATA #IMPLIED info_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_messagetutor_messagecurriculum_messagemessage

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+) id semantic_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+) id semantic_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 File from Chemistry Stoichiometry Flash Tutor Demo of Winter Workshop 2005

log_action auth_token session_id user_guid=“student1” date_time=“2005/02/22 06:43: ” 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 action START_TUTOR problem_name ChemPT1 semantic_event id=“5B86A043“ name =“START_TUTOR”

curriculum_message attempt_id =“0CEF2E07” name =“START_PROBLEM” school_name CMU course_name Winter_Workshop01 unit_name Chemistry_Stoichiometry section_name Problem_Set_1 problem_name ChemPT1

tool_message attempt_id =“0CEF2E07” semantic_event id =“0FB7AE5D” name =“ATTEMPT” problem_name ChemPT1 event_descriptor selection Numerator1Value input (0+) 1000 action (0+) UpdateTextField event_descriptor

tutor_message attempt_id =“0CEF2E07” action_evaluation INCORRECT 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? skill Set-Numerator-Unit-of-Unit-Conversion Chemistry-Skills semantic_event id =“0F957AB5” semantic_event_id =“0FB7AE5D” name =“RESULT” problem_name ChemPT1 selection Numerator1Value input (0+) 1 action (0+) UpdateTextField event_descriptor

tool_message attempt_id =“0CEF2E07” semantic_event id =“7BF61B95” name =“HINT” problem_name ChemPT1 event_descriptor selection hint_button action ButtonPressed event_descriptor

tutor_message attempt_id =“0CEF2E07” action_evaluation HINT tutor_advice current_hint_number =“1” total_hints_available =“3” Your goal here is to convert the units of the first term. skill Set-Numerator-Unit-of-Unit-Conversion Chemistry-Skills semantic_event id =“6813D817” semantic_event_id =“7BF61B95” name =“HINT_MSG” problem_name ChemPT1 selection Numerator1Value input 1 action UpdateTextField event_descriptor

ChemPT1../../../../webcontent/flash/ChemPT1.brd START_TUTOR CMU Winter_Workshop01 Chemistry_Stoichiometry Problem_Set_1 ChemPT1 ChemPT1 Numerator1Value UpdateTextField 1000 ChemPT1 <semantic_event id="0F957AB5-B828-4FC5-515F A7FB42" semantic_event_id="0FB7AE5D-B8B9-3AAA-0B01-26CAA " name="RESULT" /> Numerator1Value UpdateTextField 1000 INCORRECT "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? Set-Numerator-Unit-of-Unit-Conversion Chemistry-Skills ChemPT1 hint_button ButtonPressed ChemPT1 <semantic_event id="6813D817-C307-78DA-28FC-50857C633458" semantic_event_id="7BF61B D20-1E8B-2F4A2FAC5FE0" name="HINT_MSG" /> Numerator1Value UpdateTextField 1 HINT Your goal here is to convert the units of the first term. Set-Numerator-Unit-of-Unit-Conversion Chemistry-Skills