OSID Logo
OSID Specifications
offering rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.offering.rules.CanonicalUnitEnablerLookupSession
Implementsosid.OsidSession
Description

This session provides methods for retrieving CanonicalUnitEnablers.

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 catalogue view: All canonical unit enabler methods in this session operate, retrieve and pertain to canonical unit enablers defined explicitly in the current catalogue. Using an isolated view is useful for managing CanonicalUnitEnablers with the CanonicalUnitEnablerAdminSession.
  • federated catalogue view: All canonical unit enabler methods in this session operate, retrieve and pertain to all canonical unit enablers defined in this catalogue and any other canonical unit enablers implicitly available in this catalogue through catalogue inheritence.
  • activee canonical unit enabler view: All canonical unit enabler lookup methods return active canonical unit enablers.
  • any status canonical unit enabler view: canonical unit enablers of any active or inactive status are returned from methods.

Generally, the comparative view should be used for most applications as it permits operation even if there is data that cannot be accessed. The methods useFederatedDistributorView() and useIsolatedDistributorView() behave as a radio group and one should be selected before invoking the methods in this session.

MethodgetCatalogueId
Description

Gets the Catalogue Id associated with this session.

Returnosid.id.Idthe Catalogue Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetCatalogue
Description

Gets the Catalogue associated with this session.

Returnosid.offering.Cataloguethe catalogue
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanLookupCanonicalUnitEnablers
Description

Tests if this user can perform CanonicalUnitEnablers 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 opt not to offer lookup operations to unauthorized users.

Returnboolean false if lookup methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethoduseComparativeCanonicalUnitEnablerView
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.
MethodusePlenaryCanonicalUnitEnablerView
Description

A complete view of the CanonicalUnitEnabler 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.
MethoduseFederatedCatalogueView
Description

Federates the view for methods in this session. A federated view will include canonical unit enablers in catalogues which are children of this catalogue in the catalogue hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedCatalogueView
Description

Isolates the view for methods in this session. An isolated view restricts lookups to this catalogue only.

CompliancemandatoryThis method is must be implemented.
MethoduseActiveCanonicalUnitEnablerView
Description

Only active canonical unit enablers are returned by methods in this session.

CompliancemandatoryThis method is must be implemented.
MethoduseAnyStatusCanonicalUnitEnablerView
Description

All active and inactive canonical unit enablers are returned by methods in this session.

CompliancemandatoryThis method is must be implemented.
MethodgetCanonicalUnitEnabler
Description

Gets the CanonicalUnitEnabler specified by its Id.

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

In active mode, canonical unit enablers are returned that are currently active. In any status mode, active and inactive canonical unit enablers are returned.

Parametersosid.id.IdcanonicalUnitEnablerId Id of the CanonicalUnitEnabler
Returnosid.offering.rules.CanonicalUnitEnablerthe canonical unit enabler
ErrorsNOT_FOUND canonicalUnitEnablerId not found
NULL_ARGUMENT canonicalUnitEnablerId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method is must be implemented.
MethodgetCanonicalUnitEnablersByIds
Description

Gets a CanonicalUnitEnablerList corresponding to the given IdList.

In plenary mode, the returned list contains all of the canonical unit enablers 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 CanonicalUnitEnablers may be omitted from the list and may present the elements in any order including returning a unique set.

In active mode, canonical unit enablers are returned that are currently active. In any status mode, active and inactive canonical unit enablers are returned.

Parametersosid.id.IdListcanonicalUnitEnablerIdsthe list of Ids to retrieve
Returnosid.offering.rules.CanonicalUnitEnablerListthe returned CanonicalUnitEnabler list
ErrorsNOT_FOUNDan Id was not found
NULL_ARGUMENT canonicalUnitEnablerIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitEnablersByGenusType
Description

Gets a CanonicalUnitEnablerList corresponding to the given canonical unit enabler genus Type which does not include canonical unit enablers of genus types derived from the specified Type.

