OSID Logo
OSID Specifications
control rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.control.rules.ActionEnablerRuleApplicationSession
Implementsosid.OsidSession
Description

This session provides methods to apply ActionEnablers to Actions. An Action with multiple ActionEnablers means any positive rule evaluation across the enablers result in an active Action.

MethodgetSystemId
Description

Gets the System Id associated with this session.

Returnosid.id.Idthe System Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetSystem
Description

Gets the System associated with this session.

Returnosid.control.Systemthe system
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanAssignActionEnablers
Description

Tests if this user can alter action enabler/action 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.
MethodassignActionEnablerToAction
Description

Adds an existing ActionEnabler to an Action.

Parametersosid.id.IdactionEnablerIdthe Id of the ActionEnabler
osid.id.IdactionIdthe Id of the Action
ErrorsALREADY_EXISTS actionEnablerId already applied to actionId
NOT_FOUND actionEnablerId or actionId not found
NULL_ARGUMENT actionEnablerId or actionId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodunassignActionEnablerFromAction
Description

Removes an ActionEnabler from an Action.

Parametersosid.id.IdactionEnablerIdthe Id of the ActionEnabler
osid.id.IdactionIdthe Id of the Action
ErrorsNOT_FOUND actionEnablerId or actionId not found or actionEnablerId not applied to actionId
NULL_ARGUMENT actionEnablerId or actionId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanSequenceActionEnablers
Description

Tests if this user can order ActionEnablers. 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 ActionEnabler ordering is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodmoveActionEnablerAhead
Description

Reorders action enablers for an action by moving the specified action enabler in front of a reference action enabler.

Parametersosid.id.IdactionEnablerIdthe Id of an ActionEnabler
osid.id.IdactionIdthe Id of an Action
osid.id.IdreferenceIdthe reference action enabler Id
ErrorsNOT_FOUND actionEnablerId, actionId, or referenceId not found or, actionEnablerId or referenceId not related to actionId
NULL_ARGUMENT actionEnablerId, actionId, or referenceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodmoveActionEnablerBehind
Description

Reorders action enablers for an action by moving the specified action enabler behind a reference action enabler.

Parametersosid.id.IdactionEnablerIdthe Id of an ActionEnabler
osid.id.IdactionIdthe Id of an Action
osid.id.IdreferenceIdthe reference action enabler Id
ErrorsNOT_FOUND actionEnablerId, actionId, or referenceId not found or, actionEnablerId or referenceId not related to actionId
NULL_ARGUMENT actionEnablerId, actionId, or referenceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodorderActionEnablers
Description

Reorders a set of action enablers for an action.

Parametersosid.id.Id[]actionEnablerIdsthe Ids for a set of ActionEnablers
osid.id.IdactionIdthe Id of an Action
ErrorsNOT_FOUND actionEnablerId not found or, an actionEnablerId not related to actionId
NULL_ARGUMENT actionEnablerIds or actionId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.