OSID - osid.recognition.RecognitionProxyManager Service Interface Definition

Interface	osid.recognition.RecognitionProxyManager
Implements	`osid.OsidProxyManager`
Implements	`osid.recognition.RecognitionProfile`
Description	The recognition manager provides access to conferral 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: `ConferralLookupSession:` a session to lookup conferrals `ConferralQuerySession:` a session to query conferrals `ConferralSearchSession:` a session to search conferrals `ConferralAdminSession:` a session to manage conferrals `ConferralNotificationSession:` a session to subscribe to notifications of conferral changes `ConferralAcademySession:` a session to lookup conferral academy mappings `ConferralAcademyAssignmentSession:` a session to manage conferral academy mappings `ConferralSmartAcademySession:` a session to manage smart academies of conferrals `AwardLookupSession:` a session to retrieve awards `AwardQuerySession:` a session to query awards `AwardSearchSession:` a session to search for awards `AwardAdminSession:` a session to create, update and delete awards `AwardNotificationSession:` a session to receive notifications for changes in awards `AwardAcademySession:` a session to lookup award academy mappings `AwardAcademyAssignmentSession:` a session to manage award academy mappings `AwardSmartAcademySession:` a session to manage smart academies of awards `ConvocationSession` : a session to get available convocations for a resource `ConvocationLookupSession:` a session to lookup convocations `ConvocationQuerySession:` a session to query convocations `ConvocationSearchSession:` a session to search convocations `ConvocationAdminSession:` a session to manage convocations `ConvocationNotificationSession:` a session to subscribe to notifications of convocation changes `ConvocationAcademySession:` a session to lookup convocation academy mappings `ConvocationAcademyAssignmentSession:` a session to manage convocation academy mappings `ConvocationSmartAcademySession:` a session to manage smart academies of convocations `AcademyLookupSession:` a session to retrieve academies `AcademyQuerySession:` a session to query academies `AcademySearchSession:` a session to search for academies `AcademyAdminSession:` a session to create, update and delete academies `AcademyNotificationSession:` a session to receive notifications for changes in academies `AcademyHierarchyTraversalSession:` a session to traverse hierarchies of academies `AcademyHierarchyDesignSession:` a session to manage hierarchies of academies The recognition manager also provides a profile for determing the supported search types supported by this service.
Method	getConferralLookupSession
Description	Gets the `OsidSession` associated with the conferral lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralLookupSession`		a `ConferralLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralLookup()` is `true.`
Method	getConferralLookupSessionForAcademy
Description	Gets the `OsidSession` associated with the conferral lookup service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralLookupSession`		a `ConferralLookupSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralLookup()` and `supportsVisibleFederation()` are `true`
Method	getConferralQuerySession
Description	Gets the `OsidSession` associated with the conferral query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralQuerySession`		a `ConferralQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralQuery()` is `true.`
Method	getConferralQuerySessionForAcademy
Description	Gets the `OsidSession` associated with the conferral query service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralQuerySession`		a `ConferralQuerySession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralQuery()` and `supportsVisibleFederation()` are `true`
Method	getConferralSearchSession
Description	Gets the `OsidSession` associated with the conferral search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralSearchSession`		a `ConferralSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralSearch()` is `true.`
Method	getConferralSearchSessionForAcademy
Description	Gets the `OsidSession` associated with the conferral search service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralSearchSession`		a `ConferralSearchSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralSearch()` and `supportsVisibleFederation()` are `true`
Method	getConferralAdminSession
Description	Gets the `OsidSession` associated with the conferral administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralAdminSession`		a `ConferralAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralAdmin()` is `true.`
Method	getConferralAdminSessionForAcademy
Description	Gets the `OsidSession` associated with the conferral administration service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralAdminSession`		a `ConferralAdminSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralAdmin()` and `supportsVisibleFederation()` are `true`
Method	getConferralNotificationSession
Description	Gets the `OsidSession` associated with the conferral notification service.
Parameters	`osid.recognition.ConferralReceiver`	`conferralReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralNotificationSession`		a `ConferralNotificationSession`
Errors	NULL_ARGUMENT		`conferralReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralNotification()` is `true.`
Method	getConferralNotificationSessionForAcademy
Description	Gets the `OsidSession` associated with the conferral notification service for the given academy.
Parameters	`osid.recognition.ConferralReceiver`	`conferralReceiver`	the receiver
	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralNotificationSession`		a `ConferralNotificationSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`conferralReceiver, academyId,` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralNotification()` and `supportsVisibleFederation()` are `true`
Method	getConferralAcademySession
Description	Gets the session for retrieving conferral to academy mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralAcademySession`		a `ConferralAcademySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralAcademy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralAcademy()` is `true.`
Method	getConferralAcademyAssignmentSession
Description	Gets the session for assigning conferral to academy mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralAcademyAssignmentSession`		a `ConferralAcademyAssignmentSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralAcademyAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralAcademyAssignment()` is `true.`
Method	getConferralSmartAcademySession
Description	Gets the session associated with the conferral smart academy for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the conferral book
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConferralSmartAcademySession`		a `ConferralSmartAcademySession`
Errors	NOT_FOUND		`conferralBookId` not found
	NULL_ARGUMENT		`conferralBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConferralSmartAcademy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConferralSmartAcademy()` is `true.`
