OSID Logo
OSID Specifications
course chronicle package
Version 3.0.0
Release Candidate Preview
Interfaceosid.course.chronicle.ProgramEntryQuery
Implementsosid.OsidRelationshipQuery
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
booleanmatch true if a positive match, false for a negative match
ErrorsNULL_ARGUMENT resourceId 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.

Returnboolean true 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
ErrorsUNIMPLEMENTED supportsStudentQuery() 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
booleanmatch true if a positive match, false for a negative match
ErrorsNULL_ARGUMENT programId 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.

Returnboolean true 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
ErrorsUNIMPLEMENTED supportsProgramQuery() is false
ComplianceoptionalThis method must be implemented if supportsProgramQuery() is true.
MethodclearProgramTerms
Description

Clears the program terms.

CompliancemandatoryThis method must be implemented.
MethodmatchAdmissionDate
Description

Matches admission dates between the given dates inclusive.

Parametersosid.calendaring.DateTimefromstarting date
osid.calendaring.DateTimetoending date
booleanmatch true if a positive match, false for a negative match
ErrorsINVALID_ARGUMENT from is greater than to
NULL_ARGUMENT from or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyAdmissionDate
Description

Matches entries that have any admission date.

Parametersbooleanmatch true 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.
MethodmatchComplete
Description

Matches completed programs.

Parametersbooleanmatch true 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.
MethodmatchTermId
Description

Sets the term Id for this query.

Parametersosid.id.IdtermIda term Id
booleanmatch true if a positive match, false for a negative match
ErrorsNULL_ARGUMENT termId 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.

Returnboolean true 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
ErrorsUNIMPLEMENTED supportsTermQuery() is false
ComplianceoptionalThis method must be implemented if supportsTermQuery() is true.
MethodmatchAnyTerm
Description

Matches entries that have any term.

Parametersbooleanmatch true 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
booleanmatch true if a positive match, false for a negative match
ErrorsNULL_ARGUMENT gradeSystemId 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.

Returnboolean true 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
ErrorsUNIMPLEMENTED supportsCreditScaleQuery() is false
ComplianceoptionalThis method must be implemented if supportsCreditScaleQuery() is true.
MethodmatchAnyCreditScale
Description

Matches entries that have any credit scale.

Parametersbooleanmatch true 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
booleanmatch true if a positive match, false for a negative match
ErrorsINVALID_ARGUMENT from is greater than to
NULL_ARGUMENT from or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyCreditsEarned
Description

Matches entries that have any earned credits.

Parametersbooleanmatch true 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
booleanmatch true if a positive match, false for a negative match
ErrorsNULL_ARGUMENT gradeSystemId 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.

Returnboolean true 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
ErrorsUNIMPLEMENTED supportsGPAScaleQuery() is false
ComplianceoptionalThis method must be implemented if supportsGPAScaleQuery() is true.
MethodmatchAnyGPAScale
Description

Matches entries that have any GPA scale.

Parametersbooleanmatch true 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
booleanmatch true if a positive match, false for a negative match
ErrorsINVALID_ARGUMENT from is greater than to
NULL_ARGUMENT from or to is null
CompliancemandatoryThis method must be implemented.
MethodmatchAnyGPA
Description

Matches entries that have any GPA.

Parametersbooleanmatch true 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
booleanmatch true if a positive match, false for a negative match
ErrorsNULL_ARGUMENT enrollmentId 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.

Returnboolean true 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
ErrorsUNIMPLEMENTED supportsEnrollmentQuery() is false
ComplianceoptionalThis method must be implemented if supportsEnrollmentQuery() is true.
MethodmatchAnyEnrollment
Description

Matches entries that have any enrollment.

Parametersbooleanmatch true 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
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT courseCatalogId 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.

Returnboolean true 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
ErrorsUNIMPLEMENTED supportsCourseCatalogQuery() 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_ARGUMENT programEntryRecordType is null
OPERATION_FAILEDunable to complete request
UNSUPPORTED hasRecordType(programEntryRecordType) is false
CompliancemandatoryThis method must be implemented.