OSID - osid.contact.batch.ContactBatchManager Service Interface Definition

Interface	osid.contact.batch.ContactBatchManager
Implements	`osid.OsidManager`
Implements	`osid.contact.batch.ContactBatchProfile`
Used By	`osid.contact.ContactManager`
Description	The contact batch manager provides access to contact batch sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `ContactBatchSession`: a session to create, modify and delete contacts in bulk `AddressBatchAdminSession`: a session to create, modify and delete addresses in bulk `AddressBookBatchAdminSession`: a session to create, modify and delete address books in bulk
Method	getContactBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk contact administration service.
Return	`osid.contact.batch.ContactBatchAdminSession`		a `ContactBatchAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsContactBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactBatchAdmin()` is `true`.
Method	getContactBatchAdminSessionForAddressBook
Description	Gets the `OsidSession` associated with the bulk contact administration service for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of the `AddressBook`
Return	`osid.contact.batch.ContactBatchAdminSession`		a `ContactBatchAdminSession`
Errors	NOT_FOUND		no `AddressBook` found by the given `Id`
	NULL_ARGUMENT		`addressBookId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactBatchAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactBatchAdmin()` and `supportsVisibleFederation()` are `true`
Method	getAddressBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk address administration service.
Return	`osid.contact.batch.AddressBatchAdminSession`		an `AddressBatchAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAddressBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBatchAdmin()` is `true`.
Method	getAddressBatchAdminSessionForAddressBook
Description	Gets the `OsidSession` associated with the bulk address administration service for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of the `AddressBook`
Return	`osid.contact.batch.AddressBatchAdminSession`		an `AddressBatchAdminSession`
Errors	NOT_FOUND		no `AddressBook` found by the given `Id`
	NULL_ARGUMENT		`addressBookId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBatchAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBatchAdmin()` and `supportsVisibleFederation()` are `true`
Method	getAddressBookBatchAdminSession
Description	Gets the `OsidSession` associated with the bulk address book administration service.
Return	`osid.contact.batch.AddressBookBatchAdminSession`		a `AddressBookBatchAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAddressBookBatchAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookBatchAdmin()` is `true`.