Interface AssessmentEntryCourseCatalogSession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession
This session provides methods to retrieve AssessmentEntry to
CourseCatalog mappings. An AssessmentEntry may appear in
multiple CourseCatalog objects. Each catalog may have its own
authorizations governing who is allowed to look at it.
This lookup session defines several views:
- comparative view: elements may be silently omitted or re-ordered
- plenary view: provides a complete result set or is an error condition
-
Method Summary
Modifier and TypeMethodDescriptionbooleanTests if this user can perform lookups of assessment entry/course catalog mappings.getAssessmentEntriesByCourseCatalog(Id courseCatalogId) Gets the list ofAssessmentEntriesassociated with aCourseCatalog.getAssessmentEntriesByCourseCatalogs(IdList courseCatalogIds) Gets the list ofAssessmentEntriescorresponding to a list ofCourseCatalogobjects.getAssessmentEntryIdsByCourseCatalog(Id courseCatalogId) Gets the list ofAssessmentEntryIdsassociated with aCourseCatalog.getAssessmentEntryIdsByCourseCatalogs(IdList courseCatalogIds) Gets the list ofAssessmentEntryIdscorresponding to a list ofCourseCatalogobjects.getCourseCatalogIdsByAssessmentEntry(Id assessmentEntryId) Gets theCourseCatalogIdsmapped to anAssessmentEntry.getCourseCatalogsByAssessmentEntry(Id assessmentEntryId) Gets theCourseCatalogobjects mapped to anAssessmentEntry.voidThe returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error.voidA complete view of theAssessmentEntryandCourseCatalogreturns is desired.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
-
canLookupCourseCatalogMappings
boolean canLookupCourseCatalogMappings()Tests if this user can perform lookups of assessment entry/course catalog mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known lookup methods in this session will result in aPERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer lookup operations to unauthorized users.- Returns:
falseif looking up mappings is not authorized,trueotherwise- Compliance:
mandatory- This method must be implemented.
-
useComparativeCourseCatalogView
void useComparativeCourseCatalogView()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.- Compliance:
mandatory- This method is must be implemented.
-
usePlenaryCourseCatalogView
void usePlenaryCourseCatalogView()A complete view of theAssessmentEntryandCourseCatalogreturns 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.- Compliance:
mandatory- This method is must be implemented.
-
getAssessmentEntryIdsByCourseCatalog
IdList getAssessmentEntryIdsByCourseCatalog(Id courseCatalogId) throws NotFoundException, OperationFailedException, PermissionDeniedException Gets the list ofAssessmentEntryIdsassociated with aCourseCatalog.- Parameters:
courseCatalogId-Idof theCourseCatalog- Returns:
- list of related assessment entry
Ids - Throws:
NotFoundException-courseCatalogIdis not foundNullArgumentException-courseCatalogIdisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
getAssessmentEntriesByCourseCatalog
AssessmentEntryList getAssessmentEntriesByCourseCatalog(Id courseCatalogId) throws NotFoundException, OperationFailedException, PermissionDeniedException Gets the list ofAssessmentEntriesassociated with aCourseCatalog.- Parameters:
courseCatalogId-Idof theCourseCatalog- Returns:
- list of related assessment entries
- Throws:
NotFoundException-courseCatalogIdis not foundNullArgumentException-courseCatalogIdisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
getAssessmentEntryIdsByCourseCatalogs
IdList getAssessmentEntryIdsByCourseCatalogs(IdList courseCatalogIds) throws OperationFailedException, PermissionDeniedException Gets the list ofAssessmentEntryIdscorresponding to a list ofCourseCatalogobjects.- Parameters:
courseCatalogIds- list of course catalogIds- Returns:
- list of assessment entry
Ids - Throws:
NullArgumentException-courseCatalogIdsisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
getAssessmentEntriesByCourseCatalogs
AssessmentEntryList getAssessmentEntriesByCourseCatalogs(IdList courseCatalogIds) throws OperationFailedException, PermissionDeniedException Gets the list ofAssessmentEntriescorresponding to a list ofCourseCatalogobjects.- Parameters:
courseCatalogIds- list of course catalogIds- Returns:
- list of assessmente ntries
- Throws:
NullArgumentException-courseCatalogIdsisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
getCourseCatalogIdsByAssessmentEntry
IdList getCourseCatalogIdsByAssessmentEntry(Id assessmentEntryId) throws NotFoundException, OperationFailedException, PermissionDeniedException Gets theCourseCatalogIdsmapped to anAssessmentEntry.- Parameters:
assessmentEntryId-Idof apAssessmentEntry- Returns:
- list of course catalog
Ids - Throws:
NotFoundException-assessmentEntryIdis not foundNullArgumentException-assessmentEntryIdisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
getCourseCatalogsByAssessmentEntry
CourseCatalogList getCourseCatalogsByAssessmentEntry(Id assessmentEntryId) throws NotFoundException, OperationFailedException, PermissionDeniedException Gets theCourseCatalogobjects mapped to anAssessmentEntry.- Parameters:
assessmentEntryId-Idof anAssessmentEntry- Returns:
- list of course catalogs
- Throws:
NotFoundException-assessmentEntryIdis not foundNullArgumentException-assessmentEntryIdisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-