OSID - osid.ordering.Item Service Interface Definition

Interface	osid.ordering.Item
Implements	`osid.OsidRelationship`
Used By	`osid.ordering.ItemAdminSession`
Used By	`osid.ordering.ItemList`
Description	A `Item` represents a collection of orders. Like all OSID objects, a `Item` is identified by its `Id` and any persisted references should use the `Id`. An `Item` may have multiple unit prices for different types of currencies, such as one for payment and one for credits. Each line item cost type should be lined up with the unit price type.
Method	getOrderId
Description	Gets the order `Id` for this item.
Return	`osid.id.Id`		the order `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getOrder
Description	Gets the order for this item.
Return	`osid.ordering.Order`		the order
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	isDerived
Description	Tests if the item is a derived item as opposed to one that has been explicitly selected.
Return	`boolean`		`true` if this item is derived, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getProductId
Description	Gets the product `Id` for this item.
Return	`osid.id.Id`		the product `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getProduct
Description	Gets the product for this item.
Return	`osid.ordering.Product`		the product
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getUnitPriceIds
Description	Gets the price `Ids` for this item.
Return	`osid.id.IdList`		the price `Ids`
Compliance	`mandatory`		This method must be implemented.
Method	getUnitPrices
Description	Gets the prices for this item. There may be different price types for a single item.
Return	`osid.ordering.PriceList`		the prices
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getQuantity
Description	Gets the quantity of the product.
Return	`cardinal`		the quantity of the product
Compliance	`mandatory`		This method must be implemented.
Method	getCosts
Description	Gets the line item costs.
Return	`osid.ordering.CostList`		the costs.
Compliance	`mandatory`		This method must be implemented.
Method	getItemRecord
Description	Gets the item record corresponding to the given `Item` record `Type`.This method is used to retrieve an object implementing the requested record. The `itemRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(itemRecordType)` is `true`.
Parameters	`osid.type.Type`	`itemRecordType`	the type of item record to retrieve
Return	`osid.ordering.records.ItemRecord`		the item record
Errors	NULL_ARGUMENT		`itemRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(itemRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.