org.olat.course.nodes
Class IQTESTCourseNode

java.lang.Object
  org.olat.core.util.nodes.GenericNode
      org.olat.course.nodes.GenericCourseNode
          org.olat.course.nodes.AbstractAccessableCourseNode
              org.olat.course.nodes.IQTESTCourseNode

All Implemented Interfaces:

java.io.Serializable, ShortName, INode, AssessableCourseNode, CourseNode

public class IQTESTCourseNode
extends AbstractAccessableCourseNode
implements AssessableCourseNode

Initial Date: Feb 9, 2004

Author:

Mike Stock Comment:, BPS (BPS Bildungsportal Sachsen GmbH)

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.olat.course.nodes.CourseNode

DISPLAY_OPTS_CONTENT, DISPLAY_OPTS_TITLE_CONTENT, DISPLAY_OPTS_TITLE_DESCRIPTION_CONTENT

Constructor Summary

IQTESTCourseNode()
Constructor to create a course node of type IMS QTI.

Method Summary

void	archiveNodeData(java.util.Locale locale, ICourse course, java.io.File exportDirectory, java.lang.String charset) Override default implementation
void	cleanupOnDelete(ICourse course) Generic interface implementation.
TabbableController	createEditController(UserRequest ureq, WindowControl wControl, ICourse course, UserCourseEnvironment euce) Create a node edit controller for this node to configure node specific features
CourseNode	createInstanceForCopy() Create an instance for the copy process.
NodeRunConstructionResult	createNodeRunConstructionResult(UserRequest ureq, WindowControl wControl, UserCourseEnvironment userCourseEnv, NodeEvaluation ne, java.lang.String nodecmd) Create a course run controller for this node
Controller	createPreviewController(UserRequest ureq, WindowControl wControl, UserCourseEnvironment userCourseEnv, NodeEvaluation ne) default implementation of the previewController
void	exportNode(java.io.File exportDirectory, ICourse course) Export all node user data to the given directory.
java.lang.Float	getCutValueConfiguration()
Controller	getDetailsEditController(UserRequest ureq, WindowControl wControl, UserCourseEnvironment userCourseEnvironment) Returns a controller to edit the node specific details
java.lang.String	getDetailsListView(UserCourseEnvironment userCourseEnvironment)
java.lang.String	getDetailsListViewHeaderKey()
java.lang.Float	getMaxScoreConfiguration()
java.lang.Float	getMinScoreConfiguration()
RepositoryEntry	getReferencedRepositoryEntry() used by the publish process to ensure the reference counters for a repository entry are correct.
java.lang.Integer	getUserAttempts(UserCourseEnvironment userCourseEnvironment)
java.lang.String	getUserCoachComment(UserCourseEnvironment userCourseEnvironment)
java.lang.String	getUserLog(UserCourseEnvironment userCourseEnvironment)
ScoreEvaluation	getUserScoreEvaluation(UserCourseEnvironment userCourseEnvironment) this method implementation must not cache any results! The user has no scoring results jet (e.g.
java.lang.String	getUserUserComment(UserCourseEnvironment userCourseEnvironment)
boolean	hasAttemptsConfigured()
boolean	hasCommentConfigured()
boolean	hasDetails()
boolean	hasPassedConfigured()
boolean	hasScoreConfigured()
boolean	hasStatusConfigured()
Controller	importNode(java.io.File importDirectory, ICourse course, boolean unattendedImport, UserRequest ureq, WindowControl wControl) Import a course node's data.
void	incrementUserAttempts(UserCourseEnvironment userCourseEnvironment) Increments the users attempts for this node and this user + 1.
java.lang.String	informOnDelete(java.util.Locale locale, ICourse course) Generic interface implementation.
StatusDescription	isConfigValid()
StatusDescription[]	isConfigValid(CourseEditorEnv cev) must be implemented in the concrete subclasses as a translator is needed for the errormessages which comes with evaluating condition expressions
boolean	isEditableConfigured()
boolean	needsReferenceToARepositoryEntry()
void	updateModuleConfigDefaults(boolean isNewNode) Update the module configuration to have all mandatory configuration flags set to usefull default values
void	updateUserAttempts(java.lang.Integer userAttempts, UserCourseEnvironment userCourseEnvironment, Identity coachingIdentity) Updates the users attempts for this node and this user.
void	updateUserCoachComment(java.lang.String coachComment, UserCourseEnvironment userCourseEnvironment) Updates the coach comment for this node and this user.
void	updateUserScoreEvaluation(ScoreEvaluation scoreEvaluation, UserCourseEnvironment userCourseEnvironment, Identity coachingIdentity, boolean incrementAttempts)
void	updateUserUserComment(java.lang.String userComment, UserCourseEnvironment userCourseEnvironment, Identity coachingIdentity) Updates the user comment for this node and this user.

Methods inherited from class org.olat.course.nodes.AbstractAccessableCourseNode

getConditionExpressions, getPreConditionAccess, setPreConditionAccess

Methods inherited from class org.olat.course.nodes.GenericCourseNode

createInstanceForCopy, createPeekViewRunController, eval, explainThisDuringPublish, getDisplayOption, getDisplayOption, getLearningObjectives, getLongTitle, getModuleConfiguration, getNoAccessExplanation, getPreConditionVisibility, getShortName, getShortTitle, getType, setDisplayOption, setLearningObjectives, setLongTitle, setModuleConfiguration, setNoAccessExplanation, setPreConditionVisibility, setShortTitle, setType, toString

Methods inherited from class org.olat.core.util.nodes.GenericNode

addChild, findRoot, getChildAt, getChildCount, getIdent, getParent, getPosition, insert, remove, removeAllChildren, removeFromParent, setIdent, setParent

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.olat.course.nodes.CourseNode

createInstanceForCopy, createPeekViewRunController, eval, explainThisDuringPublish, getConditionExpressions, getDisplayOption, getLearningObjectives, getLongTitle, getModuleConfiguration, getNoAccessExplanation, getPreConditionAccess, getPreConditionVisibility, getShortTitle, getType, setDisplayOption, setIdent, setLearningObjectives, setLongTitle, setNoAccessExplanation, setPreConditionVisibility, setShortTitle

Methods inherited from interface org.olat.core.util.nodes.INode

addChild, getChildAt, getChildCount, getIdent, getParent, getPosition, insert, remove, removeAllChildren, removeFromParent, setParent

Methods inherited from interface org.olat.core.gui.ShortName

getShortName

Constructor Detail

IQTESTCourseNode

public IQTESTCourseNode()

Constructor to create a course node of type IMS QTI.

Method Detail

createEditController

public TabbableController createEditController(UserRequest ureq,
                                               WindowControl wControl,
                                               ICourse course,
                                               UserCourseEnvironment euce)

Description copied from interface: CourseNode

Create a node edit controller for this node to configure node specific features

Specified by:

createEditController in interface CourseNode

Specified by:

createEditController in class AbstractAccessableCourseNode

Parameters:

ureq - The user request

wControl - The current window controller

course - The course

euce - the editor user course environment provides syntax/semantic check methods for conditions

Returns:

A tabbable node edit controller

See Also:

org.olat.course.nodes.CourseNode#createEditController(org.olat.core.gui.UserRequest, org.olat.core.gui.control.WindowControl, org.olat.course.ICourse)

createNodeRunConstructionResult

public NodeRunConstructionResult createNodeRunConstructionResult(UserRequest ureq,
                                                                 WindowControl wControl,
                                                                 UserCourseEnvironment userCourseEnv,
                                                                 NodeEvaluation ne,
                                                                 java.lang.String nodecmd)

Description copied from interface: CourseNode

Create a course run controller for this node

Specified by:

createNodeRunConstructionResult in interface CourseNode

Specified by:

createNodeRunConstructionResult in class AbstractAccessableCourseNode

Parameters:

ureq - The user request

wControl - The current window controller

userCourseEnv - The course environment

ne - The node evaluation

Returns:

The node run controller ATTENTION: udpateModuleConfigDefaults(false) should be called inside from the courseNode.createNodeRunConstructionResult(ureq, bwControl, userCourseEnv, nodeEval, nodecmd) to set the course node specific configuration default values!

See Also:

org.olat.course.nodes.CourseNode#createNodeRunConstructionResult(org.olat.core.gui.UserRequest, org.olat.core.gui.control.WindowControl, org.olat.course.run.userview.UserCourseEnvironment, org.olat.course.run.userview.NodeEvaluation)

createPreviewController

public Controller createPreviewController(UserRequest ureq,
                                          WindowControl wControl,
                                          UserCourseEnvironment userCourseEnv,
                                          NodeEvaluation ne)

Description copied from class: GenericCourseNode

default implementation of the previewController

Specified by:

createPreviewController in interface CourseNode

Overrides:

createPreviewController in class GenericCourseNode

Returns:

Controller

See Also:

CourseNode.createPreviewController(org.olat.core.gui.UserRequest, org.olat.core.gui.control.WindowControl, org.olat.course.run.userview.UserCourseEnvironment, org.olat.course.run.userview.NodeEvaluation)

isConfigValid

public StatusDescription isConfigValid()

Specified by:

isConfigValid in interface CourseNode

Returns:

true if the course node configuration is correct without the course context.

See Also:

CourseNode.isConfigValid()

isConfigValid

public StatusDescription[] isConfigValid(CourseEditorEnv cev)

Description copied from class: GenericCourseNode

must be implemented in the concrete subclasses as a translator is needed for the errormessages which comes with evaluating condition expressions

Specified by:

isConfigValid in interface CourseNode

Specified by:

isConfigValid in class GenericCourseNode

Returns:

true if the course node configuration is valid for itself and also within the specified course environment.

See Also:

org.olat.course.nodes.CourseNode#isConfigValid(org.olat.course.run.userview.UserCourseEnvironment)

getUserScoreEvaluation

public ScoreEvaluation getUserScoreEvaluation(UserCourseEnvironment userCourseEnvironment)

Description copied from interface: AssessableCourseNode

this method implementation must not cache any results! The user has no scoring results jet (e.g. made no test yet), then the ScoreEvaluation.NA has to be returned!

Specified by:

getUserScoreEvaluation in interface AssessableCourseNode

Returns:

null, if this node cannot deliver any useful scoring info (this is not the case for a test never tried or manual scoring: those have default values 0.0f / false for score/passed; currently only the STNode returns null if there are no scoring rules defined.)

See Also:

AssessableCourseNode.getUserScoreEvaluation(org.olat.course.run.userview.UserCourseEnvironment)

getCutValueConfiguration

public java.lang.Float getCutValueConfiguration()

Specified by:

getCutValueConfiguration in interface AssessableCourseNode

Returns:

Returns the passed cut value or null if no such value is defined. A null value means that no cut value is definied and therefor the node can be passed having any score or no score at all. Throws an OLATRuntimeException if hasPassed is set to false, cutValue is undefined in this case

See Also:

AssessableCourseNode.getCutValueConfiguration()

getMaxScoreConfiguration

public java.lang.Float getMaxScoreConfiguration()

Specified by:

getMaxScoreConfiguration in interface AssessableCourseNode

Returns:

Returns the maximal score that can be achieved on this node. Throws an OLATRuntimeException if hasScore set to false, maxScore is undefined in this case

See Also:

AssessableCourseNode.getMaxScoreConfiguration()

getMinScoreConfiguration

public java.lang.Float getMinScoreConfiguration()

Specified by:

getMinScoreConfiguration in interface AssessableCourseNode

Returns:

Returns the minimal score that can be achieved on this node. Throws an OLATRuntimeException if hasScore set to false, maxScore is undefined in this case

See Also:

AssessableCourseNode.getMinScoreConfiguration()

hasCommentConfigured

public boolean hasCommentConfigured()

Specified by:

hasCommentConfigured in interface AssessableCourseNode

Returns:

True if this course node produces a comment variable for the learner

See Also:

AssessableCourseNode.hasCommentConfigured()

hasPassedConfigured

public boolean hasPassedConfigured()

Specified by:

hasPassedConfigured in interface AssessableCourseNode

Returns:

True if this course node produces a passed variable for the learner

See Also:

AssessableCourseNode.hasPassedConfigured()

hasScoreConfigured

public boolean hasScoreConfigured()

Specified by:

hasScoreConfigured in interface AssessableCourseNode

Returns:

True if this course node produces a score variable for the learner

See Also:

AssessableCourseNode.hasScoreConfigured()

hasStatusConfigured

public boolean hasStatusConfigured()

Specified by:

hasStatusConfigured in interface AssessableCourseNode

Returns:

True if this course node produces an status variable for the learner

See Also:

AssessableCourseNode.hasStatusConfigured()

isEditableConfigured

public boolean isEditableConfigured()

Specified by:

isEditableConfigured in interface AssessableCourseNode

Returns:

True if score, passed, attempts and comment are editable by the assessment tool

See Also:

AssessableCourseNode.isEditableConfigured()

updateUserCoachComment

public void updateUserCoachComment(java.lang.String coachComment,
                                   UserCourseEnvironment userCourseEnvironment)

Description copied from interface: AssessableCourseNode

Updates the coach comment for this node and this user. This comment is not visible to the user.

Specified by:

updateUserCoachComment in interface AssessableCourseNode

See Also:

AssessableCourseNode.updateUserCoachComment(java.lang.String, org.olat.course.run.userview.UserCourseEnvironment)

updateUserScoreEvaluation

public void updateUserScoreEvaluation(ScoreEvaluation scoreEvaluation,
                                      UserCourseEnvironment userCourseEnvironment,
                                      Identity coachingIdentity,
                                      boolean incrementAttempts)

Specified by:

updateUserScoreEvaluation in interface AssessableCourseNode

Parameters:

scoreEvaluation - if scoreEvaluation.getScore() != null, then the score will be updated, and/or if scoreEvaluation.getPassed() != null, then 'passed' will be updated

See Also:

org.olat.course.nodes.AssessableCourseNode#updateUserScoreEvaluation(org.olat.course.run.scoring.ScoreEvaluation, org.olat.course.run.userview.UserCourseEnvironment, org.olat.core.id.Identity)

updateUserUserComment

public void updateUserUserComment(java.lang.String userComment,
                                  UserCourseEnvironment userCourseEnvironment,
                                  Identity coachingIdentity)

Description copied from interface: AssessableCourseNode

Updates the user comment for this node and this user. This comment is visible to the user.

Specified by:

updateUserUserComment in interface AssessableCourseNode

See Also:

AssessableCourseNode.updateUserUserComment(java.lang.String, org.olat.course.run.userview.UserCourseEnvironment, org.olat.core.id.Identity)

getUserCoachComment

public java.lang.String getUserCoachComment(UserCourseEnvironment userCourseEnvironment)

Specified by:

getUserCoachComment in interface AssessableCourseNode

Returns:

The coach comment for this user for this node (not visible to user)

See Also:

AssessableCourseNode.getUserCoachComment(org.olat.course.run.userview.UserCourseEnvironment)

getUserUserComment

public java.lang.String getUserUserComment(UserCourseEnvironment userCourseEnvironment)

Specified by:

getUserUserComment in interface AssessableCourseNode

Returns:

the user comment for this user for this node, given by coach

See Also:

AssessableCourseNode.getUserUserComment(org.olat.course.run.userview.UserCourseEnvironment)

getUserLog

public java.lang.String getUserLog(UserCourseEnvironment userCourseEnvironment)

Specified by:

getUserLog in interface AssessableCourseNode

Returns:

the users log of this node

See Also:

AssessableCourseNode.getUserLog(org.olat.course.run.userview.UserCourseEnvironment)

getReferencedRepositoryEntry

public RepositoryEntry getReferencedRepositoryEntry()

Description copied from interface: CourseNode

used by the publish process to ensure the reference counters for a repository entry are correct. (you can only delete Repositoryentries if there are no references to it) returns exception when called even !needsReferenceToARespositoryEntry return the referenced RepositoryEntry if it can be found return null if the referenced RepositoryEntry could not be found

Specified by:

getReferencedRepositoryEntry in interface CourseNode

Returns:

the RepositoryEntry (if it still exists in the repository) which is referenced in this course node if there is a reference, or null otherwise

See Also:

CourseNode.getReferencedRepositoryEntry()

needsReferenceToARepositoryEntry

public boolean needsReferenceToARepositoryEntry()

Specified by:

needsReferenceToARepositoryEntry in interface CourseNode

Returns:

true if this node type potentially has a repository entry reference, false otherwhise. Attention: this method does not test if ther is actually such a reference. Use getReferencedRepository() to get this information.

See Also:

CourseNode.needsReferenceToARepositoryEntry()

informOnDelete

public java.lang.String informOnDelete(java.util.Locale locale,
                                       ICourse course)

Description copied from class: GenericCourseNode

Generic interface implementation. May be overriden by specific node's implementation.

Specified by:

informOnDelete in interface CourseNode

Overrides:

informOnDelete in class GenericCourseNode

course - The course

Returns:

The dialogue message if any data will be deleted in the next step

See Also:

org.olat.course.nodes.CourseNode#informOnDelete(org.olat.core.gui.UserRequest, org.olat.course.ICourse)

cleanupOnDelete

public void cleanupOnDelete(ICourse course)

Description copied from class: GenericCourseNode

Generic interface implementation. May be overriden by specific node's implementation.

Specified by:

cleanupOnDelete in interface CourseNode

Overrides:

cleanupOnDelete in class GenericCourseNode

Parameters:

course - The course

See Also:

CourseNode.cleanupOnDelete(org.olat.course.ICourse)

archiveNodeData

public void archiveNodeData(java.util.Locale locale,
                            ICourse course,
                            java.io.File exportDirectory,
                            java.lang.String charset)

Override default implementation

Specified by:

archiveNodeData in interface CourseNode

Overrides:

archiveNodeData in class GenericCourseNode

Parameters:

locale - The users locale

course - The course

exportDirectory - The directory where the exported files should be put. This directory must exist prior to calling this method.

See Also:

org.olat.course.nodes.CourseNode#archiveNodeData(java.util.Locale, org.olat.course.ICourse, java.io.File)

exportNode

public void exportNode(java.io.File exportDirectory,
                       ICourse course)

Description copied from interface: CourseNode

Export all node user data to the given directory. This might be one file or multiple files depending on what data is available. The archived data is intendet to be imported again if the course this node is attached to gets imported.

Specified by:

exportNode in interface CourseNode

Overrides:

exportNode in class GenericCourseNode

Parameters:

exportDirectory - The directory where the exported files should be put. This directory must exist prior to calling this method.

See Also:

CourseNode.exportNode(java.io.File, org.olat.course.ICourse)

importNode

public Controller importNode(java.io.File importDirectory,
                             ICourse course,
                             boolean unattendedImport,
                             UserRequest ureq,
                             WindowControl wControl)

Description copied from interface: CourseNode

Import a course node's data. The import directory is the root of the directory with all the data that the node has written previousely during the export. The node can provide a Controller if any user intervention is needed. The controller should send a Event.DONE_EVENT after finishing the user driven import. If no user driven import is necessary, just return null right away after finishing all importing tasks.

Specified by:

importNode in interface CourseNode

Overrides:

importNode in class GenericCourseNode

Returns:

Controller for user driven import, or null after all import tasks have finished.

See Also:

org.olat.course.nodes.CourseNode#importNode(java.io.File, org.olat.course.ICourse, org.olat.core.gui.UserRequest, org.olat.core.gui.control.WindowControl)

getUserAttempts

public java.lang.Integer getUserAttempts(UserCourseEnvironment userCourseEnvironment)

Specified by:

getUserAttempts in interface AssessableCourseNode

Returns:

the users attempts of this node

See Also:

AssessableCourseNode.getUserAttempts(org.olat.course.run.userview.UserCourseEnvironment)

hasAttemptsConfigured

public boolean hasAttemptsConfigured()

Specified by:

hasAttemptsConfigured in interface AssessableCourseNode

Returns:

True if this course node produces an attempts variable for the learner

See Also:

AssessableCourseNode.hasAttemptsConfigured()

updateUserAttempts

public void updateUserAttempts(java.lang.Integer userAttempts,
                               UserCourseEnvironment userCourseEnvironment,
                               Identity coachingIdentity)

Description copied from interface: AssessableCourseNode

Updates the users attempts for this node and this user.

Specified by:

updateUserAttempts in interface AssessableCourseNode

See Also:

AssessableCourseNode.updateUserAttempts(java.lang.Integer, org.olat.course.run.userview.UserCourseEnvironment, org.olat.core.id.Identity)

incrementUserAttempts

public void incrementUserAttempts(UserCourseEnvironment userCourseEnvironment)

Description copied from interface: AssessableCourseNode

Increments the users attempts for this node and this user + 1.

Specified by:

incrementUserAttempts in interface AssessableCourseNode

See Also:

AssessableCourseNode.incrementUserAttempts(org.olat.course.run.userview.UserCourseEnvironment)

getDetailsEditController

public Controller getDetailsEditController(UserRequest ureq,
                                           WindowControl wControl,
                                           UserCourseEnvironment userCourseEnvironment)

Description copied from interface: AssessableCourseNode

Returns a controller to edit the node specific details

Specified by:

getDetailsEditController in interface AssessableCourseNode

Returns:

a controller or null if hasDetails=false

See Also:

AssessableCourseNode.getDetailsEditController(org.olat.core.gui.UserRequest, org.olat.core.gui.control.WindowControl, org.olat.course.run.userview.UserCourseEnvironment)

getDetailsListView

public java.lang.String getDetailsListView(UserCourseEnvironment userCourseEnvironment)

Specified by:

getDetailsListView in interface AssessableCourseNode

Returns:

the details view for this node and this user. will be displayed in the user list. if hasDetails= false this returns null

See Also:

AssessableCourseNode.getDetailsListView(org.olat.course.run.userview.UserCourseEnvironment)

getDetailsListViewHeaderKey

public java.lang.String getDetailsListViewHeaderKey()

Specified by:

getDetailsListViewHeaderKey in interface AssessableCourseNode

Returns:

the details list view header key that is used to label the table row

See Also:

AssessableCourseNode.getDetailsListViewHeaderKey()

hasDetails

public boolean hasDetails()

Specified by:

hasDetails in interface AssessableCourseNode

Returns:

True if this course node has additional details to be edited / viewed

See Also:

AssessableCourseNode.hasDetails()

createInstanceForCopy

public CourseNode createInstanceForCopy()

Description copied from interface: CourseNode

Create an instance for the copy process. The copy must have a different unique ID and may take some of the configuration values configured for this node.

Specified by:

createInstanceForCopy in interface CourseNode

Overrides:

createInstanceForCopy in class AbstractAccessableCourseNode

Returns:

See Also:

CourseNode.createInstanceForCopy()

updateModuleConfigDefaults

public void updateModuleConfigDefaults(boolean isNewNode)

Update the module configuration to have all mandatory configuration flags set to usefull default values

Specified by:

updateModuleConfigDefaults in interface CourseNode

Overrides:

updateModuleConfigDefaults in class GenericCourseNode

Parameters:

isNewNode - true: an initial configuration is set; false: upgrading from previous node configuration version, set default to maintain previous behaviour