Blackboard Learning System - CE and Vista Enterprise

Content Interoperability Specification
Application Pack 2for Vista (Release 4) and CE (Release 6) CIS Version 3
Document version 4.2.0.0

© 2007 Blackboard Inc. All rights reserved. Blackboard, the Blackboard logo, and Blackboard Portfolio are either registered trademarks or trademarks of Blackboard Inc. in the United States and/or other countries. WebCT, WebCT Vista , and other WebCT product names are either registered trademarks or trademarks of Blackboard Inc. in the United States and/or other countries. This product includes software developed by the Apache Software Foundation (http://www.apache.org). This product includes software developed by the JDOM Project (http://www.jdom.org). Other product and company names mentioned herein may be the trademarks of their respective owners. U.S. Patent No. 6,988,138. Patents pending.

Contents
ABOUT THIS DOCUMENT .......................................................................... 1
Intended Audience ............................................................................................................ 1 How to Use this Document ............................................................................................... 1

CHAPTER 1: THE BLACKBOARD LEARNING SYSTEM CIS .......................... 3
Introduction ....................................................................................................................... 3 WebCT IMS Package Structure ........................................................................................ 4 Best Practices for Creating Manifests ............................................................................... 7 Creating the Metadata Section ...................................................................................... 8 Creating the Organizations Section .............................................................................. 9 Creating the Resources Section .................................................................................... 9 Creating the ContentObject Section .............................................................................. 10 XML Binding .................................................................................................................... 10 SchemaMetaData Element ............................................................................................ 10 Resource Element ......................................................................................................... 11 ContentObject Element ................................................................................................. 12

CHAPTER 2: CONTENT FILE SPECIFICATION ............................................. 14
Content File Manifest Elements ........................................................................................ 14 Best Practices for Creating a Content File Manifest ......................................................... 15 Creating the Metadata Section ...................................................................................... 16 Creating the Organizations Section .............................................................................. 16 Creating the Resources Section .................................................................................... 17 Creating the ContentObject Section .............................................................................. 18 Content File Manifest Example ........................................................................................ 18 XML Binding .................................................................................................................... 19 ContentObject Element ................................................................................................. 19

CHAPTER 3: FILE SPECIFICATION ............................................................ 21
File Manifest Elements ..................................................................................................... 21 Best Practices for Creating a File Manifest ...................................................................... 22 Creating the Metadata Section ...................................................................................... 23 Creating the Organizations Section .............................................................................. 23 Creating the Resources Section .................................................................................... 23 Creating the ContentObject Section .............................................................................. 24 File Manifest Example ...................................................................................................... 24 XML Binding .................................................................................................................... 25 ContentObject Element ................................................................................................. 26

CHAPTER 4: LEARNING MODULE SPECIFICATION ..................................... 32
Learning Module Manifest Elements ................................................................................ 32 Best Practices for Creating a Learning Module Manifest ................................................. 33

Creating the Metadata Section ...................................................................................... 34 Creating the Organizations Section .............................................................................. 34 Creating the Resources Section .................................................................................... 39 Creating the ContentObject Section .............................................................................. 39 Learning Module Manifest Example ................................................................................ 40 XML Binding .................................................................................................................... 42 Organization Element ................................................................................................... 42 ContentObject Element ................................................................................................. 46

CHAPTER 5: QUESTION SPECIFICATION ................................................... 48
Question Manifest Elements ............................................................................................. 48 Best Practices for Creating a Question Manifest .............................................................. 49 Creating the Metadata Section ...................................................................................... 49 Creating the Organizations Section .............................................................................. 50 Creating the Resources Section .................................................................................... 50 Creating the ContentObject Section .............................................................................. 51 Question Manifest Example .............................................................................................. 51 Best Practices for Creating Question QTI XML Files ...................................................... 52 Common Metadata Fields and Data Elements .............................................................. 52 Creating Calculated Questions ...................................................................................... 60 Creating Combination Questions .................................................................................. 71 Creating Fill in the Blank Questions ............................................................................. 80 Creating Jumbled Sentence Questions .......................................................................... 88 Creating Matching Questions ....................................................................................... 93 Creating Multiple Choice Questions ............................................................................. 105 Creating Paragraph Questions ....................................................................................... 117 Creating Short Answer Questions ................................................................................. 122 Creating True False Questions ...................................................................................... 137 XML Binding .................................................................................................................... 142 XML Binding for Manifest Elements ........................................................................... 142 XML Binding for Item Elements .................................................................................. 143

CHAPTER 6: ASSESSMENT SPECIFICATION .............................................. 156
Assessment Manifest Elements ......................................................................................... 156 Best Practices for Creating an Assessment Manifest ........................................................ 157 Creating the Metadata Section ...................................................................................... 157 Creating the Organizations Section .............................................................................. 158 Creating the Resources Section .................................................................................... 158 Creating the ContentObject Section .............................................................................. 159 Assessment Manifest Example ......................................................................................... 159 Best Practices for Creating Assessment QTI XML Files ................................................. 160 Creating Quizzes ........................................................................................................... 160 Creating Surveys ........................................................................................................... 176 Creating Self Tests ........................................................................................................ 182 XML Binding for Manifest Elements ............................................................................... 188 ContentObject Element ................................................................................................. 188

About this Document

ABOUT THIS DOCUMENT
INTENDED AUDIENCE
The Content Interoperability Specification (CIS) 3.0 is intended for software developers converting content to Blackboard Learning System - CE Enterprise/Basic or Blackboard Learning System - Vista Enterprise, Application Pack 2, or from CE 6 or Vista 4, Application Pack 2to or from the following: • • • third-party authoring tools. external repositories, such as libraries, learning context management systems (LCMS), content management systems (CMS), learning object (LO) repositories, and e-Portfolios. commercial content systems.

IMPORTANT: This specification assumes that you are proficient with XML and are familiar with Vista or CE functionality and the following IMS specifications: • • • IMS Content Packaging (CP) specification IMS Learning Resource Meta-data specification IMS Question and Test Interoperability (QTI) specification

HOW TO USE THIS DOCUMENT
the Blackboard Learning System CIS 3.0 includes the following chapters: • • • • • • Chapter 1: the Blackboard Learning System CIS Chapter 2: Content File Specification Chapter 3: File Specification Chapter 4: Learning Module Specification Chapter 5: Question Specification Chapter 6: Assessment Specification

Chapter 1: the Blackboard Learning System CIS contains general information about describing and packaging all learning objects supported by the Blackboard Learning System CIS 3.0. Chapters 2 and 3 contain information about describing and packaging files. Depending on where files are located and whether they have managed Media Library links, files are described and packaged either by using the File specification or by using the Content File and File specifications. For more information, read Chapters 2 and 3. Chapters 4, 5, and 6 are individual specifications for learning modules, questions, and assessments 1

About this Document

respectively. These individual specifications contain information that is specific to each learning object. Each of these individual specifications can be read separately. Depending on the type of learning object you want to convert, we recommend that you read Chapter 1: the Blackboard Learning System CIS and then read the appropriate individual specification. For example, if you want to describe and package a learning module, first read Chapter 1: the Blackboard Learning System CIS and then read Chapter 4: Learning Module Specification. IMPORTANT: the Blackboard Learning System CIS should be read in conjunction with the IMS CP specification version 1.1.3, the IMS Learning Resource Meta-data specification version 1.2.3, and the IMS QTI specification version 1.2. Information about these specifications is beyond the scope of this document. To download these specifications, go to the IMS Specifications web site (http://www.imsglobal.org/specifications.cfm).

2

Chapter 1: the Blackboard Learning System CIS

CHAPTER 1: THE BLACKBOARD LEARNING SYSTEM CIS
INTRODUCTION
the Blackboard Learning System Content Interoperability Specification (CIS) 3.0 provides instructions for describing and packaging learning objects into interoperable, distributable content packages that can be transported between different CE 6.1 and Vista 4.1 learning contexts and installations. These packages are called WebCT IMS content packages. You can use the Blackboard Learning System CIS 3.0 to describe and package the following learning objects: • • • • files learning modules that contain an action menu, heading, files, and assessments questions assessments, including quizzes, surveys, and self tests

the Blackboard Learning System CIS 3.0 implements the core elements of the following specifications: • • • IMS Content Packaging (CP) specification version 1.1.3 IMS Learning Resource Meta-data specification version 1.2.3 IMS Question and Test Interoperability (QTI) specification version 1.2

the Blackboard Learning System CIS also defines a unique schema and namespace to represent the system's base extensions to the IMS CP schema. These extensions are used when describing all learning objects. In addition, the Blackboard Learning System CIS defines a unique schema and namespace for each WebCT learning object it supports. The elements and attributes defined in the namespace for each of these schema represent content-rich features that are not defined by the IMS CP schema. Once packaged, learning objects can be transported between different learning contexts and installations using the command line or the Import tool and the Export options in the Assessments, Learning Module, and Question Database tools in the WebCT user interface. For information on importing content using the command line, see the appropriate version of the Vista PowerLinks SDK: Programmer's Guide. For information on using the user interface to export and import content, see the Online Help. This chapter contains the following sections: • • WebCT IMS Package Structure: This section describes what a WebCT IMS content package consists of and its basic structure. Best Practices for Creating Manifests: This section describes the best general practices for creating manifests for all learning object supported by the Blackboard Learning System CIS 3.0.

3

Chapter 1: the Blackboard Learning System CIS

XML Binding: This section contains narrative descriptions of the system's base extensions to the IMS CP schema.

WEBCT IMS PACKAGE STRUCTURE
IMPORTANT: To become familiar with the structure of a WebCT IMS content package, we recommend that you use the Vista 4.1 or CE 6.1 interface to create a sample learning object, export the learning object, and then analyze the files in the exported package. For example, create a sample learning module, export the learning module, download the content package to your local computer, and analyze the files. For instructions on creating and exporting Vista 4.1 or CE 6.1 learning objects, refer to the Vista 4.1 or CE 6.1 Online Help. Like an IMS content package, a WebCT IMS content package consists of a set of XML files (including XML schema files) and physical files (for example, HTML, QTI, and image files). The XML and physical files are incorporated into a single file for transportation, a Package Interchange File (PIF). A PIF is a representation of a content package within an archive format, such as a zip, jar, cab, or tar file. IMPORTANT: A WebCT IMS content package must be bundled as a single zip file. The basic unit of packaging for WebCT IMS content packages is the standard IMS manifest file (imsmanifest.xml). In a WebCT IMS content package, each learning object is represented as a self-contained manifest file. Links between learning objects, such as a learning module linking to an assessment, are represented by the resources section of the manifest. In each learning object's manifest file, there is one resource element for each linked learning object. Rather than using the resource element to reference embedded sub-manifests, the resource element references the self-contained manifest file for the linked learning object. Embedded sub-manifests are not used as this would cause a learning object's manifest to be duplicated if it is linked multiple times. The use of embedded and self-contained manifest files is shown in the following diagram.

4

Chapter 1: the Blackboard Learning System CIS

If only one learning object is selected for export, for example, one learning module, the root manifest (imsmanifest.xml) in the content package is the manifest for the learning object. The following example is a root manifest for a content package that contains one learning module called Week One. The learning module contains links to a file called Planning Europe's Capital Cities and an assessment called Capital Cities of Europe. The resource elements reference self-contained manifests for the file and assessment.
<?xml version="1.0" encoding="UTF-8" ?> <manifest identifier="40272" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:webct="http://www.webct.com/xsd/cisv3" xmlns:webctlm="http://www.webct.com/xsd/cislearningmodulev3"> <metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion> <webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3" /> <webct:Schema webct:name="webct.learningModule" webct:version="3.0.0" /> </webct:SchemaMetaData> <imsmd:lom> <imsmd:general> <imsmd:title> <imsmd:langstring xml:lang="en-US">Week One</imsmd:langstring> </imsmd:title>

5

Chapter 1: the Blackboard Learning System CIS

</imsmd:general> <imsmd:lifecycle> <imsmd:version> <imsmd:langstring xml:lang="x-none">1.0</imsmd:langstring> </imsmd:version> </imsmd:lifecycle> <imsmd:educational> <imsmd:learningresourcetype> <imsmd:source> <imsmd:langstring xml:lang="x-none">WebCT</imsmd:langstring> </imsmd:source> <imsmd:value> <imsmd:langstring xml:lang="x-none">webct.learningModule</imsmd:langstring> </imsmd:value> </imsmd:learningresourcetype> </imsmd:educational> </imsmd:lom> </metadata> <organizations> <organization identifier="40272_O" structure="webct:VistaLearningModule"> <item identifier="40272_I1" identifierref="40460" isvisible="true" xsi:type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>Planning Europe's Capital Cities</title> <webctlm:ActionMenu /> </item> <item identifier="40272_I2" identifierref="40381" isvisible="true" xsi:type="webctlm:LearningModuleItemType" webctlm:coType="webct.assessment"> <title>Capital Cities of Europe</title> <webctlm:ActionMenu /> </item> <webctlm:ActionMenu /> </organization> </organizations> <resources> <resource identifier="40460" type="webct.manifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/40460.xml" /> </resource> <resource identifier="40381" type="webct.manifest" webct:coType="webct.assessment" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/40381.xml" /> </resource> </resources> <webct:ContentObject webct:coType="webct.learningModule" xsi:type="webctlm:LearningModuleType" webctlm:numbering="DECIMAL"> <webct:Name>Week One</webct:Name> </webct:ContentObject> </manifest>

If multiple top-level learning objects are selected for export, for example, two learning modules, the root manifest is a container that references the manifest files of the two learning modules. All manifests for learning objects (such as content files or assessments) within the learning modules are not referenced at the root manifest level. These learning objects are referenced in the manifests for the learning modules. The following example is a root manifest for a content package that contains two learning modules. The resource elements reference self-contained manifests for the learning modules.
<?xml version="1.0" encoding="UTF-8" ?> <manifest identifier="2020326009" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:webct="http://www.webct.com/xsd/cisv3"> <metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion> <webct:SchemaMetaData>

6

Chapter 1: the Blackboard Learning System CIS

<webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3" /> </webct:SchemaMetaData> <imsmd:lom> <imsmd:general> <imsmd:title> <imsmd:langstring xml:lang="en-US">RootContent</imsmd:langstring> </imsmd:title> </imsmd:general> <imsmd:lifecycle> <imsmd:version> <imsmd:langstring xml:lang="x-none">1.0</imsmd:langstring> </imsmd:version> /imsmd:lifecycle> <imsmd:educational> <imsmd:learningresourcetype> <imsmd:source> <imsmd:langstring xml:lang="x-none">WebCT</imsmd:langstring> </imsmd:source> <imsmd:value> <imsmd:langstring xml:lang="x-none">webct.cis</imsmd:langstring> </imsmd:value> </imsmd:learningresourcetype> </imsmd:educational> </imsmd:lom> </metadata> <organizations /> <resources> <resource identifier="40272" type="webct.manifest" webct:coType="webct.learningModule" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/40272.xml" /> </resource> <resource identifier="40697" type="webct.manifest" webct:coType="webct.learningModule" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/40697.xml" /> </resource> </resources> </manifest>

BEST PRACTICES FOR CREATING MANIFESTS
An IMS CP manifest contains three main sections: Metadata, Organizations, and Resources. A CIS manifest contains four main sections: Metadata, Organizations, Resources, and ContentObject. This is shown in the following diagram. The ContentObject section contains additional learning object features that are not covered by the IMS CP and Meta-data specifications.

7

Chapter 1: the Blackboard Learning System CIS

This section describes the best practices for creating the four main sections in a WebCT CIS manifest: Metadata, Organizations, Resources, and ContentObject. NOTE: This section contains general information that applies to all Vista 4.1 and CE 6.1 learning objects. For information on describing and packaging a specific Vista 4.1 or CE 6.1 learning object, see the appropriate individual specification.

Creating the Metadata Section
In all CIS manifest files, the webct.cis schema is used to represent the system's base extensions to the IMS CP schema. Within the manifest's metadata element, you must specify the schema used by the manifest. Within the schema element, you must specify the value webct.cis. Within the

8

Chapter 1: the Blackboard Learning System CIS

schemaversion element, you must specify the value 3.0.0.
<metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion>

In all CIS manifest files, the SchemaMetaData element is used to specify other schemas that are also used by the manifest file: NOTE: The SchemaMetaData element is an optional element. If the SchemaMetaData element is not used, the default schema versions and namespaces for the Blackboard Learning System CIS 3.0 are used.

• •

To specify that the IMS CP schema is used, the Schema element must contain a name attribute with the value IMS Content and a version attribute with the value 1.1.3. To specify that the IMS Meta-data schema is used, the Schema element must contain a name attribute with the value IMS MetaData and a version attribute with the value 1.2.3.
<webct:SchemaMetaData> <webct:Schema webct:name:"IMS Content" webct:version="1.1.3"/ > <webct:Schema webct:name: "IMS MetaData" webct:version="1.2.3"/> </webct:SchemaMetaData>

Creating the Organizations Section
In general, the Blackboard Learning System CIS uses the standard IMS organization elements where appropriate. Certain learning objects, for example, learning modules, may extend it. For more information, see the individual specification for each learning object.

Creating the Resources Section
When creating the resources section of the manifest, the Blackboard Learning System CIS extends the IMS CP schema in the following two ways: • The resource element references self-contained manifests. To indicate that a resource is a self-contained manifest, for the type attribute of the resource element, specify a value of webct.manifest. The coType attribute specifies the type of resource pointed to by the linked manifest. For the coType attribute, specify the learning object type. In the following XML example, the resource points to a self-contained manifest for a file (webct.page).
<resources> <resource identifier="79615" type="webct.manifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/79615.xml" /> </resource> </resources>

9

Chapter 1: the Blackboard Learning System CIS

Creating the ContentObject Section
The ContentObject element is added at the end of the manifest to represent specific features that are not defined by the IMS CP schema. For example, the ContentObject element is used in a learning module manifest to define a numbering style for the table of contents. In the following XML example, the ContentObject element specifies a decimal numbering style for the learning module's table of contents.
<webct:ContentObject webct:coType="webct.learningModule" xsi:type="webctlm:LearningModuleType" webctlm:numbering="DECIMAL"> <webct:Name>Europe in the Twentieth Century</webct:Name> </content:ContentObject>

NOTE:

If multiple top-level learning objects are selected for export, the root manifest is a container manifest and must not contain the ContentObject element. For example, if the content package contains two learning modules, the root manifest must not contain the ContentObject element. The ContentObject element must be included only in the manifest for the learning object to which it applies.

The base ContentObject element is described in the section XML Binding. For each learning object, the base ContentObject element is extended to represent features that are specific to that learning object. For more information, see the individual specification for each learning object.

XML BINDING
The following is a narrative description of the elements defined in the CIS 3.0 XML schema. The http://www.webct.com/xsd/cisv3 namespace for the CIS 3.0 XML schema is located in cisv3.xsd. This file is included in the zip file of each content package exported from Vista 4.1 and CE 6.1 and is available on the Content Interoperability Specification download page.

SchemaMetaData Element
Description Namespace Multiplicity Elements This element identifies a collection of schemas used. http://www.webct.com/xsd/cisv3 Occurs zero or one time within a metadata element. • <Schema>

10

Chapter 1: the Blackboard Learning System CIS

Example

<webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3" /> </webct:SchemaMetaData>

Schema Element
Description Namespace Multiplicity Attributes This element is used to describe the schema used. http://www.webct.com/xsd/cisv3 Occurs one or more times within the SchemaMetaData element. • • Example name (required). Data type=string. version (required). Data type=string.
<webct:Schema webct:name="IMS Content" webct:version="1.1.3" />

Resource Element
the Blackboard Learning System CIS has extended the base IMS resource element by adding the coType attribute. The coType attribute specifies the type of resource pointed to by the linked manifest. Namespace Attributes http://www.webct.com/xsd/cisv3 • coType (required). Indicates the learning object type. Data type=string. Values are: • • • • •
webct.page: a file that has been added to a folder, learning module, or has

managed Media Library links.
webct.file: a file in any location other than a folder or learning module

that does not have managed Media Library links
webct.learningModule: learning module webct:question: question webct:assessment: assessment

11

Chapter 1: the Blackboard Learning System CIS

Example

<resources> <resource identifier="79615" type="webct.manifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="URN_X-WEBCT-VISTA-V0/79615.xml" /> </resource> </resources>

ContentObject Element
Description This element represents specific features of the learning object that are not defined by the IMS CP specification. http://www.webct.com/xsd/cisv3 For learning object manifests, occurs once and only once within a manifest element. NOTE: If multiple top-level learning objects are selected for export, the root manifest is a container manifest and must not contain the ContentObject element. For example, if the content package contains two learning modules, the root manifest must not contain the ContentObject element.

Namespace Multiplicity

Attributes

coType (required). Indicates the learning object type. Data type=string. Values are: • • • • •
webct.page: a file that has been added to a folder, learning module, or has

managed Media Library links.
webct.file: file webct.learningModule: learning module webct:question: question webct:assessment: assessment

isVisible (optional). Indicates whether the learning object is displayed. If not present, the value is assumed to be true. Data type=boolean. <Name>
<webct:ContentObject webct:coType="webct.file"> <webct:Name>English_poets.html</webct:Name> </webct:ContentObject>

Elements Example

12

Chapter 1: the Blackboard Learning System CIS

Name Element
Description Namespace Multiplicity Example This element describes the name of the learning object. Data type=string. http://www.webct.com/xsd/cisv3 Occurs once and only once within a ContentObject element.
<webct:Name>English_poets.html</webct:Name>

13

Chapter 2: Content File Specification

CHAPTER 2: CONTENT FILE SPECIFICATION
NOTE: Depending on where files are located in the system and whether they have managed Media Library links, they are described and packaged by using the File specification or by using the Content File and File specifications. Files that are added to a folder or learning module, or that have managed Media Library links are described and packaged by using the Content File and File specifications. In chapters 2, 3, and 4 of this document, we refer to these files as "content files". Files that are not in a folder or learning module and that do not have managed Media Library links are described and packaged by using the File specification. For more information, see Chapter 3: File Specification.

Blackboard's Content File specification provides the functionality to describe and package content files into an interoperable, distributable package that can be transported between different learning contexts and installations. Chapter 1 of the Content Interoperability Specification (CIS) describes the basic structure of a IMS content package and the system's base extensions to the IMS Content Packaging (CP) schema. These extensions apply to all learning objects. For more information, see Chapter 1: the Blackboard Learning System CIS. The Content File specification extends the CIS 3.0 XML schema and defines a unique namespace (http://www.webct.com/xsd/cispagev3) and schema (webct.page) to represent features that are specific to content files. The Content File specification is made up of the following sections: • • • • Content File Manifest Elements: This section includes a diagram of the primary elements in a content file manifest. Best Practices for Creating a Content File Manifest: This section describes the best practices for creating the four main sections in a content file manifest. Content File Manifest Example: This section includes an example of a content file manifest. XML Binding: This section contains a narrative description of the CIS 3.0 Content File schema.

CONTENT FILE MANIFEST ELEMENTS
The following diagram shows the primary elements in a content file manifest.

14

Chapter 2: Content File Specification

BEST PRACTICES FOR CREATING A CONTENT FILE MANIFEST
15

Chapter 2: Content File Specification

To create a content file that can be transported between different learning contexts and installations, you must create a self-contained manifest for the content file. This section describes the best practices for creating the four main sections in a content file manifest: Metadata, Organizations, Resources, and ContentObject.

Creating the Metadata Section
Within the manifest's metadata element, you must specify the schema used by the manifest. Within the schema element, you must specify the value webct.cis. Within the schemaversion element, you must specify the value 3.0.0.
<metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion>

If you want to specify other schemas that are used by the manifest, use the SchemaMetaData element: NOTE: The SchemaMetaData element is an optional element. If the SchemaMetaData element is not used, the default schema versions and namespaces for the Blackboard Learning System CIS 3.0 are used.

• • •

To specify that the IMS CP schema is used, the Schema element must contain a name attribute with the value IMS Content and a version attribute with the value 1.1.3. To specify that the IMS Meta-data schema is used, the Schema element must contain a name attribute with the value IMS MetaData and a version attribute with the value 1.2.3. To specify that the Content File schema is used, the Schema element must contain a name attribute with the value webct.page and a version attribute with the value 3.0.0.
<webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3 /> <webct:Schema webct:name="webct.page" webct:version="3.0.0" /> </webct:SchemaMetaData>

Creating the Organizations Section
A content file can be a single file, such as a text file, or it can be an HTML file that contains links to other files. (When content files are packaged, all HTML and images files that are linked from the content file are also included in the content package.) If a content file is a single file, in the resources section of the manifest, the resource element contains a link to a self-contained manifest for the file. The organizations section of the manifest contains an item element with an identifierref attribute that specifies the resource identifier for the file's manifest. This is shown in the following example.

16

Chapter 2: Content File Specification

<organizations> <organization identifier="79622_O"> <item identifier="79615_I" identifierref="79615" /> </organization> </organizations> <resources> <resource identifier="79615" type="webct.manifest" webct:coType="webct.file" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/79615.xml" /> </resource> </resources>

If the content file is an HTML file that contains links to other files, the resources section of the manifest contains resource elements that reference self-contained manifests for the content file's root file and all HTML and image files that are linked from the root file. Within the organizations section, the organization element is used to indicate which of the files referenced in the resources section is the root file, that is, the file from which all other files are linked. The organization element contains an item element with an identifierref attributes that specifies the resource identifier for the root file's self-contained manifest. This is shown in the following example.
<organizations> <organization identifier="79622_O"> <item identifer="79615_I" identifierref="79615" /> </organization> </organizations> <resources> <resource identifier="79615" type="webct.manifest" webct:coType="webct.file" xsi:type="webct.ResourceType"> <file href="URN_X-WEBCT-VISTA-V0/79615.xml" /> </resource> <resource identifier="79082" type="webct.manifest" webct:coType="webct.file" xsi:type="webct.ResourceType"> <file href="URN_X-WEBCT-VISTA-V0/79082.xml" /> </resource> <resource identifier="79237" type="webct.manifest" webct:coType="webct.file" xsi:type="webct.ResourceType"> <file href="URN_X-WEBCT-VISTA-V0/79237.xml" /> </resource> </resources>

Creating the Resources Section
If a content file is a single file, such as a text file, in the resources section of the manifest, the resource element contains a link to a self-contained manifest for the single file. If the content file is an HTML file that contains links to other files, the resources section of the manifest contains resource elements that reference self-contained manifests for the content file's root file and all HTML and image files that are linked from the root file (the actual physical files must be included in the Package Interchange File [PIF]). The resource element must contain a type attribute with the value webct.manifest and a coType attribute with the value webct.file.
<resources> <resource identifier="79615" type="webct.manifest" webct:coType="webct.file" xsi:type="webct.ResourceType"> <file href="URN_X-WEBCT-VISTA-V0/79615.xml" /> </resource> </resources>

17

Chapter 2: Content File Specification

Creating the ContentObject Section
At the end of the content file manifest, you must include the ContentObject element. For the coType attribute, specify the value webct.page. To specify that the content file is created in HTML (as opposed to plain text), include the useHtml attribute and specify the value true. Within the ContentObject element, the Name element is the only element that must appear.
<webct:ContentObject webct:coType="webct.page"> <xsi:type="webct.page:ContentPageType webctpage:useHtml="true"> <webct:Name>Content File One</webct:Name> </webct:ContentObject>

NOTE:

If a content package contains more than one top-level manifest (for example, more than two top-level content files), the root manifest is a container manifest and must not contain the ContentObject element.

CONTENT FILE MANIFEST EXAMPLE
<?xml version="1.0" encoding="UTF-8" ?> <manifest identifier="79622" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:webct="http://www.webct.com/xsd/cisv3" xmlns:webctpage="http://www.webct.com/xsd/cispagev3"> <metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion> <webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3" /> <webct:Schema webct:name="webct.page" webct:version="3.0.0" /> </webct:SchemaMetaData> <imsmd:lom> <imsmd:general> <imsmd:title> <imsmd:langstring xml:lang="en-US">Planning Europe's Capital Cities</imsmd:langstring> </imsmd:title> </imsmd:general> <imsmd:lifecycle> <imsmd:version> <imsmd:langstring xml:lang="x-none">1.0</imsmd:langstring> </imsmd:version> </imsmd:lifecycle> <imsmd:educational> <imsmd:learningresourcetype> <imsmd:source> <imsmd:langstring xml:lang="x-none">WebCT</imsmd:langstring> </imsmd:source> <imsmd:value> <imsmd:langstring xml:lang="x-none">webct.page</imsmd:langstring> </imsmd:value> </imsmd:learningresourcetype> </imsmd:educational> </imsmd:lom> </metadata> <organizations> <organization identifier="79622_O">

18

Chapter 2: Content File Specification

<item identifier="79615_I" identifierref="79615" /> </organization> </organizations> <resources> <resource identifier="79615" type="webct.manifest" webct:coType="webct.file" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/79615.xml" /> </resource> </resources> <webct:ContentObject webct:coType="webct.page" xsi:type="webctpage:ContentPageType" webctpage:useHtml="true"> <webct:Name>Planning Europe's Capital Cities</webct:Name> </webct:ContentObject> </manifest>

XML BINDING
This section contains a narrative description of the CIS 3.0 Content File XMLschema. The Content File schema extends the base ContentObject element that is defined in the namespace for the CIS 3.0 XML schema. The http://www.webct.com/xsd/cispagev3 namespace for the CIS 3.0 XML schema is located is cisv3.xsd. The namespace for the Content File schema is located in cispage3.xsd. Both of these files are included in the zip file of each content package exported from CE 6.1 and Vista 4.1 and are also available on the Content Interoperability Specification download page. To go to the Content Interoperability Specification download page, do the following: 1. Go to Behind the Blackboard (http://www.blackboard.com). From the download center, 2. Do one of the following: • • Click Vista 4 Download Center. The Vista 4 Download Center Login page appears. Click Campus Edition 6 Download Center. The Campus Edition 6 Download Center Login page appears.

3. In the Email Address text box, enter your e-mail address. 4. In the Password text box, do one of the following: • • Enter your Vista password. Enter your CE 4 license key or CE 6 download password.

5. Click Submit. The Vista 4 Download Center or Campus Edition 6 Download Center page appears. 6. Click Documentation. The Vista 4 Documentation or Campus Edition 6 Documentation page appears. 7. Under Programmer Documentation, click Content Interoperability Specification Version 3.0 for CE 6.1 and Vista 4.1.

ContentObject Element
19

Chapter 2: Content File Specification

Description

This element represents specific features of the learning object that are not defined by the IMS CP specification. • • http://www.webct.com/xsd/cisv3 http://www.webct.com/xsd/cispagev3

Namespace

Multiplicity

For learning object manifests, occurs once and only once within a manifest element. NOTE: If multiple top-level learning objects are selected for export, the root manifest is a container manifest and must not contain the ContentObject element. For example, if the content package contains ten top-level content files, the root manifest must not contain the ContentObject element.

Attribute

• • •

coType (required). Indicates the learning object type. Data type=string. For a content file, the value of the coType attribute must be set to webct.page. isVisible (optional). Indicates whether the learning object is displayed. If not present, the value is assumed to be true. Data type=boolean. useHtml (optional). Indicates whether the content file is created in HTML. Data type=boolean. <Name>
<webct:ContentObject webct:coType="webct.page"> xsi type="webctpage:ContentPageType" webct:page:useHtml="true"> <webct:Name>English_Poets.html</webct:Name> /webct:ContentObject>

Elements Example

Name Element
Description Namespace Multiplicity Example This element describes the name of the learning object. Data type=string. http://www.webct.com/xsd/cisv3 Occurs once and only once within a ContentObject element.
<webct:Name>English_poets.html</webct:Name>

20

Chapter 3: File Specification

CHAPTER 3: FILE SPECIFICATION
NOTE: Depending on where files are located in the systemand whether they have managed Media Library links, they are described and packaged by using the File specification or by using the Content File and File specifications. Files that are not in a folder or learning module and that do not have managed Media Library links are described and packaged by using the File specification. Files that are added to a folder or learning module, or that have managed Media Library links are described and packaged by using the Content File and File specifications. In chapters 2, 3, and 4, we refer to these files as "content files". For more information, see Chapter 2: Content File Specification.

Vista and CE's File specification provides the functionality to describe and package an individual file or a collection of files into an interoperable, distributable package that can be transported between different learning contexts and installations. In Vista 4.1 and CE 6.1, a file is more than just a collection of data. Vista 4.1 and CE 6.1 also captures information about the file, such as the author, description, and character set of the file. Chapter 1 of the Content Interoperability Specification (CIS) describes the basic structure of a WebCT IMS content package and the system's base extensions to the IMS Content Packaging (CP) schema. These extensions apply to all learning objects. For more information, see Chapter 1: The Blackboard Learning System CIS. The File specification extends CIS 3.0 XML schema and defines a unique namespace (http://www.webct.com/xsd/cisfilev3) and schema (webct.file) to represent the features that are specific to Vista 4.1 and CE 6.1 files. The File specification is made up of the following sections: • • • • File Manifest Elements: This section includes a diagram of the primary elements in a file manifest. Best Practices for Creating a File Manifest: This section describes the best practices for creating the four main sections in a file manifest. File Manifest Example: This section includes an example of a file manifest. XML Binding: This section contains a narrative description of the CIS 3.0 File schema.

FILE MANIFEST ELEMENTS
The following diagram shows the primary elements in a file manifest.

21

Chapter 3: File Specification

BEST PRACTICES FOR CREATING A FILE MANIFEST
22

Chapter 3: File Specification

To create a file that can be transported between different Vista 4.1 and CE 6.1 learning contexts and installations, you must create a self-contained manifest for the file. This section describes the best practices for creating the four main sections in a file manifest: Metadata, Organizations, Resources, and ContentObject.

Creating the Metadata Section
Within the manifest's metadata element, you must specify the schema used by the manifest. Within the schema element, you must specify the value webct.cis. Within the schemaversion element, you must specify the value 3.0.0.
<metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion>

If you want to specify other schemas that are used by the manifest, use the SchemaMetaData element: NOTE: The SchemaMetaData element is an optional element. If the SchemaMetaData element is not used, the default schema versions and namespaces for the Blackboard Learning SystemCIS 3.0 are used.

• • •

To specify that the IMS Content Packaging (CP) schema is used, the Schema element must contain a name attribute with the value IMS Content and a version attribute with the value 1.1.3. To specify that the IMS Meta-data schema is used, the Schema element must contain a name attribute with the value IMS MetaData and a version attribute with the value 1.2.3. To specify that the File schema is used, the Schema element must contain a name attribute with the value webct.file and a version attribute with the value 3.0.0.
<webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3 /> <webct:Schema webct:name="webct.file" webct:version="3.0.0" /> </webct:SchemaMetaData>

Creating the Organizations Section
A file manifest must contain an empty organizations section.

Creating the Resources Section
Within the resources element, the resource element references the actual physical file described by

23

Chapter 3: File Specification

the manifest. This file must be included in the Package Interchange File (PIF). The resource element must contain a type attribute with the value webcontent.
<resources> <resource identifier="79615_R" type="webcontent"> <file href="URN_X-WEBCT-VISTA-V0/79615.html" /> </resource> </resources>

Creating the ContentObject Section
At the end of the file manifest, you must include the ContentObject element. For the coType attribute, specify the value webct.file. Within the ContentObject element, the only element that must appear is the Name element. The Title, Author, DateCreated, Description, Keywords, CharacterSet, and Path elements are optional elements that are used to describe the file.
<webct:ContentObject webct:coType="webct.file" xsi:type="webctfl:FileType> <webct:Name>English_Poets.html</webct:Name> <webctfl:Title>English Poets</webctfl:Title> <webctfl:Author>Alice Garcia</webctfl:Author> <webctfl:DateCreated>2004-05-18T09:49:05</webctfl:DateCreated> <webctfl:Description>A short biography of some of the greatest English poets of the nineteenth century, along with examples of their work.</webctfl:Description> <webctfl:Keywords>"19th century poets", "English poets", Blake, Browning</webctfl:Keywords> <webctfl:CharacterSet>utf-8</webctfl:CharacterSet> <webctfl:Path>Poets</webctfl:Path> </webct:ContentObject>

NOTE:

If a content package contains more than one top-level manifest (for example, more than two top-level files), the root manifest is a container manifest and must not contain the ContentObject element.

FILE MANIFEST EXAMPLE
<?xml version="1.0" encoding="UTF-8" ?> <manifest identifier="71313" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:webct="http://www.webct.com/xsd/cisv3" xmlns:webctfl="http://www.webct.com/xsd/cisfilev3"> <metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion> <webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3" /> <webct:Schema webct:name="webct.file" webct:version="3.0.0" /> </webct:SchemaMetaData> <imsmd:lom> <imsmd:general> <imsmd:title> <imsmd:langstring xml:lang="en-US">English_Poets.html</imsmd:langstring> </imsmd:title> </imsmd:general>

24

Chapter 3: File Specification

<imsmd:lifecycle> <imsmd:version> <imsmd:langstring xml:lang="x-none">1.0</imsmd:langstring> </imsmd:version> </imsmd:lifecycle> <imsmd:educational> <imsmd:learningresourcetype> <imsmd:source> <imsmd:langstring xml:lang="x-none">WebCT</imsmd:langstring> </imsmd:source> <imsmd:value> <imsmd:langstring xml:lang="x-none">webct.file</imsmd:langstring> </imsmd:value> </imsmd:learningresourcetype> </imsmd:educational> </imsmd:lom> </metadata> <organizations /> <resources> <resource identifier="79615" type="webcontent"> <file href="X-WEBCT-VISTA-V0/79615.html" /> </resource> </resources> <webct:ContentObject webct:coType="webct.file" xsi:type="webctfl:FileType> <webct:Name>English_Poets.html</webct:Name> <webctfl:Title>English Poets</webctfl:Title> <webctfl:Author>Alice Garcia</webctfl:Author> <webctfl:DateCreated>2004-0704T12:35:26</webctfl:DateCreated> <webctfl:Description>A short biography of some of the greatest English poets of the nineteenth century, along with examples of their work.</webctfl:Description> <webctfl:Keywords>"19th century poets", "English poets" Blake, Browning, Byron</webctfl:Keywords> <webctfl:CharacterSet>utf-8</webctfl:CharacterSet> <webctfl:Path>Poets</webctfl:Path> </webct:ContentObject> </manifest>

XML BINDING
This section contains a narrative description of the CIS 3.0 File schema. The File schema extends the base ContentObject element that is defined in the namespace for the CIS 3.0 XML schema. The http://www.webct.com/xsd/cisv3 namespace for the CIS 3.0 XML schema is located in the file cisv3.xsd. The namespace for the File schema is located in cisfile3.xsd. Both of these files are included in the zip file of each content package exported from Vista 4.1 and CE 6.1 and are also available on the Content Interoperability Specification download page. To go to the Content Interoperability Specification download page, do the following: 1. Go to Behind the Blackboard (http://www.blackboard.com). open the download center. 2. Do one of the following: • • Click Vista 4 Download Center. The Vista 4 Download Center Login page appears. Click Campus Edition 6 Download Center. The Campus Edition 6 Download Center Login page appears.

3. In the Email Address text box, enter your e-mail address. 4. In the Password text box, do one of the following:

25

Chapter 3: File Specification

• •

Enter your Vista password. Enter your CE 4 license key or CE 6 download password.

5. Click Submit. The Vista 4 Download Center or Campus Edition 6 Download Center page appears. 6. Click Documentation. The Vista 4 Documentation or Campus Edition 6 Documentation page appears. 7. Under Programmer Documentation, click Content Interoperability Specification Version 3.0 for CE 6.1 and Vista 4.1.

ContentObject Element
Description This element represents specific features of the learning object that are not defined by the IMS CP specification. • • Multiplicity Attributes http://www.webct.com/xsd/cisv3 http://www.webct.com/xsd/cisfilev3

Namespaces

Occurs once and only once within a manifest element. • • coType (required). Indicates the learning object type. Data type=string. For a file, the value of the coType attribute must be set to webct.file. isVisible (optional). Indicates whether or not the learning object is displayed. If not present, the value is assumed to be true. Data type=boolean. <Name> <Title> <Author> <DateCreated> <Description> <Keywords> <CharacterSet> <Path>

Elements

• • • • • • • •

26

Chapter 3: File Specification

Example

<webct:ContentObject webct:coType="webct.file" xsi:type="webctfl:FileType> <webct:Name>English_Poets.html</webct:Name> <webctfl:Title>English Poets</webctfl:Title> <webctfl:Author>Alice Garcia</webctfl:Author> <webctfl:DateCreated>2004-05-18T09:49:05</webctfl:DateCreated> <webctfl:Description>A short biography of some of the greatest English poets of the nineteenth century, along with examples of their work.</webctfl:Description> <webctfl:Keywords>"19th century poets", Byron</webctfl:Keywords> <webctfl:CharacterSet>utf-8</webctfl:CharacterSet> <webctfl:Path>Poets</webctfl:Path> </webct:ContentObject>

Name Element
Description This element represents the file name of the file, including the file extension. Data type=string. http://www.webct.com/xsd/cisv3 Occurs once and only once within a ContentObject element.
<webct:Name>English_Poets.html</webct:Name>

Namespace Multiplicity Example

Title Element
Description Namespace Multiplicity Example This element represents the title of the file. Data type=string. http://www.webct.com/xsd/cisfilev3 Occurs zero or once within a ContentObject element.
<webctfl:Title>English Poets</webctfl:Title>

Author Element
Description This element represents the author of the file. Data type=string.

27

Chapter 3: File Specification

Namespace Multiplicity Example

http://www.webct.com/xsd/cisfilev3 Occurs zero or once within a ContentObject element.
<webctfl:Author>Alice Garcia</webctfl:Author>

DateCreated Element
Description This element represents the date and time that the file was created. Data type=dateTime. http://www.webct.com/xsd/cisfilev3 Occurs zero or once within a ContentObject element.
<webctfl:DateCreated>2004-05-18T09:49:05</webctfl:DateCreated>

Namespace Multiplicity Example

Description Element
Description Namespace Multiplicity Example This element contains a description of the file. Data type=string http://www.webct.com/xsd/cisfilev3 Occurs zero or once within a ContentObject element.
<webctfl:Description>A short biography of some of the greatest English poets of the nineteenth century, along with examples of their work.</webctfl:Description>

Keywords Element
Description Namespace This element contains keywords used to search for the file. Data type=string. http://www.webct.com/xsd/cisfilev3

28

Chapter 3: File Specification

Multiplicity Example

Occurs zero or once within a ContentObject element.
<webctfl:Keywords>"19th century poets", "English poets", Blake, Browning, Byron</webctfl:Keywords>

CharacterSet Element
Description This element represents the character set of the file. Data type=string. The following table includes the characters sets and the aliases that Vista 4.1 and CE 6.1 supports.
Export Aliases

Name

Arabic (ISO-8859-6)

iso-8859-6

8859_6, iso-8859-6:1987, iso-ir-127, iso_8859-6, iso8859-6, ecma-114, asmo-708, arabic, csisolatinarabic, ibm1089, ibm-1089, cp1089, 1089

Arabic (Windows 1256) Baltic (ISO-8859-4)

windows-1256 iso-8859-4 8859_4, iso_8859-4:1988, iso-ir-110, iso-8859-4, iso8859-4, latin4, l4, ibm914, ibm-914, cp914, 914, csisolatin4

Baltic (Windows 1257) Central European (ISO-8859-2)

windows-1257 iso-8859-2 iso-8859_2, ISO_8859-2, iso_8859_2, iso_8859-2:1987, iso-ir-101, iso_8859-2, iso8859-2, latin2, l2, ibm912, ibm-912, cp912, 912, csisolatin2

Central European (Windows 1250) Chinese Simplified (EUC_CN) Chinese Traditional (Big5) Cyrillic (ISO-8859-5)

wdinwos-1250 euc-cn big5 iso-8859-5 gb2312, euccn, gb2312-80, gb2312-1980 csBig5 8859_5, iso_8859-5:1988, iso-ir-144, iso_8859-5, iso8859-5, cyrillic, csisolatincyrillic, ibm915, ibm-915, cp915, 915 koi8, cskoi8r

Cyrillic (Koi8-R)

koi8-r

29

Chapter 3: File Specification

Name

Export

Aliases

Cyrillic (Windows 1251) Greek (ISO-8859-7)

windows-1251 iso-8859-7

ansi-1251 8859_7, iso_8859-7:1987, iso-ir-126, iso_8859-7, iso8859-7, elot_928, ecma-118, greek, greek8, csisolatingreek, ibm813, ibm-813, cp813, 813, sun_eu_greek

Greek (Windows 1253) Hebrew (ISO-8859-8)

windows-1253 iso-8859-8 8859_8, iso_8859-8:1988, iso-ir-138, iso_8859-8, iso8859-8, hebrew, csisolatinhebrew, ibm916, ibm-916, cp916, 916

Hebrew (Windows 1255) Japanese (EUC-JP)

windows-1255 euc-jp eucjis, x-eucjp, csEUCPkdFmtjapanese, eucjp, Extended_UNIX_Code_Packed_Format_for _Japanese, x-euc-jp ibm-33722, ibm33722, 33722 shift-jis, x-sjis, ms_kanji, csShiftJIS, pck ksc5601, ks_c_5601-1987, ksc5601-1987, ksc5601-1987, ksc_5601, 5601, csEUCKR csiso2022kr

Japanese (IBM-33722) Japanese (Shift_JIS) Korean (EUC-KR, KSC5601)

IBM-33722 shift_jis euc-kr

Korean (ISO-2022-kr) Thai (Windows 874) Thai (IBM874) Turkish (ISO-8859-9)

iso-2022-kr window-874 ibm-874 iso-8859-9

ibm874, cp874, 874 8859-9, iso-ir-148, iso_8859-9, iso8859-9, latin5, l5, ibm920, ibm-920, cp920, 920, csisolatin5, ISO_8859-9:1989

Turkish (Windows 1254) Unicode (UTF-8) Western European (ISO-8859-1)

windows-1254 utf-8 iso-8859-1 utf_8 iso-8859_1, iso-ir-100, 8859_1, ISO_8859-1, 819, csISOLatin1, IBM-819, ISO_8859-1:1987, latin1, cp819, ISO8859-1, IBM819, ISO_8859_1, l1

30

Chapter 3: File Specification

Name

Export

Aliases

Western European (Windows 1252)

window-1252

Namespace Multiplicity Example

http://www.webct.com/xsd/cisfilev3 Occurs zero or once within a ContentObject element.
<webctfl:CharacterSet>utf-8</webctfl:CharacterSet>

Path Element
Description This element describes the path of the file, relative to the template folder in the File Manager tool in Vista 4.1 and CE 6.1. Data type=string. The following example represents that the file English_Poets.html is saved in the Poets sub-folder within the template folder.
<webct:ContentObject webct:coType="webct.file" xsi:type="webctfl:FileType> <webct:Name>English_Poets.html</webct:Name> <webctfl:Path>Poets</webctfl:Path> </webct:ContentObject>

An empty Path element represents that the file is saved in the root of the template folder. NOTE: At the section level, the template folder is renamed the Section Content folder. If you export content from a section, the Path element describes the path of the file relative to the Section Content folder.

Namespace Multiplicity Example

http://www.webct.com/xsd/cisfilev3 Occurs zero or once within a ContentObject element.
<webctfl:Path>Poets</webctfl:Path>

31

Chapter 4: Learning Module Specification

CHAPTER 4: LEARNING MODULE SPECIFICATION
The Learning Module specification provides the functionality to describe and package an individual learning module or a collection of learning modules into an interoperable, distributable package that can be transported between different learning contexts and installations. Each learning module can contain an action menu, headings, files, and assessments. Chapter 1 of the Content Interoperability Specification (CIS) describes the basic structure of a IMS content package and the base extensions to the IMS Content Packaging (CP) schema. These extensions apply to all learning objects. For more information, see Chapter 1: The WebCT CIS. The Learning Module specification extends the CIS 3.0 XML schema and defines a unique namespace (http://www.webct.com/xsd/cislearningmodulev3) and schema (webct.learningModule) to represent the features that are specific to Vista 4.1 and CE 6.1 learning modules. The Learning Module specification includes the following sections: • • • • Learning Module Manifest Elements: This section includes a diagram of the primary elements in a learning module manifest. Best Practices for Creating a Learning Module Manifest: This section describes the best practices for creating the four main sections in a learning module manifest. Learning Module Manifest Example: This section includes an example of a learning module manifest. XML Binding: This section contains a narrative description of the CIS 3.0 Learning Module schema.

LEARNING MODULE MANIFEST ELEMENTS
The following diagram shows the primary elements in a learning module manifest.

32

Chapter 4: Learning Module Specification

BEST PRACTICES FOR CREATING A LEARNING MODULE MANIFEST
33

Chapter 4: Learning Module Specification

To create a learning module that can be transported between different Vista 4.1 and CE 6.1 learning contexts and installations, you must create a self-contained manifest for the learning module. This section describes the best practices for creating the four main sections in a learning module manifest: Metadata, Organizations, Resources, and ContentObject.

Creating the Metadata Section
Within the manifest's metadata element, you must specify the schema used by the manifest. Within the schema element, you must specify the value webct.cis. Within the schemaversion element, you must specify the value 3.0.0.
<metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion>

If you want to specify other schemas that are used by the manifest, use the SchemaMetaData element: NOTE: The SchemaMetaData element is an optional element. If the SchemaMetaData element is not used, the default schema versions and namespaces for the WebCT CIS 3.0 are used.

• • •

To specify that the IMS Content Packaging (CP) schema is used, the Schema element must contain a name attribute with the value IMS Content and a version attribute with the value 1.1.3. To specify that the IMS Meta-data schema is used, the Schema element must contain a name attribute with the value IMS MetaData and a version attribute with the value 1.2.3. To specify that the Learning Module schema is used, the Schema element must contain a name attribute with the value webct.learningModule and a version attribute with the value 3.0.0.
<webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3 /> <webct:Schema webct:name="webct.learningModule" webct:version="3.0.0" /> </webct:SchemaMetaData>

Creating the Organizations Section
In the organizations section of the manifest, within the organization element, there is one item element for each heading and learning object in the learning module. Headings are used to organize the links in a learning module's table of contents. The order in which the item elements appear represents the following: • • the order in which the headings and links to the learning objects appear in the learning module's table of contents the order in which the learning objects appear when you use the navigation buttons on the learning

34

Chapter 4: Learning Module Specification

module's action menu This is shown in the following XML example.
<organization identifier="116943_O" structure="webct:VistaLearningModule"> <item identifier="116943_I1"> <title>First heading in the Table of Contents</title> <webctlm:ActionMenu/> <item identifier="116943_I2" identifierref="116952" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>First Link in the Table of Contents</title> <webctlm:ActionMenu/> </item> <item identifier="116943_I3" identifierref=116967" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.assessment"> <title>Second Link in the Table of Contents</title> <webctlm:ActionMenu/> </item> <item identifier="116943_I4" identifierref="116983" isvisible ="true xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>Third Link in the Table of Contents</title> <webctlm:ActionMenu/> </item> </organization>

ActionMenu Element
The ActionMenu element that appears as an immediate child element of the organization element represents the default action menu of all learning objects in a learning module. The bookmarks, notes, and compile attributes of the ActionMenu element determine whether links to the Bookmarks, Notes, and Create Printable View tools appear on the default action menu of all learning objects in a learning module. The following diagram shows a learning module with a default action menu that contains links to the Bookmarks, Notes, and Create Printable View tools.

35

Chapter 4: Learning Module Specification

The following XML example represents a default action menu that contains links to the Bookmarks and Notes tools. Unless these links are overridden by the action menu of an individual learning object, links to these two tools will appear on the action menu of all learning objects in the learning module.
<organization identifier="117017_O" structure="webct:VistaLearningModule"> <webctlm:ActionMenu webctlm:bookmarks="true" webctlm:notes="true" webctlm:compile="false"/> </organization>

Within each item element, the ActionMenu element represents the learning object's action menu. If the item's ActionMenu element contains no attributes or elements, the learning object has the default action menu of the learning module. The following examples represents a file that has the default action menu of the learning module.
<organization identifier="117038_O" structure="webct:VistaLearningModule"> <item identifier="117038_I1" identifierref="115452" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>File_1</title> <webctlm:ActionMenu/> </item>

36

Chapter 4: Learning Module Specification

If an individual learning object in a learning module has an action menu that contains links to different tools than those that appear on the default action menu, this is represented by the attributes of the item's ActionMenu element. The following XML example represents a learning module that contains a file and an assessment. As represented by the ActionMenu element that is an immediate child element of the organization element, the default action menu for the learning module contains links to the Bookmarks and Notes tools (<webctlm:ActionMenu webctlm:bookmarks="true" webctlm:notes="true" webctlm:compile="false"/>). As represented by the ActionMenu element nested within the first item element, the content file has an action menu that contains a link to the Create Printable View tool only (<webctlm:ActionMenu webctlm:bookmarks="false" webctlm:notes="false" webctlm:compile="true"/>. As represented by the ActionMenu element nested within the second item element, the assessment has the default action menu of the learning module (<webctlm:ActionMenu/>).
<organization identifier="117038_O" structure="webct:VistaLearningModule"> <item identifier="117038_I1" identifierref="115452" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>File_1</title> <webctlm:ActionMenu webctlm:bookmarks="false" webctlm:notes="false" webctlm:compile="true"/> </item> <item identifier="117038_I2" identifierref="115507" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.assessment"> <title>Quiz_1</title> <webctlm:ActionMenu/> </item> <webctlm:ActionMenu webctlm:bookmarks="true" webctlm:notes="true" webctlm:compile="false"/> </organization>

ActionMenuItem Element
The ActionMenuItem elements nested within an ActionMenu element that is an immediate child element of the organization element represent the links to learning objects that appear on the default action menu of all learning objects in the learning module. The coType attribute of the ActionMenuItem element specifies the type of learning object that is linked. For example, if the value of the coType attribute is webct.page, this represents a link to a file that has been added to a folder, learning module, or has managed Media Library links. The following diagram shows a learning module with a default action menu that contains links to an assessment and a content file.

37

Chapter 4: Learning Module Specification

The following XML example represents a default action menu that contains links to two learning objects: an assessment and a file. Unless these links are overridden by the action menu of an individual learning object, links to these two learning objects will appear on the action menu of all learning objects in the learning module.
<organization identifier="117017_O" structure="webct:VistaLearningModule"> <webctlm:ActionMenu webctlm:bookmarks="true" webctlm:notes="true" webctlm:compile="false"> <webctlm:ActionMenuItem wectlm:identifier="117017_I2" wectlm:identifierref="115507" webctlm:coType="webct.assessment"/> <webctlm:ActionMenuItem wectlm:identifier="117017_I1" wectlm:identifierref="115452 webctlm:coType="webct.page"/> </webctlm:ActionMenu> </organization>

If an individual learning object in a learning module has an action menu that contains links to different learning objects than those that appear on the default action menu, this is represented by the ActionMenuItem element nested within an item's ActionMenu element. The following XML example represents a learning module that has a default action menu that contains a link to a content file (<webctlm:ActionMenuItem wectlm:identifier="117071_I4" wectlm:identifierref="115482 webctlm:coType="webct.page"/>). The action menu for the 38

Chapter 4: Learning Module Specification

quiz in the learning module overrides that link (<webctlm:ActionMenuItem
wectlm:identifier="117071_I2" wectlm:identifierref="115482 webctlm:overridden="true" webctlm:coType="webct.page"/>) and contains a link to an assessment only (<webctlm:ActionMenuItem wectlm:identifier="117071_I3" wectlm:identifierref="115507 webctlm:coType="webct.assessment"/>).
<organization "117071_O" structure="webct:VistaLearningModule"> <item identifier="117071_I1" identifierref="115452" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.assessment"> <title>Quiz_1</title> <webctlm:ActionMenu> <webctlm:ActionMenuItem wectlm:identifier="117071_I2" wectlm:identifierref="115482 webctlm:overridden="true" webctlm:coType="webct.page"/> <webctlm:ActionMenuItem wectlm:identifier="117071_I3" wectlm:identifierref="115507 webctlm:coType="webct.assessment"/> </webctlm:ActionMenu> </item> <webctlm:ActionMenu> <webctlm:ActionMenuItem wectlm:identifier="117071_I4" wectlm:identifierref="115482 webctlm:coType="webct.page"/> </webctlm:ActionMenu> </organization>

Creating the Resources Section
Within the resources element, there is one resource element for each learning object that is linked in the learning module. Each resource element contains a link to a self-contained manifest for the learning object. The resource element must contain a type attribute with the value webct.manifest. The coType attribute must specify the type of resource pointed to by the linked manifest. As shown in the following XML example, to specify that the resource points to a self-contained manifest for an assessment, specify the value webct.assessment
<resources> <resource identifier="79615" type="webct.manifest" webct:coType="webct.assessment" xsi:type="webct:ResourceType> <file href="URN_X-WEBCT-VISTA-V0/79615.html" /> </resource> </resources>

Creating the ContentObject Section
At the end of the learning module manifest, you must include the ContentObject element. For the coType attribute, specify the value webct.learningModule. For the numbering attribute, specify the numbering style of the table of contents. In the following XML example, the ContentObject element specifies a decimal numbering style for the table of contents.
<webct:ContentObject webct:coType="webct.learningModule" xsi:type="webctlm:LearningModuleType webctlm:numbering="DECIMAL"> <webct:Name>Week Two Learning Module</webct:Name>

39

Chapter 4: Learning Module Specification

</webct:ContentObject>

Within the ContentObject element, the only element that must appear is the Name element. NOTE: If a content package contains more than one top-level manifest (for example, more than one learning module), the root manifest is a container manifest and must not contain the ContentObject element.

LEARNING MODULE MANIFEST EXAMPLE
<?xml version="1.0" encoding="UTF-8" ?> <manifest identifier="117259" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:webct="http://www.webct.com/xsd/cisv3" xmlns:webctlm="http://www.webct.learningModule/xsd/cislearningmodulev3"> <metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion> <webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3" /> <webct:Schema webct:name="webct.learningModule" webct:version="3.0.0" /> </webct:SchemaMetaData> <imsmd:lom> <imsmd:general> <imsmd:title> <imsmd:langstring xml:lang="en-US">Week Four Learning Module</imsmd:langstring> </imsmd:title> </imsmd:general> <imsmd:lifecycle> <imsmd:version> <imsmd:langstring xml:lang="x-none">1.0</imsmd:langstring> </imsmd:version> </imsmd:lifecycle> <imsmd:educational> <imsmd:learningresourcetype> <imsmd:source> <imsmd:langstring xml:lang="x-none">WebCT</imsmd:langstring> </imsmd:source> <imsmd:value> <imsmd:langstring xml:lang="x-none">webct.learningModule</imsmd:langstring> </imsmd:value> </imsmd:learningresourcetype> </imsmd:educational> </imsmd:lom> </metadata> <organizations> <organization identifier="117259_O" structure="webct:VistaLearningModule"> <item identifier="117259_I1" identifierref="117268" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>Content File 1</title> <! -- As shown by the ActionMenu element below, the component action menu for Content File 1 contains links to the Bookmarks and Create Printable View tools. (When the bookmarks and compile attributes are not present, their values are "true".) As shown by the ActionMenuItem element below, the component action menu overrides the link to the content file that is on the learning module's default action menu and instead contains a link to another content file. --> <webctlm:ActionMenu webctlm:notes="false"> <webctlm:ActionMenuItem webctlm:identifier="117259_I2" webctlm:identifierref="115482" webctlm:overridden="true" webctlm:coType="webct.page"/>

40

Chapter 4: Learning Module Specification

<webctlm:ActionMenuItem webctlm:identifier="117259_I3" webctlm:identifierref="117186" webctlm:coType="webct.page"/> </webctlm:ActionMenu> </item> <item identifier="117259_I4" identifierref="117285" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>Content File 2</title> <! -- As shown by the ActionMenu and ActionMenuItem elements below, Content File 2 uses the default action menu of the learning module. --> <webctlm:ActionMenu> <webctlm:ActionMenuItem webctlm:identifier="117259_I5" webctlm:identifierref="117201" webctlm:coType="webct.page"/> </webctlm:ActionMenu> </item> <item identifier="117259_I6" identifierref="117303" isvisible ="true" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>Content File 3</title> <webctlm:ActionMenu> <webctlm:ActionMenuItem webctlm:identifier="117259_I7" webctlm:identifierref="115482" webctlm="overridden="true" webctlm:coType="webct.page"/> <webctlm:ActionMenuItem webctlm:identifier="117259_I8" webctlm:identifierref="117217" webctlm:coType="webct.page"/> </webctlm:ActionMenu> </item> <item identifier="117259_I9" identifierref="117313" isvisible ="false" xsi type="webctlm:LearningModuleItemType" webctlm:coType="webct.assessment"> <title>Quiz 1</title> <webctlm:ActionMenu webctlm:bookmarks="false" webctlm:notes="false" webctlm:compile="false"> <webctlm:ActionMenuItem webctlm:identifier="117259_I10" webctlm:identifierref="115482" webctlm:overridden="true" webctlm:coType="webct.page"/> </webctlm:ActionMenu> </item> <! -- As shown by the ActionMenu element below, the default action menu for the learning module contains links to the Bookmarks, Create Printable View, and Notes tools. (If the bookmarks, compile, or notes attribute is not present, the attribute value is "true".) The default action menu also contains a link to a content file. --> <webctlm:ActionMenu> <webctlm:ActionMenuItem webctlm:identifier="117259_I11" webctlm:identifierref ="115482" webctlm:coType="webct.page"/> </webctlm:ActionMenu> </organization> </organizations> <resources> <resource identifier="117303" type="webctmanifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/117303.xml" /> </resource> <resource identifier="117201" type="webctmanifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/117201.xml" /> </resource> <resource identifier="117268" type="webctmanifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/117268.xml" /> </resource> <resource identifier="117313" type="webctmanifest" webct:coType="webct.assessment" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/117313.xml" /> </resource> <resource identifier="117285" type="webctmanifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/117285.xml" /> </resource> <resource identifier="117217" type="webctmanifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/117217.xml" /> </resource> <resource identifier="117186" type="webctmanifest" webct:coType="webct.page" xsi:type="webct:ResourceType">

41

Chapter 4: Learning Module Specification

<file href="X-WEBCT-VISTA-V0/117186.xml" /> </resource> <resource identifier="115482" type="webctmanifest" webct:coType="webct.page" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/115482.xml" /> </resource> </resources> <webct:ContentObject webct:coType="webct.learningModule" xsi:type="webctlm:LearningModuleType" webctlm:numbering="DECIMAL"> <webct:Name>Week Four Learning Module</webct:Name> </webct:ContentObject> </manifest>

XML BINDING
This section contains a narrative description of the schema for the Learning Module specification. The Learning Module specification extends the namespace for the CIS 3.0 XML schema. The http://www.webct.com/xsd/cisv3 namespace for the CIS 3.0 XML schema is located in the file cisv3.xsd. The namespace for the Learning Module schema is located in cislearningmodule3.xsd. Both of these files are included in the zip file of each content package exported from Vista 4.1 and CE 6.1 and are also available on the Content Interoperability Specification download page. To go to the Content Interoperability Specification download page, do the following: 1. Go to Behind the Blackboard (http://www.blackboard.com). and open the download center. 2. Do one of the following: • • Click Vista 4 Download Center. The Vista 4 Download Center Login page appears. Click Campus Edition 6 Download Center. The Campus Edition 6 Download Center Login page appears.

3. In the Email Address text box, enter your e-mail address. 4. In the Password text box, do one of the following: • • Enter your Vista password. Enter your CE 4 license key or CE 6 download password.

5. Click Submit. The Vista 4 Download Center or Campus Edition 6 Download Center page appears. 6. Click Documentation. The Vista 4 Documentation or Campus Edition 6 Documentation page appears. 7. Under Programmer Documentation, click Content Interoperability Specification Version 3.0 for CE 6.1 and Vista 4.1.

Organization Element

42

Chapter 4: Learning Module Specification

The CIS has added the ActionMenu element to the base IMS organization element. Description Namespace This element describes the structure of the learning module. • • Multiplicity Attributes http://www.imsglobal.org/xsd/imscp_v1p1 http://www.webct.com/xsd/cislearningmodulev3

Occurs once and only once within an organizations element. • • identifier (required). An identifier that is unique within the manifest. Data type=ID. structure (optional). Describes the shape of an organization. Data type=string. For a learning module, the value of the structure attribute must be set to webct:VistaLearningModule. <item> <ActionMenu>
<organization identifier="115443_O" structure=webct:"VistaLearningModule"> <item identifier="108619_I1" identifierref="70907" isvisible="true" xsi:type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>Content File 1</title> </item> <webctlm:ActionMenu/> </organization>

Elements

• •

Example

Item Element
The CIS has added the coType attribute to the base IMS item element within the organization element. Description Namespace This element describes each heading and learning object in the learning module. • • Multiplicity http://www.imsglobal.org/xsd/imscp_v1p1 http://www.webct.com/xsd/cislearningmodulev3

Occurs one or more times within an organization element.

43

Chapter 4: Learning Module Specification

Attributes

coType (required). Indicates the type of learning object in the learning module. Data type=string. NOTE: Values are: • • • • •
webct.page: a file that has been added to a folder, learning module, or has

If the item is a heading, the coType attribute is not used.

managed Media Library links.
webct.file: a file in any location other than a folder or learning module

that does not have managed Media Library links
webct.learningModule: learning module webct:question: question webct:assessment: assessment

Elements

• •

<title> <ActionMenu> NOTE: If the item is a heading, the ActionMenu element is not used.

Example

The following XML example represents a file in the learning module called File 1.
<item identifier="108619_I1" identifierref="70907" isvisible="true" xsi:type="webctlm:LearningModuleItemType" webctlm:coType="webct.page"> <title>File 1</title> <webctlm:ActionMenu/> </item>

The following XML example represents a heading in the learning module called Heading 1.
<item identifier="108619_I2"> <title>Heading 1</title> </item>

Title Element

Description Namespace Multiplicity

This element describes the title of an <item>. Data type=string. http://www.imsglobal.org/xsd/imscp_v1p1 Occurs once and only once within an item element.

44

Chapter 4: Learning Module Specification

Example

<title>File 1</title>

ActionMenu Element
Description The ActionMenu element has different functions depending on where it appears: • If the ActionMenu element is an immediate child element of the organization element, it represents the default action menu of all learning objects in a learning module. If the ActionMenu element is nested in the item element, its represents the action menu of an individual learning object in the learning module.

Namespace Multiplicity

http://www.webct.com/xsd/cislearningmodulev3 • • Occurs once and only once as an immediate child element of an organization element. Occurs once and only once within an item element. identifier (optional). An identifier that is unique within the manifest. Data type=string. bookmarks (optional). This attribute specifies whether a link to the Bookmarks tool appears on the action menu. Data type=boolean. If not present, the value is assumed to be true. notes (optional). This attribute specifies whether a link to the Notes tool appears on the action menu. Data type=boolean. If not present, the value is assumed to be true. compile (optional). This attribute specifies whether a link to the Create Printable View tool appears on the action menu. Data type=boolean. If not present, the value is assumed to be true. <ActionMenuItem>
<webctlm:ActionMenu webctlm:bookmarks=:"true" webctlm:notes="false" webctlm:compile="false"> <webctlm:ActionMenuItem webctlm:identifier="108922_I2" webctlm:identifierref="79622" webctlm:overridden="true" webctlm:coType="webct.page"/> </webctlm:ActionMenu>

Attributes

• •

Elements Example

45

Chapter 4: Learning Module Specification

ActionMenuItem Element

Description

The ActionMenuItem element has different functions depending on where it appears: • If the ActionMenuItem element is in an ActionMenu element that is an immediate child element of an organization element, it represents a link to a learning object on the default action menu of the all learning objects within a learning module. If the ActionMenuItem element is in an ActionMenu element that is nested in an item element, it represents a link to a learning object on the action menu of a individual learning object in a learning module.

Namespace Multiplicity Attributes

http://www.webct.com/xsd/cislearningmodulev3 Occurs zero or more times within an ActionMenu element. • • • identifier (required). An identifier that is unique within the manifest. Data type=string. identifierref (required). A reference to an identifier in the resources section. Data type=string. overridden (optional). This attribute specifies whether the link (which appears on the default action menu) is overridden on the action menu of an individual learning module. Data type=boolean. If not present, the value is assumed to be false. If the value is set to true, the link will not appear on the action menu of the individual learning object. coType (required). Indicates the type of learning object that is linked on the action menu. Data type=string.
<webctlm:ActionMenuItem webctlm:identifier="108619_I5" webctlm:identifierref="70961" webctlm:overridden="true" webctlm:coType="webct.assessment"/>

Example

ContentObject Element
Description This element represents specific features of the learning object that are not defined by the IMS CP specification.

46

Chapter 4: Learning Module Specification

Namespaces

• •

http://www.webct.com/xsd/cisv3 http://www.webct.com/xsd/cislearningmodulev3

Multiplicity Attributes

Occurs once and only once within a manifest element. • coType (required). Indicates the learning object type. Data type=string. For a learning module, the value of the coType attribute must be set to webct.learningModule. isVisible (optional). Indicates whether the learning object displays. If not present, the value is assumed to be true. Data type=boolean. numbering (required). Indicates the numbering style of the table of contents in the learning module. Data type=string. Values are: • • • •
DECIMAL: decimal numbering style. For example, 1., 1.1., 1.2., 2. ROMAN: roman numbering style. For example, i., i.a., i.b., ii. NO_FORMAT_SPECIFIED

• •

tableOfContents (optional). Indicates whether the learning module's table of content displays. If not present, the value is assumed to be true. Data type=boolean. <Name>
<webct:ContentObject webct:coType="webct.learningModule" xsi:type="webctlm:LearningModuleType webctlm:numbering="DECIMAL" webctlm:tableOfContents="false"> <webct:Name>Week Two Learning Module</webct:Name> </webct:ContentObject>

Elements Example

Name Element
Description Namespace Multiplicity Example This element describes the name of the learning object. Data type=string. http://www.webct.com/xsd/cisv3 Occurs once and only once within a ContentObject element.
<webct:Name>Week Two Learning Module</webct:Name>

47

Chapter 5: Question Specification

CHAPTER 5: QUESTION SPECIFICATION
The Question specification provides the functionality to create and package an individual question or a collection of questions into an interoperable, distributable package that can be transported between different learning contexts and installations. Vista 4.2 and CE 6.2 support the following questions types: • • • • • • • • • calculated combination fill in the blank jumbled sentence matching multiple choice paragraph short answer true false

To package questions, WebCT implements the core elements of the IMS Content Packaging (CP) specification version 1.1.3 and uses the CIS 3.0 XML schema. Blackboard has added custom XML elements to provide some features that are not defined by the IMS CP specification. Chapter 1 of the Content Interoperability Specification (CIS) describes the basic structure of a IMS content package and the base extensions to the IMS Content Packaging (CP) schema. These extensions apply to all learning objects. For more information, see Chapter 1: The WebCT CIS. This section includes the following: • • • Question Manifest Elements: This section includes a diagram of the primary elements in a question manifest. Best Practices for Creating a Question Manifest: This section describes the best practices for creating the four main sections in a question manifest. Question Manifest Example: This section includes an example of a question manifest.

QUESTION MANIFEST ELEMENTS
The following diagram shows the primary elements in a question manifest.

48

Chapter 5: Question Specification

BEST PRACTICES FOR CREATING A QUESTION MANIFEST
To create a question that can be transported between different learning contexts and installations, you must create a self-contained manifest for the question. This section describes the best practices for creating the four main sections in a question manifest: Metadata, Organizations, Resources, and ContentObject.

Creating the Metadata Section
49

Chapter 5: Question Specification

Within the manifest's metadata element, you must specify the schema used by the manifest. Within the schema element, you must specify the value webct.cis. Within the schemaversion element, you must specify the value 3.0.0.
<metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion>

If you want to specify other schemas that are used by the manifest, use the SchemaMetaData element: NOTE: The SchemaMetaData element is an optional element. If the SchemaMetaData element is not used, the default schema versions and namespaces for the CIS 3.0 are used.

• •

To specify that the IMS CP schema is used, the Schema element must contain a name attribute with the value IMS Content and a version attribute with the value 1.1.3. To specify that the IMS Meta-data schema is used, the Schema element must contain a name attribute with the value IMS MetaData and a version attribute with the value 1.2.3.
<webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3"/> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3/> </webct:SchemaMetaData>

Creating the Organizations Section
A question manifest must contain an empty organizations section.

Creating the Resources Section
Within the resources element, the resource element specifies the question's QTI XML file. This element must contain a type attribute with the value ims_qtiasiv1p2. NOTE: For information on creating QTI XML files for the nine question types supported by Vista 4.2 and CE 6.2, see Best Practices for Creating Question QTI XML Files.

<resources> <resource identifier="117678_R" type="imsqtiasiv1p2"> <file href="URN_X-WEBCT-VISTA-V0/117678_R.xml"/> </resource> </resources>

The resource contains a link to a QTI XML file for the question. If the question contains an image, the resources element also contains a resource element describing the image file. The resource element must contain a type attribute with the value webct.manifest.

50

Chapter 5: Question Specification

<resources> <resource identifier="117678_R" type="imsqtiasiv1p2"> <file href="URN_X-WEBCT-VISTA-V0/117678_R.xml"/> </resource> <resource identifier="118570" type="webct.manifest"> <file href="URN_X-WEBCT-VISTA-V0/118570.xml"/> </resource> </resources>

Creating the ContentObject Section
At the end of the question manifest, you must include the ContentObject element. For the coType attribute, specify the value webct.question. Within the ContentObject element, the only element that must appear is the Name element.
<webct:ContentObject webct:coType="webct.question"> <webct:Name>Multiple Choice Question 1</webct:Name> </webct:ContentObject>

NOTE:

If a content package contains more than one top-level manifest (for example, two or more question manifests), the root manifest is a container manifest and must not contain the ContentObject element.

QUESTION MANIFEST EXAMPLE
<?xml version="1.0" encoding="UTF-8" ?> <manifest identifier="71313" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:webct="http://www.webct.com/xsd/cisv3" <metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion> <webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3" /> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3" /> </webct:SchemaMetaData> <imsmd:lom> <imsmd:general> <imsmd:title> <imsmd:langstring xml:lang="en-US">Multiple Choice Question 1</imsmd:langstring> </imsmd:title> </imsmd:general> <imsmd:lifecycle> <imsmd:version> <imsmd:langstring xml:lang="x-none">1.0</imsmd:langstring> </imsmd:version> </imsmd:lifecycle> <imsmd:educational> <imsmd:learningresourcetype> <imsmd:source> <imsmd:langstring xml:lang="x-none">WebCT</imsmd:langstring> </imsmd:source> <imsmd:value> <imsmd:langstring xml:lang="x-none">webct.question</imsmd:langstring>

51

Chapter 5: Question Specification

</imsmd:value> </imsmd:learningresourcetype> </imsmd:educational> </imsmd:lom> </metadata> <organizations /> <resources> <resource identifier="117678_R" type="ims_qtiasiv1p2"> <file href="X-WEBCT-VISTA-V0/117678.xml"/> </resource> <resource identifier="118570" type="webct.manifest"> <file href="X-WEBCT-VISTA-V0/118570.xml"/> </resource> </resources> <webct:ContentObject webct:coType="webct.question"> <webct:Name>Multiple Choice Question 1</webct:Name> </webct:ContentObject> </manifest>

BEST PRACTICES FOR CREATING QUESTION QTI XML FILES
To create items that represent the nine question types supported by Vista 4.2 and CE 6.2, Blackboard implements the core elements of the IMS Question and Test Interoperability (QTI) specification version 1.2. NOTE: A complete description of the IMS QTI specification is beyond the scope of this document. To download this specification, go to the IMS QTI specification web site (http://www.imsglobal.org/question/index.cfm).

The CIS also defines a unique namespace (http://www.webct.com/vista/assessment) and schema (webct_qti.xsd) to represent the extensions to the IMS QTI schema. The elements and attributes defined in the namespace represent content-rich features that are not defined by the IMS QTI specification. The following section describes the question fields and properties, and the corresponding metadata fields and data elements, that are common to all Vista 4.2 and CE 6.2 question types. Each question type has its own specific set of metadata fields and data elements. These are described in sections that describe how to create each question type.

Common Metadata Fields and Data Elements
This section describes the question fields and properties that are common to all questions types.

52

Chapter 5: Question Specification

Question Field or Metadata Field or Data Property Element

Description

Title

title attribute of the item element

The title attribute of the item element is an optional attribute that indicates the title of a question. If a title is not specified, the question is titled untitled. The wct_questiontype field is a required field that indicates the type of question. In Vista 4.2 and CE 6.2, this field corresponds to the Type field on the Question Database screen and on the screen in which questions are created. This field must be set to one of the following: • • • • • • • • • calculated questions: WCT_Calculated combination questions: WCT_Combination fill in the blank questions:
WCT_FillInTheBlank

Type

wct_questiontype

metadata field

jumbled sentence questions:
WCT_JumbledSentence

matching questions: WCT_Matching multiple choice questions:
WCT_MultipleChoice

paragraph questions: WCT_Paragraph short answer questions: WCT_ShortAnswer true false questions: WCT_TrueFalse

Category

wct_questioncategory The wct_questioncategory field is an optional

metadata field

field that indicates the category to which the question belongs. In Vista 4.2 and CE 6.2, this field corresponds to the category on the Question Database screen. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions.

Used By

wct_usedbyassessment The wct_usedbyassessment field is exported but

element

should not be used for import. The field indicates the assessments that use the question. In Vista 4.2 and CE 6.2, this field corresponds to the Used By field on the Question Database screen.

53

Chapter 5: Question Specification

Question Field or Metadata Field or Data Property Element

Description

Section Designer notes field

objectives element

The objectives element is an optional element that specifies notes about the question that are visible only to the designer of the question. In Vista 4.2 and CE 6.2, this element corresponds to the Section Designer notes field on the screen in which questions are created. The mattext element in material in the objectives element has the following attributes: •
xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • • •
default preserve

label (required). Must be set to wct_designer_notes_label_1. texttype (optional. Default=TEXT/PLAIN).

Specifies whether the notes are formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the notes are formatted in

HTML
TEXT/PLAIN: the notes are formatted in plain

text
charset (optional. Default=US-ASCII). The

character set that is to be used to represent the text string.

54

Chapter 5: Question Specification

Question Field or Metadata Field or Data Property Element

Description

Question text

mattext element in the The mattext element contains the question text. This first material element in element has the following attributes: flow in the • xml:space (optional). Defines whether or not the presentation element

whitespace is to be preserved. Possible values are: • •
default preserve

label (required). Data type=string. Possible

values are: • For all question types, except calculated and fill in the blank questions, the attribute must be set to wct_question_label_1. For calculated questions, the label attribute must be set to wct_calc_questionTextType. For fill in the blank questions, the label attribute must be set to wct_fib_questionTextType.

texttype (optional. Default=TEXT/PLAIN).

Specifies whether the question text is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the question is formatted in

HTML
TEXT/PLAIN: the question is formatted in

plain text
charset (optional. Default=US-ASCII). The

character set that is to be used to represent the text string.

55

Chapter 5: Question Specification

Question Field or Metadata Field or Data Property Element

Description

Question text with a Mathematical Markup Language (MathML) equation

material_webeq

element in
mat_extension in material in flow in the presentation element

When the question text contains an equation, the material_webeq element contains the question text. This element has the following attributes: • •
xmlns:webct The namespace. Must be set to http://www.webct.com/vista/assessment. label (required). Data type=string. Possible

values are: • For all question types except calculated and fill in the blank questions, the attribute must be set to wct_question_label_1. For calculated questions, the label attribute must be set to wct_calc_questionTextType. For fill in the blank questions, the label attribute must be set to wct_fib_questionTextType.

texttype (optional. Default=TEXT/PLAIN).

Specifies whether the question text is formatted in plain text or HTML. Possible values are: • •
TEXT/HTML: the question is formatted in

HTML
TEXT/PLAIN: the question is formatted in

plain text Vista 4.1 and CE 6.1 includes WebEQ™ Equation Editor version 2.5, which supports equations in MathML version 1.01 format. Information about MathML version 1.01 is beyond the scope of this document. For more information, go to the MathML 1.01 specification web site (http://www.w3.org/TR/REC-MathML/) The equation has the following attributes: • • • • 56
height. The background height, in pixels, of the

equation.
width. The background width, in pixels, of the

equation.
size (optional. Default=18). The font size of the

equation.
bgcolor. The background color of the equation.

Chapter 5: Question Specification

Question Field or Metadata Field or Data Property Element

Description

Format=hexadecimal color code. • •
title. The title of the equation. controls (optional. Default=false). Specifies

whether the user can control the font size of the equation. Possible values are: • •
false: the user cannot edit the font size of

the equation
true: the user can edit the font size of the

equation by right-clicking the equation Image
matimage element in material in flow in the presentation element

The matimage element is an optional element that contains an image that appears in the question. In Vista 4.2 and CE 6.2, this element corresponds to the question's Image field. This element has the following attributes: • •
label (required). Data type=string. Must be set to wct_question_label_1. uri (required). Contains the path to the image

from the root of the template folder. NOTE: At the section level, the template folder is renamed the Section Content folder. If you export content from a section, the uri attribute describes the path of the file relative to the Section Content folder.

Scoring type

decvar element in outcomes in the resprocessing element

The following attributes must be included in the decvar element: • •
vartype (required). Must be set to Decimal. varname (required). Must be set to SCORE.

57

Chapter 5: Question Specification

Question Field or Metadata Field or Data Property Element

Description

Scoring value

setvar element in respcondition in the resprocessing element

For calculated question, the setvar element is in unit_eval in
itemproc_extension in the resprocessing

The value of each setvar element must be set to between zero and 100 percent (0.0 and 100.0). In the item, the sum of all setvar elements that have an Action attribute that is set to Add, must be 100 percent (100.0). NOTE: Paragraph questions do not include the setvar element.

element

58

Chapter 5: Question Specification

Question Field or Metadata Field or Data Property Element

Description

General Feedback mattext element in field material in flow_mat in the itemfeedback element

The itemfeedback element is an optional element that contains feedback that appears when Students view the graded question. In Vista 4.2 and CE 6.2, the element corresponds to the General feedback field on the screen in which questions are created. The itemfeedback element has the following attributes: • •
ident (required). Must be set to wct_general_feedback_ref_1. view (optional. Default=All). Defines to whom

the material can be presented. The mattext element in material in flow_mat in the itemfeedback element specifies the general feedback that appears when Students view the graded question. This element has the following attributes: •
xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • • •
default preserve

label (required). Data type=string. Must be set to wct_general_feedback_1. texttype (optional. Default=TEXT/PLAIN).

Specifies whether the feedback is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the feedback is formatted in

HTML
TEXT/PLAIN: the feedback is formatted in

plain text
charset (optional. Default=US-ASCII). The

character set that is to be used to represent the text string. NOTE: For combination and multiple choice questions, the itemfeedback element is also used to specify answer feedback. For more information, see Creating the Itemfeedback Section in the sections Creating Combination Questions and Creating Multiple Choice Questions.

59

Chapter 5: Question Specification

Creating Calculated Questions
The following diagram shows the extension to the standard item element for calculated questions. XML bindings for extensions to the presentation and resprocessing elements are described in the section XML Binding for Item Elements.

60

Chapter 5: Question Specification

61

Chapter 5: Question Specification

Best Practices for Creating a Calculated Question QTI XML File
This section describes the best practices for creating the five main sections in a calculated question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define calculated questions:
Metadata Field wct_questiontype Description

This field indicates the type of question. This field must be set to WCT_Calculated. This field specifies the question text. Variables must be placed within square brackets ([]). This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen. This field is exported but is not required for import. This field specifies the first and last name of the author of the question.

wct_calc_questionText

wct_authorWebctGlid

wct_questioncategory

wct_usedbyassessment

wct_authorFullName

Creating the Objectives Section
Calculated questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This element is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
Calculated questions use the mattext, material_webeq, and matimage elements to specify question

62

Chapter 5: Question Specification

text, equations, and images respectively. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, within the presentation element, in the flow element, in the mat_extension element, the following elements are used to defined calculated questions:
Element calculated Description

This element specifies the formula used to calculate the question's answers. This element contains the formula used to calculate the question's answer. Variables must be place within square brackets ([]). This element contains a variable declaration for one of the variables in the formula element. There must be one var element for each variable in the formula. It has the following attributes: • • • •
name: The variable name. min: The minimum value of the variable. max: The maximum value of the variable. precision: The number of the decimal places of the variable. Possible values are 0, 1, 2, 3, 4, or 5.

formula

var

calculated_set

This element contains the calculated_var and answer elements for a calculated answer. It has the following attribute: •
index: The number of the calculated answer. (The index is zero-based, thus the first answer is 0, the second answer is 1, and so forth.)

calculated_var

A variable in the answer set. There must be one calculated_var element for each variable in the formula. It has the following attributes: • •
name: The variable name. value: The value of the variable.

answer

There must be one answer element in each calculated_set element. It has the following attribute: •
value: the calculated answer based on the values in the calculated_var elements

63

Chapter 5: Question Specification

Element variable

Description

This element is used to define the variable. It specifies where the variable appears in the question text. It has the following attributes: • • •
label (optional). Data type=string. name: The name of the variable. precision: The number of decimal places of the variable. Possible values are 0, 1, 2, 3, 4, or 5.

localizable_mattext

This element is used to specify that the word is rendered according to the locale setting. For calculated questions, the element can contain one of the following words: • •
answer units

This element has the following attributes: • •
xmlns:webct The namespace. Must be set to http://www.webct.com/vista/assessment. xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • •
default preserve

texttype: (optional. Default=TEXT/PLAIN). Specifies

whether the word is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the word is formatted in HTML TEXT/PLAIN: the word is formatted in plain text

charset: the value must be set to US-ASCII

Creating the Resprocessing Section
Calculated questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, within the resprocessing element in the itemproc_extension element, the following elements are used to define calculated questions:

64

Chapter 5: Question Specification

Element calculated_answer

Description

This element specifies information about the question's answers. It has the following attributes: •
respident: The value must match the ident attribute of the response_num element in the presentation

element. • •
precision: The number of decimal places or significant

figures to which the answer sets are calculated.
precisionType: Specifies whether the answer sets are

calculated in decimal places or significant figures. Possible values are: • • • •
Decimal: decimal places SigFig: significant figures

tolerance: The answer tolerance value. toleranceType: Specifies whether the answer tolerance

is calculated in units or as a percent. Possible values are: • •
unit_eval Unit: answer tolerance is calculated in units Percent: answer tolerance is calculated as a percent

This element specifies the units for the answer value. It has the following attribute: •
space: Specifies whether or not spaces count in the units

part of the answer. Possible values are: • •
Yes: spaces count in the units part of the answer No: ignore spaces in the units part of the answer

Creating the Itemfeedback Section
Calculated questions use the IMS QTI specification's itemfeedback element to define the General Feedback field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

XML Example of a Calculated Question With an Equation
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Square Root Question" ident="WCT:ASM0:3840892000:28225: D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" />

65

Chapter 5: Question Specification

<!-- The wct_questiontype field must be set to "WCT_Calculated". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_Calculated</fieldentry> </qtimetadatafield> <!-- Equations in questions are in MathML version 1.01 format.--> <qtimetadatafield> <fieldlabel>wct_calc_questionText</fieldlabel> <fieldentry>What is {Equation:eqn=<math><mrow><msqrt><mrow><mi>&alpha;</mi> </mrow></msqrt></mrow></math>,height=31,width=35,size=18,bgcolor=#FFFFFF,title= eqn_1,controls=false}, where a = [x]? Calculate your answer to three decimal places.</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Calculated Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This field appears only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A question for the math mid-term</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The calculated element specifies the formula used to calculate the question's answers. --> <mat_extension> <webct:calculated xmlns:webct="http://www.webct.com/vista/assessment" label= "calculated"> <webct:formula>sqrt([x])</webct:formula> <webct:var webct:name="x" webct:min="25.0" webct:max="68.0" webct:precision="0" /> <webct:calculated_set webct:index="0"> <webct:calculated_var webct:name="x" webct:value="52.0" /> <webct:answer webct:value="7.211102550927978" /> </webct:calculated_set> <webct:calculated_set webct:index="1"> <webct:calculated_var webct:name="x" webct:value="59.0" /> <webct:answer webct:value="7.681145747868608" /> </webct:calculated_set> <webct:calculated_set webct:index="2"> <webct:calculated_var webct:name="x" webct:value="61.0" /> <webct:answer webct:value="7.810249675906654" /> </webct:calculated_set> <webct:calculated_set webct:index="3"> <webct:calculated_var webct:name="x" webct:value="63.0" /> <webct:answer webct:value="7.937253933193772" /> </webct:calculated_set> <webct:calculated_set webct:index="4"> <webct:calculated_var webct:name="x" webct:value="56.0" /> <webct:answer webct:value="7.483314773547883" /> </webct:calculated_set> <webct:calculated_set webct:index="5"> <webct:calculated_var webct:name="x" webct:value="57.0" /> <webct:answer webct:value="7.54983443527075" /> </webct:calculated_set> <webct:calculated_set webct:index="6"> <webct:calculated_var webct:name="x" webct:value="49.0" /> <webct:answer webct:value="7.0" />

66

Chapter 5: Question Specification

</webct:calculated_set> <webct:calculated_set webct:index="7"> <webct:calculated_var webct:name="x" webct:value="47.0" /> <webct:answer webct:value="6.855654600401044" /> </webct:calculated_set> <webct:calculated_set webct:index="8"> <webct:calculated_var webct:name="x" webct:value="36.0" /> <webct:answer webct:value="6.0" /> </webct:calculated_set> <webct:calculated_set webct:index="9"> <webct:calculated_var webct:name="x" webct:value="56.0" /> <webct:answer webct:value="7.483314773547883" /> </webct:calculated_set> </webct:calculated> </mat_extension> <mat_extension> <webct:material_webeq xmlns:webct="http://www.webct.com/vista/assessment" label= "wct_calc_questionTextType" texttype="TEXT/HTML">What is {Equation:eqn=<math> <mrow><msqrt><mrow><mi>&alpha;</mi></mrow></msqrt></mrow></math>,height=31, width=35,size=18,bgcolor=#FFFFFF,title=eqn_1,controls=false}, where a = </webct:material_webeq> </mat_extension> <mat_extension> <webct:variable xmlns:webct="http://www.webct.com/vista/assessment" webct:label="" webct:name="x" webct:precision="0" /> </mat_extension>3 <mat_extension> <webct:material_webeq xmlns:webct="http://www.webct.com/vista/assessment" label= "wct_calc_questionTextType" texttype="TEXT/HTML">? Calculate your answer to three decimal places.</webct:material_webeq> </mat_extension> <matbreak /> </material> <material> <matbreak /> <!-- The matimage element contains the image that appears in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/square_root.jpg" /> <matbreak /> </material> <response_num ident="CALC" rtiming="No" rcardinality="Single" numtype="Decimal"> <material> <!-- In the response_num element, the localizable_mattext element specifies that the label for the question's "Answer" text box will be localized according to the locale setting. --> <mat_extension> <webct:localizable_mattext xmlns:webct="http://www.webct.com/vista/assessment" xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII">answer</webct: localizable_mattext> </mat_extension> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="20" maxchars="20" maxnumber="1" minnumber="1"> <response_label ident="A" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_num> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" defaultval="0.0" /> </outcomes> <itemproc_extension> <webct:calculated_answer xmlns:webct="http://www.webct.com/vista/assessment" respident= "CALC" webct:precision="3" webct:precisionType="Decimal" webct:tolerance="0.0" webct: toleranceType="Percent"> <setvar varname="SCORE" action="Add">100.0</setvar> </webct:calculated_answer>

67

Chapter 5: Question Specification

<unit_eval xmlns:webct="http://www.webct.com/vista/assessment" webct:space="Yes"> <conditionvar xmlns=""> <varequal xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" respident="UNITS" case="Yes" /> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> </unit_eval> </itemproc_extension> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <!-- The itemfeedback section below contains the content that appears in the "General Feedback" field. This field appears when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">The square root of a number <i>n</i> is a number that, when multiplied by itself, equals <i>n</i>.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

XML Example of a Calculated Question Without an Equation
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Travel Time Calculated Question " ident="WCT:ASM0:3560360000:28225: D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <!-- The wct_questiontype field must be set to "WCT_Calculated". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_Calculated</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_calc_questionText</fieldlabel> <fieldentry>If a car is travelling [x] miles per hour, how many hours will it take the car to travel [y] miles? Calculate your answer to two decimal places. </fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Calculated Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This field appears only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material>

68

Chapter 5: Question Specification

<mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">This question was included on the Math 101 exam.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The calculated element specifies the formula used to calculate the question's answers. --> <mat_extension> <webct:calculated xmlns:webct="http://www.webct.com/vista/assessment" label= "calculated"> <webct:formula>[y]/[x]</webct:formula> <webct:var webct:name="y" webct:min="120.0" webct:max="124.0" webct:precision= "0" /> <webct:var webct:name="x" webct:min="40.0" webct:max="60.0" webct:precision= "0" /> <webct:calculated_set webct:index="0"> <webct:calculated_var webct:name="y" webct:value="120.0" /> <webct:calculated_var webct:name="x" webct:value="40.0" /> <webct:answer webct:value="3.0" /> </webct:calculated_set> <webct:calculated_set webct:index="1"> <webct:calculated_var webct:name="y" webct:value="122.0" /> <webct:calculated_var webct:name="x" webct:value="41.0" /> <webct:answer webct:value="2.975609756097561" /> </webct:calculated_set> <webct:calculated_set webct:index="2"> <webct:calculated_var webct:name="y" webct:value="123.0" /> <webct:calculated_var webct:name="x" webct:value="52.0" /> <webct:answer webct:value="2.3653846153846154" /> </webct:calculated_set> <webct:calculated_set webct:index="3"> <webct:calculated_var webct:name="y" webct:value="123.0" /> <webct:calculated_var webct:name="x" webct:value="59.0" /> <webct:answer webct:value="2.0847457627118646" /> </webct:calculated_set> <webct:calculated_set webct:index="4"> <webct:calculated_var webct:name="y" webct:value="122.0" /> <webct:calculated_var webct:name="x" webct:value="54.0" /> <webct:answer webct:value="2.259259259259259" /> </webct:calculated_set> <webct:calculated_set webct:index="5"> <webct:calculated_var webct:name="y" webct:value="120.0" /> <webct:calculated_var webct:name="x" webct:value="49.0" /> <webct:answer webct:value="2.4489795918367347" /> </webct:calculated_set> <webct:calculated_set webct:index="6"> <webct:calculated_var webct:name="y" webct:value="121.0" /> <webct:calculated_var webct:name="x" webct:value="57.0" /> <webct:answer webct:value="2.1228070175438596" /> </webct:calculated_set> <webct:calculated_set webct:index="7"> <webct:calculated_var webct:name="y" webct:value="122.0" /> <webct:calculated_var webct:name="x" webct:value="41.0" /> <webct:answer webct:value="2.975609756097561" /> </webct:calculated_set> <webct:calculated_set webct:index="8"> <webct:calculated_var webct:name="y" webct:value="120.0" /> <webct:calculated_var webct:name="x" webct:value="54.0" /> <webct:answer webct:value="2.2222222222222223" /> </webct:calculated_set> <webct:calculated_set webct:index="9"> <webct:calculated_var webct:name="y" webct:value="120.0" /> <webct:calculated_var webct:name="x" webct:value="57.0" /> <webct:answer webct:value="2.1052631578947367" /> </webct:calculated_set> </webct:calculated> </mat_extension> <mattext xml:space="preserve" label="wct_calc_questionTextType" texttype="TEXT/HTML" charset="US-ASCII">If a car is travelling </mattext> <mat_extension> <webct:variable xmlns:webct="http://www.webct.com/vista/assessment" webct:label="" webct:name="x" webct:precision="0" /> </mat_extension>

69

Chapter 5: Question Specification

<mattext xml:space="preserve" label="wct_calc_questionTextType" texttype="TEXT/HTML" charset="US-ASCII"> miles per hour, how many hours will it take the car to travel </mattext> <mat_extension> <webct:variable xmlns:webct="http://www.webct.com/vista/assessment" webct:label="" webct:name="y" webct:precision="0" /> </mat_extension> <mattext xml:space="preserve" label="wct_calc_questionTextType" texttype="TEXT/HTML" charset="US-ASCII"> miles? Calculate your answer to two decimal places.</mattext> <matbreak /> </material> <material> <matbreak /> <!-- The matimage element contains the image that appears in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/car.bmp" /> <matbreak /> </material> <!-- In the response_num element, the localizable_mattext element specifies that the label for the question's "Answer" text box will be localized according to the locale setting. --> <response_num ident="CALC" rtiming="No" rcardinality="Single" numtype="Decimal"> <material> <mat_extension> <webct:localizable_mattext xmlns:webct="http://www.webct.com/vista/assessment" xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII">answer </webct:localizable_mattext> </mat_extension> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="20" maxchars="20" maxnumber="1" minnumber="1"> <response_label ident="A" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_num> <!-- In the response_str element, the localizable_mattext element specifies that the label for the question's "Units" answer text box will be localized according to the locale setting. --> <response_str ident="UNITS" rtiming="No" rcardinality="Single"> <material> <mat_extension> <webct:localizable_mattext xmlns:webct="http://www.webct.com/vista/assessment" xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII">units </webct:localizable_mattext> </mat_extension> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="9" maxchars="9" maxnumber="1" minnumber="1"> <response_label ident="A" rshuffle="No" /> </render_fib> </response_str> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" defaultval="0.0" /> </outcomes> <itemproc_extension> <webct:calculated_answer xmlns:webct="http://www.webct.com/vista/assessment" respident= "CALC" webct:precision="2" webct:precisionType="Decimal" webct:tolerance="0.0" webct:toleranceType="Percent"> <setvar varname="SCORE" action="Add">90.0</setvar> </webct:calculated_answer> <unit_eval xmlns:webct="http://www.webct.com/vista/assessment" webct:space="No"> <conditionvar xmlns=""> <varequal xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" respident="UNITS" case="No">hours</varequal> </conditionvar>

70

Chapter 5: Question Specification

<setvar varname="SCORE" action="Add">10.0</setvar> </unit_eval> </itemproc_extension> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <!-- The itemfeedback section below contains the content that appears in the "General Feedback" field. This field appears when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">To calculate the number of hours, divide the distance travelled by the rate of speed.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

Creating Combination Questions
The following diagram shows the extension to the standard item element for combination questions. XML bindings for the extension to the presentation element are described in the section XML Binding for Item Elements.

71

Chapter 5: Question Specification

Best Practices for Creating a Combination Question QTI XML File

72

Chapter 5: Question Specification

This section describes the best practices for creating the five main sections in a combination question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define combination questions:
Metadata Field qmd_questiontype Description

This field is exported but is not required for import. It indicates the type of question (for standard IMS QTI question types). This field is exported but is not required for import. (The structure of combination questions is derived from the structure of multiple choice questions. The layoutHorizontal property was inherited from multiple choice questions. Combination questions always appear in vertical layout, regardless of whether the property is set to false or true.) This field indicates the type of question. It must be set to WCT_Combination. This field is exported but is not required for import. It contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen. This field is exported but is not required for import. It specifies the first and last name of the author of the question.

layoutHorizontal

wct_questiontype

wct_authorWebctGlid

wct_questioncategory

wct_usedbyassessment

wct_authorFullName

Creating the Objectives Section
Combination questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
73

Chapter 5: Question Specification

Combination questions use the mattext, material_webeq, and matimage elements to specify question text, equations, and images respectively. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, the following elements are used:
Element mattext element in material in the flow element Description

Each mattext element contains an answer. The element has the following attributes: •
xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • •
default preserve

label (required). Must be set to wct_cmc_single_answerx (where x is the number of

the answer). (The index is zero-based, thus the first answer is 0, the second answer is 1, and so forth.) •
texttype: (optional. Default=TEXT/PLAIN). Specifies

whether the answer is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the answer is formatted in HTML TEXT/PLAIN: the answer is formatted in plain text

charset (optional. Default=US-ASCII). The character

set that is to be used to represent the text string.

74

Chapter 5: Question Specification

Element mattext element in material in the response_label element

Description

Each mattext element contains an answer combination. The element has the following attributes: •
xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • •
default preserve

label (required). Must be set to wct_mc_answer_textx_y (where x is the number of the answer combination and y is the position of the single

answer in the answer combination.) (The index for the answer combination is zero-based, thus the first answer combination is 0, the second answer combination is 1, and so forth.) NOTE: If an alternate answer is specified, such as All of the above or None of the above, y is not included in the label value.

texttype: (optional. Default=TEXT/PLAIN). Specifies

whether the answer combination is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the answer combination is formatted in

HTML
TEXT/PLAIN: the answer combination is formatted in

plain text
charset (optional. Default=US-ASCII). The character

set that is to be used to represent the text string.

Creating the Resprocessing Section
Combination questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Itemfeedback Section
Combination questions use the IMS QTI specification's itemfeedback element to define the General Feedback field and the answer feedback fields. The General Feedback field is common to all question types. For more information, see Common Metadata Fields and Data Elements. The answer feedback fields are described in the following table.

75

Chapter 5: Question Specification

Element itemfeedback element

Description

The itemfeedback element is an optional element that defines answer feedback that appears to Students when they view the graded question. It has the following attribute: •
ident (required). Must be set to wct_mc_answer_fbx (where x is number of the answer combination). (The

index is zero-based, thus the first answer combination is 0, the second answer combination is 1, and so forth.) •
view (optional. Default=All). Defines to whom the

material can be presented.
mattext element in material in the itemfeedback element

The mattext element contains the answer feedback that appears when Students view the graded question. It has the following attributes: •
xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • •
default preserve

label (required). Must be set to wct_mc_answer_fbx (where x is the number of the answer combination). (The

index is zero-based, thus the first answer combination is 0, the second answer combination is 1, and so forth.) •
texttype (optional. Default=TEXT/PLAIN). Specifies

whether the answer feedback is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the answer feedback is formatted in

HTML
TEXT/PLAIN: the answer feedback is formatted in

plain text
charset (optional. Default=US-ASCII). The character

set that is to be used to represent the text string.

XML Example of a Combination Question
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Breeds of Cat Combination Question" ident="WCT:ASM0:3543172000: 28225:D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <!-- The wct_questiontype field must be set to "WCT_Combination". -->

76

Chapter 5: Question Specification

<qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_Combination</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Combination Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This field appears only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A good question for the mid-term.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element below contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">Which of the following are breeds of cat?</mattext> <matbreak /> <!-- The matimage element contains the image that appears in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/cat.gif" /> <matbreak /> </material> <material> <!-- Each mattext element below contains an answer. The label attribute must be set to "wct_cmc_single_answerx" (where "x" is the number of the answer). --> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">A. </mattext> <mattext xml:space="preserve" label="wct_cmc_single_answer0" texttype="TEXT/HTML" charset="US-ASCII">Shorthair</mattext> <matbreak /> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">B. </mattext> <mattext xml:space="preserve" label="wct_cmc_single_answer1" texttype="TEXT/HTML" charset="US-ASCII">Longhair</mattext> <matbreak /> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">C. </mattext> <mattext xml:space="preserve" label="wct_cmc_single_answer2" texttype="TEXT/HTML" charset="US-ASCII">Persian</mattext> <matbreak /> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">D. </mattext> <mattext xml:space="preserve" label="wct_cmc_single_answer3" texttype="TEXT/HTML" charset="US-ASCII">Hershey</mattext> <matbreak /> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">E. </mattext> <mattext xml:space="preserve" label="wct_cmc_single_answer4" texttype="TEXT/HTML" charset="US-ASCII">Siamese</mattext> <matbreak /> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">F. </mattext> <mattext xml:space="preserve" label="wct_cmc_single_answer5" texttype="TEXT/HTML" charset="US-ASCII">Malamute</mattext> <matbreak /> </material> <response_lid ident="RESP_MC" rcardinality="Single"> <render_choice shuffle="No">

77

Chapter 5: Question Specification

<flow_label class="Row"> <!-- Each response_label element specifies an answer combination. The label attribute of the mattext element must be set to "wct_mc_answer_textx_y" (where "x" is the number of the answer combination and "y" is the position of the single answer in the answer combination). --> <response_label ident="MC0" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text0_1" texttype= "TEXT/PLAIN" charset="US-ASCII">A</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text0_2" texttype= "TEXT/PLAIN" charset="US-ASCII">B</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text0_3" texttype= "TEXT/PLAIN" charset="US-ASCII">C</mattext> <matbreak /> </material> </response_label> <response_label ident="MC1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text1_1" texttype= "TEXT/PLAIN" charset="US-ASCII">B</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text1_2" texttype= "TEXT/PLAIN" charset="US-ASCII">D</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text1_3" texttype= "TEXT/PLAIN" charset="US-ASCII">E</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text1_4" texttype= "TEXT/PLAIN" charset="US-ASCII">F</mattext> <matbreak /> </material> </response_label> <response_label ident="MC2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text2_1" texttype= "TEXT/PLAIN" charset="US-ASCII">A</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text2_2" texttype= "TEXT/PLAIN" charset="US-ASCII">B</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text2_3" texttype= "TEXT/PLAIN" charset="US-ASCII">C</mattext> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">, </mattext> <mattext xml:space="preserve" label="wct_mc_answer_text2_4" texttype= "TEXT/PLAIN" charset="US-ASCII">E</mattext> <matbreak /> </material> </response_label> <response_label ident="MC3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text3" texttype= "TEXT/HTML" charset="US-ASCII"> All of the above</mattext> <matbreak /> </material> </response_label> <response_label ident="MC4" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text4" texttype= "TEXT/HTML" charset="US-ASCII"> None of the above</mattext> <matbreak /> </material> </response_label> </flow_label> </render_choice>

78

Chapter 5: Question Specification

</response_lid> </flow> </presentation> <resprocessing scoremodel="AllorNothing"> <outcomes> <decvar vartype="Decimal" varname="SCORE" minvalue="0.0" defaultval="0.0" /> <decvar vartype="Decimal" varname="answerValue" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC0</varequal> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> <setvar varname="answerValue" action="Add">0.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb0" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC1</varequal> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> <setvar varname="answerValue" action="Add">0.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb1" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC2</varequal> </conditionvar> <setvar varname="SCORE" action="Add">100.0</setvar> <setvar varname="answerValue" action="Add">100.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb2" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC3</varequal> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> <setvar varname="answerValue" action="Add">0.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb3" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC4</varequal> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> <setvar varname="answerValue" action="Add">0.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb4" /> </respcondition> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> <respcondition continue="Yes" title="allOrNothing"> <conditionvar> <other /> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> </respcondition> </resprocessing> <!-- The itemfeedback element below contains the content that appears in the "General Feedback" field. This field appears when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">There are 30 to 40 different breeds of cat.</mattext> </material> </flow_mat> </itemfeedback>

79

Chapter 5: Question Specification

<!-- The itemfeedback elements below contain the content that appears in the answer "Feedback" fields. Answer feedback appears when Students view the graded question. The ident attribute of the itemfeedback and mattext elements must be set to "wct_mc_answer_fbx" (where "x" is the number of the answer combination). --> <itemfeedback ident="wct_mc_answer_fb0" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb0" texttype="TEXT/HTML" charset="US-ASCII">Siamese is also a breed of cat.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb1" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb1" texttype="TEXT/HTML" charset="US-ASCII">Hershey and Malamute are not breeds of cat.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb2" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb2" texttype="TEXT/HTML" charset="US-ASCII">Yes, these are all breeds of cat.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb3" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">All of the above: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb3" texttype="TEXT/HTML" charset="US-ASCII">Hershey and Malamute are not breeds of cat.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb4" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">None of the above: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb4" texttype="TEXT/HTML" charset="US-ASCII">Shorthair, Longhair, Persian, and Siamese are all breeds of cat. </mattext> </material> </itemfeedback> </item> </questestinterop>

Creating Fill in the Blank Questions
The following diagram shows the extensions to the standard item element for fill in the blank questions. XML bindings for the extensions to the presentation and resprocessing elements are described in the section XML Binding for Item Elements.

80

Chapter 5: Question Specification

81

Chapter 5: Question Specification

Best Practices for Creating a Fill in the Blank Question QTI XML File
This section describes the best practices for creating the five main sections in a fill in the blank question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define fill in the blank questions:
Metadata Field qmd_questiontype Description

This field is exported but is not required for import. It indicates the type of question (for standard IMS QTI question types). This field specifies the answer for answer x. This field is exported but should not be used for import. (The structure of fill in the blank questions is derived from the structure of short answer questions. The wct_sa_caseSensitive field was inherited from short answer questions.) When creating fill in the blank questions, the wct_fib_caseSensitive field specifies whether the answers are case sensitive. This field contains the question text. Each blank must be represented by a set of square brackets ([]) containing the correct answer. This field specifies in which text box answer x (where x is the number of the answer) is allowed to be entered. The following XML example specifies that answer 1 must be entered in the first answer text box. (The index is zero-based, thus the first answer text box is 0, the second answer text box is 1, and so forth.)
<qtimetadatafield> <fieldlabel>wct_allowedInBox1</fieldlabel> <fieldentry>0</fieldentry> </qtimetadatfield>

wct_answer_textx wct_sa_caseSensitive

wct_fib_questionText

wct_allowedInBoxx

82

Chapter 5: Question Specification

Metadata Field wct_sa_answerBoxNumber

Description

This field is exported but should not be used for import. The structure of fill in the blank questions is derived from the structure of short answer questions. The wct_sa_answerBoxNumber field was inherited from short answer questions. When creating fill in the blank questions, you cannot specify the number of answer boxes to show to Students. This field specifies the width, in characters, of the answer text box(es). The field must be set to one of the following values: 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, or 100. In Vista 4.2 and CE 6.2, this field corresponds to the question setting Answer box width.

wct_fib_answerBoxWidth

wct_comparison_typex

This field specifies the grading scheme of answer x (where x is the number of the answer). The field can be set to one of the following: • •
CONTAINS: for the answer to be graded as correct, it must contain the word or phrase that is specified for answer x EQUALS: for the answer to be graded as correct, it must be

the same as the word or phrase that is specified for answer
x

REGULAR_EXPRESSION: for the answer to be graded as

correct, it must match the regular expression specified for answer x In Vista 4.1 and CE 6.1, this field corresponds to the Grading scheme of the answer.
wct_authorWebctGlid

This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen.

wct_questioncategory

wct_usedbyassessment

83

Chapter 5: Question Specification

Metadata Field wct_fib_caseSensitive

Description

This field specifies whether the answers are case sensitive. The field can be set to one of the following: • •
Yes: the answers are case sensitive No: the answers are not case sensitive

In Vista 4.2 and CE 6.2, this field corresponds to the question setting Answers are case sensitive.
wct_valuex

This field specifies the percent value that answer x is worth towards the total point value of the question. In Vista 4.2 and CE 6.2, this field corresponds to the answer Value (%). IMPORTANT: The sum of the value of all wct_valuex fields must be 100 percent (100.0).

wct_questiontype

This field indicates the type of question. This field must be set to WCT_FillInTheBlank. This field is exported but is not required for import. This field specifies the first and last name of the author of the question.

wct_authorFullName

Creating the Objectives Section
Fill in the blank questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
Fill in the blank questions use the mattext, material_webeq, and matimage elements to define question text, equations, and images respectively. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Resprocessing Section
Fill in the blank questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, fill in the blank questions use the IMS QTI specification's var_extension element to define answers that are graded with a regular expression.

84

Chapter 5: Question Specification

Element varregex element in the conditionvar element

Description

The varregex element is used when an answer is graded with a regular expression. It has the following attributes: • •
xmlns:webct The namespace. Must be set to http://www.webct.com/vista/assessment respident (required). Must be set to FIBxx (where xx

is the number of the text box in which the answer must be entered) •
case (required). Specifies whether the answer is case

sensitive. Possible values are: • •
Yes: the answer is case sensitive No: the answers is not case sensitive

Creating the Itemfeedback Section
Fill in the blank questions use the IMS QTI specification's itemfeedback element to define the General Feedback field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

XML Example of a Fill in the Blank Question
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Jack and Jill Fill in the Blank Question" ident="WCT:ASM0:3200353000: 28225:D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_answer_text1</fieldlabel> <fieldentry>Jill</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_fib_questionText</fieldlabel> <fieldentry>Jack and [Jill] went up the hill to fetch a pail of [water].</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox1</fieldlabel> <fieldentry>0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_fib_answerBoxWidth</fieldlabel> <fieldentry>15</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type2</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Fill in the Blank Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_fib_caseSensitive</fieldlabel> <fieldentry>Yes</fieldentry>

85

Chapter 5: Question Specification

</qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value3</fieldlabel> <fieldentry>50.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type3</fieldlabel> <fieldentry>REGULAR_EXPRESSION</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox2</fieldlabel> <fieldentry>1</fieldentry> </qtimetadatafield> <!-- The wct_questiontype field must be set to "WCT_FillInTheBlank". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_FillInTheBlank</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type1</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox3</fieldlabel> <fieldentry>1</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text2</fieldlabel> <fieldentry>water</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value2</fieldlabel> <fieldentry>50.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text3</fieldlabel> <fieldentry>H2O</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value1</fieldlabel> <fieldentry>50.0</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text appears only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A question for the children's literature quiz.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element below defines the question text. The label attribute must be set to "wct_fib_questionTextType".--> <mattext xml:space="preserve" label="wct_fib_questionTextType" texttype="TEXT/HTML" charset="US-ASCII">Jack and </mattext> </material> <response_str ident="FIB01" rtiming="No" rcardinality="Single"> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="15" maxchars="15" maxnumber="1" minnumber="1"> <response_label ident="A1" rshuffle="No" /> </render_fib> </response_str> <material> <mattext xml:space="preserve" label="wct_fib_questionTextType" texttype="TEXT/HTML" charset="US-ASCII"> went up the hill to fetch a pail of </mattext>

86

Chapter 5: Question Specification

</material> <response_str ident="FIB02" rtiming="No" rcardinality="Single"> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="15" maxchars="15" maxnumber="1" minnumber="1"> <response_label ident="A2" rshuffle="No" /> </render_fib> </response_str> <material> <mattext xml:space="preserve" label="wct_fib_questionTextType" texttype="TEXT/HTML" charset="US-ASCII">.</mattext> </material> <material> <matbreak /> <!-- The matimage element contains the image that appears in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/jack_and_jill.bmp" /> <matbreak /> </material> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" defaultval="0.0" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <varequal respident="FIB01" case="Yes">Jill</varequal> </conditionvar> <setvar varname="SCORE" action="Add">50.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="FIB02" case="Yes">water</varequal> </conditionvar> <setvar varname="SCORE" action="Add">50.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <!-- The varregex element specifies that the answer is graded with a regular expression. --> <var_extension> <webct:varregex xmlns:webct="http://www.webct.com/vista/assessment" respident= "FIB02" case="Yes">H2O</webct:varregex> </var_extension> </conditionvar> <setvar varname="SCORE" action="Add">50.0</setvar> </respcondition> </resprocessing> <!-- The itemfeedback section below contains the content that appears in the "General Feedback" field. This field appears when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">The Jack and Jill nursery rhyme is said to originate in France.</mattext> </material>

87

Chapter 5: Question Specification

</flow_mat> </itemfeedback> </item> </questestinterop>

Creating Jumbled Sentence Questions
The following diagram shows the extensions to the standard item element for jumbled sentence questions. XML bindings for the extensions to the presentation element are described in the section XML Binding for Item Elements.

88

Chapter 5: Question Specification

Best Practices for Creating a Jumbled Sentence Question QTI XML File
89

Chapter 5: Question Specification

This section describes the best practices for creating the five main sections in a jumbled sentence question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define jumbled sentence questions:
Metadata Field wct_questiontype Description

This field indicates the type of question. This field must be set to WCT_JumbledSentence. This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen. This field is exported but is not required for import. This field specifies the first and last name of the author of the question.

wct_authorWebctGlid

wct_questioncategory

wct_usedbyassessment

wct_authorFullName

Creating the Objectives Section
Jumbled sentence questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
Jumbled sentence questions use the mattext, material_webeq, and matimage elements to define question text, equations, and images respectively. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, jumbled sentence questions use the following elements to define the question's text:
Element ims_render_object element in render_extension in the response_lid element Description

The ims_render_object elements is used to render the question and answer(s).

90

Chapter 5: Question Specification

Creating the Resprocessing Section
Jumbled sentence questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Itemfeedback Section
Jumbled sentence questions use the IMS QTI specification's itemfeedback element to define the General Feedback field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

XML Example of a Jumbled Sentence Question
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Jumbled Sentence Question" ident="WCT:ASM0:3200354000:28225: D527CDFD71201819E034080020C3CFDC"> <itemmetadata> </qtimetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <!-- The wct_questiontype field must be set to "WCT_JumbledSentence". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_JumbledSentence</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Jumbled Sentence Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text appears only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A good question for the French 101 mid-term.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII"></mattext> </material> <!-- The response_lid element specifies the presentation of the answer choices. --> <response_lid ident="JUMBLED01" rcardinality="Ordered"> <render_extension>

91

Chapter 5: Question Specification

<!-- The ims_render_object element is used to render the question and answer. --> <ims_render_object xmlns="" shuffle="No" orientation="row"> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII">Translate the following sentence into French: I love to work with WebCT. J'</mattext> </material> <response_label xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" ident="JA01" rshuffle="No"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII"> travailler</mattext> </material> </response_label> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII"> </mattext> </material> <response_label xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" ident="JA02" rshuffle="No"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">WebCT </mattext> </material> </response_label> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII"> </mattext> </material> <response_label xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" ident="JA03" rshuffle="No"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">avec </mattext> </material> </response_label> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII"> </mattext> </material> <response_label xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" ident="JA04" rshuffle="No"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">aime </mattext> </material> </response_label> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII">. </mattext> </material> </ims_render_object> </render_extension> </response_lid> <material> <matbreak /> <!-- The matimage element contains the image that appears in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/translation.bmp" /> <matbreak /> </material> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition>

92

Chapter 5: Question Specification

</resprocessing> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" minvalue="0.0" maxvalue="100.0" cutValue= "100.0" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <and> <varequal respident="JUMBLED01" case="Yes" index="1">JA04</varequal> <varequal respident="JUMBLED01" case="Yes" index="2">JA01</varequal> <varequal respident="JUMBLED01" case="Yes" index="3">JA03</varequal> <varequal respident="JUMBLED01" case="Yes" index="4">JA02</varequal> </and> </conditionvar> <setvar varname="SCORE" action="Add">100.0</setvar> </respcondition> </resprocessing> <!-- The itemfeedback section below contains the content that appears in the "General Feedback" field. This field appears when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1".--> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">The stem of the word aimer is aim-. Once we know the stem, we can attach the correct person ending. We know that the third person singular ending for a verb ending in -er is -e. So, if we attach -e to the stem aim-, we get the form aime.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

Creating Matching Questions
The following diagram shows the extensions to the standard item element for matching questions. XML bindings for the extensions to the presentation element are described in the section XML Binding for Item Elements.

93

Chapter 5: Question Specification

Best Practices for Creating a Matching Question QTI XML File

94

Chapter 5: Question Specification

This section describes the best practices for creating the five main sections in a matching question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define matching questions:
Metadata Field wct_m_statement_short_format Description

This field specifies the format of the items to be matched. The items to be matched appear in the first column in the question. The field can be set to one of the following: • •
Yes: the items to be matched (the words or phrases) appear

in the question
No: numbers corresponding to the items to be matched in

the question NOTE: If this field is set to No, the material_table element must be included in the presentation section of the XML file. For more information, see Creating the Presentation Section.

wct_questiontype

This field indicates the type of question. This field must be set to WCT_Matching. This field specifies the format of the answer choices in the question. The answer choices in the second column in the question. The field can be set to one of the following: • •
Yes: answer choices (the words or phrases) in drop-down

wct_m_match_short_format

lists in the question
No: letters corresponding to the answers in drop-down lists

in the question NOTE: If this field is set to No, the material_table element must be included in the presentation section of the XML file. For more information, see Creating the Presentation Section.

wct_authorWebctGlid

This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. 95

wct_questioncategory

Chapter 5: Question Specification

Metadata Field wct_usedbyassessment

Description

This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen. This field is exported but is not required for import. This field specifies the first and last name of the author of the question. This field specifies the question's grading scheme. The field can be set to one of the following: •
ALL_OR_NOTHING: Students receive the total point value

wct_authorFullName

wct_m_grading_scheme

of the question only when they correctly match all items in the question •
EQUALLY_WEIGHTED: Students receive an equal portion of

the total point value of the question for each item that they match correctly. •
RIGHT_MINUS_WRONG: each correctly matched item is

worth an equal portion of the total point value of the question but the point value of all incorrect matches is subtracted from the point value of all correct matches In Vista 4.2 and CE 6.2, this field corresponds to the question setting Grading scheme.

Creating the Objectives Section
Matching questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
In the presentation section, matching questions use the mattext, material_webeq, and matimage elements to specify question text, equations, and images respectively. These fields are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, matching questions use the IMS QTI specification's material extension (mat_extension) feature to define a preview in the question that s both the items to be matched and all of the answers.

96

Chapter 5: Question Specification

Element material_table

Description

This is an optional element that specifies, as a preview, the items to match in one column and all of the answer choices , in random order, in another column. These two columns appear below the question text. NOTE: If the metadata fields
wct_m_statement_short_format and/or wct_m_match_short_format are set to No, the material_table element must be

included in the presentation section of the XML file. In Vista 4.2 and CE 6.2, this field corresponds to the question setting Column preview.

97

Chapter 5: Question Specification

Element matching_ext_flow

Description

This element is used to define one of the columns that s as a preview in the question. The element has the following attributes: • •
xmlns:webct The WebCT namespace. Must be set to http://www.webct.com/vista/assessment. rshuffle: specifies whether the items in the preview

column are shuffled on consecutive s to the user F IMPORTANT: or the first preview column, which contains the terms to be matched, the value must be set to No. For the second preview column, which contains the answer choices, the value must be set to Yes. • •
rhidden: Must be set to No. labelType: Specifies whether the items in the preview

column are labelled with letters, numbers, or are not labelled. Possible values are: • • •
Letters Numbers None

IMPORTANT: •

If the metadata field
wct_m_statement_short_format is set to No and the metadata field wct_m_match_short_format is set to Yes, for the first column, this value must be set to Numbers. For the

second column, this value must be set to None. • If the metadata field
wct_m_statement_short_format is set to No and the metadata field wct_m_match_short_format is set to No, for the first column, this value must be set to Numbers. For the

second column, this value must be set to Letters. • If the metadata field
wct_m_statement_short_format is set to Yes and the metadata field wct_m_match_short_format is set to No, for the first column, this value

98

Chapter 5: Question Specification

Element

Description

must be set to None. For the second column, this value must be set to Letters. • If the metadata field
wct_m_statement_short_format is set to Yes and the metadata field wct_m_match_short_format is set to Yes, for the first column, this value must be set to None. For the second

column, this value must be set to None.
matching_text_ext

In a matching question, this element specifies one of the items that will appear in the preview column. It has the following attributes: • •
label rshuffle: specifies whether the item is shuffled on

consecutive s to the user IMPORTANT: For items in the first preview column, the value must be set to No. If you don't want one of the items in the second preview column to shuffle on consecutive s to the users, set the value to No.

Creating the Resprocessing Section
Matching questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Itemfeedback Section
Matching questions use the IMS QTI specification's itemfeedback element to define the General Feedback field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

XML Example of a Matching Question
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Capital Cities of Europe Matching Question" ident="WCT:ASM0:2903597000:28225: D527CDFD71201819E034080020C3CFDC"> <itemmetadata> </qtimetadata>

99

Chapter 5: Question Specification

<qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_m_statement_short_format</fieldlabel> <fieldentry>Yes</fieldentry> </qtimetadatafield> <!-- The wct_questiontype field must be set to "WCT_Matching". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_Matching</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_m_match_short_format</fieldlabel> <fieldentry>Yes</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Matching Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_m_grading_scheme</fieldlabel> <fieldentry>EQUALLY_WEIGHTED</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A good question for the Geography mid-term.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">Match the following capital cities with their countries: </mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/europe.bmp" /> <matbreak /> </material> <material label="previewColumns"> <!-- The material_table element specifies that, as a preview, the items to match in one column and all of the answer choices , in random order, in another column. These columns appear below the question text. --> <mat_extension> <material_table label="tableLabel"> <webct:matching_ext_flow xmlns:webct="http://www.webct.com/vista/assessment" rshuffle="No" rhidden="No" webct:labelType="None"> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement1" texttype="TEXT/HTML" charset="US-ASCII">Dublin</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="No">

100

Chapter 5: Question Specification

<mattext xml:space="preserve" label="Statement2" texttype="TEXT/HTML" charset="US-ASCII">Lisbon</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement3" texttype="TEXT/HTML" charset="US-ASCII">Brussels</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement4" texttype="TEXT/HTML" charset="US-ASCII">Bern</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement5" texttype="TEXT/HTML" charset="US-ASCII">Copenhagen</mattext> </webct:matching_text_ext> </webct:matching_ext_flow> <webct:matching_ext_flow xmlns:webct="http://www.webct.com/vista/assessment" rshuffle="Yes" rhidden="No" webct:labelType="None"> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match1" texttype="TEXT/HTML" charset="US-ASCII">Republic of Ireland</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match2" texttype="TEXT/HTML" charset="US-ASCII">Portugal</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match3" texttype="TEXT/HTML" charset="US-ASCII">Belgium</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match4" texttype="TEXT/HTML" charset="US-ASCII">Switzerland</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match5" texttype="TEXT/HTML" charset="US-ASCII">Denmark</mattext> </webct:matching_text_ext> </webct:matching_ext_flow> </material_table> </mat_extension> </material> <flow class="Row"> <response_grp ident="STAT1" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" label="Statement1" texttype="TEXT/HTML" charset="US-ASCII">Dublin</mattext> </material> <render_choice shuffle="Yes"> <flow_label class="Pulldown"> <response_label ident="MATCH1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match1" texttype="TEXT/HTML" charset="US-ASCII">Republic of Ireland</mattext> </material> </response_label> <response_label ident="NO_MATCH1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match2" texttype="TEXT/HTML" charset="US-ASCII">Portugal</mattext> </material> </response_label> <response_label ident="NO_MATCH2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match3" texttype="TEXT/HTML" charset="US-ASCII">Belgium</mattext> </material> </response_label> <response_label ident="NO_MATCH3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match4" texttype="TEXT/HTML" charset="US-ASCII">Switzerland</mattext> </material> </response_label> <response_label ident="NO_MATCH4" rshuffle="Yes"> <material>

101

Chapter 5: Question Specification

<mattext xml:space="preserve" label="Match5" texttype="TEXT/HTML" charset="US-ASCII">Denmark</mattext> </material> </response_label> </flow_label> </render_choice> <material> <matbreak /> </material> </response_grp> <response_grp ident="STAT2" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" label="Statement2" texttype="TEXT/HTML" charset="US-ASCII">Lisbon</mattext> </material> <render_choice shuffle="Yes"> <flow_label class="Pulldown"> <response_label ident="NO_MATCH1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match1" texttype="TEXT/HTML" charset="US-ASCII">Republic of Ireland</mattext> </material> </response_label> <response_label ident="MATCH2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match2" texttype="TEXT/HTML" charset="US-ASCII">Portugal</mattext> </material> </response_label> <response_label ident="NO_MATCH2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match3" texttype="TEXT/HTML" charset="US-ASCII">Belgium</mattext> </material> </response_label> <response_label ident="NO_MATCH3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match4" texttype="TEXT/HTML" charset="US-ASCII">Switzerland</mattext> </material> </response_label> <response_label ident="NO_MATCH4" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match5" texttype="TEXT/HTML" charset="US-ASCII">Denmark</mattext> </material> </response_label> </flow_label> </render_choice> <material> <matbreak /> </material> </response_grp> <response_grp ident="STAT3" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" label="Statement3" texttype="TEXT/HTML" charset="US-ASCII">Brussels</mattext> </material> <render_choice shuffle="Yes"> <flow_label class="Pulldown"> <response_label ident="NO_MATCH1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match1" texttype="TEXT/HTML" charset="US-ASCII">Republic of Ireland</mattext> </material> </response_label> <response_label ident="NO_MATCH2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match2" texttype="TEXT/HTML" charset="US-ASCII">Portugal</mattext> </material> </response_label> <response_label ident="MATCH3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match3" texttype="TEXT/HTML" charset="US-ASCII">Belgium</mattext>

102

Chapter 5: Question Specification

</material> </response_label> <response_label ident="NO_MATCH3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match4" texttype="TEXT/HTML" charset="US-ASCII">Switzerland</mattext> </material> </response_label> <response_label ident="NO_MATCH4" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match5" texttype="TEXT/HTML" charset="US-ASCII">Denmark</mattext> </material> </response_label> </flow_label> </render_choice> <material> <matbreak /> </material> </response_grp> <response_grp ident="STAT4" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" label="Statement4" texttype="TEXT/HTML" charset="US-ASCII">Bern</mattext> </material> <render_choice shuffle="Yes"> <flow_label class="Pulldown"> <response_label ident="NO_MATCH1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match1" texttype="TEXT/HTML" charset="US-ASCII">Republic of Ireland</mattext> </material> </response_label> <response_label ident="NO_MATCH2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match2" texttype="TEXT/HTML" charset="US-ASCII">Portugal</mattext> </material> </response_label> <response_label ident="NO_MATCH3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match3" texttype="TEXT/HTML" charset="US-ASCII">Belgium</mattext> </material> </response_label> <response_label ident="MATCH4" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match4" texttype="TEXT/HTML" charset="US-ASCII">Switzerland</mattext> </material> </response_label> <response_label ident="NO_MATCH4" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match5" texttype="TEXT/HTML" charset="US-ASCII">Denmark</mattext> </material> </response_label> </flow_label> </render_choice> <material> <matbreak /> </material> </response_grp> <response_grp ident="STAT5" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" label="Statement5" texttype="TEXT/HTML" charset="US-ASCII">Copenhagen</mattext> </material> <render_choice shuffle="Yes"> <flow_label class="Pulldown"> <response_label ident="NO_MATCH1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match1" texttype="TEXT/HTML" charset="US-ASCII">Republic of Ireland</mattext> </material> </response_label>

103

Chapter 5: Question Specification

<response_label ident="NO_MATCH2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match2" texttype="TEXT/HTML" charset="US-ASCII">Portugal</mattext> </material> </response_label> <response_label ident="NO_MATCH3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match3" texttype="TEXT/HTML" charset="US-ASCII">Belgium</mattext> </material> </response_label> <response_label ident="NO_MATCH4" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match4" texttype="TEXT/HTML" charset="US-ASCII">Switzerland</mattext> </material> </response_label> <response_label ident="MATCH5" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="Match5" texttype="TEXT/HTML" charset="US-ASCII">Denmark</mattext> </material> </response_label> </flow_label> </render_choice> <material> <matbreak /> </material> </response_grp> </flow> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" defaultval="0.0" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <varequal respident="STAT1" case="Yes">MATCH1</varequal> </conditionvar> <setvar varname="SCORE" action="Add">20.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="STAT2" case="Yes">MATCH2</varequal> </conditionvar> <setvar varname="SCORE" action="Add">20.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="STAT3" case="Yes">MATCH3</varequal> </conditionvar> <setvar varname="SCORE" action="Add">20.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="STAT4" case="Yes">MATCH4</varequal> </conditionvar> <setvar varname="SCORE" action="Add">20.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="STAT5" case="Yes">MATCH5</varequal> </conditionvar>

104

Chapter 5: Question Specification

<setvar varname="SCORE" action="Add">20.0</setvar> </respcondition> </resprocessing> <!-- The itemfeedback section below contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">There are 44 countries in Europe.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

Creating Multiple Choice Questions
The following diagram shows the extension to the standard item element for multiple choice questions. XML bindings for the extension to the presentation element are described in the section XML Binding for Item Elements.

105

Chapter 5: Question Specification

Best Practices for Creating a Multiple Choice Question QTI XML File
This section describes the best practices for creating the five main sections in a multiple choice question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback. 106

Chapter 5: Question Specification

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define multiple choice questions:
Metadata Field qmd_questiontype Description

This field is exported but is not required for import. It indicates the type of question (for standard IMS QTI question types). This field indicates the type of question. This field must be set to WCT_MultipleChoice. This field specifies whether the answers appear vertically or horizontally. The field can be set to one of the following: • •
false: the answers appear vertically true: the answers appear horizontally

wct_questiontype

layoutHorizontal

In Vista 4.1 and CE 6.1, this field corresponds to the question setting Answer layout.
wct_question_labelledletter

This field specifies whether each answer is labelled with a letter or a number. The field can be set to one of the following: • •
Yes: each answer is labelled with a letter No: each answer is labelled with a number

In Vista 4.2 and CE 6.2, this field corresponds to the question setting Answer labels.
wct_authorWebctGlid

This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen. This field is exported but is not required for import. This field specifies the first and last name of the author of the question.

wct_questioncategory

wct_usedbyassessment

wct_authorFullName

107

Chapter 5: Question Specification

Creating the Objectives Section
Multiple choice questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
Multiple choice questions use the mattext, material_webeq, and matimage elements to specify question text, equations, and images respectively. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, the following elements are used:
Element response_lid element Description

The rcardinality attribute of the response_lid element specifies how many correct answers the question has. Possible values are: • •
Single: one answer Multiple: multiple answers

In Vista 4.2 and CE 6.2, this field corresponds to the answer Select mode.
render_choice element in the response_lid element

The shuffle attribute of the render_choice element specifies whether the answers in a random order. Possible values are: • •
Yes: each time the question appears in an assessment, the

answers in a random order
No: answers in the order in which they are entered

In Vista 4.2 and CE 6.2, this field corresponds to the question setting Randomize answer ordering.
flow_label element in render_choice in the response_lid element

The class attribute of the flow_label element specifies the layout of the answers in the question. Possible values are: • •
Column: answers vertically, in a column Row: answers horizontally, in a row

In Vista 4.2 and CE 6.2, this field corresponds to the question setting Answer layout.

108

Chapter 5: Question Specification

Element mattext element in material in the response_label element

Description

Each mattext element contains an answer. The element has the following attributes: •
xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • •
default preserve

label: must be set to wct_mc_answer_textx (where x

is the number of the answer). (The index is zero-based, thus the first answer is 0, the second answer is 1, and so forth.) •
texttype: (optional. Default=TEXT/PLAIN). Specifies

whether the answer is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the answer is formatted in HTML TEXT/PLAIN: the answer is formatted in plain text

charset (optional. Default=US-ASCII). The character

set that is to be used to represent the text string.

Creating the Resprocessing Section
Multiple choice questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, multiple choice questions use the following element:

109

Chapter 5: Question Specification

Element resprocessing element

Description

The scoremodel attribute of the resprocessing element specifies the grading scheme of the question. Possible values are: •
AllorNothing: for a question with several correct

answers, for Students to receive the total value of the question, they must select all of the correct answers. otherwise they will receive zero percent for the question •
SumofScores: each correct answer counts for a portion

of the total value of the question NOTE: If the question has only one correct answer, set the value to SumofScores.

In Vista 4.2 and CE 6.2, this field corresponds to the question setting Grading scheme.

Creating the Itemfeedback Section
Multiple choice questions use the IMS QTI specification's itemfeedback element to define the General Feedback field and the answer feedback fields. The General Feedback field is common to all question types. For more information, see Common Metadata Fields and Data Elements. The answer feedback fields are described in the following table.
Element itemfeedback element Description

The itemfeedback element is an optional element that defines answer feedback that s to Students when they view the graded question. It has the following attribute: •
ident (required). Must be set to wct_mc_answer_fbx (where x is number of the answer). (The index is zero-based, thus the first answer is 0, the second answer is 1, and so forth.)

110

Chapter 5: Question Specification

Element mattext element in material in the itemfeedback element

Description

The mattext element contains the answer feedback that s when Students view the graded question. It has the following attributes: •
xml:space (optional). Defines whether or not the

whitespace is to be preserved. Possible values are: • • •
default preserve

label (required). Must be set to wct_mc_answer_fbx (where x is the number of the answer. (The index is zero-based, thus the first answer is 0, the second answer is 1, and so forth.) textype (optional. Default=TEXT/PLAIN). Specifies

whether the answer feedback is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the answer feedback is formatted in

HTML
TEXT/PLAIN: the answer feedback is formatted in

plain text
charset (optional. Default=US-ASCII). The character

set that is to be used to represent the text string.

XML Example of a Multiple Choice Question with One Correct Answer
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Star Wars Multiple Choice Question with One Correct Answer" ident= "WCT:ASM0:3200391000:28225:D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <!-- The wct_questiontype field must be set to "WCT_MultipleChoice". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_MultipleChoice</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_question_labelledletter</fieldlabel> <fieldentry>Yes</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Multiple Choice Questions</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". -->

111

Chapter 5: Question Specification

<objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A good question for the film history exam.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">Which of the following movies is NOT part of the Star Wars series?</mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/star_wars.bmp" /> <matbreak /> </material> <!-- For multiple choice questions with one correct answer, the rcardinality attribute of the response_lid element must be set to "Single". The shuffle attribute of the render_choice element specifies whether answers in a random order. The class attribute of the flow_label element specifies the layout of the answers. --> <response_lid ident="RESP_MC" rcardinality="Single"> <render_choice shuffle="Yes"> <flow_label class="Row"> <response_label ident="MC0" rshuffle="Yes"> <material> <!-- Each mattext element in a response_label element contains an answer. The label attribute must be set to "wct_mc_answer_textx" (where "x" is the number of the answer). --> <mattext xml:space="preserve" label="wct_mc_answer_text0" charset="US-ASCII">The Empire Strikes Back</mattext> <matbreak /> </material> </response_label> <response_label ident="MC1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text1" charset="US-ASCII">The Phantom Menace</mattext> <matbreak /> </material> </response_label> <response_label ident="MC2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text2" charset="US-ASCII">Return of the Jedi</mattext> <matbreak /> </material> </response_label> <response_label ident="MC3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text3" charset="US-ASCII">Shakespeare in Love</mattext> <matbreak /> </material> </response_label> </flow_label> </render_choice> </response_lid> </flow> </presentation> texttype="TEXT/HTML"

texttype="TEXT/HTML"

texttype="TEXT/HTML"

texttype="TEXT/HTML"

<!-- The scoremodel attribute of the resprocessing element specifies the grading scheme of the question. For multiple choice questions with one correct answer, the value must be set to "SumofScores". -->

112

Chapter 5: Question Specification

<resprocessing scoremodel="SumofScores"> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC0</varequal> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb0" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC1</varequal> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb1" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC2</varequal> </conditionvar> <setvar varname="SCORE" action="Add">0.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb2" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC3</varequal> </conditionvar> <setvar varname="SCORE" action="Add">100.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb3" /> </respcondition> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <!-- The itemfeedback element below contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">The Star Wars series includes the following movies: Star Wars, The Empire Strikes Back, Return of the Jedi, The Phantom Menace, and Attack of the Clones.</mattext> </material> </flow_mat> </itemfeedback> <!-- The itemfeedback elements below contain the content that appears in the answer "Feedback" fields. Answer feedback s when Students view the graded question. The ident attribute of the itemfeedback and mattext elements must be set to "wct_mc_answer_fbx" (where "x" is the number of the answer). --> <itemfeedback ident="wct_mc_answer_fb0" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">The Empire Strikes Back: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb0" texttype="TEXT/HTML" charset="US-ASCII">Incorrect. This Star Wars movie was released in 1980.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb1" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">The Phantom Menace: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb1" texttype="TEXT/HTML" charset="US-ASCII">Incorrect. This Star Wars movie was released in 1999.</mattext>

113

Chapter 5: Question Specification

</material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb2" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">Return of the Jedi: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb2" texttype="TEXT/HTML" charset="US-ASCII">Incorrect. This Star Wars movie was released in 1983.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb3" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">Shakespeare in Love: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb3" texttype="TEXT/HTML" charset="US-ASCII">Correct. This movie is not part of the Star Wars series. It was directed by John Madden and stars Joseph Fiennes and Gwyneth Paltrow.</mattext> </material> </itemfeedback> </item> </questestinterop>

XML Example of a Multiple Choice Question with Several Correct Answers
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Star Wars Multiple Choice Question with Several Correct Answers" ident="WCT: ASM0:3200356000:28225:D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <!-- The wct_questiontype field must be set to "WCT_MultipleChoice". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_MultipleChoice</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_question_labelledletter</fieldlabel> <fieldentry>Yes</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Multiple Choice Questions</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A good question for the Film History exam.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">Which of the following movies are part of the Star Wars series? </mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute

114

Chapter 5: Question Specification

must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/star_wars.bmp" /> <matbreak /> </material> <!-- For multiple choice questions with several correct answers, the rcardinality attribute of the response_lid element must be set to "Multiple". The shuffle attribute of the render_choice element specifies whether answers in a random order. The class attribute of the flow_label element specifies the layout of the answers. --> <response_lid ident="RESP_MC" rcardinality="Multiple"> <render_choice shuffle="Yes"> <flow_label class="Row"> <response_label ident="MC0" rshuffle="Yes"> <material> <!-- Each mattext element in a response_label element contains an answer. The label attribute must be set to "wct_mc_answer_textx" (where "x" is the number of the answer). --> <mattext xml:space="preserve" label="wct_mc_answer_text0" charset="US-ASCII">The Empire Strikes Back</mattext> <matbreak /> </material> </response_label> <response_label ident="MC1" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text1" charset="US-ASCII">The Phantom Menace</mattext> <matbreak /> </material> </response_label> <response_label ident="MC2" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text2" charset="US-ASCII">Return of the Jedi</mattext> <matbreak /> </material> </response_label> <response_label ident="MC3" rshuffle="Yes"> <material> <mattext xml:space="preserve" label="wct_mc_answer_text3" charset="US-ASCII">Shakespeare in Love</mattext> <matbreak /> </material> </response_label> </flow_label> </render_choice> </response_lid> </flow> </presentation> texttype="TEXT/HTML"

texttype="TEXT/HTML"

texttype="TEXT/HTML"

texttype="TEXT/HTML"

<!-- The scoremodel attribute of the resprocessing element specifies the grading scheme of the question. --> <resprocessing scoremodel="SumofScores"> <outcomes> <decvar vartype="Decimal" varname="SCORE" minvalue="0.0" defaultval="0.0" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC0</varequal> </conditionvar> <setvar varname="SCORE" action="Add">33.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb0" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC1</varequal> </conditionvar> <setvar varname="SCORE" action="Add">33.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb1" /> </respcondition> <respcondition continue="Yes"> <conditionvar>

115

Chapter 5: Question Specification

<varequal respident="RESP_MC" case="Yes">MC2</varequal> </conditionvar> <setvar varname="SCORE" action="Add">34.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb2" /> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="RESP_MC" case="Yes">MC3</varequal> </conditionvar> <setvar varname="SCORE" action="Subtract">100.0</setvar> <feedback feedbacktype="Response" linkrefid="wct_mc_answer_fb3" /> </respcondition> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <!-- The itemfeedback element below contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">The Star Wars series includes the following movies: Star Wars, The Empire Strikes Back, Return of the Jedi, Than Phantom Menace, and Attack of the Clones.</mattext> </material> </flow_mat> </itemfeedback> <!-- The itemfeedback elements below contain the content that appears in the answer "Feedback" fields. Answer feedback s when Students view the graded question. The ident attribute of the itemfeedback and mattext elements must be set to "wct_mc_answer_fbx" (where "x" is the number of the answer). --> <itemfeedback ident="wct_mc_answer_fb0" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">The Empire Strikes Back: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb0" texttype="TEXT/HTML" charset= "US-ASCII">Correct. This Star Wars movie was released in 1980.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb1" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">The Phantom Menace: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb1" texttype="TEXT/HTML" charset="US-ASCII">Correct. This Star Wars movie was released in 1999.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb2" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">Return of the Jedi: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb2" texttype="TEXT/HTML" charset="US-ASCII">Correct. This Star Wars movie was released in 1983.</mattext> </material> </itemfeedback> <itemfeedback ident="wct_mc_answer_fb3" view="All"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">Shakespeare in Love: </mattext> <mattext xml:space="preserve" label="wct_mc_answer_fb3" texttype="TEXT/HTML" charset= "US-ASCII">Incorrect. This movie is not one of the Star Wars movies.</mattext> </material> </itemfeedback> </item> </questestinterop>

116

Chapter 5: Question Specification

Creating Paragraph Questions
The following diagram shows the extension to the standard item element for paragraph questions. XML bindings for the extension to the presentation element are described in the section XML Binding for Item Elements.

117

Chapter 5: Question Specification

Best Practices for Creating a Paragraph Question QTI XML File
This section describes the best practices for creating the five main sections in a paragraph question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In addition to the metadata fields that are common to all question types, the following metadata fields are used to define paragraph questions:
Metadata Field qmd_questiontype Description

This field is exported but is not required for import. It indicates the type of question (for standard IMS QTI question types). This field indicates the type of question. This field must be set to WCT_Paragraph. This field specifies the height, in lines, of the answer text box. This field can be set to one of the following values: 2, 3, 4, 5, 10, 15, 20, 25, 30, 35, 40, 45, or 50. In Vista 4.2 and CE 6.2, this field corresponds to the question setting Answer box height.

wct_questiontype

answerBoxHeight

answerBoxWidth

This field specifies the width, in characters, of the answer text box. This field can be set to one of the following values: 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, or 100. In Vista 4.1 and CE 6.1, this field corresponds to the question setting Answer box width.

wct_authorWebctGlid

This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen.

wct_questioncategory

wct_usedbyassessment

118

Chapter 5: Question Specification

Metadata Field wct_authorFullName

Description

This field is exported but is not required for import. This field specifies the first and last name of the author of the question.

Creating the Objectives Section
Paragraph questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
Paragraph questions use the mattext, material_webeq, and matimage elements to specify question text, equations, and images respectively. These fields are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, the following elements are used:
Element response_label Description

The response_label element specifies the content that pre-fills the answer text box. The mattext element contains the content that pre-fills the answer text box. It has the following attributes: •
xml:space (optional). Defines whether or not the

mattext element in material in the response_label element

whitespace is to be preserved. Possible values are: • • • •
default preserve

label (required). Must be set to CORRECT_ANSWER. texttype (optional. Default=TEXT/PLAIN). Specifies

whether the content that pre-fills the answer text box is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the content that pre-fills the answer text

box is formatted in HTML
TEXT/PLAIN: the content that pre-fills the answer

text box is formatted in plain text
charset (optional. Default=US-ASCII). The character

set that is to be used to represent the text string.

Creating the Resprocessing Section

119

Chapter 5: Question Specification

Paragraph questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Itemfeedback Section
Paragraph questions use the IMS QTI specification's itemfeedback element to define the General Feedback and Correct Answer fields. The General Feedback field is common to all question types. For more information, see Common Metadata Fields and Data Elements. The Correct Answer field is described in the following table.
Element itemfeedback Description

The itemfeedback element specifies the correct answer that s to Students after they have submitted their answer. The element has the following attribute: •
ident (required). Must be set to CORRECT_ANSWER.

mattext element in material in solutionmaterial in the solution

The mattext element contains the correct answer. The element has the following attributes: •
xml:space (optional). Defines whether or not the

element

whitespace is to be preserved. Possible values are: • • • •
default preserve

label (required). Must be set to CORRECT_ANSWER. texttype (optional. Default=TEXT/PLAIN). Specifies

whether the correct answer is formatted in plain text or HTML. Possible values are: • • •
TEXT/HTML: the correct answer is formatted in

HTML
TEXT/PLAIN: the correct answer is formatted in plain

text
charset (optional. Default=US-ASCII). The character

set that is to be used to represent the text string.

XML Example of a Paragraph Question
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Comedy Versus Tragedy Paragraph Question" ident="WCT:ASM0:2001736000: 28225:D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" />

120

Chapter 5: Question Specification

<!-- The wct_questiontype field must be set to "WCT_Paragraph". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_Paragraph</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>answerBoxHeight</fieldlabel> <fieldentry>5</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>answerBoxWidth</fieldlabel> <fieldentry>60</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Paragraph Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">This is a good question for the mid-term.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">Explain the difference between these two genres: comedy and tragedy. </mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/comedytragedy.bmp" /> <matbreak /> </material> <response_str ident="PARA" rcardinality="Single"> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="5" columns="60" maxchars="99999999" maxnumber="1" minnumber="1"> <!-- The response_label section contains the content that pre-fills the answer text box. The label attribute of the mattext element must be set to "PRE_FILL_ANSWER". --> <response_label ident="PARA" rshuffle="No"> <material> <mattext xml:space="preserve" label="PRE_FILL_ANSWER" texttype="TEXT/HTML" charset="US-ASCII">You should have at least three points of difference in your answer.</mattext> </material> </response_label> </render_fib> </response_str> </flow> </presentation> <resprocessing> <outcomes>

121

Chapter 5: Question Specification

<decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <!-- The itemfeedback element below contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">In essence, tragedy is the mirror image of comedy.</mattext> </material> </flow_mat> </itemfeedback> <!-- The itemfeedback element below contains the content that appears in the "Correct Answer" field. This field s when Students view the graded question. The ident attribute of the itemfeedback and mattext elements must be set to "CORRECT_ANSWER". --> <itemfeedback ident="CORRECT_ANSWER" view="All"> <solution feedbackstyle="Complete"> <solutionmaterial> <material> <mattext xml:space="preserve" label="CORRECT_ANSWER" texttype="TEXT/HTML" charset="US-ASCII">A comedy is a story of the rise in fortune of a sympathetic central figure. Comedy has to do with the concerns of ordinary people. There are three sub-genres in comedy: farce, romantic comedy, and satirical comedy. A tragedy shows the downfall of a once, essentially good, powerful, and prominent hero. Tragedy depicts the downfall of a good person through some misjudgement that produces suffering on the part of the protagonist and arouses pity and fear from the audience.</mattext> </material> </solutionmaterial> </solution> </itemfeedback> </item> </questestinterop>

Creating Short Answer Questions
The following diagram shows the extensions to the standard item element for short answer questions. XML bindings for the extensions to the presentation and resprocessing elements are described in the section XML Binding for Item Elements.

122

Chapter 5: Question Specification

123

Chapter 5: Question Specification

Best Practices for Creating a Short Answer Question QTI XML File
This section describes the best practices for creating the five main sections in a short answer question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define short answer questions:
Metadata Field qmd_questiontype Description

This field is exported but is not required for import. It indicates the type of question (for standard IMS QTI question types). This field indicates whether the answer is case sensitive. The field can be set to one of the following: • •
Yes: the answer is case sensitive No: the answer is not case sensitive

wct_sa_caseSensitive

In Vista 4.2 and CE 6.2, this field corresponds to the answer setting Answers are case sensitive.
wct_answer_textx wct_sa_answerBoxNumber

This field specifies the answer for answer text box x. This field specifies the number of answer text boxes to . This field must be set to one of the following values: 1, 2, 3, 4, or 5. In Vista 4.1 and CE 6.1, this field corresponds to the question setting Number of answer boxes shown to the Student.

124

Chapter 5: Question Specification

Metadata Field wct_allowedInBoxx

Description

This field specifies in which answer text box answer x is allowed to be entered (where x is the number of the answer). The following XML example specifies that answer 2 must be entered in the first answer text box.
<qtimetadatafield> <fieldlabel>wct_allowedInBox2</fieldlabel> <fieldentry>1</fieldentry> </qtimetadatfield>

If the answer can be entered in any of the answer text boxes, the value is set to 0. The following XML example specifies that answer 2 can be entered in any of the answer text boxes.
<qtimetadatafield> <fieldlabel>wct_allowedInBox2</fieldlabel> <fieldentry>0</fieldentry> </qtimetadatfield>

In Vista 4.2 and CE 6.2, this field corresponds to the answer setting Allow in answer box.
wct_questiontype

This field indicates the type of question. This field must be set to WCT_ShortAnswer. This field specifies the grading scheme of answer x (where x is the number of the answer). The field can be set to one of the following: •
CONTAINS: for an answer to be graded as correct, it must contain the word or phrase that is specified for answer x (the word or phrase specified in the wct_answer_textx

wct_comparison_typex

field) •
EQUALS: for an answer to be graded as correct, it must be

the same as the word or phrase that is specified for answer x (the word or phrase specified in the wct_answer_textx field) •
REGULAR_EXPRESSION: for an answer to be graded as

correct, it must match the regular expression specified for answer x (the regular expression specified in the wct_answer_textx field) In Vista 4.2 and CE 6.2, this field corresponds to the answer setting Grading scheme.

125

Chapter 5: Question Specification

Metadata Field wct_sa_answerBoxWidth

Description

This field specifies the width, in characters, of the answer text box(es). This field must be set to one of the following values: 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, or 100. In Vista 4.1 and CE 6.1, this field corresponds to the answer setting Answer box width.

wct_authorWebctGlid

This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen. This field is exported but is not required for import. This field specifies the first and last name of the author of the question. This field specifies the percent value that answer x is worth towards the total point value of the question. The sum of the value of all wct_valuex fields must be 100 percent (100.0).

wct_questioncategory

wct_usedbyassessment

wct_authorFullName

wct_valuex

Creating the Objectives Section
Short answer questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
Short answer questions use the mattext, material_webeq, and matimage elements to specify question text, equations, and images respectively. These fields are common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Resprocessing Section
Short answer questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, paragraph questions use the following element:

126

Chapter 5: Question Specification

Element varregex element in the conditionvar element

Description

The varregex element is used when an answer is graded with a regular expression. It has the following attributes: • •
xmlns:webct The namespace. Must be set to http://www.webct.com/vista/assessment. respident (required). Must be set to SAxx (where xx is

the number of the answer text box in which the answer must be entered). •
case (required). Specifies whether the answer is case

sensitive. Possible values are: • •
Yes: the answer is case sensitive No: the answer is not case sensitive

Creating the Itemfeedback Section
Short answer questions use the IMS QTI specification's itemfeedback element to define the General Feedback field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

XML Example of a Short Answer Question with One Correct Answer
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Astronomy Short Answer Question" ident="WCT:ASM0:3200444000: 28225:D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_sa_caseSensitive</fieldlabel> <fieldentry>No</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text1</fieldlabel> <fieldentry>150,000,000</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_sa_answerBoxNumber</fieldlabel> <fieldentry>1</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox1</fieldlabel> <fieldentry>1</fieldentry> </qtimetadatafield> <!-- The wct_questiontype field must be set to "WCT_ShortAnswer". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_ShortAnswer</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type1</fieldlabel> <fieldentry>REGULAR_EXPRESSION</fieldentry> </qtimetadatafield>

127

Chapter 5: Question Specification

<qtimetadatafield> <fieldlabel>wct_sa_answerBoxWidth</fieldlabel> <fieldentry>50</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Short Answer Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value1</fieldlabel> <fieldentry>100.0</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A question for the Astronomy exam.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">To the nearest 10,000,000 km, what is the distance in km from the earth to the sun?</mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/earth_sun_distance.bmp" /> <matbreak /> </material> <response_str ident="SA01" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">1. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="50" maxchars="50" maxnumber="1" minnumber="1"> <response_label ident="A1" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <resprocessing>

128

Chapter 5: Question Specification

<outcomes> <decvar vartype="Decimal" varname="SCORE" defaultval="0.0" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <!-- The varregex element specifies that the answer is graded with a regular expression. --> <var_extension> <webct:varregex xmlns:webct="http://www.webct.com/vista/assessment" respident= "SA01" case="No">150,000,000</webct:varregex> </var_extension> </conditionvar> <setvar varname="SCORE" action="Add">100.0</setvar> </respcondition> </resprocessing> <!-- The itemfeedback section contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">The distance between the earth and the sun is about 92 million miles. A change of about 500 or 1,000 miles would not cause any appreciable change in the temperature on earth.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

XML Example of a Short Answer Question with Several Correct Answers in Any Order
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Astronomy Short Answer Question" ident="WCT:ASM0:3200395000: 28225:D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_answer_text4</fieldlabel> <fieldentry>Venus</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_sa_caseSensitive</fieldlabel> <fieldentry>Yes</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text1</fieldlabel> <fieldentry>Mercury</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_sa_answerBoxNumber</fieldlabel> <fieldentry>4</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox1</fieldlabel> <fieldentry>0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type2</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel>

129

Chapter 5: Question Specification

<fieldentry>Short Answer Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value4</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value3</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type3</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox2</fieldlabel> <fieldentry>0</fieldentry> </qtimetadatafield> <!-- The wct_questiontype field must be set to "WCT_ShortAnswer". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_ShortAnswer</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type1</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox3</fieldlabel> <fieldentry>0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text2</fieldlabel> <fieldentry>Earth</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_sa_answerBoxWidth</fieldlabel> <fieldentry>30</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type4</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value2</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text3</fieldlabel> <fieldentry>Mars</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value1</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox4</fieldlabel> <fieldentry>0</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">An easy question for the Astronomy exam.</mattext>

130

Chapter 5: Question Specification

</material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">Name the four inner planets. Answers can be entered in any order. </mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/inner_planets.bmp" /> <matbreak /> </material> <response_str ident="SA01" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">1. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A1" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> <response_str ident="SA02" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">2. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A2" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> <response_str ident="SA03" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">3. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A3" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> <response_str ident="SA04" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">4. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A4" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib>

131

Chapter 5: Question Specification

</response_str> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar> <other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" defaultval="0.0" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mercury</varequal> <varequal respident="SA02" case="Yes">Mercury</varequal> <varequal respident="SA03" case="Yes">Mercury</varequal> <varequal respident="SA04" case="Yes">Mercury</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mercury</varequal> <varequal respident="SA02" case="Yes">Mercury</varequal> <varequal respident="SA03" case="Yes">Mercury</varequal> <varequal respident="SA04" case="Yes">Mercury</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mercury</varequal> <varequal respident="SA02" case="Yes">Mercury</varequal> <varequal respident="SA03" case="Yes">Mercury</varequal> <varequal respident="SA04" case="Yes">Mercury</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mercury</varequal> <varequal respident="SA02" case="Yes">Mercury</varequal> <varequal respident="SA03" case="Yes">Mercury</varequal> <varequal respident="SA04" case="Yes">Mercury</varequal> </or> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <or> <varequal respident="SA01" case="Yes">Earth</varequal> <varequal respident="SA02" case="Yes">Earth</varequal> <varequal respident="SA03" case="Yes">Earth</varequal> <varequal respident="SA04" case="Yes">Earth</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Earth</varequal> <varequal respident="SA02" case="Yes">Earth</varequal> <varequal respident="SA03" case="Yes">Earth</varequal> <varequal respident="SA04" case="Yes">Earth</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Earth</varequal> <varequal respident="SA02" case="Yes">Earth</varequal> <varequal respident="SA03" case="Yes">Earth</varequal> <varequal respident="SA04" case="Yes">Earth</varequal>

132

Chapter 5: Question Specification

</or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Earth</varequal> <varequal respident="SA02" case="Yes">Earth</varequal> <varequal respident="SA03" case="Yes">Earth</varequal> <varequal respident="SA04" case="Yes">Earth</varequal> </or> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mars</varequal> <varequal respident="SA02" case="Yes">Mars</varequal> <varequal respident="SA03" case="Yes">Mars</varequal> <varequal respident="SA04" case="Yes">Mars</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mars</varequal> <varequal respident="SA02" case="Yes">Mars</varequal> <varequal respident="SA03" case="Yes">Mars</varequal> <varequal respident="SA04" case="Yes">Mars</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mars</varequal> <varequal respident="SA02" case="Yes">Mars</varequal> <varequal respident="SA03" case="Yes">Mars</varequal> <varequal respident="SA04" case="Yes">Mars</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Mars</varequal> <varequal respident="SA02" case="Yes">Mars</varequal> <varequal respident="SA03" case="Yes">Mars</varequal> <varequal respident="SA04" case="Yes">Mars</varequal> </or> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <or> <varequal respident="SA01" case="Yes">Venus</varequal> <varequal respident="SA02" case="Yes">Venus</varequal> <varequal respident="SA03" case="Yes">Venus</varequal> <varequal respident="SA04" case="Yes">Venus</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Venus</varequal> <varequal respident="SA02" case="Yes">Venus</varequal> <varequal respident="SA03" case="Yes">Venus</varequal> <varequal respident="SA04" case="Yes">Venus</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Venus</varequal> <varequal respident="SA02" case="Yes">Venus</varequal> <varequal respident="SA03" case="Yes">Venus</varequal> <varequal respident="SA04" case="Yes">Venus</varequal> </or> </conditionvar> <conditionvar> <or> <varequal respident="SA01" case="Yes">Venus</varequal> <varequal respident="SA02" case="Yes">Venus</varequal>

133

Chapter 5: Question Specification

<varequal respident="SA03" case="Yes">Venus</varequal> <varequal respident="SA04" case="Yes">Venus</varequal> </or> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> </resprocessing> <!-- The itemfeedback section contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">There are nine planets in our solar system. The four inner planets are Mercury, Venus, Earth, and Mars.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

XML Example of a Short Answer Question with Several Correct Answers in a Specific Order
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Astronomy Short Answer Question" ident="WCT:ASM0:3200394000:28225: D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_answer_text4</fieldlabel> <fieldentry>Mars</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_sa_caseSensitive</fieldlabel> <fieldentry>No</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text1</fieldlabel> <fieldentry>Mercury</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_sa_answerBoxNumber</fieldlabel> <fieldentry>4</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox1</fieldlabel> <fieldentry>1</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type2</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>Short Answer Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value4</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield>

134

Chapter 5: Question Specification

<qtimetadatafield> <fieldlabel>wct_value3</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type3</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox2</fieldlabel> <fieldentry>2</fieldentry> </qtimetadatafield> <!-- The wct_questiontype field must be set to "WCT_ShortAnswer". --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_ShortAnswer</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type1</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox3</fieldlabel> <fieldentry>3</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text2</fieldlabel> <fieldentry>Venus</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_sa_answerBoxWidth</fieldlabel> <fieldentry>30</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_comparison_type4</fieldlabel> <fieldentry>EQUALS</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value2</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_answer_text3</fieldlabel> <fieldentry>Earth</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_value1</fieldlabel> <fieldentry>25.0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_allowedInBox4</fieldlabel> <fieldentry>4</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A question for the Astronomy exam.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML"

135

Chapter 5: Question Specification

charset="US-ASCII">Name the four inner planets. Beginning with the closest, answers must be entered in their order from the sun. Only correct answers in the correct order will receive marks.</mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/inner_planets.bmp" /> <matbreak /> </material> <response_str ident="SA01" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">1. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A1" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> <response_str ident="SA02" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">2. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A2" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> <response_str ident="SA03" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">3. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A3" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> <response_str ident="SA04" rtiming="No" rcardinality="Single"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">4. </mattext> </material> <render_fib charset="US-ASCII" encoding="UTF-8" fibtype="String" prompt="Box" rows="1" columns="30" maxchars="30" maxnumber="1" minnumber="1"> <response_label ident="A4" rshuffle="No"> <material> <matbreak /> </material> </response_label> </render_fib> </response_str> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar>

136

Chapter 5: Question Specification

<other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" defaultval="0.0" /> </outcomes> <respcondition continue="Yes"> <conditionvar> <varequal respident="SA01" case="No">Mercury</varequal> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="SA02" case="No">Venus</varequal> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="SA03" case="No">Earth</varequal> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> <respcondition continue="Yes"> <conditionvar> <varequal respident="SA04" case="No">Mars</varequal> </conditionvar> <setvar varname="SCORE" action="Add">25.0</setvar> </respcondition> </resprocessing> <!-- The itemfeedback section contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">The nine planets that orbit the sun are (in order from the sun): Mercury, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Neptune, and Pluto.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

Creating True False Questions
The following diagram shows the extensions to the standard item element for true false questions. XML bindings for the extensions to the presentation element are described in the section XML Binding for Item Elements.

137

Chapter 5: Question Specification

138

Chapter 5: Question Specification

Best Practices for Creating a True False Question QTI XML File
This section describes the best practices for creating the five main sections in a true false question QTI XML file: Itemmetadata, Objectives, Presentation, Resprocessing, and Itemfeedback.

Creating the Itemmetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define true false questions:
Metadata Field qmd_questiontype Description

This field is exported but is not required for import. It indicates the type of question (for standard IMS QTI question types). This field indicates the type of question. This field must be set to WCT_TrueFalse. This field is exported but is not required for import. This field contains a unique identifier for the author of the question. This is an optional field that indicates the category to which the question belongs. The question is placed in the category specified. If a category is not specified, the question is placed in the category Uncategorized Questions. This field is exported but should not be used for import. The field indicates the assessments that use the question. This field corresponds to the Used By field on the Question Database screen. This field is exported but is not required for import. This field specifies the first and last name of the author of the question. This field specifies the answer to the question. This field can be set to one of the following: • •
true false

wct_questiontype

wct_authorWebctGlid

wct_questioncategory

wct_usedbyassessment

wct_authorFullName

answerStr

In Vista 4.2 and CE 6.2, this field corresponds to the question setting Correct response.

Creating the Objectives Section
139

Chapter 5: Question Specification

True false questions use the IMS QTI specification's objectives element to define the Section Designer notes field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Presentation Section
True false questions use the mattext, material_webeq, and matimage elements to specify question text, equations, and images respectively. These fields are common to all question types. For more information, see Common Metadata Fields and Data Elements. In addition, the following element is used:
Element localizable_mattext Description

The localizable_mattext element is used to specify that the word, which s as one of the answer choices, is rendered according to the locale setting. For true false questions, the element can contain one of the following words: • •
true false

Creating the Resprocessing Section
True false questions use the IMS QTI specification's decvar and setvar elements to define scoring for the question. These elements are common to all question types. For more information, see Common Metadata Fields and Data Elements.

Creating the Itemfeedback Section
True false questions use the IMS QTI specification's itemfeedback element to define the General Feedback field. This field is common to all question types. For more information, see Common Metadata Fields and Data Elements.

XML Example of a True False Question
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <item title="Ungulate Family True False Question" ident="WCT:ASM0:3001967000:28225: D527CDFD71201819E034080020C3CFDC"> <itemmetadata> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <!-- The wct_questiontype field must be set to WCT_TrueFalse. --> <qtimetadatafield> <fieldlabel>wct_questiontype</fieldlabel> <fieldentry>WCT_TrueFalse</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_questioncategory</fieldlabel> <fieldentry>True False Questions</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_usedbyassessment</fieldlabel>

140

Chapter 5: Question Specification

<fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>answerStr</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> </qtimetadata> </itemmetadata> <!-- The objectives section contains the content that appears in the "Section Designer notes" field. This text s only to the designer of the question. The label attribute of the mattext element must be set to "wct_designer_notes_label_1". --> <objectives view="Author"> <material> <mattext xml:space="preserve" label="wct_designer_notes_label_1" texttype="TEXT/PLAIN" charset="US-ASCII">A question for the zoology exam.</mattext> </material> </objectives> <presentation> <flow> <material> <!-- The mattext element contains the question text. The label attribute must be set to "wct_question_label_1". --> <mattext xml:space="preserve" label="wct_question_label_1" texttype="TEXT/HTML" charset="US-ASCII">True or false: The bear is a member of the ungulate family. </mattext> <matbreak /> <!-- The matimage element contains the image that s in the question. The label attribute must be set to "wct_image_label_1". The uri attribute specifies the path of the image from the root of the template/Section Content folder. --> <matimage label="wct_image_label_1" uri="/images/bear.bmp" /> <matbreak /> </material> <response_lid ident="TF01" rcardinality="Single"> <render_choice shuffle="Yes"> <flow_label class="Block"> <response_label ident="true" rshuffle="No"> <material> <!-- The localizable_mattext elements below specify that the words "True" and "False", which as the answer choices, will be localized according to the locale setting --> <mat_extension> <webct:localizable_mattext xmlns:webct="http://www.webct.com/vista/ assessment" xml:space="preserve" texttype="TEXT/PLAIN" charset= "US-ASCII">true</webct:localizable_mattext> </mat_extension> </material> </response_label> </flow_label> <flow_label class="Block"> <response_label ident="false" rshuffle="No"> <material> <mat_extension> <webct:localizable_mattext xmlns:webct="http://www.webct.com/vista/ assessment" xml:space="preserve" texttype="TEXT/PLAIN" charset= "US-ASCII">false</webct:localizable_mattext> </mat_extension> </material> </response_label> </flow_label> </render_choice> </response_lid> </flow> </presentation> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="Yes" title="genFeedback"> <conditionvar>

141

Chapter 5: Question Specification

<other /> </conditionvar> <feedback feedbacktype="Response" linkrefid="wct_general_feedback_ref_1" /> </respcondition> </resprocessing> <resprocessing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <respcondition continue="No"> <conditionvar> <varequal respident="TF01" case="Yes">false</varequal> </conditionvar> <setvar varname="SCORE" action="Set">100</setvar> </respcondition> </resprocessing> <!-- The itemfeedback section contains the content that appears in the "General Feedback" field. This field s when Students view the graded question. The ident attribute must be set to "wct_general_feedback_ref_1". The label attribute of the mattext element must be set to "wct_general_feedback_1". --> <itemfeedback ident="wct_general_feedback_ref_1" view="All"> <flow_mat class=" "> <material> <mattext xml:space="preserve" label="wct_general_feedback_1" texttype="TEXT/HTML" charset="US-ASCII">Ungulates are creatures which have hooves. The word "ungula" is Latin for hoof.</mattext> </material> </flow_mat> </itemfeedback> </item> </questestinterop>

XML BINDING
XML Binding for Manifest Elements
The following is a narrative description of the elements defined in the CIS 3.0 XML schema. The http://www.webct.com/xsd/cisv3 namespace for the CIS 3.0 XML schema is located in cisv3.xsd. This file is included in the zip file of each content package exported from Vista 4.2 and CE 6.2 and is available on the Content Interoperability Specification download page. To go to the Content Interoperability Specification download page, do the following: 1. Go to Behind the blackboard (http://www.blackboard.com/support). 2. Open the reference center. 3. Under Developer Documentation, click Content Interoperability Specification Version 3.0 for WebCT CE 6.1 and WebCT Vista 4.1.

ContentObject Element

142

Chapter 5: Question Specification

Description

This element represents specific features of the learning object that are not defined by the IMS CP specification. http://www.webct.com/xsd/cisv3 Occurs once and only once within a manifest element. • • coType (required). Indicates the learning object type. Data type=string. For a question, the value of the coType attribute must be set to webct.question. isVisible (optional). Indicates whether or not the learning object is ed. If not present, the value is assumed to be true. Data type=boolean. <Name>
<webct:ContentObject webct:coType="webct.question"> <webct:Name>Multiple Choice Question 1</webct:Name> </webct:ContentObject>

Namespace Multiplicity Attributes

Elements Example

Name Element

Description Namespace Multiplicity Example

This element describes the name of the learning object. Data type=string. http://www.webct.com/xsd/cisv3 Occurs once and only once within a ContentObject element.
<webct:Name>Multiple Choice Question 1</webct:Name>

XML Binding for Item Elements
This section contains a narrative description of the CIS 3.0 Question XML schema. The http://www.webct.com/vista/assessment namespace for the CIS 3.0 Question XML schema is located in webct_qti.xsd. This file is included in the zip file of each content package exported from Vista 4.2 and CE 6.2 and is available for download on Behind the Blackboard.

calculated Element

143

Chapter 5: Question Specification

Description Namespace Multiplicity

This element contains the formula, var, and calculated_set elements. http://www.webct.com/vista/assessment Occurs once and only once within a mat_extension element in material in flow in the presentation element of a calculated question. • • xmlns:webct. The namespace (http://www.webct.com/vista/assessment). Data type=string. label (optional). Data type=string. <formula> <var> <calculated_set>
<webct:calculated xmlns:webct="http://www.webct.com/vista/assessment" label="calculated">

Attributes

Elements

• • •

Example

formula Element

Description

This element contains the formula used to calculate the answers in a calculated question. Variables must placed within square brackets ([]). Data type=string. http://www.webct.com/vista/assessment Occurs once and only once within a calculated element.
<webct:formula>[x] + [y]</webct:formula>

Namespace Multiplicity Example

var Element

Description

This element contains a variable declaration for one of the variables in the formula element. There must be one var element for each variable in the formula. http://www.webct.com/vista/assessment Occurs one or more times within a calculated element.

Namespace Multiplicity

144

Chapter 5: Question Specification

Attributes

• • • •

name (required). The variable name. Data type=string. min (required). The minimum value of the variable. Data type=double. max (required). The maximum value of the variable. Data type=double. precision (required). The number of the decimal places of the variable. Data type=integer.
<webct:var webct:name="y" webct:min="1.0" webct:max="10.0" webct:precision="0" />

Example

calculated_set Element

Description

This element contains the calculated_var and answer elements for a calculated answer. http://www.webct.com/vista/assessment Occurs one or more times within a calculated element. • index (required). The index of the calculated answer. (The index is zero-based, thus the first is 0, the second is 1, and so forth.) Data type=integer. <calculated_var> <answer>
<webct:calculated_set webct:index="0"> <webct:calculated_var webct:name="y" webct:value="9.0" /> <webct:calculated_var webct:name="x" webct:value="9.0" /> <webct:answer webct:value="18.0" /> </webct:calculated_set>

Namespace Multiplicity Attributes

Elements

• •

Example

calculated_var Element

Description Namespace Multiplicity

There must be one calculated_var element for each variable in the formula. http://www.webct.com/vista/assessment Occurs one or more times within a calculated_set element.

145

Chapter 5: Question Specification

Attributes

• •

name (required). The variable name. Data type=string. value (required). The value of the variable. Data type=double.
<webct:calculated_var webct:name="y" wect:value="9.0" />

Example

answer Element

Description Namespace Multiplicity Attributes

There must be one answer element in each calculated_set element. http://www.webct.com/vista/assessment Occurs once and only once within a calculated_set element. • value (required). The calculated answer based on the values in the calculated_var elements. Data type=double.
<webct:answer webct:value="14.0" />

Example

calculated_answer Element
Description Namespace Multiplicity This element specifies information about the question's answers. http://www.webct.com/vista/assessment Occurs once and only once within an itemproc_extension element in the resprocessing element of a calculated question.

146

Chapter 5: Question Specification

Attributes

• • •

respident (required). The value must match the ident attribute of the response_num element in the presentation element. Data type=string. precision (required). The number of decimal places or significant figures to which the answer sets are calculated. Data type=integer. precisionType (required). Specifies whether the answer sets are calculated in decimal places or significant figures. Data type=string. Values are: • •
Decimal: Decimal places. SigFig: Significant figures.

• •

tolerance (required). The answer tolerance value. Data type=double. toleranceType (required). Specifies whether the answer tolerance is calculated in units or as a percent. Data type=string. Values are: • •
Unit Percent

Elements

<setvar>: For more information, refer to the IMS QTI specification version 1.2 section 3.6.21 <setvar> Element.
<webct:calculated_answer xmlns:webct="http://www.webct.com/vista/assessment" respident="CALC" webct:precision="1" webct:precisionType="SigFig" webct:tolerance="10.0" webct:toleranceType="Percent"> <setvar varname="SCORE" action="Add">90.0</setvar> </webct:calculated_answer>

Example

ims_render_object Element
Description This element is used in a jumbled sentence question to render the question and answer(s). http://www.webct.com/vista/assessment Occurs once and only once within a render_extension element in response_lid in flow in the presentation element. • • shuffle (required). Indicates whether the list of possible responses can be shuffled between consecutive s to the user. The value must be set to No. orientation (required). Defines the orientation of the question and answers in a jumbled sentence question. Data type=string. The value must be set to row.

Namespace Multiplicity

Attributes

147

Chapter 5: Question Specification

Elements

• •

<material>: For more information, refer to the IMS QTI specification version 1.2 section 3.6.3 <material> Element. <response_label>: For more information, refer to the IMS QTI specification version 1.2 section 3.5.21 <response_label> Element.
<ims_render_object xmlns="" shuffle="No" orientation="row"> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII">The quick brown </mattext> </material> <response_label xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" ident="JA01" rshuffle="No"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">dog</mattext> </material> </response_label> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII"> jumps over the lazy </mattext> </material> <response_label xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" ident="JA02" rshuffle="No"> <material> <mattext xml:space="preserve" texttype="TEXT/PLAIN" charset="US-ASCII">fox</mattext> </material> </response_label> <material xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <mattext xml:space="preserve" texttype="TEXT/HTML" charset="US-ASCII">.</mattext> </material> </ims_render_object>

Example

localizable_mattext Element
Description This element is used to specify that the word used in the calculated or true false question is rendered according to the locale setting. Data type=string. Possible content: • For calculated questions: • • •
answer units

For true false questions: • •
false true

Namespace

http://www.webct.com/vista/assessment

148

Chapter 5: Question Specification

Multiplicity

For calculated questions: • • occurs once and only once within a mat_extension element in material in response_num in flow in the presentation element. occurs zero or once within a mat_extension element in material in response_str in flow in the presentation element.

For true false questions: • occurs once and only once within a mat_extension element in material in response_label in flow_label in the render_choice element. texttype (required). Specifies whether the word is formatted in plain text or HTML. Data type=string. Values are: • • • Example
TEXT/HTML: the question is formatted in HTML. TEXT/PLAIN: the question is formatted in plain text.

Attributes

charset (optional). The value must be set to US-ASCII. Data type=string.
<webct:localizable_mattext xmlns:webct= "http://www.webct.com/vista/assessment" xml:space="preserve" textype="TEXT/HTML" charset="US-ASCII">answer </webct:localizable_mattext>

material_table Element
Description This element specifies that, in a matching question, as a preview, the items to match will in one column and all of the answers will , in random order, in another column. These two columns appear below the question text. http://www.webct.com/vista/assessment Occurs zero or once within a mat_extension element in material in flow in the
presentation element.

Namespace Multiplicity

Attributes Elements

• •

label (optional). Data type=string. <matching_ext_flow>

149

Chapter 5: Question Specification

Example

<material_table label="tableLabel"> <webct:matching_ext_flow xmlns:webct="http://www.webct.com/ vista/assessment" rshuffle="No" rhidden="No" webct:labelType="None"> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement1" texttype="TEXT/HTML" charset="US-ASCII">Moscow</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement2" texttype="TEXT/HTML" charset="US-ASCII">Ottawa</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement3" texttype="TEXT/HTML" charset="US-ASCII">London</mattext> </webct:matching_text_ext> </webct:matching_ext_flow> <webct:matching_ext_flow xmlns:webct="http:// www.webct.com/vista/assessment" rshuffle="Yes" rhidden="No" webct:labelType="None"> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match1" texttype="TEXT/HTML" charset="US-ASCII">Russia</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match2" texttype="TEXT/HTML" charset="US-ASCII">Canada</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="Yes"> <mattext xml:space="preserve" label="Match3" texttype="TEXT/HTML" charset="US-ASCII">England</mattext> </webct:matching_text_ext> </webct:matching_ext_flow> </material_table>

matching_ext_flow Element

Description

In a matching question, this element is used to define one of the columns that will as a preview, below the question text. http://www.webct.com/vista/assessment Occurs twice within a material_table element.

Namespace Multiplicity

150

Chapter 5: Question Specification

Attributes

rshuffle (required). Specifies whether the items in the preview column are shuffled on consecutive s to the user. Values are: • •
Yes: The items in the preview column are shuffled on each consecutive to

the user.
No: The items in the preview column appear in the order in which they were

entered when the question was created. NOTE: For the first preview column, which contains the terms to be matched, the value must be set to No. For the second preview column, which contains the answers, the value must be set to Yes.

labelType (required). Specifies whether the items in the preview column are labelled with letters, numbers, or are not labelled. Possible values are: • • •
Letters Numbers None

IMPORTANT: •

If the metadata field wct_m_statement_short_format is set to No and the metadata field wct_m_match_short_format is set to Yes, for the first column, this value must be set to Numbers. For the second column, this value must be set to None. If the metadata field wct_m_statement_short_format is set to No and the metadata field wct_m_match_short_format is set to No, for the first column, this value must be set to Numbers. For the second column, this value must be set to Letters. If the metadata field wct_m_statement_short_format is set to Yes and the metadata field wct_m_match_short_format is set to No, for the first column, this value must be set to None. For the second column, this value must be set to Letters. If the metadata field wct_m_statement_short_format is set to Yes and the metadata field wct_m_match_short_format is set to Yes, for the first column, this value must be set to None. For the second column, this value must be set to None.

• Elements •

rhidden (required). Must be set to No. <matching_text_ext>

151

Chapter 5: Question Specification

Example

<webct:matching_ext_flow xmlns:webct="http://www.webct.com/ vista/assessment" rshuffle="No" rhidden="No" webct:labelType="None"> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement1" texttype="TEXT/HTML" charset="US-ASCII">Moscow</mattext> </webct:matching_text_ext> <webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement2" texttype="TEXT/HTML" charset="US-ASCII">Ottawa</mattext> </webct:matching_text_ext> </webct:matching_ext_flow>

matching_text_ext Element

Description Namespace Multiplicity Attributes

This element specifies one of the items that will appear in the preview column. http://www.webct.com/vista/assessment Occurs one or more times within a matching_ext_flow element. • • label (optional). Data type=string. rshuffle (required). specifies whether the item is shuffled on consecutive s to the user • •
Yes: The item is shuffled on each consecutive to the user. No: The item appears in the order in which it was entered when the question

was created. IMPORTANT: For items in the first preview column, the value must be set to No. If you don't want one of the items in the second preview column to shuffle on consecutive s to the users, set the value to No. Elements Example • <mattext>
<webct:matching_text_ext label="" rshuffle="No"> <mattext xml:space="preserve" label="Statement2" texttype="TEXT/HTML" charset="US-ASCII">Ottawa</mattext> </webct:matching_text_ext>

material_webeq Element
Description This element is used when there is an equation in the question text. Data type=string. 152

Chapter 5: Question Specification

Namespace Multiplicity

http://www.webct.com/vista/assessment Occurs once and only once within a mat_extension element in the material element. • • label (required). Data type=string. Must be set to "wct_calc_questionTextType". texttype (required). Specifies whether the question text is formatted in plain text or HTML. Data type=string. Values are: • •
TEXT/HTML: the question is formatted in HTML. TEXT/PLAIN: the question is formatted in plain text.

Attributes

Example

<webct:material_webeq xmlns:webct:"http://www.webct.com/ vista/assessment" label="wct_calc_questionTextType" texttype="TEXT/HTML">If a car is travelling</webct:material_webeq>

unit_eval Element
Description Namespace Multiplicity This element specifies the units for the answer value in a calculated question. http://www.webct.com/vista/assessment Occurs once and only once in the itemproc_extension element in the resprocessing element of a calculated question. • space (required). Specifies whether or not spaces count in the units part of the answer. Values are: • •
Yes: for spaces to count in the units part of the answer. No: to ignore spaces in the units part of the answer.

Attributes

For example, if the value is set to Yes, kilowatt hours is correct and kilowatthours is incorrect. Elements • • <conditionvar> <setvar>

153

Chapter 5: Question Specification

Example

<unit_eval xmlns:webct="http://www.webct.com/vista/assessment" webct:space="Yes"> <conditionvar xmlns=""> <varequal xmlns="http://www.imsglobal.org/xsd/ ims_qtiasiv1p2 respident="UNITS" case="No">miles</varequal> </conditionvar> <setvar varname="SCORE" action="Add">10.0</setvar> </unit_eval>

variable Element
Description This element is used to define the variable. It specifies where the variable s in the question text. http://www.webct.com/vista/assessment Occurs once and only once within a mat_extension element in material in flow in presentation of a calculated question. • • • label (optional). Data type=string. name (required). The name of the variable. Data type=string. precision (required). The number of decimal places of the variable. Data type=integer.
<webct:variable xmlns:webct="http://www.webct.com/vista/ assessment" webct:label="" webct:name="y" webct:precision="0" />

Namespace Multiplicity

Attributes

Example

varregex Element
Description This element is used in fill in the blank and short answer questions when the answer is graded with a regular expression. Data type=string. http://www.webct.com/vista/assessment Occurs once and only once in the var_extension element in conditionvar in respcondition in the resprocessing element.

Namespace Multiplicity

154

Chapter 5: Question Specification

Attributes

• •

xmlns:webct. The namespace. Must be set to
http://www.webct.com/vista/assessment

respident (required). For fill in the blank questions, must be set to FIBxx (where xx is the number of the text box in which the answer must be entered). For short answer question, must be set to SAxx (where xx is the number of the text box in which the answer must be entered) Data type=string. case (required). Specifies whether the answer is case sensitive. Data type=string. Possible values are: • •
Yes: the answer is case sensitive No: the answers is not case sensitive

Example

<webct:varregex xmlns:webct="http://www.webct.com/vista/ assessment" respident="FIB02" case="No">hill</webct:varregex>

155

Chapter 6: Assessment Specification

CHAPTER 6: ASSESSMENT SPECIFICATION
the Assessment specification provides the functionality to create and package an individual assessment or a collection of assessments into an interoperable, distributable package that can be transported between different learning contexts and installations. Vista 4.2 and CE 6.2 support the following assessment types: • • • quizzes surveys self tests

To package assessments, Blackboard implements the core elements of the IMS Content Packaging (CP) specification version 1.1.3 and uses the CIS 3.0 XML schema. Blackboard has added custom XML elements to provide some features that are not defined by the IMS CP specification. Chapter 1 of the Content Interoperability Specification (CIS) describes the basic structure of a IMS content package and the base extensions to the IMS Content Packaging (CP) schema. These extensions apply to all learning objects. For more information, see Chapter 1: The CIS. This section includes the following: • • • Assessment Manifest Elements: This section includes a diagram of the primary elements in an assessment manifest. Best Practices for Creating an Assessment Manifest: This section describes the best practices for creating the four main sections in an assessment manifest. Assessment Manifest Example: This section includes an example of an assessment manifest.

ASSESSMENT MANIFEST ELEMENTS
The following diagram shows the primary elements in an assessment manifest.

156

Chapter 6: Assessment Specification

BEST PRACTICES FOR CREATING AN ASSESSMENT MANIFEST
To create an assessment that can be transported between different learning contexts and installations, you must create a self-contained manifest for the assessment. This section describes the best practices for creating the four main sections in an assessment manifest: Metadata, Organizations, Resources, and ContentObject.

Creating the Metadata Section
Within the manifest's metadata element, you must specify the schema used by the manifest. Within the schema element, you must specify the value webct.cis. Within the schemaversion element, you must specify the value 3.0.0.
<metadata> <schema>webct.cis</schema>

157

Chapter 6: Assessment Specification

<schemaversion>3.0.0</schemaversion>

If you want to specify other schemas that are used by the manifest, use the SchemaMetaData element: NOTE: The SchemaMetaData element is an optional element. If the SchemaMetaData element is not used, the default schema versions and namespaces for the CIS 3.0 are used.

• •

To specify that the IMS CP schema is used, the Schema element must contain a name attribute with the value IMS Content and a version attribute with the value 1.1.3. To specify that the IMS Meta-data schema is used, the Schema element must contain a name attribute with the value IMS MetaData and a version attribute with the value 1.2.3.
<webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3"/> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3/> </webct:SchemaMetaData>

Creating the Organizations Section
An assessment manifest must contain an empty organizations section.

Creating the Resources Section
Within the resources element, the first resource element specifies the assessment's QTI XML file. This element must contain a type attribute with the value ims_qtiasiv1p2.
<resource identifier="197975" type="ims_qtiasiv1p2"> <file href="URN_X-WEBCT-VISTA-V0/197975.html" /> </resource>

The resource contains a link to a QTI XML file for the assessment. NOTE: For information on creating a QTI XML file for the assessment, see Best Practices for Creating Assessment QTI XML Files.

Within the resources element, there is also one resource element for each question in the assessment. Each of these resource elements contain a link to a self-contained manifest for the question. NOTE: For information on creating a manifest for each question, see Chapter 5: Question Specification.

The resource element for each question must contain a type attribute with the value webct.manifest and a coType attribute with the value webct.question.
<resource identifier="188825" type="webct.manifest" webct:coType="webct.question"

158

Chapter 6: Assessment Specification

xsi:type="webct:ResourceType> <file href="URN_X-WEBCT-VISTA-V0/188825.html" /> </resource>

Creating the ContentObject Section
At the end of the assessment manifest, you must include the ContentObject element. For the coType attribute, specify the value webct.assessment. Within the ContentObject element, the only element that must appear is the Name element.
<webct:ContentObject webct:coType="webct.assessment"> <webct:Name>World History Pop Quiz</webct:Name> </webct:ContentObject>

NOTE:

If a content package contains more than one top-level manifest (for example, two or more assessment manifests), the root manifest is a container manifest and must not contain the ContentObject element.

ASSESSMENT MANIFEST EXAMPLE
<?xml version="1.0" encoding="UTF-8"?> <manifest identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.197975" xmlns= "http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:imsmd="http://www.imsglobal.org/xsd/ imsmd_v1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:webct= "http://www.webct.com/xsd/cisv3"> <metadata> <schema>webct.cis</schema> <schemaversion>3.0.0</schemaversion> <webct:SchemaMetaData> <webct:Schema webct:name="IMS Content" webct:version="1.1.3"/> <webct:Schema webct:name="IMS MetaData" webct:version="1.2.3"/> </webct:SchemaMetaData> <imsmd:lom> <imsmd:general> <imsmd:title> <imsmd:langstring xml:lang="en-US">World History Self Test </imsmd:langstring> </imsmd:title> </imsmd:general> <imsmd:lifecycle> <imsmd:version> <imsmd:langstring xml:lang="x-none">1.0</imsmd:langstring> </imsmd:version> </imsmd:lifecycle> <imsmd:educational> <imsmd:learningresourcetype> <imsmd:source> <imsmd:langstring xml:lang="x-none">WebCT</imsmd:langstring> </imsmd:source> <imsmd:value> <imsmd:langstring xml:lang="x-none">webct.assessment</imsmd:langstring> </imsmd:value> </imsmd:learningresourcetype> </imsmd:educational> </imsmd:lom> </metadata>

159

Chapter 6: Assessment Specification

<organizations/> <resources> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.197975_R" type="ims_qtiasiv1p2"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.197975_R.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.188825" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.188825.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.160508" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.160508.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.158129" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.158129.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.126416" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.126416.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.117884" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.117884.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.126527" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.126527.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.126498" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.126498.xml"/> </resource> <resource identifier="URN_X-WEBCT-VISTA-V0_D527CDFD71201819E034080020C3CFDC.28908" type="webct.manifest" webct:coType="webct.question" xsi:type="webct:ResourceType"> <file href="X-WEBCT-VISTA-V0/D527CDFD71201819E034080020C3CFDC.28908.xml"/> </resource> </resources> <webct:ContentObject webct:coType="webct.assessment" webct:isVisible="false"> <webct:Name>World History Self Test</webct:Name> </webct:ContentObject> </manifest>

BEST PRACTICES FOR CREATING ASSESSMENT QTI XML FILES
To create an assessment QTI XML file that represents one of the three assessment types (quizzes, surveys, and self tests) supported by Vista 4.2 and CE 6.2, Blackboard implements the core elements of the IMS Question and Test Interoperability (QTI) specification version 1.2. NOTE: A complete description of the IMS QTI specification is beyond the scope of this document. To download this specification, go to the IMS QTI specification web site (http://www.imsglobal.org/question/index.cfm).

Creating Quizzes
160

Chapter 6: Assessment Specification

The following diagram shows the primary elements and metadata fields in a quiz QTI XML file.

Best Practices for Creating a Quiz QTI XML File

161

Chapter 6: Assessment Specification

This section describes the best practices for creating the three main sections in a quiz QTI XML file: • • • Duration Qtimetadata Section

The title attribute of the assessment element is an optional attribute that indicates the title of the quiz. If a title is not specified, the quiz is titled untitled.

Creating the Duration Section
The duration element specifies the amount of time that Students have to complete the quiz. The value must be in the format Mn, Hn, or Dn, where M is for minutes, H is for hours, D is for days, and n is replaced with the number of minutes, hours, or days. For example, M45 is forty-five minutes, H2 is two hours, and D1 is one day.
<duration>H2</duration>

If Students have an unlimited amount of time to complete the quiz, the duration element is not included in the XML file.

Creating the Qtimetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define quizzes.
Metadata Field wct_results_showFeedback Description

This field specifies whether to display answer and general feedback for the quiz when Students view their submissions. Possible values are: • •
true: show feedback false: do not show feedback

In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Show the feedback for each question (this property appears under Results Properties).

162

Chapter 6: Assessment Specification

Metadata Field wct_results_showTotalScore

Description

This field specifies whether to display the Student's total score for the quiz when Students view their submissions. Possible values are: • •
true: show the Student's total score for the quiz false: do not show the Student's total score for the

quiz In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Show the Student's total score for the assessment (this property appears under Results Properties).
wct_attempt_displayQuestionTitle

This field specifies whether to display question titles in the quiz. Possible values are: • •
true: display question titles in the quiz false: do not display question titles in the quiz

In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Display question titles (this property appears under Question delivery).
wct_attempt_attemptsAllowed

This field specifies the number of times a Student can attempt the quiz. Possible values are: 0 (for unlimited attempts), 1, 2, 3, 4, or 5. In Vista 4.2 and WebCT CE 6.2, this field corresponds to the assessment property Allowed attempts.

wct_results_showScore

This field specifies whether to display the Student's score for each question when Students view their submissions. Possible values are: • •
true: show the Student's score for each question false: do not show the Student's score for each

question In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Show the Student's score for each question (this property appears under Results Properties).

163

Chapter 6: Assessment Specification

Metadata Field wct_attempt_displayInNewWindow

Description

This field specifies whether the assessment appears in the same or a new browser window. Possible values are: • •
true: the assessment appears in a new browser

window
false: the assessment appears in the same browser

window This field corresponds to the assessment property Display Assessment.
wct_attempt_attemptSeparation

If Students are allowed to attempt the quiz more than once, this field indicates the minimum period of time that a Student must wait before making another attempt at the quiz. The value must be in the format Mn, Hn, or Dn, where M is for minutes, H is for hours, D is for days, and n is replaced with the number of minutes, hours, or days. For example, M45 is forty-five minutes, H2 is two hours, and D1 is one day. If there is no minimum period of time to wait between attempts, enter M0 (for zero minutes). In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Minimum attempt time and Units.

wct_results_studentDisplay

This field specifies the results that display when Students view their submissions. Possible values are: • • • •
doNotDisplay: do not show any results questionOnly: show only the question text withStudentAnswer: show the question text and

the Student's response for each question
withStudentEval: show the question text, the

Student's response for each question, and the percentage value of the Student's answer •
withCorrectAnswer: show the question text, the

Student's response for each question, and the correct answer for each question •
withCorrectAnswerAndStudentEval: show the

question text, the Student's response for each question, the percentage value of the Student's answer, and the correct answer for each question In Vista 4.2 and CE 6.2, this field corresponds to the Student results display assessment properties (these properties appear under Results Properties).

164

Chapter 6: Assessment Specification

Metadata Field wct_results_showGraderComments

Description

This field specifies whether grader comments are displayed to Students when they view their submissions. Possible values are: • •
true: show grader comments false: do not show grader comments

In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Show the grader comments for the assessment (this property appear under Results Properties).
wct_attempt_instructions

This field specifies custom instructions that appear when Students begin the assessment. This field corresponds to the assessment property Custom Instructions.

wct_attempt_showStatistics

This field specifies whether Students see summary and item statistics. Possible values are: • •
true: release statistics to Students after releasing the

score
false: do not release statistics to Students after

releasing the score When the field is set to true, statistics are released only when the Student Score property (wct_results_scoreRelease metadata field) is set to Release the score once the assessment has been submitted (releaseAfterSubmission) or Release the score once the assessment has been submitted and all of the questions have been graded (releaseAfterAllGrading).
wct_randomizeAttempt

If Students are allowed to attempt the quiz more than once and question sets are included in the quiz, this field specifies whether, in each attempt, questions in a question set appear randomly. Possible values are: • •
true: each time a Student attempts the quiz,

questions in a question set appear randomly
false: each time a Student attempts the quiz, the

same question in a question set appears In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Randomize questions in a question set for each attempt.

165

Chapter 6: Assessment Specification

Metadata Field wct_attempt_instructions_is_html

Description

If custom instructions are specified (in the wct_attempt_instructions field), this field specifies whether the instructions are in HTML or Plain Text format. Possible values are: • •
true: the instructions are in HTML format false: the instructions are in Plain Text format

This field corresponds to the assessment property Use HTML (this property appears under Custom Instructions).
wct_results_scoreRelease

This field specifies whether the score results of the quiz are released to Students immediately after the quiz is submitted. Possible values are: • •
releaseAfterSubmission: release the score once

the quiz has been submitted
releaseAfterAllGrading: release the score once

the quiz has been submitted and all of the questions have been graded •
doNotRelease: do not release the score

In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Student score.
wct_results_scoring

If Students are allowed to attempt the quiz more than once, this field specifies the scoring model used by the assessment. Possible values are: • • • •
First: the Student's score for the quiz is the score of

the Student's first attempt
Last: the Student's score for the quiz is the score of

the Student's last attempt
Highest: the Student's score for the quiz is the

highest score of all of the Student's attempts
Average: the Student's score for the quiz is an

average of all of the Student's attempts In Vista 4.2 and CE 6.2, this field corresponds to the If multiple attempts are allowed, display the score of the following attempt as the Student's grade property. This property appears under Student score.

166

Chapter 6: Assessment Specification

Metadata Field

Description

wct_results_allowArtifactCreation If the institution is using Portfolio and the property to

allow users to create artifacts is enabled, this field specifies whether Students can save their graded attempts as a artifact. Possible values are: • •
true: Students can save their graded attempts as a

artifact
false: Students cannot save their graded attempts as

a artifact This field corresponds to the assessment property Allow Students to save their graded attempts as a Portfolio Artifact.
wct_attempt_allowLateSubmission

If Students have a limited amount of time to complete the quiz, this field specifies whether Students can save answers after the quiz time has expired. Possible values are: • •
true: Students can save answers after the quiz time

has expired
false: Students cannot save answers after the quiz

time has expired (Students can only submit answers for the questions that they saved before the quiz time expired) In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Disallow answer submission if time has expired.
wct_attempt_questionDelivery

This field specifies how questions are delivered to Students. Possible values are: • • •
allAtOnce: deliver questions all at once oneByOne: deliver questions one at a time and allow

questions to be revisited
oneByOneRestricted: deliver questions one at a

time and do not allow questions to be revisited In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Question delivery.

167

Chapter 6: Assessment Specification

Metadata Field wct_attempt_instructions_every _question

Description

When custom instructions are specified (in the wct_attempt_instructions field) and when question are set to be delivered one at a time (the wct_attempt_questionDelivery field is set to oneByOne or oneByOneRestricted), this field specifies whether custom instructions appear with every question. Possible values are: • •
true: custom instructions appear with every question false: custom instructions do not appear with every

question In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Display custom assessment instructions on every question when questions are delivered one at a time. This property appears under Custom Instructions.
qmd_assessmenttype

The qmd_assessmenttype field is a required field that indicates the type of assessment. In Vista 4.2 and CE 6.2, this field corresponds to the Type field on the Assessments screen. For quizzes, this field must be set to Examination.

NOTE:

The following assessment properties are not exported and cannot be imported: • • • • • • • Description Item Visibility Grade Book column name: when a quiz is imported into Vista 4.2 or CE 6.2, this property is populated automatically with the title of the quiz Goals Start Time and End Time (these properties appear under Dates Available) Submission message and E-mail submissions (these properties appear under Submission Properties) Proctor password, IP address, and IP address mask (these properties appear under Security Properties)

Creating the "Section" Section
There is one immediate child section element in each assessment element. If the assessment contains parts and question sets, within this section element, there is one section element for each part or question set. 168

Chapter 6: Assessment Specification

As shown in the following diagram, an assessment containing three parts (Part 1, Part 2, and Part 3) and two question sets contains five section elements within the parent section element.

If there are questions sets within the parts of the assessment, there is one section element for each question set in the part. This is shown in the following diagram.

169

Chapter 6: Assessment Specification

Within a section, the following values must be set:
Data Element or Attribute title attribute of the section Description

element

If the section represent a part in the assessment, the title attribute of the section element specifies the title of the part. This title appears in the assessment. If a title is not specified, the part is titled Section_x, where x is the number of the section. (The index is zero-based, thus the first section is 0, the second section is 1, and so forth.) If the section represents a question set in the assessment, the title attribute is an optional attribute. When displayed in an assessment, question sets always have the title Question Set.

decvar element in outcomes in the outcomes_processing

The vartype and varname attributes of the decvar element must be set to Decimal and SCORE respectively.

element

170

Chapter 6: Assessment Specification

Data Element or Attribute selection_ordering element

Description

If the section represents a part in the assessment, the order_type attribute of the order element in selection_ordering must be set to Sequential. If the section represents a question set in the assessment: • The selection_number element in the selection element is the number of questions in the question set that you want to include in each assessment. For example, if there are five questions in the question set and you want to include two of the five questions in each assessment, set the value to 2. The order_type attribute of the order element must be set to Random.

XML Examples of Quizzes
This section contains: • • an XML example of a quiz. an XML example of a quiz that contains parts and question sets.

XML Example of a Quiz
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <assessment ident="WCT:ASM0:3920856000:28225:D527CDFD71201819E034080020C3CFDC" title= "History Pop Quiz"> <duration>H1</duration> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_results_showFeedback</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_showTotalScore</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_displayQuestionTitle</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_attemptsAllowed</fieldlabel> <fieldentry>2</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_showScore</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_displayInNewWindow</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield>

171

Chapter 6: Assessment Specification

<qtimetadatafield> <fieldlabel>wct_attempt_attemptSeparation</fieldlabel> <fieldentry>M5</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_studentDisplay</fieldlabel> <fieldentry>withCorrectAnswerAndStudentEval</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_mailto</fieldlabel> <fieldentry>name@domain_name.com</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_showGraderComments</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_showStatistics</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_randomizeAttempt</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions_is_html</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_scoreRelease</fieldlabel> <fieldentry>doNotRelease</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_scoring</fieldlabel> <fieldentry>Average</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_allowArtifactCreation</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_allowLateSubmission</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_questionDelivery</fieldlabel> <fieldentry>allAtOnce</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions_every_question</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> </qtimetadata> <qtimetadata> <vocabulary uri="imsqtiv1p2_metadata.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>qmd_assessmenttype</fieldlabel> <fieldentry>Examination</fieldentry> </qtimetadatafield> </qtimetadata> <section ident="WCT:ASM0:3920861000:28225:D527CDFD71201819E034080020C3CFDC" title= "History Pop Quiz"> <outcomes_processing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3543172000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition>

172

Chapter 6: Assessment Specification

<outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200354000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:2001736000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3001967000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3920234000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> </outcomes_processing> <selection_ordering> <order order_type="Sequential" /> </selection_ordering> <itemref linkrefid="WCT:ASM0:3543172000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200354000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:2001736000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3001967000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3920234000:28225:D527CDFD71201819E034080020C3CFDC" /> </section> </assessment> </questestinterop>

XML Example of a Quiz with Parts and Question Sets
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <assessment ident="WCT:ASM0:3920790000:28225:D527CDFD71201819E034080020C3CFDC" title= "Geography Pop Quiz"> <duration>M15</duration> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_results_showFeedback</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_showTotalScore</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_displayInNewWindow</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_displayQuestionTitle</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_attemptsAllowed</fieldlabel> <fieldentry>1</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_showScore</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_attemptSeparation</fieldlabel> <fieldentry>M0</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_studentDisplay</fieldlabel> <fieldentry>withCorrectAnswerAndStudentEval</fieldentry>

173

Chapter 6: Assessment Specification

</qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_mailto</fieldlabel> <fieldentry>name@domain_name.com</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_showGraderComments</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_showStatistics</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_randomizeAttempt</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions_is_html</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_scoreRelease</fieldlabel> <fieldentry>doNotRelease</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_scoring</fieldlabel> <fieldentry>First</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_results_allowArtifactCreation</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_allowLateSubmission</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_questionDelivery</fieldlabel> <fieldentry>allAtOnce</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions_every_question</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> </qtimetadata> <qtimetadata> <vocabulary uri="imsqtiv1p2_metadata.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>qmd_assessmenttype</fieldlabel> <fieldentry>Examination</fieldentry> </qtimetadatafield> </qtimetadata> <section ident="WCT:ASM0:3920795000:28225:D527CDFD71201819E034080020C3CFDC" title= "Geography Pop Quiz"> <selection_ordering> <order order_type="Sequential" /> </selection_ordering> <!-- This quiz contains three parts: "North America", "Asia", and "Continents and Oceans"; followed by a question set. The first part, "North America", contains a question set with three questions. --> <section ident="WCT:ASM0:3920806000:28225:D527CDFD71201819E034080020C3CFDC" title= "North America"> <selection_ordering> <order order_type="Sequential" /> </selection_ordering> <section ident="WCT:ASM0:3920804000:28225:D527CDFD71201819E034080020C3CFDC" title= "question set"> <outcomes_processing> <outcomes>

174

Chapter 6: Assessment Specification

<decvar vartype="Decimal" varname="SCORE" /> </outcomes> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3840892000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3860047000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3560360000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> </outcomes_processing> <!For question sets, in the selection_ordering element, in selection, the selection_number element specifies the number of questions in the question set that you want to include in each assessment. The order_type attribute of the order element must be set to "Random". --> <selection_ordering> <selection> <selection_number>1</selection_number> </selection> <order order_type="Random" /> </selection_ordering> <itemref linkrefid="WCT:ASM0:3840892000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3860047000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3560360000:28225:D527CDFD71201819E034080020C3CFDC" /> </section> </section> <section ident="WCT:ASM0:3920808000:28225:D527CDFD71201819E034080020C3CFDC" title= "Asia"> <outcomes_processing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3543172000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> </outcomes_processing> <selection_ordering> <order order_type="Sequential" /> </selection_ordering> <itemref linkrefid="WCT:ASM0:3543172000:28225:D527CDFD71201819E034080020C3CFDC" /> </section> <section ident="WCT:ASM0:3920809000:28225:D527CDFD71201819E034080020C3CFDC" title= "Continents and Oceans"> <outcomes_processing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200354000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> </outcomes_processing> <selection_ordering> <order order_type="Sequential" /> </selection_ordering> <itemref linkrefid="WCT:ASM0:3200354000:28225:D527CDFD71201819E034080020C3CFDC" /> </section> <section ident="WCT:ASM0:3920810000:28225:D527CDFD71201819E034080020C3CFDC" title= "question set"> <outcomes_processing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <objects_condition>

175

Chapter 6: Assessment Specification

<outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200394000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200444000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200395000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> </outcomes_processing> <selection_ordering> <selection> <selection_number>1</selection_number> </selection> <order order_type="Random" /> </selection_ordering> <itemref linkrefid="WCT:ASM0:3200394000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200444000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200395000:28225:D527CDFD71201819E034080020C3CFDC" /> </section> </section> </assessment> </questestinterop>

Creating Surveys
The following diagram shows the primary elements and metadata fields in a survey QTI XML file.

176

Chapter 6: Assessment Specification

Best Practices for Creating a Survey QTI XML File
This section describes the best practices for creating the three main sections in a survey QTI XML file: Duration, Qtimetadata, and Section. The title attribute of the assessment element is an optional attribute that indicates the title of the survey. If a title is not specified, the survey is titled untitled.

177

Chapter 6: Assessment Specification

Creating the Duration Section
The duration element specifies the amount of time that Students have to complete the survey. The value must be in the format Mn, Hn, or Dn, where M is for minutes, H is for hours, D is for days, and n is replaced with the number of minutes, hours, or days. For example, M45 is forty-five minutes, H2 is two hours, and D1 is one day.
<duration>H2</duration>

If Students have an unlimited amount of time to complete the survey, the duration element is not included in the XML file.

Creating the Qtimetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define surveys.
Metadata Field wct_attempt_displayQuestionTitle Description

This field specifies whether to display question titles in the survey. Possible values are: • •
true: display question titles in the survey false: do not display question titles in the survey

In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Display question titles (this property appears under Question delivery).
wct_attempt_displayInNewWindow

This field specifies whether the assessment appears in the same or a new browser window. Possible values are: • •
true: the assessment appears in a new browser

window
false: the assessment appears in the same browser

window This field corresponds to the assessment property Display Assessment.
wct_attempt_instructions

This field specifies custom instructions that appear when Students begin the assessment. This field corresponds to the assessment property Custom Instructions.

178

Chapter 6: Assessment Specification

Metadata Field wct_attempt_instructions_is_html

Description

If custom instructions are specified (in the wct_attempt_instructions field), this field specifies whether the instructions are in HTML or Plain Text format. Possible values are: • •
true: the instructions are in HTML format false: the instructions are in Plain Text format

This field corresponds to the assessment property Use HTML (this property appears under Custom Instructions).
wct_attempt_allowLateSubmission

If Students have a limited amount of time to complete the survey, this field specifies whether Students can save answers after the survey time has expired. Possible values are: • •
true: Students can save answers after the survey

time has expired
false: Students cannot save answers after the survey

time has expired (Students can only submit answers for the questions that they saved before the survey time expired) In Vista 4.2 and CE 6.2 this field corresponds to the assessment property Disallow answer submission if time has expired.
wct_attempt_questionDelivery

This field specifies how questions are delivered to Students. Possible values are: • • •
allAtOnce: deliver questions all at once oneByOne: deliver questions one at a time and allow

questions to be revisited
oneByOneRestricted: deliver questions one at a

time and do not allow questions to be revisited In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Question delivery.

179

Chapter 6: Assessment Specification

Metadata Field wct_attempt_instructions_every _question

Description

When custom instructions are specified (in the wct_attempt_instructions field) and when question are set to be delivered one at a time (the wct_attempt_questionDelivery field is set to oneByOne or oneByOneRestricted), this field specifies whether custom instructions appear with every question. Possible values are: • •
true: custom instructions appear with every question false: custom instructions do not appear with every

question In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Display custom assessment instructions on every question when questions are delivered one at a time. This property appears under Custom Instructions.
qmd_assessmenttype

The qmd_assessmenttype field is a required field that indicates the type of assessment. In Vista 4.2 and CE 6.2, this field corresponds to the Type field on the Assessments screen. For surveys, this field must be set to Survey.

NOTE:

The following metadata fields are exported but are not required for import: • • • • • • • • • • • •
wct_results_showFeedback wct_results_showTotalScore wct_attempt_attemptsAllowed wct_results_showScore wct_attempt_attemptSeparation wct_results_studentDisplay wct_results_showGraderComments wct_attempt_showStatistics wct_randomizeAttempt wct_results_scoreRelease wct_results_scoring wct_results_allowArtifactCreation

180

Chapter 6: Assessment Specification

The following assessment properties are not exported and cannot be imported: • • • • • • • Description Item Visibility Grade Book column name: when a survey is imported into Vista 4.2 and CE 6.2, this property is populated automatically with the title of the survey Goals Start Time and End Time (these properties appear under Dates Available) Submission message and E-mail submissions (these properties appear under Submission Properties) Proctor password, IP address, and IP address mask (these properties appear under Security Properties)

Creating the "Section" Section
Sections are created the same way in all Vista 4.2 and CE 6.2 assessments. For more information, in the section Best Practices for Creating a Quiz QTI XML File, see Creating the "Section" Section.

XML Example of a Survey
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <assessment ident="WCT:ASM0:3920882000:28225:D527CDFD71201819E034080020C3CFDC" title= "Course Feedback Survey"> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>wct_attempt_displayQuestionTitle</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_displayInNewWindow</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions_is_html</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_allowLateSubmission</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_questionDelivery</fieldlabel> <fieldentry>oneByOne</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions_every_question</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> </qtimetadata> <qtimetadata> <vocabulary uri="imsqtiv1p2_metadata.txt" vocab_type="text/plain" />

181

Chapter 6: Assessment Specification

<qtimetadatafield> <fieldlabel>qmd_assessmenttype</fieldlabel> <fieldentry>Survey</fieldentry> </qtimetadatafield> </qtimetadata> <section ident="WCT:ASM0:3920887000:28225:D527CDFD71201819E034080020C3CFDC" title="WCT-ASM0-3920887000-28225-D527CDFD71201819E034080020C3CFDC"> <outcomes_processing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3543172000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200353000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200394000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200444000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200395000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200391000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200356000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200354000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> </outcomes_processing> <selection_ordering> <order order_type="Sequential" /> </selection_ordering> <itemref linkrefid="WCT:ASM0:3543172000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200353000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200394000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200444000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200395000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200391000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200356000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200354000:28225:D527CDFD71201819E034080020C3CFDC" /> </section> </assessment> </questestinterop>

Creating Self Tests
182

Chapter 6: Assessment Specification

The following diagram shows the primary elements and metadata fields in a self test QTI XML file.

Best Practices for Creating a Self Test QTI XML File
This section describes the best practices for creating the two main sections in a self test QTI XML file: Qtimetadata and Section. The title attribute of the assessment element is an optional attribute that indicates the title of the self test. If a title is not specified, the self test is titled untitled. NOTE: Self test do not include a duration section.

183

Chapter 6: Assessment Specification

Creating the Qtimetadata Section
In the itemmetadata element within the qtimetadata element, the following metadata fields are used to define self tests.
Metadata Field wct_attempt_displayQuestionTitle Description

This field specifies whether to display question titles in the self test. Possible values are: • •
true: display question titles in the self test false: do not display question titles in the self test

In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Display question titles (this property appears under Question delivery).
wct_attempt_displayInNewWindow

This field specifies whether the assessment appears in the same or a new browser window. Possible values are: • •
true: the assessment appears in a new browser

window
false: the assessment appears in the same browser

window This field corresponds to the assessment property Display Assessment.
wct_attempt_instructions

This field specifies custom instructions that appear when Students begin the assessment. This field corresponds to the assessment property Custom Instructions.

wct_attempt_instructions_is_html

If custom instructions are specified (in the wct_attempt_instructions field), this field specifies whether the instructions are in HTML or Plain Text format. Possible values are: • •
true: the instructions are in HTML format false: the instructions are in Plain Text format

This field corresponds to the assessment property Use HTML (this property appears under Custom Instructions).

184

Chapter 6: Assessment Specification

Metadata Field wct_attempt_questionDelivery

Description

This field specifies how questions are delivered to Students. Possible values are: • • •
allAtOnce: deliver questions all at once oneByOne: deliver questions one at a time and do not

show immediate feedback
oneByOneRestricted: deliver questions one at a

time and show immediate feedback In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Question delivery.
wct_attempt_instructions_every _question

When custom instructions are specified (in the wct_attempt_instructions field) and when question are set to be delivered one at a time (the wct_attempt_questionDelivery field is set to oneByOne or oneByOneRestricted), this field specifies whether custom instructions appear with every question. Possible values are: • •
true: custom instructions appear with every question false: custom instructions do not appear with every

question In Vista 4.2 and CE 6.2, this field corresponds to the assessment property Display custom assessment instructions on every question when questions are delivered one at a time (this property appears under Custom Instructions).
qmd_assessmenttype

The qmd_assessmenttype field is a required field that indicates the type of assessment. In Vista 4.2 and CE 6.2, this field corresponds to the Type field on the Assessments screen. For self tests, this field must be set to Self-assessment.

NOTE:

The following metadata fields are exported but are not required for import: • • • • •
wct_results_showFeedback wct_results_showTotalScore wct_attempt_attemptsAllowed wct_results_showScore wct_attempt_attemptSeparation

185

Chapter 6: Assessment Specification

• • • • • • • • •

wct_results_studentDisplay wct_results_showGraderComments wct_attempt_showStatistics wct_randomizeAttempt wct_results_scoreRelease wct_results_scoring wct_results_allowArtifactCreation wct_attempt_allowLateSubmission

The following assessment properties are not exported and cannot be imported: • • • • Description Item Visibility Goals Start Time and End Time (these properties appear under Dates Available)

Creating the "Section" Section
Sections are created the same way in all Vista 4.2 and CE 6.2 assessments. For more information, in the section Best Practices for Creating a Quiz QTI XML File, see Creating the "Section" Section.

XML Example of a Self Test
<?xml version="1.0" encoding="UTF-8"?> <questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2"> <assessment ident="WCT:ASM0:3920955000:28225:D527CDFD71201819E034080020C3CFDC" title= "World History Self Test"> <qtimetadata> <vocabulary uri="webct_imsqti_metadatav1p0.txt" vocab_type="text/plain" /> <qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_displayQuestionTitle</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_displayInNewWindow</fieldlabel> <fieldentry>true</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions</fieldlabel> <fieldentry></fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_instructions_is_html</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> <qtimetadatafield> <fieldlabel>wct_attempt_questionDelivery</fieldlabel> <fieldentry>oneByOne</fieldentry> </qtimetadatafield> <qtimetadatafield>

186

Chapter 6: Assessment Specification

<fieldlabel>wct_attempt_instructions_every_question</fieldlabel> <fieldentry>false</fieldentry> </qtimetadatafield> </qtimetadata> <qtimetadata> <vocabulary uri="imsqtiv1p2_metadata.txt" vocab_type="text/plain" /> <qtimetadatafield> <fieldlabel>qmd_assessmenttype</fieldlabel> <fieldentry>Self-assessment</fieldentry> </qtimetadatafield> </qtimetadata> <section ident="WCT:ASM0:3920956000:28225:D527CDFD71201819E034080020C3CFDC" title= "World History Self Test"> <outcomes_processing> <outcomes> <decvar vartype="Decimal" varname="SCORE" /> </outcomes> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3840892000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3560360000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3543172000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200354000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:2903597000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200391000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:3200356000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> <objects_condition> <outcomes_metadata mdname="ident" mdoperator="EQ">WCT:ASM0:2001736000:28225: D527CDFD71201819E034080020C3CFDC</outcomes_metadata> <objects_parameter pname="qmd_weighting">0.1</objects_parameter> </objects_condition> </outcomes_processing> <selection_ordering> <order order_type="Sequential" /> </selection_ordering> <itemref linkrefid="WCT:ASM0:3840892000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3560360000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3543172000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200354000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:2903597000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200391000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:3200356000:28225:D527CDFD71201819E034080020C3CFDC" /> <itemref linkrefid="WCT:ASM0:2001736000:28225:D527CDFD71201819E034080020C3CFDC" /> </section> </assessment> </questestinterop>

187

Chapter 6: Assessment Specification

XML BINDING FOR MANIFEST ELEMENTS
The following is a narrative description of the elements defined in the CIS 3.0 XML schema. The http://www.webct.com/xsd/cisv3 namespace for the CIS 3.0 XML schema is located in cisv3.xsd. This file is included in the zip file of each content package exported from Vista 4.2 and CE 6.2 and is available on Behind the Blackboard.

ContentObject Element
Description This element represents specific features of the learning object that are not defined by the IMS CP specification. http://www.webct.com/xsd/cisv3 Occurs once and only once within a manifest element. • • coType (required). Indicates the learning object type. Data type=string. For a question, the value of the coType attribute must be set to webct.question. isVisible (optional). Indicates whether or not the learning object appears. If not present, the value is assumed to be true. Data type=boolean. <Name>
<webct:ContentObject webct:coType="webct.question"> <webct:Name>Multiple Choice Question 1</webct:Name> </webct:ContentObject>

Namespace Multiplicity Attributes

Elements Example

Name Element
Description Namespace Multiplicity Example This element describes the name of the learning object. Data type=string. http://www.webct.com/xsd/cisv3 Occurs once and only once within a ContentObject element.
<webct:Name>Multiple Choice Question 1</webct:Name>

188