OSID Logo
OSID Specifications
calendaring rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.calendaring.rules.RecurringEventEnablerRuleApplicationSession
Implementsosid.OsidSession
Description

This session provides methods to apply RecurringEventEnablers to RecurringEvents. A RecurringEvent with multiple RecurringEventEnablers means any positive rule evaluation across the enablers result in an effective RecurringEvent.

MethodgetCalendarId
Description

Gets the Calendar Id associated with this session.

Returnosid.id.Idthe Calendar Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetCalendar
Description

Gets the Calendar associated with this session.

Returnosid.calendaring.Calendarthe calendar
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanAssignRecurringEventEnablerRules
Description

Tests if this user can alter recurring event enabler/recurring event mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known mapping 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 mapping is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodassignRecurringEventEnablerToRecurringEvent
Description

Adds an existing RecurringEventEnabler to a RecurringEvent.

Parametersosid.id.IdrecurringEventEnablerIdthe Id of the RecurringEventEnabler
osid.id.IdrecurringEventIdthe Id of the RecurringEvent
ErrorsALREADY_EXISTS recurringEventEnablerId already applied to recurringEventId
NOT_FOUND recurringEventEnablerId or recurringEventId not found
NULL_ARGUMENT recurringEventEnablerId or recurringEventId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodunassignRecurringEventEnablerFromRecurringEvent
Description

Removes a RecurringEventEnabler from a RecurringEvent.

Parametersosid.id.IdrecurringEventEnablerIdthe Id of the RecurringEventEnabler
osid.id.IdrecurringEventIdthe Id of the RecurringEvent
ErrorsNOT_FOUND recurringEventEnablerId or recurringEventId not found or recurringEventEnablerId not applied to recurringEventId
NULL_ARGUMENT recurringEventEnablerId or recurringEventId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanSequenceRecurringEventEnablers
Description

Tests if this user can order RecurringEventEnablers. A return of true does not guarantee successful authorization. A return of false indicates that it is known sequencing operations will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer sequencing operations to an unauthorized user.

Returnboolean false if RecurringEventEnabler ordering is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodmoveRecurringEventEnablerAhead
Description

Reorders recurring event enablers for a recurring event by moving the specified recurring event enabler in front of a reference recurring event enabler.

Parametersosid.id.IdrecurringEventEnablerIdthe Id of a RecurringEventEnabler
osid.id.IdrecurringEventIdthe Id of a RecurringEvent
osid.id.IdreferenceIdthe reference recurring event enabler Id
ErrorsNOT_FOUND recurringEventEnablerId, recurringEventId, or referenceId not found or, recurringEventEnablerId or referenceId not related to recurringEventId
NULL_ARGUMENT recurringEventEnablerId, recurringEventId, or referenceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodmoveRecurringEventEnablerBehind
Description

Reorders recurring event enablers for a recurring event by moving the specified recurring event enabler behind a reference recurring event enabler.

Parametersosid.id.IdrecurringEventEnablerIdthe Id of a RecurringEventEnabler
osid.id.IdrecurringEventIdthe Id of a RecurringEvent
osid.id.IdreferenceIdthe reference recurring event enabler Id
ErrorsNOT_FOUND recurringEventEnablerId, recurringEventId, or referenceId not found or, recurringEventEnablerId or referenceId not related to recurringEventId
NULL_ARGUMENT recurringEventEnablerId, recurringEventId, or referenceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodorderRecurringEventEnablers
Description

Reorders a set of recurring event enablers for a recurring event.

Parametersosid.id.Id[]recurringEventEnablerIdsthe Ids for a set of RecurringEventEnablers
osid.id.IdrecurringEventIdthe Id of a RecurringEvent
ErrorsNOT_FOUND recurringEventEnablerId not related to recurringEventId
NULL_ARGUMENT rceurringEventEnablerIds or recurringEventId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.