org.sakaiproject.tool.assessment.qti.helper.item
Interface ItemHelperIfc

All Known Implementing Classes:

ItemHelper12Impl, ItemHelper20Impl, ItemHelperBase

public interface ItemHelperIfc

Interface for QTI-versioned item helper implementation.

Copyright: Copyright (c) 2005

Organization: Sakai Project

Version:

$Id: ItemHelperIfc.java 9274 2006-05-10 22:50:48Z daisyf@stanford.edu $

Author:

Ed Smiley esmiley@stanford.edu

Field Summary

static long	ITEM_AUDIO
static long	ITEM_ESSAY
static long	ITEM_FIB
static long	ITEM_FILE
static long	ITEM_FIN
static long	ITEM_MATCHING
static long	ITEM_MCMC
static long	ITEM_MCMC_SS
static long	ITEM_MCSC
static long	ITEM_MXSURVEY
static long	ITEM_SURVEY
static long	ITEM_TF
static String[]	itemTypes

Method Summary

void	addCorrectAnswer(String correctAnswerLabel, Item itemXml) Flags an answer as correct.
void	addIncorrectAnswer(String incorrectAnswerLabel, Item itemXml) Flags an answer as NOT correct.
void	addMaxScore(Float score, Item itemXml) Add minimum score to item XML.
void	addMinScore(Float score, Item itemXml) Add maximum score to item XML
String	getItemType(Item itemXml)
String	getMetaLabelXPath(String fieldlabel) Get the metadata field entry XPath for a given label
String	getMetaXPath() Get the metadata field entry XPath
String	getText(Item itemXml) Get the text for the item
Item	readTypeSurveyItem(String scaleName) Get Item Xml for a given survey item scale name.
Item	readTypeXMLItem(Long type) Get Item Xml for a given item type as a Long .
Item	readXMLDocument(InputStream inputStream) Read XML document from input stream
void	setAnswers(ArrayList itemTextList, Item itemXml) Set the answer texts for item.
void	setFeedback(ArrayList itemTextList, Item itemXml) Set the feedback texts for item.
void	setItemText(String itemText, Item itemXml) Set the (usually instructional text) for trhe item.
void	setItemTexts(ArrayList itemTextList, Item itemXml) Set the (one or more) item texts.
Item	updateItemXml(Item itemXml, String xpath, String value) DOCUMENTATION PENDING

Field Detail

ITEM_AUDIO

static final long ITEM_AUDIO

ITEM_ESSAY

static final long ITEM_ESSAY

ITEM_FILE

static final long ITEM_FILE

ITEM_FIB

static final long ITEM_FIB

ITEM_FIN

static final long ITEM_FIN

ITEM_MCSC

static final long ITEM_MCSC

ITEM_SURVEY

static final long ITEM_SURVEY

ITEM_MCMC

static final long ITEM_MCMC

ITEM_MCMC_SS

static final long ITEM_MCMC_SS

ITEM_TF

static final long ITEM_TF

ITEM_MATCHING

static final long ITEM_MATCHING

ITEM_MXSURVEY

static final long ITEM_MXSURVEY

itemTypes

static final String[] itemTypes

Method Detail

readTypeXMLItem

Item readTypeXMLItem(Long type)

Get Item Xml for a given item type as a Long .

Parameters:

type - item type as a Long

Returns:

readTypeSurveyItem

Item readTypeSurveyItem(String scaleName)

Get Item Xml for a given survey item scale name.

Parameters:

scaleName -

Returns:

readXMLDocument

Item readXMLDocument(InputStream inputStream)

Read XML document from input stream

Parameters:

inputStream - XML docuemnt stream

Returns:

item XML

updateItemXml

Item updateItemXml(Item itemXml,
                   String xpath,
                   String value)

DOCUMENTATION PENDING

Parameters:

itemXml - item xml to update

xpath - the XPath

value - value to set

Returns:

the item xml

addMaxScore

void addMaxScore(Float score,
                 Item itemXml)

Add minimum score to item XML.

Parameters:

score -

itemXml -

addMinScore

void addMinScore(Float score,
                 Item itemXml)

Add maximum score to item XML

Parameters:

score -

itemXml -

addCorrectAnswer

void addCorrectAnswer(String correctAnswerLabel,
                      Item itemXml)

Flags an answer as correct.

Parameters:

correctAnswerLabel -

addIncorrectAnswer

void addIncorrectAnswer(String incorrectAnswerLabel,
                        Item itemXml)

Flags an answer as NOT correct.

Parameters:

correctAnswerLabel -

getMetaXPath

String getMetaXPath()

Get the metadata field entry XPath

Returns:

the XPath

getMetaLabelXPath

String getMetaLabelXPath(String fieldlabel)

Get the metadata field entry XPath for a given label

Parameters:

fieldlabel -

Returns:

the XPath

getText

String getText(Item itemXml)

Get the text for the item

Parameters:

itemXml -

Returns:

the text

setItemTexts

void setItemTexts(ArrayList itemTextList,
                  Item itemXml)

Set the (one or more) item texts. Valid for single and multiple texts.

Parameters:

itemXml -

itemText - text to be updated

setItemText

void setItemText(String itemText,
                 Item itemXml)

Set the (usually instructional text) for trhe item.

Parameters:

itemText -

itemXml -

getItemType

String getItemType(Item itemXml)

Parameters:

itemXml -

Returns:

type as string

setAnswers

void setAnswers(ArrayList itemTextList,
                Item itemXml)

Set the answer texts for item.

Parameters:

itemTextList - the text(s) for item

setFeedback

void setFeedback(ArrayList itemTextList,
                 Item itemXml)

Set the feedback texts for item.

Parameters:

itemTextList - the text(s) for item