OSID - osid.checklist.ChecklistProxyManager Service Interface Definition

Interface	osid.checklist.ChecklistProxyManager
Implements	`osid.OsidProxyManager`
Implements	`osid.checklist.ChecklistProfile`
Description	The checklist manager provides access to checklist sessions and provides interoperability tests for various aspects of this service. Methods in this manager accept a `Proxy` for passing information from a server environment. The sessions included in this manager are: `TodoLookupSession:` a session to lookup todos `TodoQuerySession:` a session to query todos `TodoSearchSession:` a session to search todos `TodoAdminSession:` a session to manage todos `TodoNotificationSession:` a session to subscribe to notifications of todo changes `TodoHierarchySession:` a session to traverse a hierarchy of todos `TodoHierarchyDesignSession:` a session to manage a todo hierarchy `TodoChecklistSession:` a session for looking up todo and checklist mappings `TodoChecklistAssignmentSession:` a session for managing todo and checklist mappings `TodoSmartChecklistSession:` a session to manage dynamic todo checklists `ChecklistLookupSession:` a session to retrieve checklists `ChecklistQuerySession:` a session to query checklists `ChecklistSearchSession:` a session to search for checklists `ChecklistAdminSession:` a session to create, update and delete checklists `ChecklistNotificationSession:` a session to receive notifications for changes in checklists `ChecklistHierarchyTraversalSession:` a session to traverse hierarchies of checklists `ChecklistHierarchyDesignSession:` a session to manage hierarchies of checklists The todoing manager also provides a profile for determing the supported search types supported by this service.
Method	getTodoLookupSession
Description	Gets the `OsidSession` associated with the todo lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoLookupSession`		a `TodoLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoLookup()` is `true.`
Method	getTodoLookupSessionForChecklist
Description	Gets the `OsidSession` associated with the todo lookup service for the given checklist.
Parameters	`osid.id.Id`	`checklistId`	the `Id` of the `Checklist`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoLookupSession`		a `TodoLookupSession`
Errors	NOT_FOUND		no `Checklist` found by the given `Id`
	NULL_ARGUMENT		`checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoLookup()` and `supportsVisibleFederation()` are `true`
Method	getTodoQuerySession
Description	Gets the `OsidSession` associated with the todo query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoQuerySession`		a `TodoQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoQuery()` is `true.`
Method	getTodoQuerySessionForChecklist
Description	Gets the `OsidSession` associated with the todo query service for the given checklist.
Parameters	`osid.id.Id`	`checklistId`	the `Id` of the `Checklist`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoQuerySession`		a `TodoQuerySession`
Errors	NOT_FOUND		no `Todo` found by the given `Id`
	NULL_ARGUMENT		`checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoQuery()` and `supportsVisibleFederation()` are `true`
Method	getTodoSearchSession
Description	Gets the `OsidSession` associated with the todo search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoSearchSession`		a `TodoSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoSearch()` is `true.`
Method	getTodoSearchSessionForChecklist
Description	Gets the `OsidSession` associated with the todo search service for the given checklist.
Parameters	`osid.id.Id`	`checklistId`	the `Id` of the `Checklist`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoSearchSession`		a `TodoSearchSession`
Errors	NOT_FOUND		no `Todo` found by the given `Id`
	NULL_ARGUMENT		`checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoSearch()` and `supportsVisibleFederation()` are `true`
Method	getTodoAdminSession
Description	Gets the `OsidSession` associated with the todo administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoAdminSession`		a `TodoAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoAdmin()` is `true.`
Method	getTodoAdminSessionForChecklist
Description	Gets the `OsidSession` associated with the todo administration service for the given checklist.
Parameters	`osid.id.Id`	`checklistId`	the `Id` of the `Checklist`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoAdminSession`		a `TodoAdminSession`
Errors	NOT_FOUND		no `Todo` found by the given `Id`
	NULL_ARGUMENT		`checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoAdmin()` and `supportsVisibleFederation()` are `true`
