OSID - osid.sequencing.ChainAntimatroidAssignmentSession Service Interface Definition

Interface	osid.sequencing.ChainAntimatroidAssignmentSession
Implements	`osid.OsidSession`
Used By	`osid.sequencing.SequencingManager`
Used By	`osid.sequencing.SequencingProxyManager`
Description	This session provides methods to re-assign `Chains` to `Antimatroid` mappings. A `Chain` may appear in multiple `Antimatroid` objects and removing the last reference to a `Chain` is the equivalent of deleting it. Each `Antimatroid` may have its own authorizations governing who is allowed to operate on it. Adding a reference of a `Chain` to another `Antimatroid` is not a copy operation (eg: does not change its `Id`).
Method	canAssignChains
Description	Tests if this user can alter chain/antimatroid mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known mapping methods in this session will result in a `PERMISSION_DENIED`. This is intended as a hint to an application that may opt not to offer assignment operations to unauthorized users.
Return	`boolean`		`false` if chain is not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	canAssignChainsToAntimatroid
Description	Tests if this user can alter chain/antimatroid mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known mapping methods in this session will result in a `PERMISSION_DENIED`. This is intended as a hint to an application that may opt not to offer assignment operations to unauthorized users.
Parameters	`osid.id.Id`	`antimatroidId`	the `Id` of the `Antimatroid`
Return	`boolean`		`false` if mapping is not authorized, `true` otherwise
Errors	NULL_ARGUMENT		`antimatroidId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	getAssignableAntimatroidIds
Description	Gets a list of antimatroids including and under the given antimatroid node in which any chain can be assigned.
Parameters	`osid.id.Id`	`antimatroidId`	the `Id` of the `Antimatroid`
Return	`osid.id.IdList`		list of assignable antimatroid `Ids`
Errors	NULL_ARGUMENT		`antimatroidId` is `null`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getAssignableAntimatroidIdsForChain
Description	Gets a list of antimatroids including and under the given antimatroid node in which a specific chain can be assigned.
Parameters	`osid.id.Id`	`antimatroidId`	the `Id` of the `Antimatroid`
Parameters	`osid.id.Id`	`chainId`	the `Id` of the `Chain`
Return	`osid.id.IdList`		list of assignable antimatroid `Ids`
Errors	NULL_ARGUMENT		`antimatroidId` or `chainId` is `null`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	assignChainToAntimatroid
Description	Adds an existing `Chain` to a `Antimatroid`.
Parameters	`osid.id.Id`	`chainId`	the `Id` of the `Chain`
Parameters	`osid.id.Id`	`antimatroidId`	the `Id` of the `Antimatroid`
Errors	ALREADY_EXISTS		`chainId` is already assigned to `antimatroidId`
	NOT_FOUND		`chainId` or `antimatroidId` not found
	NULL_ARGUMENT		`chainId` or `antimatroidId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	unassignChainFromAntimatroid
Description	Removes a `Chain` from a `Antimatroid`.
Parameters	`osid.id.Id`	`chainId`	the `Id` of the `Chain`
Parameters	`osid.id.Id`	`antimatroidId`	the `Id` of the `Antimatroid`
Errors	NOT_FOUND		`chainId` or `antimatroidId` not found or `chainId` not assigned to `antimatroidId`
	NULL_ARGUMENT		`chainId` or `antimatroidId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	reassignChainToAntimatroid
Description	Moves a `Chain` from one `Antimatroid` to another. Mappings to other `Antimatroids` are unaffected.
Parameters	`osid.id.Id`	`chainId`	the `Id` of the `Chain`
	`osid.id.Id`	`fromAntimatroidId`	the `Id` of the current `Antimatroid`
	`osid.id.Id`	`toAntimatroidId`	the `Id` of the destination `Antimatroid`
Errors	ALREADY_EXISTS		`chainId` already assigned to `toAntimatroidId`
	NOT_FOUND		`chainId, fromAntimatroidId`, or `toAntimatroidId` not found or `chainId` not mapped to `fromAntimatroidId`
	NULL_ARGUMENT		`chainId, fromAntimatroidId`, or `toAntimatroidId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.