OSID Logo
OSID Specifications
course chronicle package
Version 3.0.0
Interfaceosid.course.chronicle.ProgramEntryQuery
Implementsosid.OsidRelationshipQuery
Used Byosid.course.chronicle.ProgramEntryQuery
osid.course.chronicle.ProgramEntryQuerySession
osid.course.chronicle.ProgramEntrySearchSession
osid.course.chronicle.ProgramEntrySmartCourseCatalogSession
Description

This is the query for searching program entries. Each method match specifies an AND term while multiple invocations of the same method produce a nested OR .

MethodmatchStudentId
Description

Sets the student Id for this query.

Parametersosid.id.IdresourceIda resource Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTresourceId is null
CompliancemandatoryThis method must be implemented.
MethodclearStudentIdTerms
Description

Clears the student Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsStudentQuery
Description

Tests if a StudentQuery is available.

Returnbooleantrue if a student query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetStudentQuery
Description

Gets the query for a student option. Multiple retrievals produce a nested OR term.

Returnosid.resource.ResourceQuerya student query
ErrorsUNIMPLEMENTEDsupportsStudentQuery() is false
ComplianceoptionalThis method must be implemented if supportsStudentQuery() is true .
MethodclearStudentTerms
Description

Clears the student option terms.

CompliancemandatoryThis method must be implemented.
MethodmatchProgramId
Description

Sets the program Id for this query to match entries that have an entry for the given course.

Parametersosid.id.IdprogramIda program Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTprogramId is null
CompliancemandatoryThis method must be implemented.
MethodclearProgramIdTerms
Description

Clears the program Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsProgramQuery
Description

Tests if a ProgramQuery is available.

Returnbooleantrue if a program query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetProgramQuery
Description

Gets the query for a program entry. Multiple retrievals produce a nested OR term.

Returnosid.course.program.ProgramQuerya program query
ErrorsUNIMPLEMENTEDsupportsProgramQuery() is false
ComplianceoptionalThis method must be implemented if supportsProgramQuery() is true .
MethodclearProgramTerms
Description

Clears the program terms.

CompliancemandatoryThis method must be implemented.
MethodmatchParentProgramEntryId
Description

Sets the parent program entry Id for this query.

Parametersosid.id.IdprogramEntryIda program entry Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTprogramEntryId is null
CompliancemandatoryThis method must be implemented.
MethodclearParentProgramEntryIdTerms
Description

Clears the parent program entry Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsParentProgramEntryQuery
Description

Tests if a ProgramEntryQuery is available.

Returnbooleantrue if a program entry query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetParentProgramEntryQuery
Description

Gets the query for a parent program entry. Multiple retrievals produce a nested OR term.

Returnosid.course.chronicle.ProgramEntryQuerya parent program entry query
ErrorsUNIMPLEMENTEDsupportsParentProgramEntryQuery() is false
ComplianceoptionalThis method must be implemented if supportsParentProgramEntryQuery() is true .
MethodmatchAnyParentProgramEntry
Description

Matches program entries that have any parent.

Parametersbooleanmatchtrue to match entries with a parent, false to match entries with no parent
CompliancemandatoryThis method must be implemented.
MethodclearParentProgramEntryTerms
Description

Clears the parent program entry terms.

CompliancemandatoryThis method must be implemented.
MethodmatchIsMatriculationKnown
Description

Matches credential entries with a matriculation known value.

Parametersbooleanmatchtrue to match a true value, false to match a false value
CompliancemandatoryThis method must be implemented.
MethodclearIsMatriculationKnownTerms
Description

Clears the matriculation known terms.

CompliancemandatoryThis method must be implemented.
MethodmatchEntranceDate
Description

Matches entrance dates between the given dates inclusive.

Parametersosid.calendaring.DateTimefromstarting date
osid.calendaring.DateTimetoending date
booleanmatchtrue if a positive match, false for a negative match
ErrorsINVALID_ARGUMENTfrom is greater than to
NULL_ARGUMENTfrom or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyEntranceDate
Description

Matches program entries with any entrance date.

Parametersbooleanmatchtrue to match entries with a entrance date, false to match entries with no entrance date
CompliancemandatoryThis method must be implemented.
MethodclearEntranceDateTerms
Description

Clears the entrance date terms.

CompliancemandatoryThis method must be implemented.
MethodmatchEntranceTermId
Description

