Guide to the Tutor Message format (v4) > The Tutor Message format

2. The Tutor Message format

2.1. Validating your XML
2.2. Root element
2.3. Message types
2.4. <context_message>
2.4.1. Attributes of <context_message>
2.4.2. Child elements of <context_message>
2.4.2.1. <meta>
2.4.2.2. <dataset>
2.4.2.3. Example of <dataset>
2.4.2.4. <class>
2.4.2.5. <condition>
2.4.2.6. <skill>
2.4.2.7. <custom_field>
2.4.2.8. <dfa>
2.5. <tool_message>
2.5.1. Attributes of <tool_message>
2.5.2. Child elements of <tool_message>
2.5.2.1. <meta>
2.5.2.2. <event_descriptor>
2.5.2.3. <semantic_event>
2.5.2.4. <ui_event>
2.5.2.5. <custom_field>
2.5.2.6. <replay>
2.6. <tutor_message>
2.6.1. Attributes of <tutor_message>
2.6.2. Child elements
2.6.2.1. <action_evaluation>
2.6.2.2. <skill>
2.6.2.3. <tutor_advice>
2.6.2.4. <interpretation>
2.7. <message>

The tutor message format describes an XML hierarchy in which various message elements are contained within a root element. The format is described normatively in an XML Schema Definition (XSD), and informally in a DTD.

2.1. Validating your XML

The normative schema for the Tutor Message format is defined using the XML Schema language in an XML Schema Definition (XSD). You should use this XSD for the purposes of validating your XML to determine how well it conforms to the Tutor Message format.

The XSD file can be downloaded from the DataShop web site:

http://learnlab.web.cmu.edu/dtd

You may also validate against the DTD; however, we recommend you validate with the XSD, which expresses the constraints of the Tutor Message format more accurately than the older DTD representation.

Validation tools

DataShop provides a free validation tool, the XML Validator Tool, for validating Tutor Message XML. We strongly encourage you to use this tool for validation.