Method	getTodoNotificationSession
Description	Gets the `OsidSession` associated with the todo notification service.
Parameters	`osid.checklist.TodoReceiver`	`todoReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoNotificationSession`		a `TodoNotificationSession`
Errors	NULL_ARGUMENT		`todoReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoNotification()` is `true.`
Method	getTodoNotificationSessionForChecklist
Description	Gets the `OsidSession` associated with the todo notification service for the given checklist.
Parameters	`osid.checklist.TodoReceiver`	`todoReceiver`	the receiver
	`osid.id.Id`	`checklistId`	the `Id` of the `Checklist`
	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoNotificationSession`		a `TodoNotificationSession`
Errors	NOT_FOUND		no `Todo` found by the given `Id`
	NULL_ARGUMENT		`todoReceiver, checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoNotification()` and `supportsVisibleFederation()` are `true`
Method	getTodoHierarchySession
Description	Gets the todo hierarchy traversal session.
Parameters	`osid.proxy.Proxy`	`proxy`	proxy
Return	`osid.checklist.TodoHierarchySession`		`a TodoHierarchySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoHierarchy()` is `true.`
Method	getTodoHierarchySessionForChecklist
Description	Gets the todo hierarchy traversal session for the given checklist.
Parameters	`osid.id.Id`	`checklistId`	the `Id` of the `Checklist`
Parameters	`osid.proxy.Proxy`	`proxy`	proxy
Return	`osid.checklist.TodoHierarchySession`		`a TodoHierarchySession`
Errors	NOT_FOUND		no checklist found by the given `Id`
	NULL_ARGUMENT		`checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoHierarchy()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoHierarchy()` and `supportsVisibleFederation()` are `true`
Method	getTodoHierarchyDesignSession
Description	Gets the todo hierarchy design session.
Parameters	`osid.proxy.Proxy`	`proxy`	proxy
Return	`osid.checklist.TodoHierarchyDesignSession`		a `TodoHierarchyDesignSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoHierarchyDesign()` is `true.`
Method	getTodoHierarchyDesignSessionForChecklist
Description	Gets the todo hierarchy design session for the given checklist.
Parameters	`osid.id.Id`	`checklistId`	the `Id` of the `Checklist`
Parameters	`osid.proxy.Proxy`	`proxy`	proxy
Return	`osid.checklist.TodoHierarchyDesignSession`		a `TodoHierarchyDesignSession`
Errors	NOT_FOUND		no checklist found by the given `Id`
	NULL_ARGUMENT		`checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoHierarchyDesign()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoHierarchyDesign()` and `supportsVisibleFederation()` are `true`
Method	getTodoChecklistSession
Description	Gets the session for retrieving todo to checklist mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoChecklistSession`		a `TodoChecklistSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoChecklist()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoChecklist()` is `true.`
Method	getTodoChecklistAssignmentSession
Description	Gets the session for assigning todo to checklist mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoChecklistAssignmentSession`		a `TodoChecklistAssignmentSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoChecklistAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoChecklistAssignment()` is `true.`
Method	getTodoSmartChecklistSession
Description	Gets the session for managing dynamic todo checklists for the given checklist.
Parameters	`osid.id.Id`	`checklistId`	the `Id` of a checklist
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.TodoSmartChecklistSession`		`checklistId` not found
Errors	NOT_FOUND		`checklistId` or `proxy` is `null`
	NULL_ARGUMENT		`checklistId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsTodoSmartChecklist()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTodoSmartChecklist()` is `true.`
Method	getChecklistLookupSession
Description	Gets the `OsidSession` associated with the checklist lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.ChecklistLookupSession`		a `ChecklistLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsChecklistLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistLookup()` is `true.`
Method	getChecklistQuerySession
Description	Gets the `OsidSession` associated with the checklist query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.ChecklistQuerySession`		a `ChecklistQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsChecklistQueryh()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistQuery()` is `true.`
Method	getChecklistSearchSession
Description	Gets the `OsidSession` associated with the checklist search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.ChecklistSearchSession`		a `ChecklistSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsChecklistSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistSearch()` is `true.`
Method	getChecklistAdminSession
Description	Gets the `OsidSession` associated with the checklist administrative service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.ChecklistAdminSession`		a `ChecklistAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsChecklistAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistAdmin()` is `true.`
Method	getChecklistNotificationSession
Description	Gets the `OsidSession` associated with the checklist notification service.
Parameters	`osid.checklist.ChecklistReceiver`	`checklistReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.ChecklistNotificationSession`		a `ChecklistNotificationSession`
Errors	NULL_ARGUMENT		`checklistReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsChecklistNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistNotification()` is `true.`
Method	getChecklistHierarchySession
Description	Gets the `OsidSession` associated with the checklist hierarchy service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.ChecklistHierarchySession`		a `ChecklistHierarchySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsChecklistHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistHierarchy()` is `true.`
Method	getChecklistHierarchyDesignSession
Description	Gets the `OsidSession` associated with the checklist hierarchy design service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.checklist.ChecklistHierarchyDesignSession`		a `ChecklistHierarchyDesignSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsChecklistHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistHierarchyDesign()` is `true.`
Method	getChecklistBatchProxyManager
Description	Gets a `ChecklistBatchProxyManager.`
Return	`osid.checklist.batch.ChecklistBatchProxyManager`		a `ChecklistBatchProxyManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsChecklistBatch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistBatch()` is `true.`
Method	getChecklistMasonProxyManager
Description	Gets a `ChecklistMasonProxyManager.`
Return	`osid.checklist.mason.ChecklistMasonProxyManager`		a `ChecklistMasonProxyManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsChecklistMason()` is `false`
Compliance	`optional`		This method must be implemented if `supportsChecklistMason()` is `true.`