Sets the entrance term Id for this query.

Parametersosid.id.IdentranceTermIda entrance term Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTentranceTermId is null
CompliancemandatoryThis method must be implemented.
MethodclearEntranceTermIdTerms
Description

Clears the entrance term Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsEntranceTermQuery
Description

Tests if a TermQuery is available.

Returnbooleantrue if a entrance term query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetEntranceTermQuery
Description

Gets the query for a entrance term. Multiple retrievals produce a nested OR term.

Returnosid.course.TermQuerya entrance term query
ErrorsUNIMPLEMENTEDsupportsEntranceTermQuery() is false
ComplianceoptionalThis method must be implemented if supportsEntranceTermQuery() is true .
MethodclearEntranceTermTerms
Description

Clears the entrance term terms.

CompliancemandatoryThis method must be implemented.
MethodmatchIsExpectedToComplete
Description

Matches credential entries with a expected to complete value.

Parametersbooleanmatchtrue to match a true value, false to match a false value
CompliancemandatoryThis method must be implemented.
MethodclearIsExpectedToCompleteTerms
Description

Clears the expected to complete terms.

CompliancemandatoryThis method must be implemented.
MethodmatchExpectedCompletionDate
Description

Matches expected completion dates between the given dates inclusive.

Parametersosid.calendaring.DateTimefromstarting date
osid.calendaring.DateTimetoending date
booleanmatchtrue if a positive match, false for a negative match
ErrorsINVALID_ARGUMENTfrom is greater than to
NULL_ARGUMENTfrom or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyExpectedCompletionDate
Description

Matches program entries with any expected completion date.

Parametersbooleanmatchtrue to match entries with a expected completion date, false to match entries with no expected completion date
CompliancemandatoryThis method must be implemented.
MethodclearExpectedCompletionDateTerms
Description

Clears the expected completion date terms.

CompliancemandatoryThis method must be implemented.
MethodmatchExpectedCompletionTermId
Description

Sets the expected completion term Id for this query.

Parametersosid.id.IdexpectedCompletionTermIda expected completion term Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTexpectedCompletionTermId is null
CompliancemandatoryThis method must be implemented.
MethodclearExpectedCompletionTermIdTerms
Description

Clears the expected completion term Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsExpectedCompletionTermQuery
Description

Tests if a TermQuery is available.

Returnbooleantrue if a expected completion term query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetExpectedCompletionTermQuery
Description

Gets the query for a expected completion term. Multiple retrievals produce a nested OR term.

Returnosid.course.TermQuerya expected completion term query
ErrorsUNIMPLEMENTEDsupportsExpectedCompletionTermQuery() is false
ComplianceoptionalThis method must be implemented if supportsExpectedCompletionTermQuery() is true .
MethodclearExpectedCompletionTermTerms
Description

Clears the expected completion term terms.

CompliancemandatoryThis method must be implemented.
MethodmatchIsEnrolled
Description

Matches credential entries with a enrolled value.

Parametersbooleanmatchtrue to match a true value, false to match a false value
CompliancemandatoryThis method must be implemented.
MethodclearIsEnrolledTerms
Description

Clears the enrolled terms.

CompliancemandatoryThis method must be implemented.
MethodmatchIsActivelyEnrolled
Description

Matches credential entries with a actively enrolled value.

Parametersbooleanmatchtrue to match a true value, false to match a false value
CompliancemandatoryThis method must be implemented.
MethodclearIsActivelyEnrolledTerms
Description

Clears the actively enrolled terms.

CompliancemandatoryThis method must be implemented.
MethodmatchIsOnLeave
Description

Matches credential entries with a on leave value.

Parametersbooleanmatchtrue to match a true value, false to match a false value
CompliancemandatoryThis method must be implemented.
MethodclearIsOnLeaveTerms
Description

Clears the on leave terms.

CompliancemandatoryThis method must be implemented.
MethodmatchHasWithdrawn
Description

Matches credential entries with a withdrawn value.

Parametersbooleanmatchtrue to match a true value, false to match a false value
CompliancemandatoryThis method must be implemented.
MethodclearHasWithdrawnTerms
Description

Clears the withdrawn terms.

CompliancemandatoryThis method must be implemented.
MethodmatchWithdrawDate
Description

Matches withdraw dates between the given dates inclusive.

