public interface ActivityCourseCatalogAssignmentSession extends OsidSession
This session provides methods to re-assign Activities
to
CourseCatalog
objects An Activity
may appear
in multiple CourseCatalog
objects and removing the last
reference to an Activity
is the equivalent of deleting it.
Each CourseCatalog
may have its own authorizations
governing who is allowed to operate on it.
Adding a reference of an Activity
to another
CourseCatalog
is not a copy operation (eg: does not change its
Id
).
Modifier and Type | Method and Description |
---|---|
void |
assignActivityToCourseCatalog(Id activityId,
Id courseCatalogId)
Adds an existing
Activity to a CourseCatalog. |
boolean |
canAssignActivities()
Tests if this user can alter activity/course catalog mappings.
|
boolean |
canAssignActivitiesToCourseCatalog(Id courseCatalogId)
Tests if this user can alter activity/course catalog mappings.
|
IdList |
getAssignableCourseCatalogIds(Id courseCatalogId)
Gets a list of course catalogs including and under the given course
catalog node in which any activity can be assigned.
|
IdList |
getAssignableCourseCatalogIdsForActivity(Id courseCatalogId,
Id activityId)
Gets a list of course catalogs including and under the given course
catalog node in which a specific activity can be assigned.
|
void |
reassignActivityToCourseCatalog(Id activityId,
Id fromCourseCatalogId,
Id toCourseCatalogId)
Moves an
Activity from one CourseCatalog
to another. |
void |
unassignActivityFromCourseCatalog(Id activityId,
Id courseCatalogId)
Removes an
Activity from a CourseCatalog. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canAssignActivities()
PERMISSION_DENIED.
This is intended as
a hint to an application that may opt not to offer assignment
operations to unauthorized users. false
if mapping is not authorized, true
otherwisemandatory
- This method must be implemented. boolean canAssignActivitiesToCourseCatalog(Id courseCatalogId)
PERMISSION_DENIED.
This is intended as
a hint to an application that may opt not to offer lookup operations
to unauthorized users.courseCatalogId
- the Id
of the
CourseCatalog
false
if mapping is not authorized, true
otherwiseNullArgumentException
- courseCatalogId
is null
mandatory
- This method must be implemented. IdList getAssignableCourseCatalogIds(Id courseCatalogId) throws OperationFailedException
courseCatalogId
- the Id
of the
CourseCatalog
Ids
NullArgumentException
- courseCatalogId
is null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. IdList getAssignableCourseCatalogIdsForActivity(Id courseCatalogId, Id activityId) throws OperationFailedException
courseCatalogId
- the Id
of the
CourseCatalog
activityId
- the Id
of the Activity
Ids
NullArgumentException
- courseCatalogId
or activityId
is null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. void assignActivityToCourseCatalog(Id activityId, Id courseCatalogId) throws AlreadyExistsException, NotFoundException, OperationFailedException, PermissionDeniedException
Activity
to a CourseCatalog.
activityId
- the Id
of the Activity
courseCatalogId
- the Id
of the
CourseCatalog
AlreadyExistsException
- activityId
is
already assigned to courseCatalogId
NotFoundException
- activityId
or
courseCatalogId
not foundNullArgumentException
- activityId
or
courseCatalogId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void unassignActivityFromCourseCatalog(Id activityId, Id courseCatalogId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Activity
from a CourseCatalog.
activityId
- the Id
of the Activity
courseCatalogId
- the Id
of the
CourseCatalog
NotFoundException
- activityId
or
courseCatalogId
not found or activityId
not assigned to courseCatalogId
NullArgumentException
- activityId
or
courseCatalogId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void reassignActivityToCourseCatalog(Id activityId, Id fromCourseCatalogId, Id toCourseCatalogId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Activity
from one CourseCatalog
to another. Mappings to other CourseCatalogs
are
unaffected.activityId
- the Id
of the Activity
fromCourseCatalogId
- the Id
of the current
CourseCatalog
toCourseCatalogId
- the Id
of the destination
CourseCatalog
NotFoundException
- activityId,
fromCourseCatalogId,
or toCourseCatalogId
not found or activityId
not mapped to
fromCourseCatalogId
NullArgumentException
- activityId,
fromCourseCatalogId,
or toCourseCatalogId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.