org.osid.assessment

Interface AssessmentOfferedForm

All Superinterfaces:

Extensible, Identifiable, OsidBrowsableForm, OsidExtensibleForm, OsidForm, OsidIdentifiableForm, OsidObjectForm, OsidSubjugateableForm, Suppliable

All Known Subinterfaces:

AssessmentOfferedBatchForm

public interface AssessmentOfferedForm
extends OsidObjectForm, OsidSubjugateableForm

This is the form for creating and updating an AssessmentOffered. Like all OsidForm objects, various data elements may be set here for use in the create and update methods in the AssessmentOfferedAdminSession. For each data element that may be set, metadata may be examined to provide display hints or data constraints.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearDeadline() Clears the deadline.
void	clearDuration() Clears the duration.
void	clearGradeSystem() Clears the grading system.
void	clearItemsSequential() Clears the items sequential flag.
void	clearItemsShuffled() Clears the shuffle flag.
void	clearLevel() Clears the level.
void	clearScoreSystem() Clears the score system.
void	clearStartTime() Clears the start time.
AssessmentOfferedFormRecord	getAssessmentOfferedFormRecord(Type assessmentOfferedRecordType) Gets the AssessmentOfferedFormRecord corresponding to the given assessment record Type.
Metadata	getDeadlineMetadata() Gets the metadata for the assessment deadline.
Metadata	getDurationMetadata() Gets the metadata for the assessment duration
Metadata	getGradeSystemMetadata() Gets the metadata for a grading system.
Metadata	getItemsSequentialMetadata() Gets the metadata for sequential operation.
Metadata	getItemsShuffledMetadata() Gets the metadata for shuffling items.
Metadata	getLevelMetadata() Gets the metadata for a grade level.
Metadata	getScoreSystemMetadata() Gets the metadata for a score system.
Metadata	getStartTimeMetadata() Gets the metadata for the assessment start time.
void	setDeadline(java.util.Date end) Sets the assessment end time.
void	setDuration(Duration duration) Sets the assessment duration.
void	setGradeSystem(Id gradeSystemId) Sets the grading system.
void	setItemsSequential(boolean sequential) Sets the items sequential flag.
void	setItemsShuffled(boolean shuffle) Sets the shuffle flag.
void	setLevel(Id gradeId) Sets the level of difficulty expressed as a Grade.
void	setScoreSystem(Id gradeSystemId) Sets the scoring system.
void	setStartTime(DateTime start) Sets the assessment start time.

Methods inherited from interface org.osid.OsidObjectForm

clearDescription, clearDisplayName, clearGenusType, getDescriptionMetadata, getDisplayNameMetadata, getGenusTypeMetadata, setDescription, setDisplayName, setGenusType

Methods inherited from interface org.osid.OsidExtensibleForm

getRequiredRecordTypes

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Methods inherited from interface org.osid.OsidForm

getDefaultLocale, getInvalidMetadata, getJournalCommentMetadata, getLocales, getValidationMessages, isForUpdate, isValid, setJournalComment, setLocale

Methods inherited from interface org.osid.Identifiable

getId, isCurrent

Method Detail

getLevelMetadata

Metadata getLevelMetadata()

Gets the metadata for a grade level.

Returns:

metadata for the grade level

Compliance:

mandatory - This method must be implemented.

setLevel

void setLevel(Id gradeId)

Sets the level of difficulty expressed as a Grade.

Parameters:

gradeId - the grade level

Throws:

InvalidArgumentException - gradeId is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearLevel

void clearLevel()

Clears the level.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getItemsSequentialMetadata

Metadata getItemsSequentialMetadata()

Gets the metadata for sequential operation.

Returns:

metadata for the sequential flag

Compliance:

mandatory - This method must be implemented.

setItemsSequential

void setItemsSequential(boolean sequential)

Sets the items sequential flag.

Parameters:

sequential - true if the items are taken sequentially, false if the items can be skipped and revisited

Throws:

InvalidArgumentException - sequential is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearItemsSequential

void clearItemsSequential()

Clears the items sequential flag.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getItemsShuffledMetadata

Metadata getItemsShuffledMetadata()

Gets the metadata for shuffling items.

Returns:

metadata for the shuffled flag

Compliance:

mandatory - This method must be implemented.

setItemsShuffled

void setItemsShuffled(boolean shuffle)

Sets the shuffle flag. The shuffle flag may be overidden by other assessment sequencing rules.

Parameters:

shuffle - true if the items are shuffled, false if the items appear in the designated order

Throws:

InvalidArgumentException - shuffle is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearItemsShuffled

void clearItemsShuffled()

Clears the shuffle flag.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getStartTimeMetadata

Metadata getStartTimeMetadata()

Gets the metadata for the assessment start time.

Returns:

metadata for the start time

Compliance:

mandatory - This method must be implemented.

setStartTime

void setStartTime(DateTime start)

Sets the assessment start time.

Parameters:

start - assessment start time

Throws:

InvalidArgumentException - start is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearStartTime

void clearStartTime()

Clears the start time.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getDeadlineMetadata

Metadata getDeadlineMetadata()

Gets the metadata for the assessment deadline.

Returns:

metadata for the end time

Compliance:

mandatory - This method must be implemented.

setDeadline

void setDeadline(java.util.Date end)

Sets the assessment end time.

Parameters:

end - assessment end time

Throws:

InvalidArgumentException - end is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearDeadline

void clearDeadline()

Clears the deadline.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getDurationMetadata

Metadata getDurationMetadata()

Gets the metadata for the assessment duration

Returns:

metadata for the duration

Compliance:

mandatory - This method must be implemented.

setDuration

void setDuration(Duration duration)

Sets the assessment duration.

Parameters:

duration - assessment duration

Throws:

InvalidArgumentException - duration is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearDuration

void clearDuration()

Clears the duration.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getScoreSystemMetadata

Metadata getScoreSystemMetadata()

Gets the metadata for a score system.

Returns:

metadata for the grade system

Compliance:

mandatory - This method must be implemented.

setScoreSystem

void setScoreSystem(Id gradeSystemId)

Sets the scoring system.

Parameters:

gradeSystemId - the grade system

Throws:

InvalidArgumentException - gradeSystemId is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearScoreSystem

void clearScoreSystem()

Clears the score system.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getGradeSystemMetadata

Metadata getGradeSystemMetadata()

Gets the metadata for a grading system.

Returns:

metadata for the grade system

Compliance:

mandatory - This method must be implemented.

setGradeSystem

void setGradeSystem(Id gradeSystemId)

Sets the grading system.

Parameters:

gradeSystemId - the grade system

Throws:

InvalidArgumentException - gradeSystemId is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearGradeSystem

void clearGradeSystem()

Clears the grading system.

Throws:

NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getAssessmentOfferedFormRecord

AssessmentOfferedFormRecord getAssessmentOfferedFormRecord(Type assessmentOfferedRecordType)
                                                           throws OperationFailedException

Gets the AssessmentOfferedFormRecord corresponding to the given assessment record Type.

Parameters:

assessmentOfferedRecordType - the assessment offered record type

Returns:

the assessment offered record

Throws:

NullArgumentException - assessmentOfferedRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(assessmentOfferedRecordType) is false

Compliance:

mandatory - This method must be implemented.