public interface OfferingConstrainerRuleLookupSession extends OsidSession
This session provides methods to retrieve OfferingConstrainer
to CanonicalUnit
mappings. A CanonicalUnit
with multiple OfferingConstrainers
means any
positive rule evaluation across the result in an effective
CanonicalUnit.
This lookup session defines several views:
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupOfferingConstrainerRules()
Tests if this user can perform lookups of offering
constrainer/canonical unit mappings.
|
IdList |
getCanonicalUnitIdsForOfferingConstrainer(Id offeringConstrainerId)
Gets the
CanonicalUnit Ids mapped to an
OfferingConstrainer. |
CanonicalUnitList |
getCanonicalUnitsForOfferingConstrainer(Id offeringConstrainerId)
Gets the
CanonicalUnits mapped to an
OfferingConstrainer. |
Catalogue |
getCatalogue()
Gets the
Catalogue associated with this session. |
Id |
getCatalogueId()
Gets the
Catalogue Id associated with
this session. |
IdList |
getOfferingConstrainerIdsForCanonicalUnit(Id canonicalUnitId)
Gets the
OfferingConstrainer Id associated with a
CanonicalUnit. |
OfferingConstrainerList |
getOfferingConstrainersForCanonicalUnit(Id canonicalUnitId)
Gets the
OfferingConstrainer associated with a
CanonicalUnit. |
void |
useComparativeOfferingConstrainerRuleView()
The returns from the lookup methods may omit or translate elements
based on this session, such as authorization, and not result in an
error.
|
void |
useFederatedCatalogueView()
Federates the view for methods in this session.
|
void |
useIsolatedCatalogueView()
Isolates the view for methods in this session.
|
void |
usePlenaryOfferingConstrainerRuleView()
A complete view of the
OfferingConstrainer and
CanonicalUnit returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCatalogueId()
Catalogue
Id
associated with
this session. Catalogue Id
associated with this sessionmandatory
- This method must be implemented. Catalogue getCatalogue() throws OperationFailedException, PermissionDeniedException
Catalogue
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canLookupOfferingConstrainerRules()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer lookup operations to
unauthorized users. false
if looking up mappings is not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativeOfferingConstrainerRuleView()
mandatory
- This method is must be implemented. void usePlenaryOfferingConstrainerRuleView()
OfferingConstrainer
and
CanonicalUnit
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.mandatory
- This method is must be implemented. void useFederatedCatalogueView()
mandatory
- This method is must be implemented. void useIsolatedCatalogueView()
mandatory
- This method is must be implemented. IdList getOfferingConstrainerIdsForCanonicalUnit(Id canonicalUnitId) throws NotFoundException, OperationFailedException, PermissionDeniedException
OfferingConstrainer Id
associated with a
CanonicalUnit.
canonicalUnitId
- Id
of the CanonicalUnit
Ids
NotFoundException
- canonicalUnitId
is
not foundNullArgumentException
- canonicalUnitId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. OfferingConstrainerList getOfferingConstrainersForCanonicalUnit(Id canonicalUnitId) throws NotFoundException, OperationFailedException, PermissionDeniedException
OfferingConstrainer
associated with a
CanonicalUnit.
canonicalUnitId
- Id
of the CanonicalUnit
NotFoundException
- canonicalUnitId
is
not foundNullArgumentException
- canonicalUnitId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getCanonicalUnitIdsForOfferingConstrainer(Id offeringConstrainerId) throws NotFoundException, OperationFailedException, PermissionDeniedException
CanonicalUnit
Ids
mapped to an
OfferingConstrainer.
offeringConstrainerId
- Id
of an
OfferingConstrainer
Ids
NotFoundException
- offeringConstrainerId
is not foundNullArgumentException
- offeringConstrainerId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CanonicalUnitList getCanonicalUnitsForOfferingConstrainer(Id offeringConstrainerId) throws NotFoundException, OperationFailedException, PermissionDeniedException
CanonicalUnits
mapped to an
OfferingConstrainer.
offeringConstrainerId
- Id
of an
OfferingConstrainer
NotFoundException
- offeringConstrainerId
is not foundNullArgumentException
- offeringConstrainerId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.