OSID Logo
OSID Specifications
course chronicle package
Version 3.0.0
Release Candidate Preview
Interfaceosid.course.chronicle.CredentialEntryQuery
Implementsosid.OsidRelationshipQuery
Description

This is the query for searching credential 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.
MethodmatchCredentialId
Description

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

Parametersosid.id.IdcredentialIda credential Id
booleanmatch true if a positive match, false for a negative match
ErrorsNULL_ARGUMENT credentialId is null
CompliancemandatoryThis method must be implemented.
MethodclearCredentialIdTerms
Description

Clears the credential Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsCredentialQuery
Description

Tests if a CredentialQuery is available.

Returnboolean true if a credential query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetCredentialQuery
Description

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

Returnosid.course.program.CredentialQuerya credential query
ErrorsUNIMPLEMENTED supportsCredentialQuery() is false
ComplianceoptionalThis method must be implemented if supportsCredentialQuery() is true.
MethodclearCredentialTerms
Description

Clears the credential terms.

CompliancemandatoryThis method must be implemented.
MethodmatchDateAwarded
Description

Matches award 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.
MethodmatchAnyDateAwarded
Description

Matches entries that have any award date.

Parametersbooleanmatch true to match entries with any award date, false to match entries with no award date
CompliancemandatoryThis method must be implemented.
MethodclearDateAwardedTerms
Description

Clears the award date terms.

CompliancemandatoryThis method must be implemented.
MethodmatchProgramId
Description

Sets the program Id for this query.

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. 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.
MethodmatchAnyProgram
Description

Matches entries that have any program.

Parametersbooleanmatch true to match entries with any program false to match entries with no program
CompliancemandatoryThis method must be implemented.
MethodclearProgramTerms
Description

Clears the program 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.
MethodgetCredentialEntryQueryRecord
Description

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

Parametersosid.type.TypecredentialEntryRecordTypea credential entry record type
Returnosid.course.chronicle.records.CredentialEntryQueryRecordthe credential entry query record
ErrorsNULL_ARGUMENT credentialEntryRecordType is null
OPERATION_FAILEDunable to complete request
UNSUPPORTED hasRecordType(credentialEntryRecordType) is false
CompliancemandatoryThis method must be implemented.