Method	getAwardLookupSession
Description	Gets the `OsidSession` associated with the award lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardLookupSession`		an `AwardLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardLookup()` is `true.`
Method	getAwardLookupSessionForAcademy
Description	Gets the `OsidSession` associated with the award lookup service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardLookupSession`		an `AwardLookupSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardLookup()` and `supportsVisibleFederation()` are `true`
Method	getAwardQuerySession
Description	Gets the `OsidSession` associated with the award query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardQuerySession`		an `AwardQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardQuery()` is `true.`
Method	getAwardQuerySessionForAcademy
Description	Gets the `OsidSession` associated with the award query service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardQuerySession`		an `AwardQuerySession`
Errors	NOT_FOUND		no `Award` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardQuery()` and `supportsVisibleFederation()` are `true`
Method	getAwardSearchSession
Description	Gets the `OsidSession` associated with the award search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardSearchSession`		an `AwardSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardSearch()` is `true.`
Method	getAwardSearchSessionForAcademy
Description	Gets the `OsidSession` associated with the award search service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardSearchSession`		an `AwardSearchSession`
Errors	NOT_FOUND		no `Award` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardSearch()` and `supportsVisibleFederation()` are `true`
Method	getAwardAdminSession
Description	Gets the `OsidSession` associated with the award administrative service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardAdminSession`		an `AwardAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardAdmin()` is `true.`
Method	getAwardAdminSessionForAcademy
Description	Gets the `OsidSession` associated with the award administration service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardAdminSession`		an `AwardAdminSession`
Errors	NOT_FOUND		no `Award` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardAdmin()` and `supportsVisibleFederation()` are `true`
Method	getAwardNotificationSession
Description	Gets the `OsidSession` associated with the award notification service.
Parameters	`osid.recognition.AwardReceiver`	`awardReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardNotificationSession`		an `AwardNotificationSession`
Errors	NULL_ARGUMENT		`awardReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardNotification()` is `true.`
Method	getAwardNotificationSessionForAcademy
Description	Gets the `OsidSession` associated with the award notification service for the given academy.
Parameters	`osid.recognition.AwardReceiver`	`awardReceiver`	the receiver
	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardNotificationSession`		an `AwardNotificationSession`
Errors	NOT_FOUND		no `Award` found by the given `Id`
	NULL_ARGUMENT		`awardReceiver, academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardNotification()` and `supportsVisibleFederation()` are `true`
