Interface AssessmentPartQuerySession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession
- All Known Subinterfaces:
AssessmentPartSearchSession
This session provides methods for searching among
AssessmentPart objects. The search query is constructed using the
AssessmentPartQuery .
This session defines views that offer differing behaviors for searching.
- federated bank view: searches include assessment parts in bank of which this bank is an ancestor in the bank hierarchy
- isolated bank view: searches are restricted to assessment parts in this bank
- sequestered assessment part viiew: All assessment part methods suppress sequestered assessment parts.
- unsequestered assessment part view: All assessment part methods return all assessment parts.
Assessment parts may have a query record indicated by their respective
record types. The query record is accessed via the
AssessmentPartQuery .
-
Method Summary
Modifier and TypeMethodDescriptionbooleanTests if this user can performAssessmentPartlookups.Gets an assessment part query.getAssessmentPartsByQuery(AssessmentPartQuery assessmentPartQuery) Gets a list ofAssessmentPartsmatching the given assessment part query.getBank()Gets theBankassociated with this session.Gets theBankIdassociated with this session.voidFederates the view for methods in this session.voidIsolates the view for methods in this session.voidThe methods in this session omit sequestered assessment parts.voidThe methods in this session return all assessment parts, including sequestered assessment parts.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
-
getBankId
Id getBankId()Gets theBankIdassociated with this session.- Returns:
- the
Bank Idassociated with this session - Compliance:
mandatory- This method must be implemented.
-
getBank
Gets theBankassociated with this session.- Returns:
- the bank
- Throws:
OperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
canSearchAssessmentParts
boolean canSearchAssessmentParts()Tests if this user can performAssessmentPartlookups. 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.
-
useFederatedBankView
void useFederatedBankView()Federates the view for methods in this session. A federated view will include assessment part in banks which are children of this step in the bank hierarchy.- Compliance:
mandatory- This method is must be implemented.
-
useIsolatedBankView
void useIsolatedBankView()Isolates the view for methods in this session. An isolated view restricts lookups to this bank only.- Compliance:
mandatory- This method is must be implemented.
-
useSequesteredAssessmentPartView
void useSequesteredAssessmentPartView()The methods in this session omit sequestered assessment parts.- Compliance:
mandatory- This method is must be implemented.
-
useUnsequesteredAssessmentPartView
void useUnsequesteredAssessmentPartView()The methods in this session return all assessment parts, including sequestered assessment parts.- Compliance:
mandatory- This method is must be implemented.
-
getAssessmentPartQuery
AssessmentPartQuery getAssessmentPartQuery()Gets an assessment part query.- Returns:
- the assessment part query
- Compliance:
mandatory- This method must be implemented.
-
getAssessmentPartsByQuery
AssessmentPartList getAssessmentPartsByQuery(AssessmentPartQuery assessmentPartQuery) throws OperationFailedException, PermissionDeniedException Gets a list ofAssessmentPartsmatching the given assessment part query.- Parameters:
assessmentPartQuery- the assessment part query- Returns:
- the returned
AssessmentPartList - Throws:
NullArgumentException-assessmentPartQueryisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failureUnsupportedException-assessmentPartQueryis not of this service- Compliance:
mandatory- This method must be implemented.
-