OSID Logo
OSID Specifications
ordering package
Version 3.0.0
Release Candidate Preview
Interfaceosid.ordering.PriceScheduleLookupSession
Implementsosid.OsidSession
Description

This session provides methods for retrieving PriceSchedule objects. The PriceSchedule represents a collection of prices.

This session defines views that offer differing behaviors when retrieving multiple objects.

  • comparative view: elements may be silently omitted or re-ordered
  • plenary view: provides a complete set or is an error condition
  • isolated store view: All order methods in this session operate, retrieve and pertain to price schedules defined explicitly in the current store. Using an isolated view is useful for managing price schedules with the PriceScheduleAdminSession.
  • federated store view: All priice schedule lookup methods in this session operate, retrieve and pertain to all price schedules defined in this store and any other stores implicitly available in this store through store inheritence.
MethodgetStoreId
Description

Gets the Store Id associated with this session.

Returnosid.id.Idthe Store Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetStore
Description

Gets the Store associated with this session.

Returnosid.ordering.Storethe store
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanLookupPriceSchedules
Description

Tests if this user can perform Price lookups. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may not offer lookup operations to unauthorized users.

Returnboolean false if lookup methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethoduseComparativePriceScheduleView
Description

The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error. This view is used when greater interoperability is desired at the expense of precision.

CompliancemandatoryThis method is must be implemented.
MethodusePlenaryPriceScheduleView
Description

A complete view of the PriceSchedule returns is desired. Methods will return what is requested or result in an error. This view is used when greater precision is desired at the expense of interoperability.

CompliancemandatoryThis method is must be implemented.
MethoduseFederatedStoreView
Description

Federates the view for methods in this session. A federated view will include price schedules in stores which are children of this store in the store hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedStoreView
Description

Isolates the view for methods in this session. An isolated view restricts retrievals to this store only.

CompliancemandatoryThis method is must be implemented.
MethodgetPriceSchedule
Description

Gets the PriceSchedule specified by its Id. In plenary mode, the exact Id is found or a NOT_FOUND results. Otherwise, the returned PriceSchedule may have a different Id than requested, such as the case where a duplicate Id was assigned to a PriceSchedule and retained for compatibility.

Parametersosid.id.IdpriceScheduleId Id of the PriceSchedule
Returnosid.ordering.PriceSchedulethe price schedule
ErrorsNOT_FOUND priceScheduleId not found
NULL_ARGUMENT priceScheduleId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method is must be implemented.
MethodgetPriceScheduleByPrice
Description

Gets the PriceSchedule by a Price Id.

Parametersosid.id.IdpriceId Id of a Price
Returnosid.ordering.PriceSchedulethe price schedule
ErrorsNOT_FOUND priceId not found
NULL_ARGUMENT priceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method is must be implemented.
MethodgetPriceSchedulesByIds
Description

Gets a PriceScheduleList corresponding to the given IdList. In plenary mode, the returned list contains all of the price schedules specified in the Id list, in the order of the list, including duplicates, or an error results if an Id in the supplied list is not found or inaccessible. Otherwise, inaccessible PriceSchedules may be omitted from the list and may present the elements in any order including returning a unique set.

Parametersosid.id.IdListpriceScheduleIdsthe list of Ids to retrieve
Returnosid.ordering.PriceScheduleListthe returned PriceSchedule list
ErrorsNOT_FOUNDan Id was not found
NULL_ARGUMENT priceScheduleIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetPriceSchedulesByGenusType
Description

Gets a PriceScheduleList corresponding to the given price schedule genus Type which does not include price schedules of genus types derived from the specified Type. In plenary mode, the returned list contains all known price schedules or an error results. Otherwise, the returned list may contain only those price schedules that are accessible through this session.

Parametersosid.type.TypepriceScheduleGenusTypea price schedule genus type
Returnosid.ordering.PriceScheduleListthe returned PriceSchedule list
ErrorsNULL_ARGUMENT priceScheduleGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetPriceSchedulesByParentGenusType
Description

Gets a PriceScheduleList corresponding to the given price schedule genus Type and include any additional price schedules with genus types derived from the specified Type. In plenary mode, the returned list contains all known price schedules or an error results. Otherwise, the returned list may contain only those price schedules that are accessible through this session.

Parametersosid.type.TypepriceScheduleGenusTypea price schedule genus type
Returnosid.ordering.PriceScheduleListthe returned PriceSchedule list
ErrorsNULL_ARGUMENT priceScheduleGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetPriceSchedulesByRecordType
Description

Gets a PriceScheduleList containing the given repository record Type. In plenary mode, the returned list contains all known price schedules or an error results. Otherwise, the returned list may contain only those price schedules that are accessible through this session.

Parametersosid.type.TypepriceScheduleRecordTypea price schedule record type
Returnosid.ordering.PriceScheduleListthe returned PriceSchedule list
ErrorsNULL_ARGUMENT priceScheduleRecordType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetPriceSchedules
Description

Gets all PriceSchedules. In plenary mode, the returned list contains all known price schedules or an error results. Otherwise, the returned list may contain only those price schedules that are accessible through this session.

Returnosid.ordering.PriceScheduleLista list of PriceSchedules
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.