public interface IssueOublietteAssignmentSession extends OsidSession
This session provides methods to re-assign Issues
to
Oubliette
mappings. An Issue
may appear in
multiple Oubliette
objects and removing the last reference
to an Issue
is the equivalent of deleting it. Each
Oubliette
may have its own authorizations governing who is allowed
to operate on it.
Adding a reference of an Issue
to another
Oubliette
is not a copy operation (eg: does not change its
Id
).
Modifier and Type | Method and Description |
---|---|
void |
assignIssueToOubliette(Id issueId,
Id oublietteId)
Adds an existing
Issue to a Oubliette. |
boolean |
canAssignIssues()
Tests if this user can alter issue/oubliette mappings.
|
boolean |
canAssignIssuesToOubliette(Id oublietteId)
Tests if this user can alter issue/oubliette mappings.
|
IdList |
getAssignableOublietteIds(Id oublietteId)
Gets a list of oubliettes including and under the given oubliette node
in which any issue can be assigned.
|
IdList |
getAssignableOublietteIdsForIssue(Id oublietteId,
Id issueId)
Gets a list of oubliettes including and under the given oubliette node
in which a specific issue can be assigned.
|
void |
reassignIssueToOubliette(Id issueId,
Id fromOublietteId,
Id toOublietteId)
Moves an
Issue from one Oubliette to
another. |
void |
unassignIssueFromOubliette(Id issueId,
Id oublietteId)
Removes an
Issue from a Oubliette. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canAssignIssues()
PERMISSION_DENIED.
This is intended as a hint to
an application that may opt not to offer lookup operations to
unauthorized users. false
if issue is not authorized, true
otherwisemandatory
- This method must be implemented. boolean canAssignIssuesToOubliette(Id oublietteId)
PERMISSION_DENIED.
This is intended as a hint to
an application that may opt not to offer lookup operations to
unauthorized users.oublietteId
- the Id
of the Oubliette
false
if mapping is not authorized, true
otherwiseNullArgumentException
- oublietteId
is
null
mandatory
- This method must be implemented. IdList getAssignableOublietteIds(Id oublietteId) throws OperationFailedException
oublietteId
- the Id
of the Oubliette
Ids
NullArgumentException
- oublietteId
is
null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. IdList getAssignableOublietteIdsForIssue(Id oublietteId, Id issueId) throws OperationFailedException
oublietteId
- the Id
of the Oubliette
issueId
- the Id
of the Issue
Ids
NullArgumentException
- oublietteId
or
issueId
is null
OperationFailedException
- unable to complete requestmandatory
- This method must be implemented. void assignIssueToOubliette(Id issueId, Id oublietteId) throws AlreadyExistsException, NotFoundException, OperationFailedException, PermissionDeniedException
Issue
to a Oubliette.
issueId
- the Id
of the Issue
oublietteId
- the Id
of the Oubliette
AlreadyExistsException
- issueId
is
already assigned to oublietteId
NotFoundException
- issueId
or
oublietteId
not foundNullArgumentException
- issueId
or
oublietteId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void unassignIssueFromOubliette(Id issueId, Id oublietteId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Issue
from a Oubliette.
issueId
- the Id
of the Issue
oublietteId
- the Id
of the Oubliette
NotFoundException
- issueId
or
oublietteId
not found or issueId
is not
assigned to oublietteId
NullArgumentException
- issueId
or
oublietteId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void reassignIssueToOubliette(Id issueId, Id fromOublietteId, Id toOublietteId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Issue
from one Oubliette
to
another. Mappings to other Oubliettes
are unaffected.issueId
- the Id
of the Issue
fromOublietteId
- the Id
of the current
Oubliette
toOublietteId
- the Id
of the destination
Oubliette
NotFoundException
- issueId, fromOublietteId,
or toOublietteId
not found or
issueId
not mapped to fromOublietteId
NullArgumentException
- issueId,
fromOublietteId,
or toOublietteId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.