Interface StepConstrainerEnablerQuerySession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession
- All Known Subinterfaces:
StepConstrainerEnablerSearchSession
This session provides methods for searching among
StepConstrainerEnabler objects. The search query is constructed using the
StepConstrainerEnablerQuery .
This session defines views that offer differing behaviors for searching.
- federated office view: searches include step constrainer enablers in office of which this office is an ancestor in the office hierarchy
- isolated office view: searches are restricted to step constrainer enablers in this office
Step constrainer enablers may have a query record indicated by their
respective record types. The query record is accessed via the
StepConstrainerEnablerQuery .
-
Method Summary
Modifier and TypeMethodDescriptionbooleanTests if this user can performStepConstrainerEnablerlookups.Gets theOfficeassociated with this session.Gets theOfficeIdassociated with this session.Gets a step constrainer enabler query.getStepConstrainerEnablersByQuery(StepConstrainerEnablerQuery stepConstrainerEnablerQuery) Gets a list ofStepConstrainerEnablersmatching the given step constrainer enabler query.voidFederates the view for methods in this session.voidIsolates the view for methods in this session.Methods inherited from interface OsidSession
closeMethods inherited from interface OsidSession
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactionsModifier and TypeMethodDescriptionGets the agent authenticated to this session.Gets theIdof the agent authenticated to this session.Gets the rate of the service clock.getDate()Gets the service date which may be the current date or the effective date in which this session exists.Gets the effective agent in use by this session.Gets theIdof the effective agent in use by this session.Gets theDisplayTextformatTypepreference in effect for this session.Gets the locale indicating the localization preferences in effect for this session.booleanTests if an agent is authenticated to this session.Starts a new transaction for this sesson.booleanTests for the availability of transactions.
-
Method Details
-
getOfficeId
Id getOfficeId()Gets theOfficeIdassociated with this session.- Returns:
- the
Office Idassociated with this session - Compliance:
mandatory- This method must be implemented.
-
getOffice
Gets theOfficeassociated with this session.- Returns:
- the office
- Throws:
OperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
canSearchStepConstrainerEnablers
boolean canSearchStepConstrainerEnablers()Tests if this user can performStepConstrainerEnablerlookups. 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 aPERMISSION_DENIED. This is intended as a hint to an application that may not offer lookup operations to unauthorized users.- Returns:
falseif search methods are not authorized,trueotherwise- Compliance:
mandatory- This method must be implemented.
-
useFederatedOfficeView
void useFederatedOfficeView()Federates the view for methods in this session. A federated view will include step constrainer enablers in offices which are children of this step in the office hierarchy.- Compliance:
mandatory- This method is must be implemented.
-
useIsolatedOfficeView
void useIsolatedOfficeView()Isolates the view for methods in this session. An isolated view restricts lookups to this office only.- Compliance:
mandatory- This method is must be implemented.
-
getStepConstrainerEnablerQuery
StepConstrainerEnablerQuery getStepConstrainerEnablerQuery()Gets a step constrainer enabler query.- Returns:
- the step constrainer enabler query
- Compliance:
mandatory- This method must be implemented.
-
getStepConstrainerEnablersByQuery
StepConstrainerEnablerList getStepConstrainerEnablersByQuery(StepConstrainerEnablerQuery stepConstrainerEnablerQuery) throws OperationFailedException, PermissionDeniedException Gets a list ofStepConstrainerEnablersmatching the given step constrainer enabler query.- Parameters:
stepConstrainerEnablerQuery- the sestep constrainer enabler query- Returns:
- the returned
StepConstrainerEnablerList - Throws:
NullArgumentException-stepConstrainerEnablerQueryisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failureUnsupportedException-stepConstrainerEnablerQueryis not of this service- Compliance:
mandatory- This method must be implemented.
-