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$

Author:

Ed Smiley esmiley@stanford.edu

Field Summary

Fields

Modifier and Type	Field and Description
static long	ITEM_AUDIO
static long	ITEM_CALCQ
static long	ITEM_EMI
static long	ITEM_ESSAY
static long	ITEM_FIB
static long	ITEM_FILE
static long	ITEM_FIN
static long	ITEM_IMAGMQ
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

Modifier and Type	Method and Description
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(Double score, Item itemXml) Add minimum score to item XML.
void	addMinScore(Double 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(List<ItemTextIfc> itemTextList, Item itemXml) Set the answer texts for item.
void	setAttachments(Set<? extends AttachmentIfc> attachmentSet, Item item)
void	setFeedback(List<ItemTextIfc> itemTextList, Item itemXml) Set the feedback texts for item.
void	setItemLabel(String itemLabel, Item itemXml) Set the label for the item.
void	setItemText(String itemText, Item itemXml) Set the (usually instructional text) for trhe item.
void	setItemText(String itemText, String flowClass, Item itemXml) Set the (usually instructional text) for the item for the specified flow.
void	setItemTexts(List<ItemTextIfc> itemTextList, Item itemXml) Set the (one or more) item texts.
void	setPresentationFlowResponseIdent(String presentationFlowResponseIdent, Item itemXml) Set the public void Presentation Flow Response Ident
void	setPresentationLabel(String presentationLabel, Item itemXml) Set the presentation label.
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_EMI

static final long ITEM_EMI

ITEM_MXSURVEY

static final long ITEM_MXSURVEY

ITEM_CALCQ

static final long ITEM_CALCQ

ITEM_IMAGMQ

static final long ITEM_IMAGMQ

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(Double score,
                 Item itemXml)

Add minimum score to item XML.

Parameters:

score -

itemXml -

addMinScore

void addMinScore(Double 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(List<ItemTextIfc> itemTextList,
                  Item itemXml)

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

Parameters:

itemXml -

itemText - text to be updated

setItemLabel

void setItemLabel(String itemLabel,
                  Item itemXml)

Set the label for the item.

Parameters:

itemLabel -

itemXml -

setItemText

void setItemText(String itemText,
                 Item itemXml)

Set the (usually instructional text) for trhe item.

Parameters:

itemText -

itemXml -

setItemText

void setItemText(String itemText,
                 String flowClass,
                 Item itemXml)

Set the (usually instructional text) for the item for the specified flow.

Parameters:

itemText -

itemXml -

setPresentationLabel

void setPresentationLabel(String presentationLabel,
                          Item itemXml)

Set the presentation label.

Parameters:

presentationLabel -

itemXml -

setPresentationFlowResponseIdent

void setPresentationFlowResponseIdent(String presentationFlowResponseIdent,
                                      Item itemXml)

Set the public void Presentation Flow Response Ident

Parameters:

presentationFlowResponseIdent -

itemXml -

getItemType

String getItemType(Item itemXml)

Parameters:

itemXml -

Returns:

type as string

setAnswers

void setAnswers(List<ItemTextIfc> itemTextList,
                Item itemXml)

Set the answer texts for item.

Parameters:

itemTextList - the text(s) for item

setFeedback

void setFeedback(List<ItemTextIfc> itemTextList,
                 Item itemXml)

Set the feedback texts for item.

Parameters:

itemTextList - the text(s) for item

setAttachments

void setAttachments(Set<? extends AttachmentIfc> attachmentSet,
                    Item item)