Interface AssessmentOffered

All Superinterfaces:
Browsable, Extensible, Identifiable, OsidObject, Subjugateable

public interface AssessmentOffered extends OsidObject, Subjugateable

An AssessmentOffered represents a sequence of assessment items. Like all OSID objects, an AssessmentOffered is identified by its Id and any persisted references should use the Id.

  • Method Details

    • getAssessmentId

      Id getAssessmentId()
      Gets the assessment Id corresponding to this assessment offering.
      Returns:
      the assessment id
      Compliance:
      mandatory - This method must be implemented.
    • getAssessment

      Assessment getAssessment() throws OperationFailedException
      Gets the assessment corresponding to this assessment offereng.
      Returns:
      the assessment
      Throws:
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • getLevelId

      Id getLevelId()
      Gets the Id of a Grade corresponding to the assessment difficulty.
      Returns:
      a grade id
      Compliance:
      mandatory - This method must be implemented.
    • getLevel

      Grade getLevel() throws OperationFailedException
      Gets the Grade corresponding to the assessment difficulty.
      Returns:
      the level
      Throws:
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • areItemsSequential

      boolean areItemsSequential()
      Tests if the items or parts in this assessment 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.
    • hasStartTime

      boolean hasStartTime()
      Tests if there is a fixed start time for this assessment.
      Returns:
      true if there is a fixed start time, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getStartTime

      DateTime getStartTime()
      Gets the start time for this assessment.
      Returns:
      the designated start time
      Throws:
      IllegalStateException - hasStartTime() is false
      Compliance:
      mandatory - This method must be implemented.
    • hasDeadline

      boolean hasDeadline()
      Tests if there is a fixed end time for this assessment.
      Returns:
      true if there is a fixed end time, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getDeadline

      DateTime getDeadline()
      Gets the end time for this assessment.
      Returns:
      the designated end time
      Throws:
      IllegalStateException - hasDeadline() is false
      Compliance:
      mandatory - This method must be implemented.
    • hasDuration

      boolean hasDuration()
      Tests if there is a fixed duration for this assessment.
      Returns:
      true if there is a fixed duration, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getDuration

      Duration getDuration()
      Gets the duration for this assessment.
      Returns:
      the duration
      Throws:
      IllegalStateException - hasDuration() is false
      Compliance:
      mandatory - This method must be implemented.
    • isScored

      boolean isScored()
      Tests if this assessment will be scored.
      Returns:
      true if this assessment will be scored false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getScoreSystemId

      Id getScoreSystemId()
      Gets the grade system Id for the score.
      Returns:
      the grade system Id
      Throws:
      IllegalStateException - isScored() is false
      Compliance:
      mandatory - This method must be implemented.
    • getScoreSystem

      GradeSystem getScoreSystem() throws OperationFailedException
      Gets the grade system for the score.
      Returns:
      the grade system
      Throws:
      IllegalStateException - isScored() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • isGraded

      boolean isGraded()
      Tests if this assessment will be graded.
      Returns:
      true if this assessment will be graded, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getGradeSystemId

      Id getGradeSystemId()
      Gets the grade system Id for the grade.
      Returns:
      the grade system Id
      Throws:
      IllegalStateException - isGraded() is false
      Compliance:
      mandatory - This method must be implemented.
    • getGradeSystem

      GradeSystem getGradeSystem() throws OperationFailedException
      Gets the grade system for the grade.
      Returns:
      the grade system
      Throws:
      IllegalStateException - isGraded() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • hasRubric

      boolean hasRubric()
      Tests if a rubric assessment is associated with this assessment.
      Returns:
      true if a rubric is available, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getRubricId

      Id getRubricId()
      Gets the Id of the rubric.
      Returns:
      an assessment offered Id
      Throws:
      IllegalStateException - hasRubric() is false
      Compliance:
      mandatory - This method must be implemented.
    • getRubric

      Gets the rubric.
      Returns:
      the assessment offered
      Throws:
      IllegalStateException - hasRubric() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • getAssessmentOfferedRecord

      AssessmentOfferedRecord getAssessmentOfferedRecord(Type assessmentTakenRecordType) throws OperationFailedException
      Gets the assessment offered record corresponding to the given AssessmentOffered record Type. This method is used to retrieve an object implementing the requested record. The assessmentOfferedRecordType may be the Type returned in getRecordTypes() or any of its parents in a Type hierarchy where hasRecordType(assessmentOfferedRecordType) is true.
      Parameters:
      assessmentTakenRecordType - an 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.