Parametersosid.calendaring.DateTimefromstarting date
osid.calendaring.DateTimetoending date
booleanmatchtrue if a positive match, false for a negative match
ErrorsINVALID_ARGUMENTfrom is greater than to
NULL_ARGUMENTfrom or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyWithdrawDate
Description

Matches program entries with any withdraw date.

Parametersbooleanmatchtrue to match entries with a withdraw date, false to match entries with no withdraw date
CompliancemandatoryThis method must be implemented.
MethodclearWithdrawDateTerms
Description

Clears the withdraw date terms.

CompliancemandatoryThis method must be implemented.
MethodmatchWithdrawTermId
Description

Sets the withdraw term Id for this query.

Parametersosid.id.IdwithdrawTermIda withdraw term Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTwithdrawTermId is null
CompliancemandatoryThis method must be implemented.
MethodclearWithdrawTermIdTerms
Description

Clears the withdraw term Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsWithdrawTermQuery
Description

Tests if a TermQuery is available.

Returnbooleantrue if a withdraw term query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetWithdrawTermQuery
Description

Gets the query for a withdraw term. Multiple retrievals produce a nested OR term.

Returnosid.course.TermQuerya withdraw term query
ErrorsUNIMPLEMENTEDsupportsWithdrawTermQuery() is false
ComplianceoptionalThis method must be implemented if supportsWithdrawTermQuery() is true .
MethodclearWithdrawTermTerms
Description

Clears the withdraw term terms.

CompliancemandatoryThis method must be implemented.
MethodmatchComplete
Description

Matches completed programs.

Parametersbooleanmatchtrue if a positive match, false for a negative match
CompliancemandatoryThis method must be implemented.
MethodclearCompleteTerms
Description

Clears the complete terms.

CompliancemandatoryThis method must be implemented.
MethodmatchCompletionDate
Description

Matches completion dates between the given dates inclusive.

Parametersosid.calendaring.DateTimefromstarting date
osid.calendaring.DateTimetoending date
booleanmatchtrue if a positive match, false for a negative match
ErrorsINVALID_ARGUMENTfrom is greater than to
NULL_ARGUMENTfrom or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyCompletionDate
Description

Matches program entries with any completion date.

Parametersbooleanmatchtrue to match entries with a completion date, false to match entries with no completion date
CompliancemandatoryThis method must be implemented.
MethodclearCompletionDateTerms
Description

Clears the completion date terms.

CompliancemandatoryThis method must be implemented.
MethodmatchCompletionTermId
Description

Sets the completion term Id for this query.

Parametersosid.id.IdcompletionTermIda completion term Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTcompletionTermId is null
CompliancemandatoryThis method must be implemented.
MethodclearCompletionTermIdTerms
Description

Clears the completion term Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsCompletionTermQuery
Description

Tests if a TermQuery is available.

Returnbooleantrue if a completion term query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetCompletionTermQuery
Description

Gets the query for a completion term. Multiple retrievals produce a nested OR term.

Returnosid.course.TermQuerya completion term query
ErrorsUNIMPLEMENTEDsupportsCompletionTermQuery() is false
ComplianceoptionalThis method must be implemented if supportsCompletionTermQuery() is true .
MethodclearCompletionTermTerms
Description

Clears the completion term terms.

CompliancemandatoryThis method must be implemented.
MethodmatchLevelId
Description

Sets the level Id for this query.

Parametersosid.id.IdlevelIda level Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTlevelId is null
CompliancemandatoryThis method must be implemented.
MethodclearLevelIdTerms
Description

Clears the level Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsLevelQuery
Description

Tests if a GradeQuery is available.

Returnbooleantrue if a level query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetLevelQuery
Description

Gets the query for a level. Multiple retrievals produce a nested OR term.

Returnosid.grading.GradeQuerya level query
ErrorsUNIMPLEMENTEDsupportsLevelQuery() is false
ComplianceoptionalThis method must be implemented if supportsLevelQuery() is true .
MethodmatchAnyLevel
Description

Matches program entries with any level.

Parametersbooleanmatchtrue to match entries with a level, false to match entries with no level
CompliancemandatoryThis method must be implemented.
MethodclearLevelTerms
Description

Clears the level terms.

CompliancemandatoryThis method must be implemented.
MethodmatchStandingId
Description

Sets the standing Id for this query.

