org.osid.assessment

Interface AssessmentSection

All Superinterfaces:

Browsable, Extensible, Identifiable, OsidObject

public interface AssessmentSection
extends OsidObject

Represents an assessment section. An assessment section represents a cluster of questions used to organize the execution of an assessment. The section is the student aspect of an assessment part.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	areItemsSequential() Tests if the items or parts in this section are taken sequentially.
boolean	areItemsShuffled() Tests if the items or parts appear in a random order.
Duration	getAllocatedTime() Gets the allocated time for this section.
AssessmentSectionRecord	getAssessmentSectionRecord(Type assessmentSectionRecordType) Gets the assessment section record corresponding to the given AssessmentSection record Type.
boolean	hasAllocatedTime() Tests if this section must be completed within an allocated time.

Methods inherited from interface org.osid.OsidObject

getDescription, getDisplayName, getGenusType, isOfGenusType

Methods inherited from interface org.osid.Identifiable

getId, isCurrent

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Methods inherited from interface org.osid.Browsable

getProperties, getPropertiesByRecordType

Method Detail

hasAllocatedTime

boolean hasAllocatedTime()

Tests if this section must be completed within an allocated time.

Returns:

true if this section has an allocated time, false otherwise

Compliance:

mandatory - This method must be implemented.

getAllocatedTime

Duration getAllocatedTime()

Gets the allocated time for this section.

Returns:

allocated time

Throws:

IllegalStateException - hasAllocatedTime() is false

Compliance:

mandatory - This method must be implemented.

areItemsSequential

boolean areItemsSequential()

Tests if the items or parts in this section are taken sequentially.

Returns:

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

Compliance:

mandatory - This method must be implemented.

areItemsShuffled

boolean areItemsShuffled()

Tests if the items or parts appear in a random order.

Returns:

true if the items appear in a random order, false otherwise

Compliance:

mandatory - This method must be implemented.

getAssessmentSectionRecord

AssessmentSectionRecord getAssessmentSectionRecord(Type assessmentSectionRecordType)
                                                   throws OperationFailedException

Gets the assessment section record corresponding to the given AssessmentSection record Type. This method is used to retrieve an object implementing the requested record. The assessmentSectionRecordType may be the Type returned in getRecordTypes() or any of its parents in a Type hierarchy where hasRecordType(assessmentSectionRecordType) is true .

Parameters:

assessmentSectionRecordType - an assessment section record type

Returns:

the assessment section record

Throws:

NullArgumentException - assessmentSectionRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(assessmentSectionRecordType) is false

Compliance:

mandatory - This method must be implemented.