In plenary mode, the returned list contains all known canonical unit enablers or an error results. Otherwise, the returned list may contain only those canonical unit enablers that are accessible through this session.

In active mode, canonical unit enablers are returned that are currently active. In any status mode, active and inactive canonical unit enablers are returned.

Parametersosid.type.TypecanonicalUnitEnablerGenusTypea canonical unit enabler genus type
Returnosid.offering.rules.CanonicalUnitEnablerListthe returned CanonicalUnitEnabler list
ErrorsNULL_ARGUMENT canonicalUnitEnablerGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitEnablersByParentGenusType
Description

Gets a CanonicalUnitEnablerList corresponding to the given canonical unit enabler genus Type and include any additional canonical unit enablers with genus types derived from the specified Type.

In plenary mode, the returned list contains all known canonical unit enablers or an error results. Otherwise, the returned list may contain only those canonical unit enablers that are accessible through this session.

In active mode, canonical unit enablers are returned that are currently active. In any status mode, active and inactive canonical unit enablers are returned.

Parametersosid.type.TypecanonicalUnitEnablerGenusTypea canonical unit enabler genus type
Returnosid.offering.rules.CanonicalUnitEnablerListthe returned CanonicalUnitEnabler list
ErrorsNULL_ARGUMENT canonicalUnitEnablerGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitEnablersByRecordType
Description

Gets a CanonicalUnitEnablerList containing the given canonical unit enabler record Type.

In plenary mode, the returned list contains all known canonical unit enablers or an error results. Otherwise, the returned list may contain only those canonical unit enablers that are accessible through this session.

In active mode, canonical unit enablers are returned that are currently active. In any status mode, active and inactive canonical unit enablers are returned.

Parametersosid.type.TypecanonicalUnitEnablerRecordTypea canonical unit enabler record type
Returnosid.offering.rules.CanonicalUnitEnablerListthe returned CanonicalUnitEnabler list
ErrorsNULL_ARGUMENT canonicalUnitEnablerRecordType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitEnablersOnDate
Description

Gets a CanonicalUnitEnablerList that are effective for the entire given date range but not confined to the date range.

In plenary mode, the returned list contains all known canonical unit enablers or an error results. Otherwise, the returned list may contain only those canonical unit enablers that are accessible through this session.

In active mode, canonical unit enablers are returned that are currently active in addition to being effective during the given date range. In any status mode, active and inactive canonical unit enablers are returned.

Parametersosid.calendaring.DateTimefroma start date
osid.calendaring.DateTimetoan end date
Returnosid.offering.rules.CanonicalUnitEnablerListthe returned CanonicalUnitEnabler list
ErrorsINVALID_ARGUMENT from is greater than to
NULL_ARGUMENT from or to is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitEnablersOnDateWithAgent
Description

Gets a CanonicalUnitEnablerList that are effective for the entire given date range but not confined to the date range and evaluated against the given agent.

In plenary mode, the returned list contains all known canonical unit enablers or an error results. Otherwise, the returned list may contain only those canonical unit enablers that are accessible through this session.

In active mode, canonical unit enablers are returned that are currently active in addition to being effective during the given date range. In any status mode, active and inactive canonical unit enablers are returned.

Parametersosid.id.IdagentIdan agent Id
osid.calendaring.DateTimefroma start date
osid.calendaring.DateTimetoan end date
Returnosid.offering.rules.CanonicalUnitEnablerListthe returned CanonicalUnitEnabler list
ErrorsINVALID_ARGUMENT from is greater than to
NULL_ARGUMENT agentId, from, or to is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitEnablers
Description

Gets all CanonicalUnitEnablers.

In plenary mode, the returned list contains all known canonical unit enablers or an error results. Otherwise, the returned list may contain only those canonical unit enablers that are accessible through this session.

In active mode, canonical unit enablers are returned that are currently active. In any status mode, active and inactive canonical unit enablers are returned.

Returnosid.offering.rules.CanonicalUnitEnablerListthe returned CanonicalUnitEnabler list
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.