OSID - osid.inquiry.Inquiry Service Interface Definition

Interface	osid.inquiry.Inquiry
Implements	`osid.OsidRule`
Implements	`osid.Subjugateable`
Description	An `Inquiry` is an `OsidRule` that determines the nature of a `Response.`
Method	getAuditId
Description	Gets the `Id` of the audit.
Return	`osid.id.Id`		the audit `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAudit
Description	Gets the audit.
Return	`osid.inquiry.Audit`		the audit
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getQuestion
Description	Gets the question.
Return	`osid.locale.DisplayText`		the question
Compliance	`mandatory`		This method must be implemented.
Method	isRequired
Description	Tests if a `Response` is required for this `Inquiry.`
Return	`boolean`		`true` if a response is required, false if optional
Compliance	`mandatory`		This method must be implemented.
Method	isAffirmationRequired
Description	Tests if a positive `Response` is required for this `Inquiry` to pass the `Audit.`
Return	`boolean`		`true` if a positive response is required, false if optional
Compliance	`mandatory`		This method must be implemented.
Method	needsOneResponse
Description	Tests if a single effective `Response` is required.
Return	`boolean`		`true` if a single effective response is required, false responses should be collected for every inquiry
Compliance	`mandatory`		This method must be implemented.
Method	getInquiryRecord
Description	Gets the inquiry record corresponding to the given `Inquiry` record `Type.` This method is used to retrieve an object implementing the requested record. The `inquiryRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(inquiryRecordType)` is `true` .
Parameters	`osid.type.Type`	`inquiryRecordType`	the type of inquiry record to retrieve
Return	`osid.inquiry.records.InquiryRecord`		the inquiry record
Errors	NULL_ARGUMENT		`inquiryRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure occurred
	UNSUPPORTED		`hasRecordType(inquiryRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.