OSID - osid.tracking.IssueTriagingSession Service Interface Definition

Interface	osid.tracking.IssueTriagingSession
Implements	`osid.OsidSession`
Description	This session defines methods for routing issues. This lookup session defines several views: isolated front office view: All issue methods in this session operate, retrieve and pertain to issues defined explicitly in the current front office. Using an isolated view is useful for managing `Issues` with the `IssueAdminSession.` federated front office view: All issue lookup methods in this session operate, retrieve and pertain to all issues defined in this front office and any other issues implicitly available in this front office through front office inheritence. The methods `useFederatedFrontOfficeView()` and `useIsolatedFrontOfficeView()` behave as a radio group and one should be selected before invoking any lookup methods.
Method	getFrontOfficeId
Description	Gets the `FrontOffice` `Id` associated with this session.
Return	`osid.id.Id`		the `FrontOffice Id` associated with this session
Compliance	`mandatory`		This method must be implemented.
Method	getFrontOffice
Description	Gets the `FrontOffice` associated with this session.
Return	`osid.tracking.FrontOffice`		the front office
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	canRouteIssues
Description	Tests if this user can route `Issue` lookups. 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 a `PERMISSION_DENIED.` This is intended as a hint to an application that may not offer routing operations to unauthorized users.
Return	`boolean`		`false` if routing methods are not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	useFederatedFrontOfficeView
Description	Federates the view for methods in this session. A federated view will include issues in front offices which are children of this front office in the front office hierarchy.
Compliance	`mandatory`		This method is must be implemented.
Method	useIsolatedFrontOfficeView
Description	Isolates the view for methods in this session. An isolated view restricts retrievals to this front office only.
Compliance	`mandatory`		This method is must be implemented.
Method	moveIssueToQueue
Description	Moves an `Issue` to another `Queue.` If the assigned resource is not valid in the destination queue, the issue may automatically be unassigned. If the assigned topic is not valid in the destination queue, it may default to another topic.
Parameters	`osid.id.Id`	`issueId`	the `Id` of the `Issue`
Parameters	`osid.id.Id`	`queueId`	the `Id` of the `Queue`
Errors	ALREADY_EXISTS		`issueId` already in `queueId`
	NOT_FOUND		`issueId` or `queueId` not found
	NULL_ARGUMENT		`issueId` or `queueId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	getAssignableTopicIds
Description	Gets a list of assignable topic `Ids` for a queue.
Parameters	`osid.id.Id`	`queueId`	the `Id` of the `Queue`
Return	`osid.id.IdList`		a list of subject `Ids`
Errors	NOT_FOUND		`queueId` not found
	NULL_ARGUMENT		`queueId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	getAssignableTopics
Description	Gets a list of assignable topics for a queue.
Parameters	`osid.id.Id`	`queueId`	the `Id` of the `Queue`
Return	`osid.ontology.SubjectList`		a list of subjects
Errors	NOT_FOUND		`queueId` not found
	NULL_ARGUMENT		`queueId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	assignTopic
Description	Assigns a `Topic` to an `Issue.`
Parameters	`osid.id.Id`	`issueId`	the `Id` of the `Issue`
Parameters	`osid.id.Id`	`subjectId`	the `Id` of the `Subject`
Errors	ALREADY_EXISTS		`issueId` already assigned to `subjectId`
	NOT_FOUND		`issueId` or `subjectId` not found
	NULL_ARGUMENT		`issueId` or `subjectId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	closeIssue
Description	Closes an issue.
Parameters	`osid.id.Id`	`issueId`	the `Id` of the `Issue`
Errors	NOT_FOUND		`issueId` not found
	NULL_ARGUMENT		`issueId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.