Interface | osid.offering.OfferingLookupSession | ||
---|---|---|---|
Implements | osid.OsidSession | ||
Description |
This session defines methods for retrieving offerings. This lookup session defines several views:
The methods | ||
Method | getCatalogueId | ||
Description |
Gets the | ||
Return | osid.id.Id | the Catalogue Id associated with this session | |
Compliance | mandatory | This method must be implemented. | |
Method | getCatalogue | ||
Description |
Gets the | ||
Return | osid.offering.Catalogue | the catalogue | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | canLookupOfferings | ||
Description |
Tests if this user can examine this catalogue. 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 | ||
Return | boolean | false if catalogue reading methods are not authorized,
true otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | useComparativeOfferingView | ||
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. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | usePlenaryOfferingView | ||
Description |
A complete view of the | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useFederatedCatalogueView | ||
Description |
Federates the view for methods in this session. A federated view will include offerings in catalogues which are children of this catalogue in the catalogue hierarchy. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useIsolatedCatalogueView | ||
Description |
Isolates the view for methods in this session. An isolated view restricts retrievals to this catalogue only. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useEffectiveOfferingView | ||
Description |
Only offerings whose effective dates are current are returned by methods in this session. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useAnyEffectiveOfferingView | ||
Description |
All offerings of any effective dates are returned by methods in this session. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getOffering | ||
Description |
Gets the In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | offeringId | the Id of the Offering to retrieve |
Return | osid.offering.Offering | the returned Offering | |
Errors | NOT_FOUND | no Offering found with the given Id | |
NULL_ARGUMENT | offeringId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByIds | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.IdList | offeringIds | the list of Ids to retrieve |
Return | osid.offering.OfferingList | the returned Offering list | |
Errors | NOT_FOUND | an Id was not found | |
NULL_ARGUMENT | offeringIds is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusType | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.type.Type | offeringGenusType | an offerings genus type |
Return | osid.offering.OfferingList | the returned Offering list | |
Errors | NULL_ARGUMENT | offeringGenusType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByParentGenusType | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.type.Type | offeringGenusType | an offering genus type |
Return | osid.offering.OfferingList | the returned Offering list | |
Errors | NULL_ARGUMENT | offeringGenusType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByRecordType | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.type.Type | offeringRecordType | an offering record type |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | offeringRecordType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.calendaring.DateTime | from | start of date range |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | from or to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusTypeOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.type.Type | offeringGenusType | an offering genus type |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | offeringGenusType, from, or to is null
| ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsForCanonicalUnit | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | canonicalUnitId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusTypeForCanonicalUnit | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
osid.type.Type | offeringGenusType | an offering genus type | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | canonicalUnitId or offeringGenusType is
null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsForCanonicalUnitOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | canonicalUnitId, from, or to is null
| ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusTypeForCanonicalUnitOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
osid.type.Type | offeringGenusType | an offering genus type | |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | canonicalUnitId, offeringGenusType, from, or to
is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsForTimePeriod | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | timePeriodId | a time period Id |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | timePeriodId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusTypeForTimePeriod | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | timePeriodId | a time period Id |
osid.type.Type | offeringGenusType | an offering genus type | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | timePeriodId or offeringGenusType is
null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsForTimePeriodOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | timePeriodId | a time period Id |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | timePeriodId, from, or to is null
| ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusTypeForTimePeriodOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | timePeriodId | a time period Id |
osid.type.Type | offeringGenusType | an offering genus type | |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | timePeriodId, offeringGenusType, from, or to
is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsForCanonicalUnitAndTimePeriod | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
osid.id.Id | timePeriodId | a time period Id | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | canonicalUnitId or timePeriodId is
null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusTypeForCanonicalUnitAndTimePeriod | ||
Description |
Gets an In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
osid.id.Id | timePeriodId | a time period Id | |
osid.type.Type | offeringGenusType | an offering genus type | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | canonicalUnitId, timePeriodId, or
offeringGenusType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsForCanonicalUnitAndTimePeriodOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
osid.id.Id | timePeriodId | a time period Id | |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | canonicalUnitId, timePeriodId, from, or to is
null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByGenusTypeForCanonicalUnitAndTimePeriodOnDate | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | osid.id.Id | canonicalUnitId | a canonical unit Id |
osid.id.Id | timePeriodId | a time period Id | |
osid.type.Type | offeringGenusType | an offering genus type | |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | canonicalUnitId, timePeriodId, offeringGenusType, from, or
to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferingsByCodeAndTimePeriod | ||
Description |
Gets an In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Parameters | string | code | a canonical unit Id |
osid.id.Id | timePeriodId | a time period Id | |
Return | osid.offering.OfferingList | the returned OfferingList | |
Errors | NULL_ARGUMENT | code or timePeriodId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getOfferings | ||
Description |
Gets all offerings. In plenary mode, the returned list contains all known offerings or an error results. Otherwise, the returned list may contain only those offerings that are accessible through this session. In effective mode, offerings are returned that are currently effective. In any effective mode, effective offerings and those currently expired are returned. | ||
Return | osid.offering.OfferingList | a list of offerings | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. |