OSID Logo
OSID Specifications
repository rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.repository.rules.CompositionEnablerLookupSession
Implementsosid.OsidSession
Description

This session provides methods for retrieving CompositionEnablers.

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

Gets the Repository Id associated with this session.

Returnosid.id.Idthe Repository Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetRepository
Description

Gets the Repository associated with this session.

Returnosid.repository.Repositorythe repository
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanLookupCompositionEnablers
Description

Tests if this user can perform CompositionEnablers 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.
MethoduseComparativeCompositionEnablerView
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.
MethodusePlenaryCompositionEnablerView
Description

A complete view of the CompositionEnabler 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.
MethoduseFederatedRepositoryView
Description

Federates the view for methods in this session. A federated view will include composition enablers in repositories which are children of this repository in the repository hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedRepositoryView
Description

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

CompliancemandatoryThis method is must be implemented.
MethoduseActiveCompositionEnablerView
Description

Only active composition enablers are returned by methods in this session.

CompliancemandatoryThis method is must be implemented.
MethoduseAnyStatusCompositionEnablerView
Description

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

CompliancemandatoryThis method is must be implemented.
MethodgetCompositionEnabler
Description

Gets the CompositionEnabler specified by its Id.

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

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

Parametersosid.id.IdcompositionEnablerId Id of the CompositionEnabler
Returnosid.repository.rules.CompositionEnablerthe composition enabler
ErrorsNOT_FOUND compositionEnablerId not found
NULL_ARGUMENT compositionEnablerId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method is must be implemented.
MethodgetCompositionEnablersByIds
Description

Gets a CompositionEnablerList corresponding to the given IdList.

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

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

Parametersosid.id.IdListcompositionEnablerIdsthe list of Ids to retrieve
Returnosid.repository.rules.CompositionEnablerListthe returned CompositionEnabler list
ErrorsNOT_FOUNDan Id was not found
NULL_ARGUMENT compositionEnablerIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCompositionEnablersByGenusType
Description

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

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

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

Parametersosid.type.TypecompositionEnablerGenusTypea composition enabler genus type
Returnosid.repository.rules.CompositionEnablerListthe returned CompositionEnabler list
ErrorsNULL_ARGUMENT compositionEnablerGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCompositionEnablersByParentGenusType
Description

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

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

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

Parametersosid.type.TypecompositionEnablerGenusTypea composition enabler genus type
Returnosid.repository.rules.CompositionEnablerListthe returned CompositionEnabler list
ErrorsNULL_ARGUMENT compositionEnablerGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCompositionEnablersByRecordType
Description

Gets a CompositionEnablerList containing the given composition enabler record Type.

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

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

Parametersosid.type.TypecompositionEnablerRecordTypea composition enabler record type
Returnosid.repository.rules.CompositionEnablerListthe returned CompositionEnabler list
ErrorsNULL_ARGUMENT compositionEnablerRecordType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCompositionEnablersOnDate
Description

Gets a CompositionEnablerList that are effective for the entire given date range inclusive but not confined to the date range for any agent.

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

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

Parametersosid.calendaring.DateTimefroma start date
osid.calendaring.DateTimetoan end date
Returnosid.repository.rules.CompositionEnablerListthe returned CompositionEnabler 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.
MethodgetCompositionEnablersOnDateWithAgent
Description

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

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

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

Parametersosid.id.IdagentIdan agent Id
osid.calendaring.DateTimefroma start date
osid.calendaring.DateTimetoan end date
Returnosid.repository.rules.CompositionEnablerListthe returned CompositionEnabler 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.
MethodgetCompositionEnablers
Description

Gets all CompositionEnablers.

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

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

Returnosid.repository.rules.CompositionEnablerListthe returned CompositionEnabler list
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.