OSID - osid.subscription.rules.DispatchConstrainerEnablerPublisherAssignmentSession Service Interface Definition

Interface	osid.subscription.rules.DispatchConstrainerEnablerPublisherAssignmentSession
Implements	`osid.OsidSession`
Used By	`osid.subscription.rules.SubscriptionRulesManager`
Used By	`osid.subscription.rules.SubscriptionRulesProxyManager`
Description	This session provides methods to re-assign `DispatchConstrainerEnabler` to `Publisher` mappings. A `DispatchConstrainerEnabler` may appear in multiple `Publisher` catalogs and removing the last reference to a `DispatchConstrainerEnabler` is the equivalent of deleting it. Each `Publisher` may have its own authorizations governing who is allowed to operate on it. Adding a reference of a `DispatchConstrainerEnabler` to another `Publisher is n` ot a copy operation (eg: does not change its `Id`).
Method	canAssignDispatchConstrainerEnablers
Description	Tests if this user can alter dispatch constrainer enabler/publisher 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. T` his 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	canAssignDispatchConstrainerEnablerToPublisher
Description	Tests if this user can alter dispatch constrainer enabler/publisher 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. T` his is intended as a hint to an application that may opt not to offer assignment operations to unauthorized users.
Parameters	`osid.id.Id`	`publisherId`	the `Id` of the `Publisher`
Return	`boolean`		`false` if mapping is not authorized, `true` otherwise
Errors	NULL_ARGUMENT		`publisherId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	getAssignablePublisherIds
Description	Gets a list of publishers including and under the given publisher node in which any dispatch constrainer enabler can be assigned.
Parameters	`osid.id.Id`	`publisherId`	the `Id` of the `Publisher`
Return	`osid.id.IdList`		list of assignable publisher `Ids`
Errors	NULL_ARGUMENT		`publisherId` is `null`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getAssignablePublisherIdsForDispatchConstrainerEnabler
Description	Gets a list of publishers including and under the given publisher node in which a specific dispatch constrainer enabler can be assigned.
Parameters	`osid.id.Id`	`publisherId`	the `Id` of the `Publisher`
Parameters	`osid.id.Id`	`dispatchConstrainerEnablerId`	the `Id` of the `DispatchConstrainerEnabler`
Return	`osid.id.IdList`		list of assignable publisher `Ids`
Errors	NULL_ARGUMENT		`publisherId` or `dispatchConstrainerEnablerId` is `null`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	assignDispatchConstrainerEnablerToPublisher
Description	Adds an existing `DispatchConstrainerEnabler` to a `Publisher`.
Parameters	`osid.id.Id`	`dispatchConstrainerEnablerId`	the `Id` of the `DispatchConstrainerEnabler`
Parameters	`osid.id.Id`	`publisherId`	the `Id` of the `Publisher`
Errors	ALREADY_EXISTS		`dispatchConstrainerEnablerId` is already assigned to `publisherId`
	NOT_FOUND		`dispatchConstrainerEnablerId` or `publisherId` not found
	NULL_ARGUMENT		`dispatchConstrainerEnablerId` or `publisherId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	unassignDispatchConstrainerEnablerFromPublisher
Description	Removes a `DispatchConstrainerEnabler` from a `Publisher`.
Parameters	`osid.id.Id`	`dispatchConstrainerEnablerId`	the `Id` of the `DispatchConstraienrEnabler`
Parameters	`osid.id.Id`	`publisherId`	the `Id` of the `Publisher`
Errors	NOT_FOUND		`dispatchConstrainerEnablerId` or `publisherId` not found or `dispatchConstrainerEnablerId` not assigned to `publisherId`
	NULL_ARGUMENT		`dispatchConstrainerEnablerId` or `publisherId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	reassignDispatchConstrainerEnablerToPublisher
Description	Moves a `DispatchConstrainerEnabler` from one `Publisher` to another. Mappings to other `Publishers` are unaffected.
Parameters	`osid.id.Id`	`dispatchConstrainerEnablerId`	the `Id` of the `DispatchConstrainerEnabler`
	`osid.id.Id`	`fromPublisherId`	the `Id` of the current `Publisher`
	`osid.id.Id`	`toPublisherId`	the `Id` of the destination `Publisher`
Errors	ALREADY_EXISTS		`dispatchConstrainerEnablerId` already assigned to `toPublisherId`
	NOT_FOUND		`dispatchConstrainerEnablerId, fromPublisherId`, or `toPublisherId` not found or `dispatchConstrainerEnablerId` not mapped to `fromPublisherId`
	NULL_ARGUMENT		`dispatchConstrainerEnablerId, fromPublisherId`, or `toPublisherId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.