OSID - osid.contact.ContactProxyManager Service Interface Definition

Interface	osid.contact.ContactProxyManager
Implements	`osid.OsidProxyManager`
Implements	`osid.contact.ContactProfile`
Description	The contact manager provides access to contact 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: `ContactSession` : a session to get available contacts for a resource `ContactLookupSession:` a session to lookup contacts `ContactQuerySession:` a session to query contacts `ContactSearchSession:` a session to search contacts `ContactAdminSession:` a session to manage contacts `ContactNotificationSession:` a session to subscribe to notifications of contact changes `ContactAddressBookSession:` a session to lookup contact address book mappings `ContactAddressBookAssignmentSession:` a session to manage contact address book mappings `ContactSmartAddressBookSession:` a session to manage smart address books of contacts `AddressLookupSession:` a session to retrieve addresses `AddressQuerySession:` a session to query addresses `AddressSearchSession:` a session to search for addresses `AddressAdminSession:` a session to create, update and delete addresses `AddressNotificationSession:` a session to receive notifications for changes in addresses `AddressAddressBookSession:` a session to lookup address address book mappings `AddressAddressBookAssignmentSession:` a session to manage address address book mappings `AddressSmartAddressBookSession:` a session to manage smart address books of addresses `AddressBookLookupSession:` a session to retrieve address books `AddressBookQuerySession:` a session to query address books `AddressBookSearchSession:` a session to search for address books `AddressBookAdminSession:` a session to create, update and delete address books `AddressBookNotificationSession:` a session to receive notifications for changes in address books `AddressBookHierarchyTraversalSession:` a session to traverse hierarchies of address books `AddressBookHierarchyDesignSession:` a session to manage hierarchies of address books The contact manager also provides a profile for determing the supported search types supported by this service.
Method	getContactSession
Description	Gets the `OsidSession` associated with the contact service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactSession`		a `ContactSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContact()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContact()` is `true.`
Method	getContactSessionForAddressBook
Description	Gets the `OsidSession` associated with the contact service for the given address book.
Parameters	`osid.id.Id`	`addressId`	the `Id` of the `Address`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactSession`		a `ContactLookupSession`
Errors	NOT_FOUND		no `Address` found by the given `Id`
	NULL_ARGUMENT		`addressId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContact()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContact()` and `supportsVisibleFederation()` are `true`
Method	getContactLookupSession
Description	Gets the `OsidSession` associated with the contact lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactLookupSession`		a `ContactLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactLookup()` is `true.`
Method	getContactLookupSessionForAddressBook
Description	Gets the `OsidSession` associated with the contact lookup service for the given address book.
Parameters	`osid.id.Id`	`addressId`	the `Id` of the `Address`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactLookupSession`		a `ContactLookupSession`
Errors	NOT_FOUND		no `Address` found by the given `Id`
	NULL_ARGUMENT		`addressId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactLookup()` and `supportsVisibleFederation()` are `true`
Method	getContactQuerySession
Description	Gets the `OsidSession` associated with the contact query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactQuerySession`		a `ContactQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactQuery()` is `true.`
Method	getContactQuerySessionForAddressBook
Description	Gets the `OsidSession` associated with the contact query service for the given address book.
Parameters	`osid.id.Id`	`addressId`	the `Id` of the `Address`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactQuerySession`		a `ContactQuerySession`
Errors	NOT_FOUND		no `Contact` found by the given `Id`
	NULL_ARGUMENT		`addressId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactQuery()` and `supportsVisibleFederation()` are `true`
Method	getContactSearchSession
Description	Gets the `OsidSession` associated with the contact search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactSearchSession`		a `ContactSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactSearch()` is `true.`
Method	getContactSearchSessionForAddressBook
Description	Gets the `OsidSession` associated with the contact search service for the given address book.
Parameters	`osid.id.Id`	`addressId`	the `Id` of the `Address`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactSearchSession`		a `ContactSearchSession`
Errors	NOT_FOUND		no `Contact` found by the given `Id`
	NULL_ARGUMENT		`addressId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactSearch()` and `supportsVisibleFederation()` are `true`
