OSID - osid.forum.PostForumAssignmentSession Service Interface Definition

Interface	osid.forum.PostForumAssignmentSession
Implements	`osid.OsidSession`
Used By	`osid.forum.ForumManager`
Used By	`osid.forum.ForumProxyManager`
Description	This session provides methods to re-assign `Posts` to `Forums`. A `Post` may map to multiple `Forums` and removing the last reference to a `Post` is the equivalent of deleting it. Each `Forum` may have its own authorizations governing who is allowed to operate on it. Adding a reference of a `Post` to another `Forum` is not a copy operation (eg: does not change its `Id`).
Method	canAssignPosts
Description	Tests if this user can alter post/forum 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	canAssignPostsToForum
Description	Tests if this user can alter post/forum 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`	`forumId`	the `Id` of the `Forum`
Return	`boolean`		`false` if mapping is not authorized, `true` otherwise
Errors	NULL_ARGUMENT		`forumId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	getAssignableForumIds
Description	Gets a list of forums including and under the given forum node in which any post can be assigned.
Parameters	`osid.id.Id`	`forumId`	the `Id` of the `Forum`
Return	`osid.id.IdList`		list of assignable forum `Ids`
Errors	NULL_ARGUMENT		`forumId` is `null`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getAssignableForumIdsForPost
Description	Gets a list of forums including and under the given forum node in which a specific post can be assigned.
Parameters	`osid.id.Id`	`forumId`	the `Id` of the `Forum`
Parameters	`osid.id.Id`	`postId`	the `Id` of the `Post`
Return	`osid.id.IdList`		list of assignable forum `Ids`
Errors	NULL_ARGUMENT		`forumId` or `postId` is `null`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	assignPostToForum
Description	Adds an existing `Post` to a `Forum`.
Parameters	`osid.id.Id`	`postId`	the `Id` of the `Post`
Parameters	`osid.id.Id`	`forumId`	the `Id` of the `Forum`
Errors	ALREADY_EXISTS		`postId` is already assigned to `forumId`
	NOT_FOUND		`postId` or `forumId` not found
	NULL_ARGUMENT		`postId` or `forumId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	unassignPostFromForum
Description	Removes a `Post` from a `Forum`.
Parameters	`osid.id.Id`	`postId`	the `Id` of the `Post`
Parameters	`osid.id.Id`	`forumId`	the `Id` of the `Forum`
Errors	NOT_FOUND		`postId` or `forumId` not found or `postId` not assigned to `forumId`
	NULL_ARGUMENT		`postId` or `forumId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	reassignPostToForum
Description	Moves a `Post` from one `Forum` to another. Mappings to other `Forums` are unaffected.
Parameters	`osid.id.Id`	`postId`	the `Id` of the `Post`
	`osid.id.Id`	`fromForumId`	the `Id` of the current `Forum`
	`osid.id.Id`	`toForumId`	the `Id` of the destination `Forum`
Errors	ALREADY_EXISTS		`postId` already assigned to `toForumId`
	NOT_FOUND		`postId, fromForumId`, or `toForumId` not found or `postId` not mapped to `fromForumId`
	NULL_ARGUMENT		`postId, fromForumId`, or `toForumId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.