Parametersosid.id.IdstandingIda standing Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTstandingId is null
CompliancemandatoryThis method must be implemented.
MethodclearStandingIdTerms
Description

Clears the standing Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsStandingQuery
Description

Tests if a GradeQuery is available.

Returnbooleantrue if a standing query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetStandingQuery
Description

Gets the query for a standing. Multiple retrievals produce a nested OR term.

Returnosid.grading.GradeQuerya standing query
ErrorsUNIMPLEMENTEDsupportsStandingQuery() is false
ComplianceoptionalThis method must be implemented if supportsStandingQuery() is true .
MethodmatchAnyStanding
Description

Matches program entries with any standing.

Parametersbooleanmatchtrue to match entries with a standing, false to match entries with no standing
CompliancemandatoryThis method must be implemented.
MethodclearStandingTerms
Description

Clears the standing terms.

CompliancemandatoryThis method must be implemented.
MethodmatchAdmissionDate
Description

Matches admission dates between the given dates inclusive.

Parametersosid.calendaring.DateTimefromstarting date
osid.calendaring.DateTimetoending date
booleanmatchtrue if a positive match, false for a negative match
ErrorsINVALID_ARGUMENTfrom is greater than to
NULL_ARGUMENTfrom or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyAdmissionDate
Description

Matches entries that have any admission date.

Parametersbooleanmatchtrue to match entries with any admission date, false to match entries with no admission date
CompliancemandatoryThis method must be implemented.
MethodclearAdmissionDateTerms
Description

Clears the admission date terms.

CompliancemandatoryThis method must be implemented.
MethodmatchTermId
Description

Sets the term Id for this query.

Parametersosid.id.IdtermIda term Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTtermId is null
CompliancemandatoryThis method must be implemented.
MethodclearTermIdTerms
Description

Clears the term Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsTermQuery
Description

Tests if a TermQuery is available.

Returnbooleantrue if a term query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetTermQuery
Description

Gets the query for a term entry. Multiple retrievals produce a nested OR term.

Returnosid.course.TermQuerya term query
ErrorsUNIMPLEMENTEDsupportsTermQuery() is false
ComplianceoptionalThis method must be implemented if supportsTermQuery() is true .
MethodmatchAnyTerm
Description

Matches entries that have any term.

Parametersbooleanmatchtrue to match entries specific to a term, false to match entries for the entire enrollment
CompliancemandatoryThis method must be implemented.
MethodclearTermTerms
Description

Clears the term terms.

CompliancemandatoryThis method must be implemented.
MethodmatchCreditScaleId
Description

Matches a credit scale Id .

Parametersosid.id.IdgradeSystemIda grade system Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTgradeSystemId is null
CompliancemandatoryThis method must be implemented.
MethodclearCreditScaleIdTerms
Description

Clears the grade system Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsCreditScaleQuery
Description

Tests if a GradeSystemQuery is available.

Returnbooleantrue if a grade system query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetCreditScaleQuery
Description

Gets the query for a grade system. Multiple retrievals produce a nested OR term.

Returnosid.grading.GradeSystemQuerya grade system query
ErrorsUNIMPLEMENTEDsupportsCreditScaleQuery() is false
ComplianceoptionalThis method must be implemented if supportsCreditScaleQuery() is true .
MethodmatchAnyCreditScale
Description

Matches entries that have any credit scale.

Parametersbooleanmatchtrue to match entries with any credit scale, false to match entries with no credit scale
CompliancemandatoryThis method must be implemented.
MethodclearCreditScaleTerms
Description

Clears the credit scale terms.

CompliancemandatoryThis method must be implemented.
MethodmatchCreditsEarned
Description

Matches earned credits between the given range inclusive.

Parametersdecimalfromstarting value
decimaltoending value
booleanmatchtrue if a positive match, false for a negative match
ErrorsINVALID_ARGUMENTfrom is greater than to
NULL_ARGUMENTfrom or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyCreditsEarned
Description

Matches entries that have any earned credits.

Parametersbooleanmatchtrue to match entries with any earned credits, false to match entries with no earned credits
CompliancemandatoryThis method must be implemented.
MethodclearCreditsEarnedTerms
Description

Clears the earned credits terms.

CompliancemandatoryThis method must be implemented.
MethodmatchGPAScaleId
Description

Matches a GPA scale Id .

Parametersosid.id.IdgradeSystemIda grade system Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTgradeSystemId is null
CompliancemandatoryThis method must be implemented.
MethodclearGPAScaleIdTerms
Description

