170 likes | 292 Views
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.
E N D
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 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
tool_message tutor_message message curriculum_message tutor_related_message_sequence version_number=“2”
tool_message attempt_id meta (0 or 1) user_id session_id time time_zone problem_name (0 or 1) semantic_event id semantic_event_id name trigger event_descriptor (0+) event_id (1+) ui_event id selection (0+) id type action (0+) id input (0+) id
meta (0 or 1) user_id session_id time time_zone problem_name (0 or 1) semantic_event id semantic_event_id name trigger event_descriptor (0+) event_id (1+) ui_event id selection (0+) id type action_evaluation (0+) current_hint_number total_hints_available action (0+) id tutor_advice (0+) input (0+) id skill (0+) probability production (0+) tutor_message attempt_id
meta (0 or 1) user_id session_id time time_zone skill (0+) probability production (0+) curriculum_message attempt_id name 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+)
property (0+) name message attempt_id 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: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” problem_name ChemPT1 event_descriptor selection ../../../../webcontent/flash/ChemPT1.brd semantic_event id=“5B86A043“ name =“START_TUTOR” action 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” event_descriptor event_descriptor problem_name ChemPT1 selection Numerator1Value semantic_event id=“0FB7AE5D” name=“ATTEMPT” action (0+) UpdateTextField input (0+) 1000
event_descriptor problem_name ChemPT1 selection Numerator1Value semantic_event id=“0F957AB5” semantic_event_id =“0FB7AE5D” name=“RESULT” action (0+) UpdateTextField input (0+) 1 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
tool_message attempt_id=“0CEF2E07” problem_name ChemPT1 event_descriptor event_descriptor selection hint_button semantic_event id=“7BF61B95” name=“HINT” action ButtonPressed
event_descriptor problem_name ChemPT1 selection Numerator1Value semantic_event id=“6813D817” semantic_event_id =“7BF61B95” name=“HINT_MSG” action UpdateTextField input 1 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
<?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>