Interface CourseRequirementForm

All Superinterfaces:
Extensible, Identifiable, OsidAggregateableForm, OsidBrowsableForm, OsidExtensibleForm, OsidForm, OsidIdentifiableForm, OsidObjectForm, OsidOperableForm, OsidRuleForm, Suppliable

public interface CourseRequirementForm extends OsidRuleForm, OsidAggregateableForm

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

  • Method Details

    • getCoursesMetadata

      Metadata getCoursesMetadata()
      Gets the metadata for the courses.
      Returns:
      metadata for the courses
      Compliance:
      mandatory - This method must be implemented.
    • setCourses

      void setCourses(Id[] courseIds)
      Sets the courses.
      Parameters:
      courseIds - the new courses
      Throws:
      InvalidArgumentException - courseIds is invalid
      NoAccessException - Metadata.isReadOnly() is true
      NullArgumentException - courseIds is null
      Compliance:
      mandatory - This method must be implemented.
    • clearCourses

      void clearCourses()
      Removes the courses.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getRequiresSubjectAreaMetadata

      Metadata getRequiresSubjectAreaMetadata()
      Gets the metadata for the requires subject area flag.
      Returns:
      metadata for the requires subject area flag
      Compliance:
      mandatory - This method must be implemented.
    • setRequiresSubjectArea

      void setRequiresSubjectArea(boolean requiresSubjectArea)
      Sets the requires subject area flag.
      Parameters:
      requiresSubjectArea - the new requires subject area flag
      Throws:
      InvalidArgumentException - requiresSubjectArea is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearRequiresSubjectArea

      void clearRequiresSubjectArea()
      Clears the requires subject area flag.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getSubjectAreaMetadata

      Metadata getSubjectAreaMetadata()
      Gets the metadata for the subject area.
      Returns:
      metadata for the subject area
      Compliance:
      mandatory - This method must be implemented.
    • setSubjectArea

      void setSubjectArea(Id subjectAreaId)
      Sets the subject area.
      Parameters:
      subjectAreaId - the new subject area
      Throws:
      InvalidArgumentException - subjectAreaId is invalid
      NoAccessException - Metadata.isReadOnly() is true
      NullArgumentException - subjectAreaId is null
      Compliance:
      mandatory - This method must be implemented.
    • clearSubjectArea

      void clearSubjectArea()
      Clears the subject area.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getIncludeEquivalentUnitsMetadata

      Metadata getIncludeEquivalentUnitsMetadata()
      Gets the metadata for the include equivalent units flag.
      Returns:
      metadata for the include equivalent units flag
      Compliance:
      mandatory - This method must be implemented.
    • setIncludeEquivalentUnits

      void setIncludeEquivalentUnits(boolean includeEquivalentUnits)
      Sets the include equivalent units flag.
      Parameters:
      includeEquivalentUnits - the new include equivalent units flag
      Throws:
      InvalidArgumentException - includeEquivalentUnits is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearIncludeEquivalentUnits

      void clearIncludeEquivalentUnits()
      Clears the include equivalent units flag.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getMinimumNumberMetadata

      Metadata getMinimumNumberMetadata()
      Gets the metadata for the minimum number of courses.
      Returns:
      metadata for the minimum number
      Compliance:
      mandatory - This method must be implemented.
    • setMinimumNumber

      void setMinimumNumber(long number)
      Sets the minimum number of courses to complete from the set.
      Parameters:
      number - the new minimum number
      Throws:
      InvalidArgumentException - number is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearMinimumNumber

      void clearMinimumNumber()
      Clears the minimum number of courses.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getMinimumNonTransferNumberMetadata

      Metadata getMinimumNonTransferNumberMetadata()
      Gets the metadata for the minimum number of non-transfer courses.
      Returns:
      metadata for the minimum non-transfer number
      Compliance:
      mandatory - This method must be implemented.
    • setMinimumNonTransferNumber

      void setMinimumNonTransferNumber(long number)
      Sets the minimum number of non-transfer courses to complete from the set.
      Parameters:
      number - the new minimum non-transfer number
      Throws:
      InvalidArgumentException - number is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearMinimumNonTransferNumber

      void clearMinimumNonTransferNumber()
      Clears the minimum non-transfer number of courses.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getTargetSetNumberMetadata

      Metadata getTargetSetNumberMetadata()
      Gets the metadata for the target number of courses in the set.
      Returns:
      metadata for the target set number
      Compliance:
      mandatory - This method must be implemented.
    • setTargetSetNumber

      void setTargetSetNumber(long number)
      Sets the target number of courses in the set.
      Parameters:
      number - the new target set number
      Throws:
      InvalidArgumentException - number is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearTargetSetNumber

      void clearTargetSetNumber()
      Clears the target set number.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getMinimumCreditsMetadata

      Metadata getMinimumCreditsMetadata()
      Gets the metadata for the minimum credits.
      Returns:
      metadata for the minimum credits
      Compliance:
      mandatory - This method must be implemented.
    • setMinimumCredits

      void setMinimumCredits(BigDecimal credits)
      Sets the minimum credits.
      Parameters:
      credits - the new minimum credits
      Throws:
      InvalidArgumentException - credits is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearMinimumCredits

      void clearMinimumCredits()
      Clears the minimum credits.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getCreditScaleMetadata

      Metadata getCreditScaleMetadata()
      Gets the metadata for the credit scale.
      Returns:
      metadata for the credit scale
      Compliance:
      mandatory - This method must be implemented.
    • setCreditScale

      void setCreditScale(Id gradeSystemId)
      Sets the credit scale.
      Parameters:
      gradeSystemId - the new credit scale
      Throws:
      InvalidArgumentException - gradeSystemId is invalid
      NoAccessException - Metadata.isReadOnly() is true
      NullArgumentException - gradeSystemId is null
      Compliance:
      mandatory - This method must be implemented.
    • clearCreditScale

      void clearCreditScale()
      Clears the credit scale.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getNonTransferCreditsMetadata

      Metadata getNonTransferCreditsMetadata()
      Gets the metadata for the minimum non-transfer credits.
      Returns:
      metadata for the non-transfer credits
      Compliance:
      mandatory - This method must be implemented.
    • setNonTransferCredits

      void setNonTransferCredits(BigDecimal credits)
      Sets the minimum non-transfer credits.
      Parameters:
      credits - the new minimum non-transfer credits
      Throws:
      InvalidArgumentException - credits is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearNonTransferCredits

      void clearNonTransferCredits()
      Clears the non-transfer credits.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getTargetSetCreditsMetadata

      Metadata getTargetSetCreditsMetadata()
      Gets the metadata for the target credits in the set.
      Returns:
      metadata for the target set credits
      Compliance:
      mandatory - This method must be implemented.
    • setTargetSetCredits

      void setTargetSetCredits(BigDecimal credits)
      Sets the target credits in the set.
      Parameters:
      credits - the new target set credits
      Throws:
      InvalidArgumentException - credits is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearTargetSetCredits

      void clearTargetSetCredits()
      Clears the target set credits.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getRequiresCompletionMetadata

      Metadata getRequiresCompletionMetadata()
      Gets the metadata for the requires completion flag.
      Returns:
      metadata for the requires completion flag
      Compliance:
      mandatory - This method must be implemented.
    • setRequiresCompletion

      void setRequiresCompletion(boolean completion)
      Sets the requires completion flag.
      Parameters:
      completion - the new requires completion flag
      Throws:
      InvalidArgumentException - completion is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearRequiresCompletion

      void clearRequiresCompletion()
      Clears the requires completion flag.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getTimeframeMetadata

      Metadata getTimeframeMetadata()
      Gets the metadata for the timeframe.
      Returns:
      metadata for the timeframe
      Compliance:
      mandatory - This method must be implemented.
    • setTimeframe

      void setTimeframe(Duration duration)
      Sets the timeframe.
      Parameters:
      duration - the new duration
      Throws:
      InvalidArgumentException - duration is invalid
      NoAccessException - Metadata.isReadOnly() is true
      NullArgumentException - duration is null
      Compliance:
      mandatory - This method must be implemented.
    • clearTimeframe

      void clearTimeframe()
      Clears the timeframe.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getMinimumGradeMetadata

      Metadata getMinimumGradeMetadata()
      Gets the metadata for the minimum grade.
      Returns:
      metadata for the minimum grade
      Compliance:
      mandatory - This method must be implemented.
    • setMinimumGrade

      void setMinimumGrade(Id gradeId)
      Sets the minimum grade.
      Parameters:
      gradeId - the new grade
      Throws:
      InvalidArgumentException - gradeId is invalid
      NoAccessException - Metadata.isReadOnly() is true
      NullArgumentException - gradeId is null
      Compliance:
      mandatory - This method must be implemented.
    • clearMinimumGrade

      void clearMinimumGrade()
      Clears the minimum grade.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getMinimumScoreSystemMetadata

      Metadata getMinimumScoreSystemMetadata()
      Gets the metadata for the minimum score system.
      Returns:
      metadata for the minimum score system
      Compliance:
      mandatory - This method must be implemented.
    • setMinimumScoreSystem

      void setMinimumScoreSystem(Id gradeSystemId)
      Sets the minimum score system.
      Parameters:
      gradeSystemId - the new grade system
      Throws:
      InvalidArgumentException - gradeSystemId is invalid
      NoAccessException - Metadata.isReadOnly() is true
      NullArgumentException - gradeSystemId is null
      Compliance:
      mandatory - This method must be implemented.
    • clearMinimumScoreSystem

      void clearMinimumScoreSystem()
      Clears the minimum score system.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getMinimumScoreMetadata

      Metadata getMinimumScoreMetadata()
      Gets the metadata for the minimum score.
      Returns:
      metadata for the minimum score
      Compliance:
      mandatory - This method must be implemented.
    • setMinimumScore

      void setMinimumScore(BigDecimal score)
      Sets the minimum score.
      Parameters:
      score - the new minimum score
      Throws:
      InvalidArgumentException - score is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearMinimumScore

      void clearMinimumScore()
      Clears the minimum score.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getMinimumEarnedCreditsMetadata

      Metadata getMinimumEarnedCreditsMetadata()
      Gets the metadata for the minimum earned credits
      Returns:
      metadata for the minimum earned credits
      Compliance:
      mandatory - This method must be implemented.
    • setMinimumEarnedCredits

      void setMinimumEarnedCredits(BigDecimal credits)
      Sets the minimum earned credits.
      Parameters:
      credits - the new minimum earned credits
      Throws:
      InvalidArgumentException - credits is invalid
      NoAccessException - Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • clearMinimumEarnedCredits

      void clearMinimumEarnedCredits()
      Clears the minimum earned credits.
      Throws:
      NoAccessException - Metadata.isRequired() or Metadata.isReadOnly() is true
      Compliance:
      mandatory - This method must be implemented.
    • getCourseRequirementFormRecord

      CourseRequirementFormRecord getCourseRequirementFormRecord(Type courseRequirementRecordType) throws OperationFailedException
      Gets the CourseRequirementFormRecord corresponding to the given course requirement record Type.
      Parameters:
      courseRequirementRecordType - a course requirement record type
      Returns:
      the course requirement form record
      Throws:
      NullArgumentException - courseRequirementRecordType is null
      OperationFailedException - unable to complete request
      UnsupportedException - hasRecordType(courseRequirementRecordType) is false
      Compliance:
      mandatory - This method must be implemented.