Method	getContactAdminSession
Description	Gets the `OsidSession` associated with the contact administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactAdminSession`		a `ContactAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactAdmin()` is `true.`
Method	getContactAdminSessionForAddressBook
Description	Gets the `OsidSession` associated with the contact administration service for the given address book.
Parameters	`osid.id.Id`	`addressId`	the `Id` of the `Address`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactAdminSession`		a `ContactAdminSession`
Errors	NOT_FOUND		no `Contact` found by the given `Id`
	NULL_ARGUMENT		`addressId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactAdmin()` and `supportsVisibleFederation()` are `true`
Method	getContactNotificationSession
Description	Gets the `OsidSession` associated with the contact notification service.
Parameters	`osid.contact.ContactReceiver`	`contactReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactNotificationSession`		a `ContactNotificationSession`
Errors	NULL_ARGUMENT		`contactReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactNotification()` is `true.`
Method	getContactNotificationSessionForAddressBook
Description	Gets the `OsidSession` associated with the contact notification service for the given address book.
Parameters	`osid.contact.ContactReceiver`	`contactReceiver`	the receiver
	`osid.id.Id`	`addressId`	the `Id` of the `Address`
	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactNotificationSession`		a `ContactNotificationSession`
Errors	NOT_FOUND		no `Contact` found by the given `Id`
	NULL_ARGUMENT		`contactReceiver, addressId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactNotification()` and `supportsVisibleFederation()` are `true`
Method	getContactAddressBookSession
Description	Gets the session for retrieving contact to address book mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactAddressBookSession`		a `ContactAddressBookSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactAddressBook()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactAddressBook()` is `true.`
Method	getContactAddressBookAssignmentSession
Description	Gets the session for assigning contact to address book mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactAddressBookAssignmentSession`		a `ContactAddressBookAssignmentSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactAddressBookAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactAddressBookAssignment()` is `true.`
Method	getContactSmartAddressBookSession
Description	Gets the session associated with the contact smart address book for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of the contact book
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.ContactSmartAddressBookSession`		a `ContactSmartAddressBookSession`
Errors	NOT_FOUND		`contactBookId` not found
	NULL_ARGUMENT		`contactBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsContactSmartAddressBook()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactSmartAddressBook()` is `true.`
Method	getAddressLookupSession
Description	Gets the `OsidSession` associated with the address lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressLookupSession`		an `AddressLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressLookup()` is `true.`
Method	getAddressLookupSessionForAddressBook
Description	Gets the `OsidSession` associated with the address lookup service for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of the `AddressBook`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressLookupSession`		an `AddressLookupSession`
Errors	NOT_FOUND		no `AddressBook` found by the given `Id`
	NULL_ARGUMENT		`addressBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressLookup()` and `supportsVisibleFederation()` are `true`
Method	getAddressQuerySession
Description	Gets the `OsidSession` associated with the address query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressQuerySession`		an `AddressQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressQuery()` is `true.`
Method	getAddressQuerySessionForAddressBook
Description	Gets the `OsidSession` associated with the address query service for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of the `AddressBook`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressQuerySession`		an `AddressQuerySession`
Errors	NOT_FOUND		no `Address` found by the given `Id`
	NULL_ARGUMENT		`addressBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressQuery()` and `supportsVisibleFederation()` are `true`
Method	getAddressSearchSession
Description	Gets the `OsidSession` associated with the address search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressSearchSession`		an `AddressSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressSearch()` is `true.`
Method	getAddressSearchSessionForAddressBook
Description	Gets the `OsidSession` associated with the address search service for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of the `AddressBook`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressSearchSession`		an `AddressSearchSession`
Errors	NOT_FOUND		no `Address` found by the given `Id`
	NULL_ARGUMENT		`addressBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressSearch()` and `supportsVisibleFederation()` are `true`
Method	getAddressAdminSession
Description	Gets the `OsidSession` associated with the address administrative service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressAdminSession`		an `AddressAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressAdmin()` is `true.`
Method	getAddressAdminSessionForAddressBook
Description	Gets the `OsidSession` associated with the address administration service for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of the `AddressBook`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressAdminSession`		an `AddressAdminSession`
Errors	NOT_FOUND		no `Address` found by the given `Id`
	NULL_ARGUMENT		`addressBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressAdmin()` and `supportsVisibleFederation()` are `true`
