Interface CredentialEntry

All Superinterfaces:
Browsable, Extensible, Identifiable, OsidObject, OsidRelationship, Temporal

public interface CredentialEntry extends OsidRelationship

A CredentialEntry represents an academic record entry for a credential.

  • Method Details

    • getStudentId

      Id getStudentId()
      Gets the Id of the Student.
      Returns:
      the student Id
      Compliance:
      mandatory - This method must be implemented.
    • getStudent

      Resource getStudent() throws OperationFailedException
      Gets the Student.
      Returns:
      the student
      Throws:
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • getCredentialId

      Id getCredentialId()
      Gets the Id of the Credential.
      Returns:
      the credential Id
      Compliance:
      mandatory - This method must be implemented.
    • getCredential

      Credential getCredential() throws OperationFailedException
      Gets the Credential.
      Returns:
      the credential
      Throws:
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • isMatriculationKnown

      boolean isMatriculationKnown()
      Tests if the matriculation status for this credential entry is known.
      Returns:
      true if the matriculation status is known, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getStartDate

      DateTime getStartDate()
      Gets the start date of the matriculation.
      Specified by:
      getStartDate in interface Temporal
      Returns:
      the start date
      Throws:
      IllegalStateException - isMatriculationKnown() is false
      Compliance:
      mandatory - This method must be implemented.
    • getStartTermId

      Id getStartTermId()
      Gets the Id of the start Term.
      Returns:
      the start term Id
      Throws:
      IllegalStateException - isMatriculationKnown() is false
      Compliance:
      mandatory - This method must be implemented.
    • getStartTerm

      Term getStartTerm() throws OperationFailedException
      Gets the start Term.
      Returns:
      the start term
      Throws:
      IllegalStateException - isMatriculationKnown() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • isExpectedToComplete

      boolean isExpectedToComplete()
      Tests if an expected completion is known.
      Returns:
      true if an expected completion is known, false otherwise
      Throws:
      IllegalStateException - isMatriculationKnown() is false
      Compliance:
      mandatory - This method must be implemented.
    • getExpectedCompletionDate

      DateTime getExpectedCompletionDate()
      Gets the expected completion date.
      Returns:
      the expected completion date
      Throws:
      IllegalStateException - isExpectedToComplete() is false
      Compliance:
      mandatory - This method must be implemented.
    • getExpectedCompletionTermId

      Id getExpectedCompletionTermId()
      Gets the Id of the expected completion Term.
      Returns:
      the expected completion term Id
      Throws:
      IllegalStateException - isExpectedToComplete() is false
      Compliance:
      mandatory - This method must be implemented.
    • getExpectedCompletionTerm

      Term getExpectedCompletionTerm() throws OperationFailedException
      Gets the expected completion Term.
      Returns:
      the expected completion term
      Throws:
      IllegalStateException - isExpectedToComplete() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • isActivelyPursuing

      boolean isActivelyPursuing()
      Tests if the credential is being actively pursued.
      Returns:
      true if the credential is being actively pursued, false otherwise
      Throws:
      IllegalStateException - isMatriculationKnown() is false
      Compliance:
      mandatory - This method must be implemented.
    • isPaused

      boolean isPaused()
      Tests if the pursuit of the credential is paused.
      Returns:
      true if the pursuit of the credential is paused, false otherwise
      Throws:
      IllegalStateException - isMatriculationKnown() is false
      Compliance:
      mandatory - This method must be implemented.
    • isAbandoned

      boolean isAbandoned()
      Tests if the pursuit of the credential has been abandoned.
      Returns:
      true if the pursuit of the credential has been abandoned, false otherwise
      Throws:
      IllegalStateException - isMatriculationKnown() is false
      Compliance:
      mandatory - This method must be implemented.
    • getAbandonDate

      DateTime getAbandonDate()
      Gets the date the credential was abandoned.
      Returns:
      the abandon date
      Throws:
      IllegalStateException - isAbandoned() is false
      Compliance:
      mandatory - This method must be implemented.
    • getAbandonTermId

      Id getAbandonTermId()
      Gets the Id of the abandon Term.
      Returns:
      the abandon term Id
      Throws:
      IllegalStateException - isAbandoned() is false
      Compliance:
      mandatory - This method must be implemented.
    • getAbandonTerm

      Term getAbandonTerm() throws OperationFailedException
      Gets the abandon Term.
      Returns:
      the abandon term
      Throws:
      IllegalStateException - isAbandoned() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • isAwarded

      boolean isAwarded()
      Tests if the credential has been awarded.
      Returns:
      true if the credential has been awarded, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getAwardDate

      DateTime getAwardDate()
      Gets the date the credential was awarded.
      Returns:
      the award date
      Throws:
      IllegalStateException - isAwarded() is false
      Compliance:
      mandatory - This method must be implemented.
    • getAwardTermId

      Id getAwardTermId()
      Gets the Id of the award Term.
      Returns:
      the award term Id
      Throws:
      IllegalStateException - isAwarded() is false
      Compliance:
      mandatory - This method must be implemented.
    • getAwardTerm

      Term getAwardTerm() throws OperationFailedException
      Gets the award Term.
      Returns:
      the award term
      Throws:
      IllegalStateException - isAwarded() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • getDateAwarded

      DateTime getDateAwarded()
      Gets the award date.
      Returns:
      the date awarded
      Compliance:
      mandatory - This method must be implemented.
    • hasProgram

      boolean hasProgram()
      Tests if a program is associated with this credential.
      Returns:
      true if a program is available, false otherwise
      Compliance:
      mandatory - This method must be implemented.
    • getProgramId

      Id getProgramId()
      Gets the Id of the Program.
      Returns:
      the program Id
      Throws:
      IllegalStateException - hasProgram() is false
      Compliance:
      mandatory - This method must be implemented.
    • getProgram

      Program getProgram() throws OperationFailedException
      Gets the Program.
      Returns:
      the program
      Throws:
      IllegalStateException - hasProgram() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.
    • getCredentialEntryRecord

      CredentialEntryRecord getCredentialEntryRecord(Type credentialEntryRecordType) throws OperationFailedException
      Gets the credential entry record corresponding to the given CredentialEntry record Type. This method is used to retrieve an object implementing the requested record. The credentialEntryRecordType may be the Type returned in getRecordTypes() or any of its parents in a Type hierarchy where hasRecordType(credentialEntryRecordType) is true .
      Parameters:
      credentialEntryRecordType - the type of credential entry record to retrieve
      Returns:
      the credential entry record
      Throws:
      NullArgumentException - credentialEntryRecordType is null
      OperationFailedException - unable to complete request
      UnsupportedException - hasRecordType(credentialEntryRecordType) is false
      Compliance:
      mandatory - This method must be implemented.