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

Class ItemHelper12Impl

java.lang.Object

org.sakaiproject.tool.assessment.qti.helper.item.ItemHelperBase

org.sakaiproject.tool.assessment.qti.helper.item.ItemHelper12Impl

All Implemented Interfaces:

ItemHelperIfc

public class ItemHelper12Impl
extends ItemHelperBase
implements ItemHelperIfc

Version for QTI 1.2 item XML, significant differences between 1.2 and 2.0

* @version $Id: ItemHelper12Impl.java 305964 2014-02-14 01:05:35Z ktsao@stanford.edu $ Many methods in Fill in Blank and Numerical Responses(FIN) are identical for now. This might change if we want to add random variable, parameterized calculation....

Field Summary

Fields

Modifier and Type	Field and Description
protected String[]	itemTypes

Fields inherited from class org.sakaiproject.tool.assessment.qti.helper.item.ItemHelperBase

ITEM_AUDIO, ITEM_CALCQ, ITEM_EMI, ITEM_ESSAY, ITEM_FIB, ITEM_FILE, ITEM_FIN, ITEM_MATCHING, ITEM_MCMC, ITEM_MCMC_SS, ITEM_MCSC, ITEM_MXSURVEY, ITEM_SURVEY, ITEM_TF

Fields inherited from interface org.sakaiproject.tool.assessment.qti.helper.item.ItemHelperIfc

ITEM_AUDIO, ITEM_CALCQ, ITEM_EMI, ITEM_ESSAY, ITEM_FIB, ITEM_FILE, ITEM_FIN, ITEM_MATCHING, ITEM_MCMC, ITEM_MCMC_SS, ITEM_MCSC, ITEM_MXSURVEY, ITEM_SURVEY, ITEM_TF

Constructor Summary

Constructors

Constructor and Description
ItemHelper12Impl()

Method Summary

Methods

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 INCORRECT.
void	addMaxScore(Double score, Item itemXml) Add maximum score to item XML.
void	addMinScore(Double discount, Item itemXml) Add minimum score to item XML
void	addResponseEntry(Item itemXml, String xpath, String value, boolean isInsert, String responseNo, String responseLabel) Add/update a response label entry
void	flagAnswerCorrect(String answerLabel, Item itemXml, boolean correct) Flags an answer as correct/incorrect.
protected AuthoringXml	getAuthoringXml() We will have a versioned AuthoringXml in subclasses.
String	getItemType(Item itemXml) get item type string
String	getMetaLabelXPath(String fieldlabel) Get the metadata field entry XPath for a given label
String	getMetaXPath() Get the metadata field entry XPath
protected int	getQtiVersion() get the qti version
String	getText(Item itemXml) Get the text for the item
void	setAnswers(List<ItemTextIfc> itemTextList, Item itemXml) Set the answer texts for item.
void	setAttachments(Set<? extends AttachmentIfc> attachmentSet, Item itemXml)
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 item text.
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.

Methods inherited from class org.sakaiproject.tool.assessment.qti.helper.item.ItemHelperBase

makeItemNodeText, readTypeSurveyItem, readTypeXMLItem, readXMLDocument, updateItemXml

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.sakaiproject.tool.assessment.qti.helper.item.ItemHelperIfc

readTypeSurveyItem, readTypeXMLItem, readXMLDocument, updateItemXml

Field Detail

itemTypes

protected String[] itemTypes

Constructor Detail

ItemHelper12Impl

public ItemHelper12Impl()

Method Detail

getAuthoringXml

protected AuthoringXml getAuthoringXml()

Description copied from class: ItemHelperBase

We will have a versioned AuthoringXml in subclasses.

Specified by:

getAuthoringXml in class ItemHelperBase

Returns:

getQtiVersion

protected int getQtiVersion()

get the qti version

Specified by:

getQtiVersion in class ItemHelperBase

Returns:

addMaxScore

public void addMaxScore(Double score,
               Item itemXml)

Add maximum score to item XML.

Specified by:

addMaxScore in interface ItemHelperIfc

Parameters:

score -

itemXml -

addMinScore