Method	getAddressNotificationSession
Description	Gets the `OsidSession` associated with the address notification service.
Parameters	`osid.contact.AddressReceiver`	`addressReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressNotificationSession`		an `AddressNotificationSession`
Errors	NULL_ARGUMENT		`addressReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressNotification()` is `true.`
Method	getAddressNotificationSessionForAddressBook
Description	Gets the `OsidSession` associated with the address notification service for the given address book.
Parameters	`osid.contact.AddressReceiver`	`addressReceiver`	the receiver
	`osid.id.Id`	`addressBookId`	the `Id` of the `AddressBook`
	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressNotificationSession`		an `AddressNotificationSession`
Errors	NOT_FOUND		no `Address` found by the given `Id`
	NULL_ARGUMENT		`addressReceiver, addressBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressNotification()` and `supportsVisibleFederation()` are `true`
Method	getAddressAddressBookSession
Description	Gets the session for retrieving address to address book mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressAddressBookSession`		an `AddressAddressBookSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressAddressBook()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressAddressBook()` is `true.`
Method	getAddressAddressBookAssignmentSession
Description	Gets the session for assigning address to address book mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressAddressBookAssignmentSession`		an `AddressAddressBookAssignmentSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressAddressBookAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressAddressBookAssignment()` is `true.`
Method	getAddressSmartAddressBookSession
Description	Gets the session for managing dynamic address address books for the given address book.
Parameters	`osid.id.Id`	`addressBookId`	the `Id` of an address book
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressSmartAddressBookSession`		an `AddressSmartAddressBookSession`
Errors	NOT_FOUND		`addressBookId` is not found
	NULL_ARGUMENT		`addressBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressSmartAddressBook()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressSmartAddressBook()` is `true.`
Method	getAddressBookLookupSession
Description	Gets the `OsidSession` associated with the address book lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressBookLookupSession`		an `AddressBookLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBookLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookLookup()` is `true.`
Method	getAddressBookQuerySession
Description	Gets the `OsidSession` associated with the address book query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressBookQuerySession`		an `AddressBookQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBookQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookQuery()` is `true.`
Method	getAddressBookSearchSession
Description	Gets the `OsidSession` associated with the address book search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressBookSearchSession`		an `AddressBookSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBookSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookSearch()` is `true.`
Method	getAddressBookAdminSession
Description	Gets the `OsidSession` associated with the address book administrative service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressBookAdminSession`		an `AddressBookAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBookAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookAdmin()` is `true.`
Method	getAddressBookNotificationSession
Description	Gets the `OsidSession` associated with the address book notification service.
Parameters	`osid.contact.AddressBookReceiver`	`addressBookReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressBookNotificationSession`		an `AddressBookNotificationSession`
Errors	NULL_ARGUMENT		`addressBookReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBookNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookNotification()` is `true.`
Method	getAddressBookHierarchySession
Description	Gets the `OsidSession` associated with the address book hierarchy service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressBookHierarchySession`		an `AddressBookHierarchySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBookHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookHierarchy()` is `true.`
Method	getAddressBookHierarchyDesignSession
Description	Gets the `OsidSession` associated with the address book hierarchy design service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.contact.AddressBookHierarchyDesignSession`		an `AddressBookHierarchyDesignSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAddressBookHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAddressBookHierarchyDesign()` is `true.`
Method	getContactBatchProxyManager
Description	Gets the `ContactBatchProxyManager.`
Return	`osid.contact.batch.ContactBatchProxyManager`		a `ContactBatchProxyManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsContactBatch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactBatch()` is `true.`
Method	getContactRulesProxyManager
Description	Gets the `ContactRulesProxyManager.`
Return	`osid.contact.rules.ContactRulesProxyManager`		a `ContactRulesProxyManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsContactRules()` is `false`
Compliance	`optional`		This method must be implemented if `supportsContactRules()` is `true.`