OSID - osid.cataloging.CatalogAssignmentSession Service Interface Definition

Interface	osid.cataloging.CatalogAssignmentSession
Implements	`osid.OsidSession`
Description	This session provides methods to assign OSID `Ids` to `Catalogs.` An `Id` may appear in multiple `Catalogs` and removing the last reference to an `Id` is the equivalent of deleting it. Each catalog may have its own authorizations as to who is allowed to operate on it.
Method	canAssignCatalogs
Description	Tests if this user can perform alter `Id/Catalog` 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 mapping is not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	assignIdToCatalog
Description	Adds an `Id` to a `Catalog.`
Parameters	`osid.id.Id`	`id`	an `Id`
Parameters	`osid.id.Id`	`catalogId`	the `Id` of the `Catalog`
Errors	ALREADY_EXISTS		`id` is already mapped to `catalogId`
	NOT_FOUND		`id` or `catalogId` not found
	NULL_ARGUMENT		`id` or `catalogId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	unassignIdFromCatalog
Description	Removes an `Id` from a `Catalog.`
Parameters	`osid.id.Id`	`id`	an `Id`
Parameters	`osid.id.Id`	`catalogId`	the `Id` of the `Catalog`
Errors	NOT_FOUND		`id` or `catalogId` not found or `id` is not mapped to `catalogId`
	NULL_ARGUMENT		`id` or `catalogId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	reassignIdToCatalog
Description	Moves an `Id` from one `Catalog` to another. Mappings to other `Catalogs` are unaffected.
Parameters	`osid.id.Id`	`id`	the `Id`
	`osid.id.Id`	`fromCatalogId`	the `Id` of the current `Catalog`
	`osid.id.Id`	`toCatalogId`	the `Id` of the destination `Catalog`
Errors	NOT_FOUND		`id, fromCatalogId,` or `toCatalogId` not found or `id` not mapped to `fromCatalogId`
	NULL_ARGUMENT		`id, fromCatalogId,` or `toCatalogId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.