public void addMinScore(Double discount,
               Item itemXml)

Add minimum score to item XML

Specified by:

addMinScore in interface ItemHelperIfc

Parameters:

score -

itemXml -

addCorrectAnswer

public void addCorrectAnswer(String correctAnswerLabel,
                    Item itemXml)

Flags an answer as correct.

Specified by:

addCorrectAnswer in interface ItemHelperIfc

Parameters:

correctAnswerLabel - the answer that is correct

itemXml - the encapsulation of the item xml

addIncorrectAnswer

public void addIncorrectAnswer(String incorrectAnswerLabel,
                      Item itemXml)

Flags an answer as INCORRECT. Currently, only used for true false questions.

Specified by:

addIncorrectAnswer in interface ItemHelperIfc

Parameters:

incorrectAnswerLabel - the answer that is NOT correct

itemXml - the encapsulation of the item xml

flagAnswerCorrect

public void flagAnswerCorrect(String answerLabel,
                     Item itemXml,
                     boolean correct)

Flags an answer as correct/incorrect.

Parameters:

correctAnswerLabel - the answer that is correct

itemXml - the encapsulation of the item xml

correct - true, or false if not correct

addResponseEntry

public void addResponseEntry(Item itemXml,
                    String xpath,
                    String value,
                    boolean isInsert,
                    String responseNo,
                    String responseLabel)

Add/update a response label entry

Parameters:

itemXml -

xpath -

itemText -

isInsert -

responseNo -

responseLabelIdent -

getMetaXPath

public String getMetaXPath()

Get the metadata field entry XPath

Specified by:

getMetaXPath in interface ItemHelperIfc

Returns:

the XPath

getMetaLabelXPath

public String getMetaLabelXPath(String fieldlabel)

Get the metadata field entry XPath for a given label

Specified by:

getMetaLabelXPath in interface ItemHelperIfc

Parameters:

fieldlabel -

Returns:

the XPath

getText

public String getText(Item itemXml)

Get the text for the item

Specified by:

getText in interface ItemHelperIfc

Parameters:

itemXml -

Returns:

the text

setItemLabel

public void setItemLabel(String itemLabel,
                Item itemXml)

Description copied from interface: ItemHelperIfc

Set the label for the item.

Specified by:

setItemLabel in interface ItemHelperIfc

setPresentationLabel

public void setPresentationLabel(String presentationLabel,
                        Item itemXml)

Description copied from interface: ItemHelperIfc

Set the presentation label.

Specified by:

setPresentationLabel in interface ItemHelperIfc

setPresentationFlowResponseIdent

public void setPresentationFlowResponseIdent(String presentationFlowResponseIdent,
                                    Item itemXml)

Description copied from interface: ItemHelperIfc

Set the public void Presentation Flow Response Ident

Specified by:

setPresentationFlowResponseIdent in interface ItemHelperIfc

setItemText

public void setItemText(String itemText,
               Item itemXml)

Set the item text. This is valid for all undelimited single item texts. Not valid for matching or fill in the blank, but OK for instructional text

Specified by:

setItemText in interface ItemHelperIfc

Parameters:

itemText - text to be updated

itemXml -

setItemText

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

Description copied from interface: ItemHelperIfc

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

Specified by:

setItemText in interface ItemHelperIfc

setItemTexts

public void setItemTexts(List<ItemTextIfc> itemTextList,
                Item itemXml)

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

Specified by:

setItemTexts in interface ItemHelperIfc

Parameters:

itemXml -

itemText - text to be updated

getItemType

public String getItemType(Item itemXml)

get item type string

Specified by:

getItemType in interface ItemHelperIfc

Parameters:

itemXml -

Returns:

type as string

setAnswers

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

Set the answer texts for item.

Specified by:

setAnswers in interface ItemHelperIfc

Parameters:

itemTextList - the text(s) for item

setFeedback

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

Set the feedback texts for item.

Specified by:

setFeedback in interface ItemHelperIfc

Parameters:

itemTextList - the text(s) for item

itemXml -

setAttachments

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

Specified by:

setAttachments in interface ItemHelperIfc