Clears the grade system Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsGPAScaleQuery
Description

Tests if a GradeSystemQuery is available.

Returnbooleantrue if a grade system query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetGPAScaleQuery
Description

Gets the query for a grade system. Multiple retrievals produce a nested OR term.

Returnosid.grading.GradeSystemQuerya grade system query
ErrorsUNIMPLEMENTEDsupportsGPAScaleQuery() is false
ComplianceoptionalThis method must be implemented if supportsGPAScaleQuery() is true .
MethodmatchAnyGPAScale
Description

Matches entries that have any GPA scale.

Parametersbooleanmatchtrue to match entries with any GPA scale, false to match entries with no GPA scale
CompliancemandatoryThis method must be implemented.
MethodclearGPAScaleTerms
Description

Clears the credit scale terms.

CompliancemandatoryThis method must be implemented.
MethodmatchGPA
Description

Matches GPA between the given range inclusive.

Parametersdecimalfromstarting value
decimaltoending value
booleanmatchtrue if a positive match, false for a negative match
ErrorsINVALID_ARGUMENTfrom is greater than to
NULL_ARGUMENTfrom or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyGPA
Description

Matches entries that have any GPA.

Parametersbooleanmatchtrue to match entries with any GPA, false to match entries with no GPA
CompliancemandatoryThis method must be implemented.
MethodclearGPATerms
Description

Clears the GPA terms.

CompliancemandatoryThis method must be implemented.
MethodmatchEnrollmentId
Description

Sets the enrollment Id for this query.

Parametersosid.id.IdenrollmentIdan enrollment Id
booleanmatchtrue if a positive match, false for a negative match
ErrorsNULL_ARGUMENTenrollmentId is null
CompliancemandatoryThis method must be implemented.
MethodclearEnrollmentIdTerms
Description

Clears the enrollment Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsEnrollmentQuery
Description

Tests if an EnrollmentQuery is available.

Returnbooleantrue if an enrollment query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetEnrollmentQuery
Description

Gets the query for an enrollment entry. Multiple retrievals produce a nested OR term.

Returnosid.course.program.EnrollmentQueryan enrollment query
ErrorsUNIMPLEMENTEDsupportsEnrollmentQuery() is false
ComplianceoptionalThis method must be implemented if supportsEnrollmentQuery() is true .
MethodmatchAnyEnrollment
Description

Matches entries that have any enrollment.

Parametersbooleanmatchtrue to match enries with any enrollment, false to match enries with no enrollments
CompliancemandatoryThis method must be implemented.
MethodclearEnrollmentTerms
Description

Clears the enrollment terms.

CompliancemandatoryThis method must be implemented.
MethodmatchCourseCatalogId
Description

Sets the course catalog Id for this query to match entries assigned to course catalogs.

Parametersosid.id.IdcourseCatalogIdthe course catalog Id
booleanmatchtrue for a positive match, false for a negative match
ErrorsNULL_ARGUMENTcourseCatalogId is null
CompliancemandatoryThis method must be implemented.
MethodclearCourseCatalogIdTerms
Description

Clears the course catalog Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsCourseCatalogQuery
Description

Tests if a CourseCatalogQuery is available.

Returnbooleantrue if a course catalog query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetCourseCatalogQuery
Description

Gets the query for a course catalog. Multiple retrievals produce a nested OR term.

Returnosid.course.CourseCatalogQuerythe course catalog query
ErrorsUNIMPLEMENTEDsupportsCourseCatalogQuery() is false
ComplianceoptionalThis method must be implemented if supportsCourseCatalogQuery() is true .
MethodclearCourseCatalogTerms
Description

Clears the course catalog terms.

CompliancemandatoryThis method must be implemented.
MethodgetProgramEntryQueryRecord
Description

Gets the program entry query record corresponding to the given ProgramEntry record Type . Multiple record retrievals produce a nested OR term.

Parametersosid.type.TypeprogramEntryRecordTypea program entry record type
Returnosid.course.chronicle.records.ProgramEntryQueryRecordthe program entry query record
ErrorsNULL_ARGUMENTprogramEntryRecordType is null
OPERATION_FAILEDunable to complete request
UNSUPPORTEDhasRecordType(programEntryRecordType) is false
CompliancemandatoryThis method must be implemented.