OSID - osid.course.chronicle.ProgramEntrySearchOrder Service Interface Definition

Interface	osid.course.chronicle.ProgramEntrySearchOrder
Implements	`osid.OsidRelationshipSearchOrder`
Description	An interface for specifying the ordering of search results.
Method	orderByStudent
Description	Specifies a preference for ordering the result set by the resource.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	supportsStudentSearchOrder
Description	Tests if a resource order is available.
Return	`boolean`		`true` if a resource order is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getStudentSearchOrder
Description	Gets the resource order.
Return	`osid.resource.ResourceSearchOrder`		the resource search order
Errors	UNIMPLEMENTED		`supportsStudentSearchOrder()` is `false`
Compliance	`optional`		This method must be implemented if `supportsStudentSearchOrder()` is `true.`
Method	orderByProgram
Description	Specifies a preference for ordering the result set by the program.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	supportsProgramSearchOrder
Description	Tests if a program order is available.
Return	`boolean`		`true` if a program order is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getProgramSearchOrder
Description	Gets the program order.
Return	`osid.course.program.ProgramSearchOrder`		the program search order
Errors	UNIMPLEMENTED		`supportsProgramSearchOrder()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProgramSearchOrder()` is `true.`
Method	orderByAdmissionDate
Description	Specifies a preference for ordering the result set by the admission date.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	orderByComplete
Description	Specifies a preference for ordering the result set by completed programs.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	orderByTerm
Description	Specifies a preference for ordering the result set by the term.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	supportsTermSearchOrder
Description	Tests if a term order is available.
Return	`boolean`		`true` if a term order is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getTermSearchOrder
Description	Gets the term order.
Return	`osid.course.TermSearchOrder`		the term search order
Errors	UNIMPLEMENTED		`supportsTermSearchOrder()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTermSearchOrder()` is `true.`
Method	orderByCreditScale
Description	Specifies a preference for ordering the result set by the grade system for credits.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	supportsCreditScaleSearchOrder
Description	Tests if a grade system order is available.
Return	`boolean`		`true` if a grade system order is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getCreditScaleSearchOrder
Description	Gets the grade system order.
Return	`osid.grading.GradeSystemSearchOrder`		the credit scale search order
Errors	UNIMPLEMENTED		`supportsCreditScaleSearchOrder()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditScaleSearchOrder()` is `true.`
Method	orderByCreditsEarned
Description	Specifies a preference for ordering the result set by the earned credits.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	orderByGPAScale
Description	Specifies a preference for ordering the result set by the grade system for GPAs.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	supportsGPAScaleSearchOrder
Description	Tests if a grade system order is available.
Return	`boolean`		`true` if a grade system order is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getGPAScaleSearchOrder
Description	Gets the grade system order.
Return	`osid.grading.GradeSystemSearchOrder`		the GPA scale search order
Errors	UNIMPLEMENTED		`supportsGPAScaleSearchOrder()` is `false`
Compliance	`optional`		This method must be implemented if `supportsGPAScaleSearchOrder()` is `true.`
Method	orderByGPA
Description	Specifies a preference for ordering the result set by the gpa.
Parameters	`osid.SearchOrderStyle`	`style`	search order style
Errors	NULL_ARGUMENT		`style` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	getProgramEntrySearchOrderRecord
Description	Gets the program entry search order record corresponding to the given program entry record `Type.` Multiple retrievals return the same underlying object.
Parameters	`osid.type.Type`	`programEntryRecordType`	a program entry record type
Return	`osid.course.chronicle.records.ProgramEntrySearchOrderRecord`		the program entry search order record
Errors	NULL_ARGUMENT		`programEntryRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(programEntryRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.