OSID - osid.tracking.DuplicateIssueAdminSession Service Interface Definition

Interface	osid.tracking.DuplicateIssueAdminSession
Implements	`osid.OsidSession`
Used By	`osid.tracking.TrackingManager`
Used By	`osid.tracking.TrackingProxyManager`
Description	This session creates and manages linked issues.
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	canLinkIssues
Description	Tests if this user can link duplicate `Issues`. A return of true does not guarantee successful authorization. A return of false indicates that it is known linking an issue will result in a `PERMISSION_DENIED`. This is intended as a hint to an application that may opt not to offer create operations to an unauthorized user.
Return	`boolean`		`false` if linking `Issues` is not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	canLinkIssue
Description	Tests if this user can link an `Issue`. A return of true does not guarantee successful authorization. A return of false indicates that it is known linking the issue will result in a `PERMISSION_DENIED`. This is intended as a hint to an application that may opt not to offer update operations to an unauthorized user.
Parameters	`osid.id.Id`	`issueId`	the `Id` of the `Issue`
Return	`boolean`		`false` if issue linking is not authorized, `true` otherwise
Errors	NULL_ARGUMENT		`issueId` is `null`
Compliance	`mandatory`		This method must be implemented.
Provider Notes	If the `issueId` is not found, then it is acceptable to return false to indicate the lack of linking available.
Method	linkIssue
Description	Links two issues as duplicates. An issue may link to more than issue.
Parameters	`osid.id.Id`	`issueId`	the `Id` of the `Issue`
Parameters	`osid.id.Id`	`anotherIssueId`	the `Id` of another `Issue`
Errors	ALREADY_EXISTS		`issueId` and `anotherIssueId` already linked
	NOT_FOUND		`issueId` or `anotherIssueId` is not found
	NULL_ARGUMENT		`issueId` or `anotherIssueId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	unlinkIssue
Description	Removes the link between two issues as duplicates.
Parameters	`osid.id.Id`	`issueId`	the `Id` of the `Issue`
Parameters	`osid.id.Id`	`anotherIssueId`	the `Id` of another `Issue`
Errors	NOT_FOUND		`issueId` and `anotherIssueId` not linked
	NULL_ARGUMENT		`issueId` or `anotherIssueId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.