public interface InquiryEnablerInquestAssignmentSession extends OsidSession
This session provides methods to re-assign InquiryEnabler
to Inquest
mappings. An InquiryEnabler
may appear in multiple Inquest
objects and removing
the last reference to an InquiryEnabler
is the equivalent
of deleting it. Each Inquest
may have its own
authorizations governing who is allowed to operate on it.
Adding a reference of an InquiryEnabler
to another
Inquest
is not a copy operation (eg: does not change its
Id
).
Modifier and Type | Method and Description |
---|---|
void |
assignInquiryEnablerToInquest(Id inquiryEnablerId,
Id inquestId)
Adds an existing
InquiryEnabler to an Inquest. |
boolean |
canAssignInquiryEnablers()
Tests if this user can alter inquiry enabler/inquest mappings.
|
boolean |
canAssignInquiryEnablersToInquest(Id inquestId)
Tests if this user can alter inquiry enabler/inquest mappings.
|
IdList |
getAssignableInquestIds(Id inquestId)
Gets a list of inquests including and under the given inquest node in
which any inquiry enabler can be assigned.
|
IdList |
getAssignableInquestIdsForInquiryEnabler(Id inquestId,
Id inquiryEnablerId)
Gets a list of inquests including and under the given inquest node in
which a specific inquiry enabler can be assigned.
|
void |
reassignInquiryEnablerToInquest(Id inquiryEnablerId,
Id fromInquestId,
Id toInquestId)
Moves an
InquiryEnabler from one Inquest
to another. |
void |
unassignInquiryEnablerFromInquest(Id inquiryEnablerId,
Id inquestId)
Removes an
InquiryEnabler from an Inquest. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canAssignInquiryEnablers()
PERMISSION_DENIED.
This is intended as
a hint to an application that may opt not to offer lookup operations
to unauthorized users. false
if mapping is not authorized, true
otherwisemandatory
- This method must be implemented. boolean canAssignInquiryEnablersToInquest(Id inquestId)
PERMISSION_DENIED.
This is intended as
a hint to an application that may opt not to offer lookup operations
to unauthorized users.inquestId
- the Id
of the Inquest
false
if mapping is not authorized, true
otherwiseNullArgumentException
- inquestId
is
null
mandatory
- This method must be implemented. IdList getAssignableInquestIds(Id inquestId) throws OperationFailedException
inquestId
- the Id
of the Inquest
Ids
NullArgumentException
- inquestId
is
null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. IdList getAssignableInquestIdsForInquiryEnabler(Id inquestId, Id inquiryEnablerId) throws OperationFailedException
inquestId
- the Id
of the Inquest
inquiryEnablerId
- the Id
of the
InquiryEnabler
Ids
NullArgumentException
- inquestId
or
inquiryEnablerId
is null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. void assignInquiryEnablerToInquest(Id inquiryEnablerId, Id inquestId) throws AlreadyExistsException, NotFoundException, OperationFailedException, PermissionDeniedException
InquiryEnabler
to an Inquest.
inquiryEnablerId
- the Id
of the
InquiryEnabler
inquestId
- the Id
of the Inquest
AlreadyExistsException
- inquiryEnablerId
already assigned to inquestId
NotFoundException
- inquiryEnablerId
or
inquestId
not foundNullArgumentException
- inquiryEnablerId
or inquestId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void unassignInquiryEnablerFromInquest(Id inquiryEnablerId, Id inquestId) throws NotFoundException, OperationFailedException, PermissionDeniedException
InquiryEnabler
from an Inquest.
inquiryEnablerId
- the Id
of the
InquiryEnabler
inquestId
- the Id
of the Inquest
NotFoundException
- inquiryEnablerId
or
inquestId
not found or inquiryEnablerId
already assigned to inquestId
NullArgumentException
- inquiryEnablerId
or inquestId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void reassignInquiryEnablerToInquest(Id inquiryEnablerId, Id fromInquestId, Id toInquestId) throws NotFoundException, OperationFailedException, PermissionDeniedException
InquiryEnabler
from one Inquest
to another. Mappings to other Inquests
are unaffected.inquiryEnablerId
- the Id
of the
InquiryEnabler
fromInquestId
- the Id
of the current
Inquest
toInquestId
- the Id
of the destination
Inquest
NotFoundException
- inquiryEnabler,
fromInquestId,
or toInquestId
not found
or inquiryEnabler
not mapped to
fromInquestId
NullArgumentException
- inquiryEnabler,
fromInquestId,
or toInquestId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.