Method	getAwardAcademySession
Description	Gets the session for retrieving award to academy mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardAcademySession`		an `AwardAcademySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardAcademy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardAcademy()` is `true.`
Method	getAwardAcademyAssignmentSession
Description	Gets the session for assigning award to academy mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardAcademyAssignmentSession`		an `AwardAcademyAssignmentSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardAcademyAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardAcademyAssignment()` is `true.`
Method	getAwardSmartAcademySession
Description	Gets the session for managing dynamic award academies for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of an academy
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AwardSmartAcademySession`		an `AwardSmartAcademySession`
Errors	NOT_FOUND		`academyId` is not found
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAwardSmartAcademy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAwardSmartAcademy()` is `true.`
Method	getConvocationLookupSession
Description	Gets the `OsidSession` associated with the convocation lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationLookupSession`		a `ConvocationLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationLookup()` is `true.`
Method	getConvocationLookupSessionForAcademy
Description	Gets the `OsidSession` associated with the convocation lookup service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationLookupSession`		a `ConvocationLookupSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationLookup()` and `supportsVisibleFederation()` are `true`
Method	getConvocationQuerySession
Description	Gets the `OsidSession` associated with the convocation query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationQuerySession`		a `ConvocationQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationQuery()` is `true.`
Method	getConvocationQuerySessionForAcademy
Description	Gets the `OsidSession` associated with the convocation query service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationQuerySession`		a `ConvocationQuerySession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationQuery()` and `supportsVisibleFederation()` are `true`
Method	getConvocationSearchSession
Description	Gets the `OsidSession` associated with the convocation search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationSearchSession`		a `ConvocationSearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationSearch()` is `true.`
Method	getConvocationSearchSessionForAcademy
Description	Gets the `OsidSession` associated with the convocation search service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationSearchSession`		a `ConvocationSearchSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationSearch()` and `supportsVisibleFederation()` are `true`
Method	getConvocationAdminSession
Description	Gets the `OsidSession` associated with the convocation administration service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationAdminSession`		a `ConvocationAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationAdmin()` is `true.`
Method	getConvocationAdminSessionForAcademy
Description	Gets the `OsidSession` associated with the convocation administration service for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationAdminSession`		a `ConvocationAdminSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`academyId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationAdmin()` and `supportsVisibleFederation()` are `true`
Method	getConvocationNotificationSession
Description	Gets the `OsidSession` associated with the convocation notification service.
Parameters	`osid.recognition.ConvocationReceiver`	`convocationReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationNotificationSession`		a `ConvocationNotificationSession`
Errors	NULL_ARGUMENT		`convocationReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationNotification()` is `true.`
Method	getConvocationNotificationSessionForAcademy
Description	Gets the `OsidSession` associated with the convocation notification service for the given academy.
Parameters	`osid.recognition.ConvocationReceiver`	`convocationReceiver`	the receiver
	`osid.id.Id`	`academyId`	the `Id` of the `Academy`
	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationNotificationSession`		a `ConvocationNotificationSession`
Errors	NOT_FOUND		no `Academy` found by the given `Id`
	NULL_ARGUMENT		`convocationReceiver, academyId,` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationNotification()` and `supportsVisibleFederation()` are `true`
Method	getConvocationAcademySession
Description	Gets the session for retrieving convocation to academy mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationAcademySession`		a `ConvocationAcademySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationAcademy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationAcademy()` is `true.`
Method	getConvocationAcademyAssignmentSession
Description	Gets the session for assigning convocation to academy mappings.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationAcademyAssignmentSession`		a `ConvocationAcademyAssignmentSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationAcademyAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationAcademyAssignment()` is `true.`
Method	getConvocationSmartAcademySession
Description	Gets the session associated with the convocation smart academy for the given academy.
Parameters	`osid.id.Id`	`academyId`	the `Id` of the convocation book
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.ConvocationSmartAcademySession`		a `ConvocationSmartAcademySession`
Errors	NOT_FOUND		`convocationBookId` not found
	NULL_ARGUMENT		`convocationBookId` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsConvocationSmartAcademy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsConvocationSmartAcademy()` is `true.`
Method	getAcademyLookupSession
Description	Gets the `OsidSession` associated with the academy lookup service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AcademyLookupSession`		an `AcademyLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAcademyLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcademyLookup()` is `true.`
Method	getAcademyQuerySession
Description	Gets the `OsidSession` associated with the academy query service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AcademyQuerySession`		an `AcademyQuerySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAcademyQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcademyQuery()` is `true.`
Method	getAcademySearchSession
Description	Gets the `OsidSession` associated with the academy search service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AcademySearchSession`		an `AcademySearchSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAcademySearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcademySearch()` is `true.`
Method	getAcademyAdminSession
Description	Gets the `OsidSession` associated with the academy administrative service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AcademyAdminSession`		an `AcademyAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAcademyAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcademyAdmin()` is `true.`
Method	getAcademyNotificationSession
Description	Gets the `OsidSession` associated with the academy notification service.
Parameters	`osid.recognition.AcademyReceiver`	`academyReceiver`	the receiver
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AcademyNotificationSession`		an `AcademyNotificationSession`
Errors	NULL_ARGUMENT		`academyReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAcademyNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcademyNotification()` is `true.`
Method	getAcademyHierarchySession
Description	Gets the `OsidSession` associated with the academy hierarchy service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AcademyHierarchySession`		an `AcademyHierarchySession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAcademyHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcademyHierarchy()` is `true.`
Method	getAcademyHierarchyDesignSession
Description	Gets the `OsidSession` associated with the academy hierarchy design service.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.recognition.AcademyHierarchyDesignSession`		an `AcademyHierarchyDesignSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAcademyHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcademyHierarchyDesign()` is `true.`
Method	getRecognitionBatchProxyManager
Description	Gets a `RecognitionBatchProxyManager.`
Return	`osid.recognition.batch.RecognitionBatchProxyManager`		a `RecognitionBatchProxyManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRecognitionBatch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRecognitionBatch()` is `true.`