OSID - osid.assessment.authoring.AssessmentPart Service Interface Definition

Interface	osid.assessment.authoring.AssessmentPart
Implements	`osid.OsidObject`
	`osid.Containable`
	`osid.Operable`
Description	An `AssessmentPart` represents a section of an assessment. `AssessmentParts` may be visible as sections of an assessment or just used to clump together a set of items on which to hang sequence rules.
Method	getAssessmentId
Description	Gets the assessment `Id` to which this rule belongs.
Return	`osid.id.Id`		`Id` of an assessment
Compliance	`mandatory`		This method must be implemented.
Method	getAssessment
Description	Gets the assessment to which this rule belongs.
Return	`osid.assessment.Assessment`		an assessment
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	hasParentPart
Description	Tests if this assessment part belongs to a parent assessment part.
Return	`boolean`		`true` if this part has a parent, `false` if a root
Compliance	`mandatory`		This method must be implemented.
Method	getAssessmentPartId
Description	Gets the parent assessment `Id.`
Return	`osid.id.Id`		`Id` of an assessment
Errors	ILLEGAL_STATE		`hasParentPart()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getAssessmentPart
Description	Gets the parent assessment.
Return	`osid.assessment.authoring.AssessmentPart`		the parent assessment part
Errors	ILLEGAL_STATE		`hasParentPart()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	isSection
Description	Tests if this part should be visible as a section in an assessment. If visible, this part will appear to the user as a separate section of the assessment. Typically, a section may not be under a non-sectioned part.
Return	`boolean`		`true` if this part is a section, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getWeight
Description	Gets an integral weight factor for this assessment part used for scoring. The percentage weight for this part is this weight divided by the sum total of all the weights in the assessment.
Return	`cardinal`		the weight
Compliance	`mandatory`		This method must be implemented.
Method	getAllocatedTime
Description	Gets the allocated time for this part. The allocated time may be used to assign fixed time limits to each item or can be used to estimate the total assessment time.
Return	`osid.calendaring.Duration`		allocated time
Compliance	`mandatory`		This method must be implemented.
Method	getChildAssessmentPartIds
Description	Gets any child assessment part `Ids.`
Return	`osid.id.IdList`		`Ids` of the child assessment parts
Compliance	`mandatory`		This method must be implemented.
Method	getChildAssessmentParts
Description	Gets any child assessment parts.
Return	`osid.assessment.authoring.AssessmentPartList`		the child assessment parts
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getAssessmentPartRecord
Description	Gets the assessment part record corresponding to the given `AssessmentPart` record `Type.` This method is used to retrieve an object implementing the requested record. The `assessmentPartRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(assessmentPartRecordType)` is `true` .
Parameters	`osid.type.Type`	`assessmentPartRecordType`	the type of the record to retrieve
Return	`osid.assessment.authoring.records.AssessmentPartRecord`		the assessment part record
Errors	NULL_ARGUMENT		`assessmentPartRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(assessmentPartRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.